npm - @ai-agent-forge/agent-forge - Versions diffs - 0.86.7 → 0.87.0 - Mend

@ai-agent-forge/agent-forge 0.86.7 → 0.87.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (665) hide show

package/dist/bundle/rpc-entry.js CHANGED Viewed

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 import { createRequire as __piCreateRequire } from "node:module"; const require = __piCreateRequire(import.meta.url);
-import{APP_NAME,configureHttpDispatcher,main}from"./chunks/chunk-EALJ5DDX.js";import"./chunks/chunk-JUUC5AZY.js";import"./chunks/chunk-A7GUOX2H.js";import"./chunks/chunk-XDUWOHPL.js";import"./chunks/chunk-3QKHSPQL.js";import"./chunks/chunk-DRQDKNXA.js";import"./chunks/chunk-7ZY7IXZD.js";import"./chunks/chunk-Y7HXTASS.js";import"./chunks/chunk-CIX3FSBK.js";import"./chunks/chunk-4L3WN2XY.js";process.title=`${APP_NAME}-rpc`;process.env.AGENT_FORGE="true";process.env.AI_AGENT="agent-forge";process.emitWarning=(()=>{});configureHttpDispatcher();main(["--mode","rpc",...process.argv.slice(2)]);
+import{APP_NAME,configureHttpDispatcher,main}from"./chunks/chunk-MOHOLL3F.js";import"./chunks/chunk-JUUC5AZY.js";import"./chunks/chunk-6ZKDNZHA.js";import"./chunks/chunk-XDUWOHPL.js";import"./chunks/chunk-3QKHSPQL.js";import"./chunks/chunk-BFC2BDVJ.js";import"./chunks/chunk-DRQDKNXA.js";import"./chunks/chunk-7ZY7IXZD.js";import"./chunks/chunk-Y7HXTASS.js";import"./chunks/chunk-CIX3FSBK.js";import"./chunks/chunk-4L3WN2XY.js";process.title=`${APP_NAME}-rpc`;process.env.AGENT_FORGE="true";process.env.AI_AGENT="agent-forge";process.emitWarning=(()=>{});configureHttpDispatcher();main(["--mode","rpc",...process.argv.slice(2)]);

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

	@@ -1 +1 @@
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\t/* Explicit suite/profile migration on resume (--rebind-suite): adopt the current plugin set when the session binding drifted. /\n\trebindSuite?: 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\") {\n\t\t\tconst mode = args[i + 1];\n\t\t\tif (mode === undefined \|\| mode.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--mode requires text, json, or rpc\" });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\ti++;\n\t\t\tif (mode !== \"text\" && mode !== \"json\" && mode !== \"rpc\") {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: `Invalid mode \"${mode}\". Valid values: text, json, rpc`,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tresult.mode = mode;\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 === \"--rebind-suite\") {\n\t\t\tresult.rebindSuite = 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"]}
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 { t } from \"../core/i18n/index.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\t/* Explicit suite/profile migration on resume (--rebind-suite): adopt the current plugin set when the session binding drifted. /\n\trebindSuite?: 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: t(\"{option} requires a plugin id\", { option }) });\n\t\treturn index;\n\t}\n\tconst value = raw.trim();\n\tif (value.length === 0) {\n\t\tresult.diagnostics.push({ type: \"error\", message: t(\"{option} requires a non-empty plugin id\", { option }) });\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: t(\"{option} plugin id must be at most {max} characters\", {\n\t\t\t\toption,\n\t\t\t\tmax: MAX_PLUGIN_CLI_ID_CHARS,\n\t\t\t}),\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: t(\"{option} accepts at most {max} plugin ids\", { option, max: MAX_PLUGIN_CLI_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: t(\"--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({\n\t\t\ttype: \"error\",\n\t\t\tmessage: t(\"--plugin-profile requires a non-empty profile id\"),\n\t\t});\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: t(\"--plugin-profile id must be at most {max} characters\", { max: MAX_PLUGIN_CLI_ID_CHARS }),\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\") {\n\t\t\tconst mode = args[i + 1];\n\t\t\tif (mode === undefined \|\| mode.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: t(\"--mode requires text, json, or rpc\") });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\ti++;\n\t\t\tif (mode !== \"text\" && mode !== \"json\" && mode !== \"rpc\") {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: t('Invalid mode \"{mode}\". Valid values: text, json, rpc', { mode }),\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tresult.mode = mode;\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: t(\"--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 === \"--rebind-suite\") {\n\t\t\tresult.rebindSuite = 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: t(\"--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: t(\"--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: t(\"--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: t(\"--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: t(\"--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({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: t(\"--serve requires a valid TCP port (0-65535)\"),\n\t\t\t\t});\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({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: t(\"--serve-workspace-root requires a directory\"),\n\t\t\t\t});\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: t('Invalid thinking level \"{level}\". Valid values: {levels}', {\n\t\t\t\t\t\tlevel,\n\t\t\t\t\t\tlevels: VALID_THINKING_LEVELS.join(\", \"),\n\t\t\t\t\t}),\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({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: t(\"--trace-kind requires a comma-separated kind list\"),\n\t\t\t\t});\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({\n\t\t\t\t\t\ttype: \"error\",\n\t\t\t\t\t\tmessage: t(\"--trace-kind requires at least one trace kind\"),\n\t\t\t\t\t});\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: t('Invalid trace kind(s) \"{kinds}\". Valid values: {valid}', {\n\t\t\t\t\t\t\tkinds: invalid.join(\", \"),\n\t\t\t\t\t\t\tvalid: TRACE_KINDS_V1.join(\", \"),\n\t\t\t\t\t\t}),\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({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: t(\"--trace-limit requires a positive integer\"),\n\t\t\t\t});\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: t('Invalid trace limit \"{limit}\". Expected a positive integer', { limit: raw }),\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: t(\"--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: t('Invalid log level \"{level}\". Valid values: {levels}', {\n\t\t\t\t\t\tlevel,\n\t\t\t\t\t\tlevels: VALID_LOG_LEVELS.join(\", \"),\n\t\t\t\t\t}),\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: t(\"--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: t(\"--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({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: t(\"{option} requires a non-empty plugin id\", { option: \"--plugin\" }),\n\t\t\t\t});\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: t(\"{option} plugin id must be at most {max} characters\", {\n\t\t\t\t\t\toption: \"--plugin\",\n\t\t\t\t\t\tmax: MAX_PLUGIN_CLI_ID_CHARS,\n\t\t\t\t\t}),\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: t(\"{option} accepts at most {max} plugin ids\", { option: \"--plugin\", max: MAX_PLUGIN_CLI_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({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: t(\"{option} requires a non-empty plugin id\", { option: \"--disable-plugin\" }),\n\t\t\t\t});\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: t(\"{option} plugin id must be at most {max} characters\", {\n\t\t\t\t\t\toption: \"--disable-plugin\",\n\t\t\t\t\t\tmax: MAX_PLUGIN_CLI_ID_CHARS,\n\t\t\t\t\t}),\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: t(\"{option} accepts at most {max} plugin ids\", {\n\t\t\t\t\t\toption: \"--disable-plugin\",\n\t\t\t\t\t\tmax: MAX_PLUGIN_CLI_IDS,\n\t\t\t\t\t}),\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: t(\"--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: t(\"--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: t('Invalid TUI mode \"{mode}\". Valid values: regular, fullscreen', { mode }),\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)} - ${t(\"AI coding assistant with read, bash, edit, write tools\")}\n\n${chalk.bold(t(\"Usage:\"))}\n ${APP_NAME} [options] [--] [@files...] [messages...]\n\n${chalk.bold(t(\"Commands:\"))}\n ${APP_NAME} install <source> [-l] ${t(\"Install extension source and add to settings\")}\n ${APP_NAME} remove <source> [-l] ${t(\"Remove extension source from settings\")}\n ${APP_NAME} uninstall <source> [-l] ${t(\"Alias for remove\")}\n ${APP_NAME} update [source\|self\|agent-forge] ${t(\"Update Agent Forge, extensions, or model catalogs\")}\n ${APP_NAME} list ${t(\"List installed extensions from settings\")}\n ${APP_NAME} config [-l] ${t(\"Open TUI to enable/disable package resources (Tab switches scope)\")}\n ${APP_NAME} auth <command> ${t(\"Print credentials or check provider readiness\")}\n ${APP_NAME} <command> --help ${t(\"Show help for install/remove/uninstall/update/list/config/auth\")}\n\n${chalk.bold(t(\"Options:\"))}\n --provider <name> ${t(\"Provider name (default: google)\")}\n --model <pattern> ${t('Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")')}\n --api-key <key> ${t(\"API key (defaults to env vars)\")}\n --system-prompt <text> ${t(\"System prompt (default: coding assistant prompt)\")}\n --append-system-prompt <text> ${t(\"Append text or file contents to the system prompt (can be used multiple times)\")}\n --mode <mode> ${t(\"Output mode: text (default), json, or rpc\")}\n --print, -p ${t(\"Non-interactive mode: process prompt and exit\")}\n --continue, -c ${t(\"Continue previous session\")}\n --resume, -r ${t(\"Select a session to resume\")}\n --session <path\|id> ${t(\"Use specific session file or partial UUID\")}\n --session-id <id> ${t(\"Use exact project session ID, creating it if missing\")}\n --fork <path\|id> ${t(\"Fork specific session file or partial UUID into a new session\")}\n --session-dir <dir> ${t(\"Directory for session storage and lookup\")}\n --suite <id> ${t(\"Suite (方案) for this run: coding (default) or assistant; new sessions only\")}\n --suite-create <id> ${t(\"Create a user suite workspace and exit; add --clone-from <id> to copy one\")}\n --suite-delete <id> ${t(\"Delete a user suite workspace (active session references refuse) and exit\")}\n --suite-reset <id> ${t(\"Reset a builtin suite to factory contents (shows a diff) and exit\")}\n --serve <port> ${t(\"(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 ${t(\"Durable journal: <agentDir>/remote-server-journal.jsonl (never the process cwd)\")}\n --serve-workspace-root <dir> ${t(\"Opt-in --serve boundary: remote creates must run inside one of these roots (repeatable); without it any local directory is allowed\")}\n --subagent-runner ${t(\"(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 ${t(\"Don't save session (ephemeral)\")}\n --name, -n <name> ${t(\"Set session display name\")}\n --models <patterns> ${t(\"Comma-separated model patterns for Ctrl+P cycling\")}\n ${t(\"Supports globs (anthropic/, sonnet) and fuzzy matching\")}\n --no-tools, -nt ${t(\"Disable all tools by default (built-in and plugin)\")}\n --no-builtin-tools, -nbt ${t(\"Disable built-in tools by default but keep plugin/custom tools enabled\")}\n --tools, -t <tools> ${t(\"Comma-separated allowlist of tool names to enable\")}\n ${t(\"Applies to built-in, plugin, and custom tools\")}\n --exclude-tools, -xt <tools> ${t(\"Comma-separated denylist of tool names to disable\")}\n ${t(\"Applies to built-in, plugin, and custom tools\")}\n --thinking <level> ${t(\"Set thinking level: off, minimal, low, medium, high, xhigh, max\")}\n --no-plugins, -np ${t(\"Disable capability plugin discovery (D-028 escape hatch)\")}\n --no-trace ${t(\"Disable session trace collection (no .trace.jsonl file is written)\")}\n --log-level <level> ${t(\"Host log level: debug, info (default), warn, error\")}\n --plugin-profile <id> ${t(\"Select a builtin capability plugin profile for this run\")}\n --plugin <id> ${t(\"Select a plugin within the profile (repeatable)\")}\n --disable-plugin <id> ${t(\"Disable a plugin within the profile (repeatable)\")}\n --plugin-scope <scope> ${t(\"Read the explicit selection from global or project storage\")}\n plugin catalog list ${t(\"List installed/available ecosystem plugins (independent namespace)\")}\n --skill <path> ${t(\"Load a skill file or directory (can be used multiple times)\")}\n --no-skills, -ns ${t(\"Disable skills discovery and loading\")}\n --prompt-template <path> ${t(\"Load a prompt template file or directory (can be used multiple times)\")}\n --no-prompt-templates, -np ${t(\"Disable prompt template discovery and loading\")}\n --theme <path> ${t(\"Load a theme file or directory (can be used multiple times)\")}\n --use-theme <name[/name]> ${t(\"Set the initial interactive theme for this run\")}\n --no-themes ${t(\"Disable theme discovery and loading\")}\n --no-context-files, -nc ${t(\"Disable AGENTS.md and CLAUDE.md discovery and loading\")}\n --export <file> ${t(\"Export session file to HTML and exit\")}\n --trace <session> ${t(\"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 ${t(\"With --trace, output the structured trace records as JSON instead of the text timeline\")}\n --trace-kind <k1,k2> ${t(\"With --trace, show only records of these kinds (comma-separated); valid kinds: {kinds}\", { kinds: TRACE_KINDS_V1.join(\", \") })}\n --trace-limit <n> ${t(\"With --trace, show only the last N records (positive integer)\")}\n --list-models [search] ${t(\"List available models (with optional fuzzy search)\")}\n --verbose ${t(\"Force verbose startup (overrides quietStartup setting)\")}\n --tui-mode <mode> ${t(\"TUI mode: regular (default) or fullscreen\")}\n --offline ${t(\"Disable startup network operations (same as AGENT_FORGE_OFFLINE=1)\")}\n -- ${t(\"End option parsing; treat remaining arguments as messages/files\")}\n --help, -h ${t(\"Show this help\")}\n --version, -v ${t(\"Show version number\")}\n\n${chalk.bold(t(\"Examples:\"))}\n # ${t(\"Print a provider API key for an external client\")}\n ${APP_NAME} auth print-api-key --provider openai\n\n # ${t(\"Print an OAuth bearer token for an external client (refreshes if expired)\")}\n ${APP_NAME} auth print-bearer-token --provider openai-codex\n\n # ${t(\"Interactive mode\")}\n ${APP_NAME}\n\n # ${t(\"Interactive mode with initial prompt\")}\n ${APP_NAME} \"List all .ts files in src/\"\n\n # ${t(\"Include files in initial message\")}\n ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\n\n # ${t(\"Non-interactive mode (process and exit)\")}\n ${APP_NAME} -p \"List all .ts files in src/\"\n\n # ${t(\"Prompt beginning with a dash\")}\n ${APP_NAME} -p -- \"- Summarize these points\"\n\n # ${t(\"Multiple messages (interactive)\")}\n ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\n\n # ${t(\"Continue previous session\")}\n ${APP_NAME} --continue \"What did we discuss?\"\n\n # ${t(\"Start a named session\")}\n ${APP_NAME} --name \"Refactor auth module\"\n\n # ${t(\"Use different model\")}\n ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n # ${t(\"Use model with provider prefix (no --provider needed)\")}\n ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\n\n # ${t(\"Use model with thinking level shorthand\")}\n ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\n\n # ${t(\"Limit model cycling to specific models\")}\n ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n # ${t(\"Limit to a specific provider with glob pattern\")}\n ${APP_NAME} --models \"github-copilot/*\"\n\n # ${t(\"Cycle models with fixed thinking levels\")}\n ${APP_NAME} --models sonnet:high,haiku:low\n\n # ${t(\"Start with a specific thinking level\")}\n ${APP_NAME} --thinking high \"Solve this complex problem\"\n\n # ${t(\"Read-only mode (no file modifications possible)\")}\n ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\n\n # ${t(\"Disable one tool while keeping the rest available\")}\n ${APP_NAME} --exclude-tools ask_question\n\n # ${t(\"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(t(\"Environment Variables:\"))}\n ANTHROPIC_AUTH_TOKEN - ${t(\"Anthropic bearer auth token\")}\n ANTHROPIC_API_KEY - ${t(\"Anthropic Claude API key\")}\n ANTHROPIC_OAUTH_TOKEN - ${t(\"Anthropic OAuth token (alternative to API key)\")}\n ANT_LING_API_KEY - ${t(\"Ant Ling API key\")}\n OPENAI_API_KEY - ${t(\"OpenAI GPT API key\")}\n AZURE_OPENAI_API_KEY - ${t(\"Azure OpenAI API key\")}\n AZURE_OPENAI_BASE_URL - ${t(\"Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)\")}\n AZURE_OPENAI_RESOURCE_NAME - ${t(\"Azure OpenAI resource name (alternative to base URL)\")}\n AZURE_OPENAI_API_VERSION - ${t(\"Azure OpenAI API version (default: v1)\")}\n AZURE_OPENAI_DEPLOYMENT_NAME_MAP - ${t(\"Azure OpenAI model=deployment map (comma-separated)\")}\n DEEPSEEK_API_KEY - ${t(\"DeepSeek API key\")}\n NVIDIA_API_KEY - ${t(\"NVIDIA NIM API key\")}\n GEMINI_API_KEY - ${t(\"Google Gemini API key\")}\n GROQ_API_KEY - ${t(\"Groq API key\")}\n CEREBRAS_API_KEY - ${t(\"Cerebras API key\")}\n XAI_API_KEY - ${t(\"xAI Grok API key\")}\n FIREWORKS_API_KEY - ${t(\"Fireworks API key\")}\n TOGETHER_API_KEY - ${t(\"Together AI API key\")}\n BASETEN_API_KEY - ${t(\"Baseten API key\")}\n OPENROUTER_API_KEY - ${t(\"OpenRouter API key\")}\n AI_GATEWAY_API_KEY - ${t(\"Vercel AI Gateway API key\")}\n ZAI_API_KEY - ${t(\"ZAI Coding Plan API key (Global)\")}\n ZAI_CODING_CN_API_KEY - ${t(\"ZAI Coding Plan API key (China)\")}\n MISTRAL_API_KEY - ${t(\"Mistral API key\")}\n MINIMAX_API_KEY - ${t(\"MiniMax API key\")}\n MOONSHOT_API_KEY - ${t(\"Moonshot AI API key\")}\n OPENCODE_API_KEY - ${t(\"OpenCode Zen/OpenCode Go API key\")}\n KIMI_API_KEY - ${t(\"Kimi For Coding API key\")}\n CLOUDFLARE_API_KEY - ${t(\"Cloudflare API token (Workers AI and AI Gateway)\")}\n CLOUDFLARE_ACCOUNT_ID - ${t(\"Cloudflare account id (required for both)\")}\n CLOUDFLARE_GATEWAY_ID - ${t(\"Cloudflare AI Gateway slug (required for AI Gateway)\")}\n QWEN_TOKEN_PLAN_API_KEY - ${t(\"Qwen Token Plan API key (international region)\")}\n QWEN_TOKEN_PLAN_CN_API_KEY - ${t(\"Qwen Token Plan API key (China region)\")}\n XIAOMI_API_KEY - ${t(\"Xiaomi MiMo API key (api.xiaomimimo.com billing)\")}\n XIAOMI_TOKEN_PLAN_CN_API_KEY - ${t(\"Xiaomi MiMo Token Plan API key (China region)\")}\n XIAOMI_TOKEN_PLAN_AMS_API_KEY - ${t(\"Xiaomi MiMo Token Plan API key (Amsterdam region)\")}\n XIAOMI_TOKEN_PLAN_SGP_API_KEY - ${t(\"Xiaomi MiMo Token Plan API key (Singapore region)\")}\n AWS_PROFILE - ${t(\"AWS profile for Amazon Bedrock\")}\n AWS_ACCESS_KEY_ID - ${t(\"AWS access key for Amazon Bedrock\")}\n AWS_SECRET_ACCESS_KEY - ${t(\"AWS secret key for Amazon Bedrock\")}\n AWS_BEARER_TOKEN_BEDROCK - ${t(\"Bedrock API key (bearer token)\")}\n AWS_REGION - ${t(\"AWS region for Amazon Bedrock (e.g., us-east-1)\")}\n ${ENV_AGENT_DIR.padEnd(32)} - ${t(\"Config directory (default: ~/{configDir}/agent)\", { configDir: CONFIG_DIR_NAME })}\n ${ENV_SESSION_DIR.padEnd(32)} - ${t(\"Session storage directory (overridden by --session-dir)\")}\n AGENT_FORGE_PACKAGE_DIR - ${t(\"Override package directory (for Nix/Guix store paths)\")}\n AGENT_FORGE_OFFLINE - ${t(\"Disable startup network operations when set to 1/true/yes\")}\n\n${chalk.bold(t(\"Built-in Tool Names:\"))}\n read - ${t(\"Read file contents\")}\n bash - ${t(\"Execute bash commands\")}\n powershell - ${t(\"Execute PowerShell commands on Windows\")}\n edit - ${t(\"Edit files with find/replace\")}\n write - ${t(\"Write files (creates/overwrites)\")}\n grep - ${t(\"Search file contents (read-only, off by default)\")}\n find - ${t(\"Find files by glob pattern (read-only, off by default)\")}\n ls - ${t(\"List directory contents (read-only, off by default)\")}\n`);\n}\n"]}