fengming 0.3.4 → 0.3.5

package/dist/cli-session-jBtClYfT.js

@@ -0,0 +1,119 @@
+import { c as normalizeOptionalString } from "./string-coerce-DKw2K5wM.js";
+import { r as normalizeProviderId } from "./provider-id-DhcncFyL.js";
+import "./model-selection-D5-ERakL.js";
+import crypto from "node:crypto";
+//#region src/agents/cli-session.ts
+const CLAUDE_CLI_BACKEND_ID = "claude-cli";
+function hashCliSessionText(value) {
+	const trimmed = normalizeOptionalString(value);
+	if (!trimmed) return;
+	return crypto.createHash("sha256").update(trimmed).digest("hex");
+}
+function getCliSessionBinding(entry, provider) {
+	if (!entry) return;
+	const normalized = normalizeProviderId(provider);
+	const fromBindings = entry.cliSessionBindings?.[normalized];
+	const bindingSessionId = normalizeOptionalString(fromBindings?.sessionId);
+	if (bindingSessionId) return {
+		sessionId: bindingSessionId,
+		...fromBindings?.forceReuse === true ? { forceReuse: true } : {},
+		authProfileId: normalizeOptionalString(fromBindings?.authProfileId),
+		authEpoch: normalizeOptionalString(fromBindings?.authEpoch),
+		authEpochVersion: fromBindings?.authEpochVersion,
+		extraSystemPromptHash: normalizeOptionalString(fromBindings?.extraSystemPromptHash),
+		promptToolNamesHash: normalizeOptionalString(fromBindings?.promptToolNamesHash),
+		cwdHash: normalizeOptionalString(fromBindings?.cwdHash),
+		mcpConfigHash: normalizeOptionalString(fromBindings?.mcpConfigHash),
+		mcpResumeHash: normalizeOptionalString(fromBindings?.mcpResumeHash)
+	};
+	const fromMap = entry.cliSessionIds?.[normalized];
+	const normalizedFromMap = normalizeOptionalString(fromMap);
+	if (normalizedFromMap) return { sessionId: normalizedFromMap };
+	if (normalized === CLAUDE_CLI_BACKEND_ID) {
+		const legacy = normalizeOptionalString(entry.claudeCliSessionId);
+		if (legacy) return { sessionId: legacy };
+	}
+}
+function getCliSessionId(entry, provider) {
+	return getCliSessionBinding(entry, provider)?.sessionId;
+}
+function setCliSessionId(entry, provider, sessionId) {
+	setCliSessionBinding(entry, provider, { sessionId });
+}
+function setCliSessionBinding(entry, provider, binding) {
+	const normalized = normalizeProviderId(provider);
+	const trimmed = binding.sessionId.trim();
+	if (!trimmed) return;
+	entry.cliSessionBindings = {
+		...entry.cliSessionBindings,
+		[normalized]: {
+			sessionId: trimmed,
+			...binding.forceReuse === true ? { forceReuse: true } : {},
+			...normalizeOptionalString(binding.authProfileId) ? { authProfileId: normalizeOptionalString(binding.authProfileId) } : {},
+			...normalizeOptionalString(binding.authEpoch) ? { authEpoch: normalizeOptionalString(binding.authEpoch) } : {},
+			...typeof binding.authEpochVersion === "number" && Number.isFinite(binding.authEpochVersion) ? { authEpochVersion: binding.authEpochVersion } : {},
+			...normalizeOptionalString(binding.extraSystemPromptHash) ? { extraSystemPromptHash: normalizeOptionalString(binding.extraSystemPromptHash) } : {},
+			...normalizeOptionalString(binding.promptToolNamesHash) ? { promptToolNamesHash: normalizeOptionalString(binding.promptToolNamesHash) } : {},
+			...normalizeOptionalString(binding.cwdHash) ? { cwdHash: normalizeOptionalString(binding.cwdHash) } : {},
+			...normalizeOptionalString(binding.mcpConfigHash) ? { mcpConfigHash: normalizeOptionalString(binding.mcpConfigHash) } : {},
+			...normalizeOptionalString(binding.mcpResumeHash) ? { mcpResumeHash: normalizeOptionalString(binding.mcpResumeHash) } : {}
+		}
+	};
+	entry.cliSessionIds = {
+		...entry.cliSessionIds,
+		[normalized]: trimmed
+	};
+	if (normalized === CLAUDE_CLI_BACKEND_ID) entry.claudeCliSessionId = trimmed;
+}
+function clearCliSession(entry, provider) {
+	const normalized = normalizeProviderId(provider);
+	if (entry.cliSessionBindings?.[normalized] !== void 0) {
+		const next = { ...entry.cliSessionBindings };
+		delete next[normalized];
+		entry.cliSessionBindings = Object.keys(next).length > 0 ? next : void 0;
+	}
+	if (entry.cliSessionIds?.[normalized] !== void 0) {
+		const next = { ...entry.cliSessionIds };
+		delete next[normalized];
+		entry.cliSessionIds = Object.keys(next).length > 0 ? next : void 0;
+	}
+	if (normalized === CLAUDE_CLI_BACKEND_ID) entry.claudeCliSessionId = void 0;
+}
+function clearAllCliSessions(entry) {
+	entry.cliSessionBindings = void 0;
+	entry.cliSessionIds = void 0;
+	entry.claudeCliSessionId = void 0;
+}
+function resolveCliSessionReuse(params) {
+	const binding = params.binding;
+	const sessionId = normalizeOptionalString(binding?.sessionId);
+	if (!sessionId) return {};
+	if (binding?.forceReuse === true) return { sessionId };
+	const currentAuthProfileId = normalizeOptionalString(params.authProfileId);
+	const currentAuthEpoch = normalizeOptionalString(params.authEpoch);
+	const currentExtraSystemPromptHash = normalizeOptionalString(params.extraSystemPromptHash);
+	const currentPromptToolNamesHash = normalizeOptionalString(params.promptToolNamesHash);
+	const currentCwdHash = normalizeOptionalString(params.cwdHash);
+	const currentMcpConfigHash = normalizeOptionalString(params.mcpConfigHash);
+	const currentMcpResumeHash = normalizeOptionalString(params.mcpResumeHash);
+	const storedAuthProfileId = normalizeOptionalString(binding?.authProfileId);
+	const storedAuthEpoch = normalizeOptionalString(binding?.authEpoch);
+	const hasMatchingVersionedAuthEpoch = binding?.authEpochVersion === params.authEpochVersion && storedAuthEpoch !== void 0 && currentAuthEpoch !== void 0 && storedAuthEpoch === currentAuthEpoch;
+	if (storedAuthProfileId !== currentAuthProfileId) {
+		if (!hasMatchingVersionedAuthEpoch) return { invalidatedReason: "auth-profile" };
+	}
+	if (binding?.authEpochVersion === params.authEpochVersion && storedAuthEpoch !== currentAuthEpoch) return { invalidatedReason: "auth-epoch" };
+	if (normalizeOptionalString(binding?.extraSystemPromptHash) !== currentExtraSystemPromptHash) return { invalidatedReason: "system-prompt" };
+	if (normalizeOptionalString(binding?.promptToolNamesHash) !== currentPromptToolNamesHash) return { invalidatedReason: "system-prompt" };
+	const storedCwdHash = normalizeOptionalString(binding?.cwdHash);
+	if (storedCwdHash !== void 0 && storedCwdHash !== currentCwdHash) return { invalidatedReason: "cwd" };
+	const storedMcpResumeHash = normalizeOptionalString(binding?.mcpResumeHash);
+	if (storedMcpResumeHash && currentMcpResumeHash) {
+		if (storedMcpResumeHash !== currentMcpResumeHash) return { invalidatedReason: "mcp" };
+		return { sessionId };
+	}
+	if (normalizeOptionalString(binding?.mcpConfigHash) !== currentMcpConfigHash) return { invalidatedReason: "mcp" };
+	return { sessionId };
+}
+//#endregion
+export { hashCliSessionText as a, setCliSessionId as c, getCliSessionId as i, clearCliSession as n, resolveCliSessionReuse as o, getCliSessionBinding as r, setCliSessionBinding as s, clearAllCliSessions as t };

package/dist/cli-startup-metadata.json

@@ -14,19 +14,19 @@
     "qqbot"
   ],
   "channelCatalogSignature": "649dd4660f8591ab54187cf587697b1e51d03901",
-  "rootHelpBundleSignature": "70753ae090b7fda285ec5091bcf9b8f74585dd7b",
+  "rootHelpBundleSignature": "9cb14c35479977aee2564c47d0a629a5287684c4",
   "browserHelpSourceSignature": "eb8b7c08ef06d6723040ce460fe2ab62dca02a38",
   "secretsHelpSourceSignature": "c2efa6d5df3760f891975bad34b9284171c51377",
   "nodesHelpSourceSignature": "4ed0a15d2aa9da1ef1477157f713127378d9bff4",
   "subcommandHelpSourceSignature": "106cea75a5d0c22eb794899dcb17fad911ce358e",
-  "browserHelpText": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming browser [options] [command]\n\nManage FengMing's dedicated browser (Chrome/Chromium)\n\nOptions:\n  --browser-profile <name>  Browser profile name (default from config)\n  --expect-final            Wait for final response (agent) (default: false)\n  -h, --help                Display help for command\n  --json                    Output machine-readable JSON (default: false)\n  --timeout <ms>            Timeout in ms (default: \"30000\")\n  --token <token>           Gateway token (if required)\n  --url <url>               Gateway WebSocket URL (defaults to\n                            gateway.remote.url when configured)\n\nCommands:\n  click                     Click an element by ref from snapshot\n  click-coords              Click viewport coordinates\n  close                     Close a tab (target id optional)\n  console                   Get recent console messages\n  cookies                   Read/write cookies\n  create-profile            Create a new browser profile\n  delete-profile            Delete a browser profile\n  dialog                    Arm the next modal dialog (alert/confirm/prompt)\n  doctor                    Check browser plugin readiness\n  download                  Click a ref and save the resulting download\n  drag                      Drag from one ref to another\n  errors                    Get recent page errors\n  evaluate                  Evaluate a function against the page or a ref\n  fill                      Fill a form with JSON field descriptors\n  focus                     Focus a tab by target id, tab id, label, or unique\n                            target id prefix\n  highlight                 Highlight an element by ref\n  hover                     Hover an element by ai ref\n  navigate                  Navigate the current tab to a URL\n  open                      Open a URL in a new tab\n  pdf                       Save page as PDF\n  press                     Press a key\n  profiles                  List all browser profiles\n  requests                  Get recent network requests (best-effort)\n  reset-profile             Reset browser profile (moves it to Trash)\n  resize                    Resize the viewport\n  responsebody              Wait for a network response and return its body\n  screenshot                Capture a screenshot (MEDIA:<path>)\n  scrollintoview            Scroll an element into view by ref from snapshot\n  select                    Select option(s) in a select element\n  set                       Browser environment settings\n  snapshot                  Capture a snapshot (default: ai; aria is the\n                            accessibility tree)\n  start                     Start the browser (no-op if already running)\n  status                    Show browser status\n  stop                      Stop the browser (best-effort)\n  storage                   Read/write localStorage/sessionStorage\n  tab                       Tab shortcuts (index-based)\n  tabs                      List open tabs\n  trace                     Record a Playwright trace\n  type                      Type into an element by ref from snapshot\n  upload                    Arm file upload for the next file chooser\n  wait                      Wait for time, selector, URL, load state, or JS\n                            conditions\n  waitfordownload           Wait for the next download (and save it)\n\nExamples:\n  fengming browser status\n  fengming browser start\n  fengming browser start --headless\n  fengming browser stop\n  fengming browser tabs\n  fengming browser open https://example.com\n  fengming browser focus abcd1234\n  fengming browser close abcd1234\n  fengming browser screenshot\n  fengming browser screenshot --full-page\n  fengming browser screenshot --ref 12\n  fengming browser snapshot\n  fengming browser snapshot --format aria --limit 200\n  fengming browser snapshot --efficient\n  fengming browser snapshot --labels\n  fengming browser navigate https://example.com\n  fengming browser resize 1280 720\n  fengming browser click 12 --double\n  fengming browser click-coords 120 340\n  fengming browser type 23 \"hello\" --submit\n  fengming browser press Enter\n  fengming browser hover 44\n  fengming browser drag 10 11\n  fengming browser select 9 OptionA OptionB\n  fengming browser upload /tmp/fengming/uploads/file.pdf\n  fengming browser fill --fields '[{\"ref\":\"1\",\"value\":\"Ada\"}]'\n  fengming browser dialog --accept\n  fengming browser wait --text \"Done\"\n  fengming browser evaluate --fn '(el) => el.textContent' --ref 7\n  fengming browser console --level error\n  fengming browser pdf\n\nDocs: https://docs.fengming.ai/cli/browser\n\n",
-  "secretsHelpText": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming secrets [options] [command]\n\nSecrets runtime controls\n\nOptions:\n  -h, --help  Display help for command\n\nCommands:\n  apply       Apply a previously generated secrets plan\n  audit       Audit plaintext secrets, unresolved refs, and precedence drift\n  configure   Interactive secrets helper (provider setup + SecretRef mapping +\n              preflight)\n  help        Display help for command\n  reload      Re-resolve secret references and atomically swap runtime snapshot\n\nDocs: https://docs.fengming.ai/gateway/security\n\n",
-  "nodesHelpText": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming nodes [options] [command]\n\nManage gateway-owned nodes (pairing, status, invoke, and media)\n\nOptions:\n  -h, --help  Display help for command\n\nCommands:\n  approve     Approve a pending pairing request\n  camera      Capture camera media from a paired node\n  canvas      Capture or render canvas content from a paired node\n  describe    Describe a node (capabilities + supported invoke commands)\n  help        Display help for command\n  invoke      Invoke a command on a paired node\n  list        List pending and paired nodes\n  location    Fetch location from a paired node\n  notify      Send a local notification on a node (mac only)\n  pending     List pending pairing requests\n  push        Send an APNs test push to an iOS node\n  reject      Reject a pending pairing request\n  remove      Remove a paired node entry\n  rename      Rename a paired node (display name override)\n  screen      Capture screen recordings from a paired node\n  status      List known nodes with connection status and capabilities\n\nExamples:\n  fengming nodes status\n    List known nodes with live status.\n  fengming nodes pairing pending\n    Show pending node pairing requests.\n  fengming nodes remove --node <id|name|ip>\n    Remove a stale paired node entry.\n  fengming nodes invoke --node <id> --command system.which --params '{\"name\":\"uname\"}'\n    Invoke a node command directly.\n  fengming nodes camera snap --node <id>\n    Capture a photo from a node camera.\n\nDocs: https://docs.fengming.ai/cli/nodes\n\n",
+  "browserHelpText": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming browser [options] [command]\n\nManage FengMing's dedicated browser (Chrome/Chromium)\n\nOptions:\n  --browser-profile <name>  Browser profile name (default from config)\n  --expect-final            Wait for final response (agent) (default: false)\n  -h, --help                Display help for command\n  --json                    Output machine-readable JSON (default: false)\n  --timeout <ms>            Timeout in ms (default: \"30000\")\n  --token <token>           Gateway token (if required)\n  --url <url>               Gateway WebSocket URL (defaults to\n                            gateway.remote.url when configured)\n\nCommands:\n  click                     Click an element by ref from snapshot\n  click-coords              Click viewport coordinates\n  close                     Close a tab (target id optional)\n  console                   Get recent console messages\n  cookies                   Read/write cookies\n  create-profile            Create a new browser profile\n  delete-profile            Delete a browser profile\n  dialog                    Arm the next modal dialog (alert/confirm/prompt)\n  doctor                    Check browser plugin readiness\n  download                  Click a ref and save the resulting download\n  drag                      Drag from one ref to another\n  errors                    Get recent page errors\n  evaluate                  Evaluate a function against the page or a ref\n  fill                      Fill a form with JSON field descriptors\n  focus                     Focus a tab by target id, tab id, label, or unique\n                            target id prefix\n  highlight                 Highlight an element by ref\n  hover                     Hover an element by ai ref\n  navigate                  Navigate the current tab to a URL\n  open                      Open a URL in a new tab\n  pdf                       Save page as PDF\n  press                     Press a key\n  profiles                  List all browser profiles\n  requests                  Get recent network requests (best-effort)\n  reset-profile             Reset browser profile (moves it to Trash)\n  resize                    Resize the viewport\n  responsebody              Wait for a network response and return its body\n  screenshot                Capture a screenshot (MEDIA:<path>)\n  scrollintoview            Scroll an element into view by ref from snapshot\n  select                    Select option(s) in a select element\n  set                       Browser environment settings\n  snapshot                  Capture a snapshot (default: ai; aria is the\n                            accessibility tree)\n  start                     Start the browser (no-op if already running)\n  status                    Show browser status\n  stop                      Stop the browser (best-effort)\n  storage                   Read/write localStorage/sessionStorage\n  tab                       Tab shortcuts (index-based)\n  tabs                      List open tabs\n  trace                     Record a Playwright trace\n  type                      Type into an element by ref from snapshot\n  upload                    Arm file upload for the next file chooser\n  wait                      Wait for time, selector, URL, load state, or JS\n                            conditions\n  waitfordownload           Wait for the next download (and save it)\n\nExamples:\n  fengming browser status\n  fengming browser start\n  fengming browser start --headless\n  fengming browser stop\n  fengming browser tabs\n  fengming browser open https://example.com\n  fengming browser focus abcd1234\n  fengming browser close abcd1234\n  fengming browser screenshot\n  fengming browser screenshot --full-page\n  fengming browser screenshot --ref 12\n  fengming browser snapshot\n  fengming browser snapshot --format aria --limit 200\n  fengming browser snapshot --efficient\n  fengming browser snapshot --labels\n  fengming browser navigate https://example.com\n  fengming browser resize 1280 720\n  fengming browser click 12 --double\n  fengming browser click-coords 120 340\n  fengming browser type 23 \"hello\" --submit\n  fengming browser press Enter\n  fengming browser hover 44\n  fengming browser drag 10 11\n  fengming browser select 9 OptionA OptionB\n  fengming browser upload /tmp/fengming/uploads/file.pdf\n  fengming browser fill --fields '[{\"ref\":\"1\",\"value\":\"Ada\"}]'\n  fengming browser dialog --accept\n  fengming browser wait --text \"Done\"\n  fengming browser evaluate --fn '(el) => el.textContent' --ref 7\n  fengming browser console --level error\n  fengming browser pdf\n\nDocs: https://docs.fengming.ai/cli/browser\n\n",
+  "secretsHelpText": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming secrets [options] [command]\n\nSecrets runtime controls\n\nOptions:\n  -h, --help  Display help for command\n\nCommands:\n  apply       Apply a previously generated secrets plan\n  audit       Audit plaintext secrets, unresolved refs, and precedence drift\n  configure   Interactive secrets helper (provider setup + SecretRef mapping +\n              preflight)\n  help        Display help for command\n  reload      Re-resolve secret references and atomically swap runtime snapshot\n\nDocs: https://docs.fengming.ai/gateway/security\n\n",
+  "nodesHelpText": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming nodes [options] [command]\n\nManage gateway-owned nodes (pairing, status, invoke, and media)\n\nOptions:\n  -h, --help  Display help for command\n\nCommands:\n  approve     Approve a pending pairing request\n  camera      Capture camera media from a paired node\n  canvas      Capture or render canvas content from a paired node\n  describe    Describe a node (capabilities + supported invoke commands)\n  help        Display help for command\n  invoke      Invoke a command on a paired node\n  list        List pending and paired nodes\n  location    Fetch location from a paired node\n  notify      Send a local notification on a node (mac only)\n  pending     List pending pairing requests\n  push        Send an APNs test push to an iOS node\n  reject      Reject a pending pairing request\n  remove      Remove a paired node entry\n  rename      Rename a paired node (display name override)\n  screen      Capture screen recordings from a paired node\n  status      List known nodes with connection status and capabilities\n\nExamples:\n  fengming nodes status\n    List known nodes with live status.\n  fengming nodes pairing pending\n    Show pending node pairing requests.\n  fengming nodes remove --node <id|name|ip>\n    Remove a stale paired node entry.\n  fengming nodes invoke --node <id> --command system.which --params '{\"name\":\"uname\"}'\n    Invoke a node command directly.\n  fengming nodes camera snap --node <id>\n    Capture a photo from a node camera.\n\nDocs: https://docs.fengming.ai/cli/nodes\n\n",
   "subcommandHelpText": {
-    "doctor": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming doctor [options]\n\nHealth checks + quick fixes for the gateway and channels\n\nOptions:\n  --allow-exec                Allow doctor to execute exec SecretRefs while\n                              verifying configured secrets (default: false)\n  --deep                      Scan system services for extra gateway installs\n                              (default: false)\n  --fix                       Apply recommended repairs (alias for --repair)\n                              (default: false)\n  --force                     Apply aggressive repairs (overwrites custom\n                              service config) (default: false)\n  --generate-gateway-token    Generate and configure a gateway token (default:\n                              false)\n  -h, --help                  Display help for command\n  --json                      With --lint: emit JSON findings instead of human\n                              output (default: false)\n  --lint                      Run read-only health checks and report findings\n                              (default: false)\n  --no-workspace-suggestions  Disable workspace memory system suggestions\n  --non-interactive           Run without prompts (safe migrations only)\n                              (default: false)\n  --only <id>                 With --lint: run only the specified check id\n                              (repeatable) (default: [])\n  --repair                    Apply recommended repairs without prompting\n                              (default: false)\n  --severity-min <level>      With --lint: drop findings below this severity\n                              (info|warning|error)\n  --skip <id>                 With --lint: skip a specific check id (repeatable)\n                              (default: [])\n  --yes                       Accept defaults without prompting (default: false)\n\nDocs: https://docs.fengming.ai/cli/doctor\n\n",
-    "gateway": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming gateway [options] [command]\n\nRun, inspect, and query the WebSocket Gateway\n\nOptions:\n  --allow-unconfigured       Allow gateway start without enforcing\n                             gateway.mode=local in config (does not repair\n                             config) (default: false)\n  --auth <mode>              Gateway auth mode\n                             (\"none\"|\"token\"|\"password\"|\"trusted-proxy\")\n  --bind <mode>              Bind mode\n                             (\"loopback\"|\"lan\"|\"tailnet\"|\"auto\"|\"custom\").\n                             Defaults to config gateway.bind (or loopback).\n  --claude-cli-logs          Deprecated alias for --cli-backend-logs (default:\n                             false)\n  --cli-backend-logs         Only show CLI backend logs in the console (includes\n                             stdout/stderr) (default: false)\n  --compact                  Alias for \"--ws-log compact\" (default: false)\n  --dev                      Create a dev config + workspace if missing (no\n                             BOOTSTRAP.md) (default: false)\n  --force                    Kill any existing listener on the target port\n                             before starting (default: false)\n  -h, --help                 Display help for command\n  --password <password>      Password for auth mode=password\n  --password-file <path>     Read gateway password from file\n  --port <port>              Port for the gateway WebSocket\n  --raw-stream               Log raw model stream events to jsonl (default:\n                             false)\n  --raw-stream-path <path>   Raw stream jsonl path\n  --reset                    Reset dev config + credentials + sessions +\n                             workspace (requires --dev) (default: false)\n  --tailscale <mode>         Tailscale exposure mode (\"off\"|\"serve\"|\"funnel\")\n  --tailscale-reset-on-exit  Reset Tailscale serve/funnel configuration on\n                             shutdown (default: false)\n  --token <token>            Shared token required in connect.params.auth.token\n                             (default: FENGMING_GATEWAY_TOKEN env if set)\n  --verbose                  Verbose logging to stdout/stderr (default: false)\n  --ws-log <style>           WebSocket log style (\"auto\"|\"full\"|\"compact\")\n                             (default: \"auto\")\n\nCommands:\n  call                       Call a Gateway method\n  diagnostics                Export local support diagnostics\n  discover                   Discover gateways via Bonjour (local + wide-area if\n                             configured)\n  health                     Fetch Gateway health\n  install                    Install the Gateway service\n                             (launchd/systemd/schtasks)\n  probe                      Show gateway reachability, auth capability, and\n                             read-probe summary (local + remote)\n  restart                    Restart the Gateway service\n                             (launchd/systemd/schtasks)\n  run                        Run the WebSocket Gateway (foreground)\n  stability                  Fetch payload-free Gateway stability diagnostics\n  start                      Start the Gateway service\n                             (launchd/systemd/schtasks)\n  status                     Show gateway service status + probe\n                             connectivity/capability\n  stop                       Stop the Gateway service (launchd/systemd/schtasks)\n  uninstall                  Uninstall the Gateway service\n                             (launchd/systemd/schtasks)\n  usage-cost                 Fetch usage cost summary from session logs\n\nExamples:\n  fengming gateway run\n    Run the gateway in the foreground.\n  fengming gateway status\n    Show service status plus connectivity/capability.\n  fengming gateway discover\n    Find local and wide-area gateway beacons.\n  fengming gateway stability\n    Show recent stability diagnostics.\n  fengming gateway call health\n    Call a gateway RPC method directly.\n\nDocs: https://docs.fengming.ai/cli/gateway\n\n",
-    "models": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming models [options] [command]\n\nModel discovery, scanning, and configuration\n\nOptions:\n  --agent <id>     Agent id to inspect (overrides FENGMING_AGENT_DIR)\n  -h, --help       Display help for command\n  --status-json    Output JSON (alias for `models status --json`) (default:\n                   false)\n  --status-plain   Plain output (alias for `models status --plain`) (default:\n                   false)\n\nCommands:\n  aliases          Manage model aliases\n  auth             Manage model auth profiles\n  fallbacks        Manage model fallback list\n  image-fallbacks  Manage image model fallback list\n  list             List models (configured by default)\n  scan             Scan OpenRouter free models for tools + images\n  set              Set the default model\n  set-image        Set the image model\n  status           Show configured model state\n\nDocs: https://docs.fengming.ai/cli/models\n\n",
-    "plugins": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming plugins [options] [command]\n\nManage FengMing plugins and extensions\n\nOptions:\n  -h, --help   Display help for command\n\nCommands:\n  build        Generate simple tool plugin metadata\n  disable      Disable a plugin in config\n  doctor       Report plugin load issues\n  enable       Enable a plugin in config\n  init         Create a simple tool plugin project\n  inspect      Inspect plugin details\n  install      Install a plugin or hook pack (path, archive, npm spec, git repo,\n               clawhub:package, or marketplace entry)\n  list         List discovered plugins\n  marketplace  Inspect Claude-compatible plugin marketplaces\n  registry     Inspect or rebuild the persisted plugin registry\n  search       Search ClawHub plugin packages\n  uninstall    Uninstall a plugin\n  validate     Validate simple tool plugin metadata\n\nDocs: https://docs.fengming.ai/cli/plugins\n\n"
+    "doctor": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming doctor [options]\n\nHealth checks + quick fixes for the gateway and channels\n\nOptions:\n  --allow-exec                Allow doctor to execute exec SecretRefs while\n                              verifying configured secrets (default: false)\n  --deep                      Scan system services for extra gateway installs\n                              (default: false)\n  --fix                       Apply recommended repairs (alias for --repair)\n                              (default: false)\n  --force                     Apply aggressive repairs (overwrites custom\n                              service config) (default: false)\n  --generate-gateway-token    Generate and configure a gateway token (default:\n                              false)\n  -h, --help                  Display help for command\n  --json                      With --lint: emit JSON findings instead of human\n                              output (default: false)\n  --lint                      Run read-only health checks and report findings\n                              (default: false)\n  --no-workspace-suggestions  Disable workspace memory system suggestions\n  --non-interactive           Run without prompts (safe migrations only)\n                              (default: false)\n  --only <id>                 With --lint: run only the specified check id\n                              (repeatable) (default: [])\n  --repair                    Apply recommended repairs without prompting\n                              (default: false)\n  --severity-min <level>      With --lint: drop findings below this severity\n                              (info|warning|error)\n  --skip <id>                 With --lint: skip a specific check id (repeatable)\n                              (default: [])\n  --yes                       Accept defaults without prompting (default: false)\n\nDocs: https://docs.fengming.ai/cli/doctor\n\n",
+    "gateway": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming gateway [options] [command]\n\nRun, inspect, and query the WebSocket Gateway\n\nOptions:\n  --allow-unconfigured       Allow gateway start without enforcing\n                             gateway.mode=local in config (does not repair\n                             config) (default: false)\n  --auth <mode>              Gateway auth mode\n                             (\"none\"|\"token\"|\"password\"|\"trusted-proxy\")\n  --bind <mode>              Bind mode\n                             (\"loopback\"|\"lan\"|\"tailnet\"|\"auto\"|\"custom\").\n                             Defaults to config gateway.bind (or loopback).\n  --claude-cli-logs          Deprecated alias for --cli-backend-logs (default:\n                             false)\n  --cli-backend-logs         Only show CLI backend logs in the console (includes\n                             stdout/stderr) (default: false)\n  --compact                  Alias for \"--ws-log compact\" (default: false)\n  --dev                      Create a dev config + workspace if missing (no\n                             BOOTSTRAP.md) (default: false)\n  --force                    Kill any existing listener on the target port\n                             before starting (default: false)\n  -h, --help                 Display help for command\n  --password <password>      Password for auth mode=password\n  --password-file <path>     Read gateway password from file\n  --port <port>              Port for the gateway WebSocket\n  --raw-stream               Log raw model stream events to jsonl (default:\n                             false)\n  --raw-stream-path <path>   Raw stream jsonl path\n  --reset                    Reset dev config + credentials + sessions +\n                             workspace (requires --dev) (default: false)\n  --tailscale <mode>         Tailscale exposure mode (\"off\"|\"serve\"|\"funnel\")\n  --tailscale-reset-on-exit  Reset Tailscale serve/funnel configuration on\n                             shutdown (default: false)\n  --token <token>            Shared token required in connect.params.auth.token\n                             (default: FENGMING_GATEWAY_TOKEN env if set)\n  --verbose                  Verbose logging to stdout/stderr (default: false)\n  --ws-log <style>           WebSocket log style (\"auto\"|\"full\"|\"compact\")\n                             (default: \"auto\")\n\nCommands:\n  call                       Call a Gateway method\n  diagnostics                Export local support diagnostics\n  discover                   Discover gateways via Bonjour (local + wide-area if\n                             configured)\n  health                     Fetch Gateway health\n  install                    Install the Gateway service\n                             (launchd/systemd/schtasks)\n  probe                      Show gateway reachability, auth capability, and\n                             read-probe summary (local + remote)\n  restart                    Restart the Gateway service\n                             (launchd/systemd/schtasks)\n  run                        Run the WebSocket Gateway (foreground)\n  stability                  Fetch payload-free Gateway stability diagnostics\n  start                      Start the Gateway service\n                             (launchd/systemd/schtasks)\n  status                     Show gateway service status + probe\n                             connectivity/capability\n  stop                       Stop the Gateway service (launchd/systemd/schtasks)\n  uninstall                  Uninstall the Gateway service\n                             (launchd/systemd/schtasks)\n  usage-cost                 Fetch usage cost summary from session logs\n\nExamples:\n  fengming gateway run\n    Run the gateway in the foreground.\n  fengming gateway status\n    Show service status plus connectivity/capability.\n  fengming gateway discover\n    Find local and wide-area gateway beacons.\n  fengming gateway stability\n    Show recent stability diagnostics.\n  fengming gateway call health\n    Call a gateway RPC method directly.\n\nDocs: https://docs.fengming.ai/cli/gateway\n\n",
+    "models": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming models [options] [command]\n\nModel discovery, scanning, and configuration\n\nOptions:\n  --agent <id>     Agent id to inspect (overrides FENGMING_AGENT_DIR)\n  -h, --help       Display help for command\n  --status-json    Output JSON (alias for `models status --json`) (default:\n                   false)\n  --status-plain   Plain output (alias for `models status --plain`) (default:\n                   false)\n\nCommands:\n  aliases          Manage model aliases\n  auth             Manage model auth profiles\n  fallbacks        Manage model fallback list\n  image-fallbacks  Manage image model fallback list\n  list             List models (configured by default)\n  scan             Scan OpenRouter free models for tools + images\n  set              Set the default model\n  set-image        Set the image model\n  status           Show configured model state\n\nDocs: https://docs.fengming.ai/cli/models\n\n",
+    "plugins": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming plugins [options] [command]\n\nManage FengMing plugins and extensions\n\nOptions:\n  -h, --help   Display help for command\n\nCommands:\n  build        Generate simple tool plugin metadata\n  disable      Disable a plugin in config\n  doctor       Report plugin load issues\n  enable       Enable a plugin in config\n  init         Create a simple tool plugin project\n  inspect      Inspect plugin details\n  install      Install a plugin or hook pack (path, archive, npm spec, git repo,\n               clawhub:package, or marketplace entry)\n  list         List discovered plugins\n  marketplace  Inspect Claude-compatible plugin marketplaces\n  registry     Inspect or rebuild the persisted plugin registry\n  search       Search ClawHub plugin packages\n  uninstall    Uninstall a plugin\n  validate     Validate simple tool plugin metadata\n\nDocs: https://docs.fengming.ai/cli/plugins\n\n"
   },
-  "rootHelpText": "\nFengMing 0.3.4 (510c148) — All your chats, one FengMing.\n\nUsage: fengming [options] [command]\n\nOptions:\n  --container <name>   Run the CLI inside a running Podman/Docker container\n                       named <name> (default: env FENGMING_CONTAINER)\n  --dev                Dev profile: isolate state under ~/.fengming-dev, default\n                       gateway port 19001, and shift derived ports\n                       (browser/canvas)\n  -h, --help           Display help for command\n  --log-level <level>  Global log level override for file + console\n                       (silent|fatal|error|warn|info|debug|trace)\n  --no-color           Disable ANSI colors\n  --profile <name>     Use a named profile (isolates\n                       FENGMING_STATE_DIR/FENGMING_CONFIG_PATH under\n                       ~/.fengming-<name>)\n  -V, --version        output the version number\n\nCommands:\n  Hint: commands suffixed with * have subcommands. Run <command> --help for details.\n  acp *                Run and manage ACP-backed coding agents\n  agent                Run one agent turn via the Gateway\n  agents *             Manage isolated agents (workspaces, auth, routing)\n  approvals *          Manage exec approvals (gateway or node host)\n  backup *             Create and verify local backup archives for FengMing\n                       state\n  capability *         Run provider capability commands (fallback alias: infer)\n  channels *           Add, remove, login, and inspect messaging channels\n  chat                 Open a local terminal UI (alias for tui --local)\n  clawbot *            Legacy clawbot command aliases\n  commitments *        List and manage inferred follow-up commitments\n  completion           Generate shell completion script\n  config *             Non-interactive config helpers\n                       (get/set/unset/file/validate). Default: starts guided\n                       setup.\n  configure            Interactive configuration for credentials, channels,\n                       gateway, and agent defaults\n  crestodian           Open the interactive setup and repair assistant\n  cron *               Schedule and inspect Gateway background jobs\n  daemon *             Manage the Gateway service (legacy alias)\n  dashboard            Open the Control UI with your current token\n  devices *            Device pairing + token management\n  directory *          Lookup contact and group IDs (self, peers, groups) for\n                       supported chat channels\n  dns *                DNS helpers for wide-area discovery (Tailscale + CoreDNS)\n  docs                 Search the live FengMing docs\n  doctor               Diagnose and repair config, Gateway, plugin, and channel\n                       problems\n  exec-policy *        Show or synchronize requested exec policy with host\n                       approvals\n  gateway *            Run, inspect, and query the FengMing Gateway\n  health               Fetch detailed health from the running Gateway\n  help                 Display help for command\n  hooks *              Manage internal agent hooks\n  infer *              Run provider-backed model, media, search, and embedding\n                       commands\n  logs                 Tail Gateway logs locally or via RPC\n  mcp *                Manage FengMing MCP config and channel bridge\n  memory *             Search, inspect, and reindex memory files\n  message *            Send, read, and manage channel messages\n  migrate *            Import state from another agent system\n  models *             List, scan, and set model providers\n  node *               Run and manage the headless node host service\n  nodes *              Pair nodes and run node-host commands through the Gateway\n  onboard              Interactive onboarding for gateway, workspace, and skills\n  pairing *            Secure DM pairing (approve inbound requests)\n  plugins *            Install, enable, disable, and inspect plugins\n  proxy *              Run the FengMing debug proxy and inspect captured traffic\n  qr                   Generate mobile pairing QR/setup code\n  reset                Reset local config/state (keeps the CLI installed)\n  sandbox *            Manage sandbox containers for agent isolation\n  secrets *            Audit, apply, and reload SecretRef-backed credentials\n  security *           Security tools and local config audits\n  sessions *           List stored conversation sessions\n  setup                Initialize local config and an agent workspace\n  skills *             List, inspect, and install agent skills\n  status               Show Gateway, channel, model, and recent-session status\n  system *             System events, heartbeat, and presence\n  tasks *              Inspect durable background tasks and flows\n  terminal             Open a local terminal UI (alias for tui --local)\n  transcripts *        Inspect stored transcripts\n  tui                  Open a terminal UI connected to the Gateway\n  uninstall            Uninstall the gateway service + local data (CLI remains)\n  update *             Update FengMing and inspect update channel status\n  webhooks *           Webhook helpers and integrations\n\nExamples:\n  fengming onboard\n    Run guided setup for a local Gateway, workspace, auth, and channels.\n  fengming setup\n    Create the baseline config, workspace, and session folders.\n  fengming configure\n    Change models, Gateway, channels, plugins, skills, and health checks.\n  fengming status\n    Check Gateway, channel, model, and recent-session status.\n  fengming doctor --fix\n    Repair common config, service, plugin, and channel problems.\n  fengming channels add\n    Add or update a chat channel account with guided prompts.\n  fengming channels status\n    See connected messaging accounts and login state.\n  fengming --dev gateway\n    Run a dev Gateway (isolated state/config) on ws://127.0.0.1:19001.\n  fengming gateway run --force\n    Start the Gateway and replace anything bound to its port.\n  fengming models status\n    Show model/provider auth health before running agents.\n  fengming plugins list\n    Inspect enabled, disabled, and installed plugins.\n  fengming agent --to +15555550123 --message \"Run summary\" --deliver\n    Run one agent turn through the Gateway and optionally deliver the reply.\n  fengming message send --channel telegram --target @mychat --message \"Hi\"\n    Send via your Telegram bot.\n\nDocs: https://docs.fengming.ai/cli\n\n"
+  "rootHelpText": "\nFengMing 0.3.5 (510c148) — All your chats, one FengMing.\n\nUsage: fengming [options] [command]\n\nOptions:\n  --container <name>   Run the CLI inside a running Podman/Docker container\n                       named <name> (default: env FENGMING_CONTAINER)\n  --dev                Dev profile: isolate state under ~/.fengming-dev, default\n                       gateway port 19001, and shift derived ports\n                       (browser/canvas)\n  -h, --help           Display help for command\n  --log-level <level>  Global log level override for file + console\n                       (silent|fatal|error|warn|info|debug|trace)\n  --no-color           Disable ANSI colors\n  --profile <name>     Use a named profile (isolates\n                       FENGMING_STATE_DIR/FENGMING_CONFIG_PATH under\n                       ~/.fengming-<name>)\n  -V, --version        output the version number\n\nCommands:\n  Hint: commands suffixed with * have subcommands. Run <command> --help for details.\n  acp *                Run and manage ACP-backed coding agents\n  agent                Run one agent turn via the Gateway\n  agents *             Manage isolated agents (workspaces, auth, routing)\n  approvals *          Manage exec approvals (gateway or node host)\n  backup *             Create and verify local backup archives for FengMing\n                       state\n  capability *         Run provider capability commands (fallback alias: infer)\n  channels *           Add, remove, login, and inspect messaging channels\n  chat                 Open a local terminal UI (alias for tui --local)\n  clawbot *            Legacy clawbot command aliases\n  commitments *        List and manage inferred follow-up commitments\n  completion           Generate shell completion script\n  config *             Non-interactive config helpers\n                       (get/set/unset/file/validate). Default: starts guided\n                       setup.\n  configure            Interactive configuration for credentials, channels,\n                       gateway, and agent defaults\n  crestodian           Open the interactive setup and repair assistant\n  cron *               Schedule and inspect Gateway background jobs\n  daemon *             Manage the Gateway service (legacy alias)\n  dashboard            Open the Control UI with your current token\n  devices *            Device pairing + token management\n  directory *          Lookup contact and group IDs (self, peers, groups) for\n                       supported chat channels\n  dns *                DNS helpers for wide-area discovery (Tailscale + CoreDNS)\n  docs                 Search the live FengMing docs\n  doctor               Diagnose and repair config, Gateway, plugin, and channel\n                       problems\n  exec-policy *        Show or synchronize requested exec policy with host\n                       approvals\n  gateway *            Run, inspect, and query the FengMing Gateway\n  health               Fetch detailed health from the running Gateway\n  help                 Display help for command\n  hooks *              Manage internal agent hooks\n  infer *              Run provider-backed model, media, search, and embedding\n                       commands\n  logs                 Tail Gateway logs locally or via RPC\n  mcp *                Manage FengMing MCP config and channel bridge\n  memory *             Search, inspect, and reindex memory files\n  message *            Send, read, and manage channel messages\n  migrate *            Import state from another agent system\n  models *             List, scan, and set model providers\n  node *               Run and manage the headless node host service\n  nodes *              Pair nodes and run node-host commands through the Gateway\n  onboard              Interactive onboarding for gateway, workspace, and skills\n  pairing *            Secure DM pairing (approve inbound requests)\n  plugins *            Install, enable, disable, and inspect plugins\n  proxy *              Run the FengMing debug proxy and inspect captured traffic\n  qr                   Generate mobile pairing QR/setup code\n  reset                Reset local config/state (keeps the CLI installed)\n  sandbox *            Manage sandbox containers for agent isolation\n  secrets *            Audit, apply, and reload SecretRef-backed credentials\n  security *           Security tools and local config audits\n  sessions *           List stored conversation sessions\n  setup                Initialize local config and an agent workspace\n  skills *             List, inspect, and install agent skills\n  status               Show Gateway, channel, model, and recent-session status\n  system *             System events, heartbeat, and presence\n  tasks *              Inspect durable background tasks and flows\n  terminal             Open a local terminal UI (alias for tui --local)\n  transcripts *        Inspect stored transcripts\n  tui                  Open a terminal UI connected to the Gateway\n  uninstall            Uninstall the gateway service + local data (CLI remains)\n  update *             Update FengMing and inspect update channel status\n  webhooks *           Webhook helpers and integrations\n\nExamples:\n  fengming onboard\n    Run guided setup for a local Gateway, workspace, auth, and channels.\n  fengming setup\n    Create the baseline config, workspace, and session folders.\n  fengming configure\n    Change models, Gateway, channels, plugins, skills, and health checks.\n  fengming status\n    Check Gateway, channel, model, and recent-session status.\n  fengming doctor --fix\n    Repair common config, service, plugin, and channel problems.\n  fengming channels add\n    Add or update a chat channel account with guided prompts.\n  fengming channels status\n    See connected messaging accounts and login state.\n  fengming --dev gateway\n    Run a dev Gateway (isolated state/config) on ws://127.0.0.1:19001.\n  fengming gateway run --force\n    Start the Gateway and replace anything bound to its port.\n  fengming models status\n    Show model/provider auth health before running agents.\n  fengming plugins list\n    Inspect enabled, disabled, and installed plugins.\n  fengming agent --to +15555550123 --message \"Run summary\" --deliver\n    Run one agent turn through the Gateway and optionally deliver the reply.\n  fengming message send --channel telegram --target @mychat --message \"Hi\"\n    Send via your Telegram bot.\n\nDocs: https://docs.fengming.ai/cli\n\n"
 }