@mininglamp-oss/octo-runtime 1.0.1 → 1.1.0

package/node_modules/@mininglamp-oss/octo-runtime-adapter-mcode/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-mcode",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
@@ -9,6 +9,6 @@
     "dist"
   ],
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-adapter-acp": "1.0.1"
+    "@mininglamp-oss/octo-runtime-adapter-acp": "1.1.0"
   }
 }

package/node_modules/@mininglamp-oss/octo-runtime-adapter-openclaw/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-openclaw",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.1",
-    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.0.1",
+    "@mininglamp-oss/octo-runtime-protocol": "1.1.0",
+    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.1.0",
     "ws": "8.22.0"
   },
   "types": "./dist/index.d.ts",

package/node_modules/@mininglamp-oss/octo-runtime-adapter-opencode/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-opencode",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.1",
-    "@mininglamp-oss/octo-runtime-adapter-acp": "1.0.1",
-    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.0.1"
+    "@mininglamp-oss/octo-runtime-protocol": "1.1.0",
+    "@mininglamp-oss/octo-runtime-adapter-acp": "1.1.0",
+    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.1.0"
   },
   "types": "./dist/index.d.ts",
   "files": [

package/node_modules/@mininglamp-oss/octo-runtime-adapter-qodercli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-qodercli",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
@@ -9,6 +9,6 @@
     "dist"
   ],
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-adapter-acp": "1.0.1"
+    "@mininglamp-oss/octo-runtime-adapter-acp": "1.1.0"
   }
 }

package/node_modules/@mininglamp-oss/octo-runtime-adapter-qoderclicn/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-qoderclicn",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
@@ -9,6 +9,6 @@
     "dist"
   ],
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-adapter-acp": "1.0.1"
+    "@mininglamp-oss/octo-runtime-adapter-acp": "1.1.0"
   }
 }

package/node_modules/@mininglamp-oss/octo-runtime-adapter-sdk/dist/native.js

@@ -101,6 +101,7 @@ export class NativeInteractionBridge {
     #pending = new Map();
     #closed = false;
     #closeTransport;
+    #transportClosed;
     #seen = new Set();
     constructor(limits) {
         this.queue = new DriverQueue({ limits, boundary: "adapter.native_queue" });
@@ -108,6 +109,12 @@ export class NativeInteractionBridge {
     bindTransport(close) {
         this.#closeTransport = close;
     }
+    #closeTransportOnce() {
+        this.#transportClosed ??= Promise.resolve().then(() => this.#closeTransport?.());
+        // 后台关闭也保留同一次失败，stream 收尾负责向调用方报告。
+        void this.#transportClosed.catch(() => undefined);
+        return this.#transportClosed;
+    }
     request(requestId, payload, write, validate, automatic) {
         if (this.#closed ||
             this.#seen.has(requestId) ||
@@ -123,7 +130,7 @@ export class NativeInteractionBridge {
                 control: { type: "interaction", requestId, status: "expired" }
             });
             this.queue.close(protocolError("INTERACTION_NOT_ACTIVE", "Native interaction expired"));
-            void this.#closeTransport?.();
+            void this.#closeTransportOnce();
         }, 600_000);
         timer.unref();
         this.#pending.set(requestId, { write, validate, timer, expiresAt, responding: false });
@@ -135,7 +142,7 @@ export class NativeInteractionBridge {
         if (automatic)
             void this.respond({ requestId, payload: automatic }).catch((error) => {
                 this.queue.close(error instanceof Error ? error : new Error(String(error)));
-                void this.#closeTransport?.();
+                void this.#closeTransportOnce();
             });
     }
     async respond(response) {
@@ -150,7 +157,14 @@ export class NativeInteractionBridge {
         catch (error) {
             this.close();
             this.queue.close(error instanceof Error ? error : new Error(String(error)));
-            await this.#closeTransport?.();
+            try {
+                await this.#closeTransportOnce();
+            }
+            catch (cleanupError) {
+                throw new AggregateError([error, cleanupError], "Native response and cleanup failed", {
+                    cause: cleanupError
+                });
+            }
             throw error;
         }
         if (!this.#pending.has(response.requestId))
@@ -198,9 +212,12 @@ export class NativeInteractionBridge {
         }
         finally {
             this.close();
-            await this.#closeTransport?.();
-            await iterator.return?.();
-            await producer;
+            // 独立清理均须执行，不能因传输关闭失败跳过源 iterator 的资源释放。
+            await Promise.all([
+                this.#closeTransportOnce(),
+                Promise.resolve().then(() => iterator.return?.()),
+                producer
+            ]);
         }
     }
 }

package/node_modules/@mininglamp-oss/octo-runtime-adapter-sdk/dist/process-cleanup.d.ts

@@ -1,11 +1,12 @@
-import type { ChildProcess } from "node:child_process";
+import { type ChildProcess } from "node:child_process";
 /**
  * 只回收调用方创建的进程/独立进程组；leader 退出不代表工具后代已退出。
  * R06：.octospec/tasks/pr1-yujiawei-review/assessment.md
  * 同一 close Promise 覆盖 TERM、KILL 和确认阶段，不扫描全机、不缓存历史 PGID。
  */
-export declare function createProcessCleanup(child: ChildProcess, { processGroup, termGraceMs, killGraceMs }?: {
+export declare function createProcessCleanup(child: ChildProcess, { processGroup, processTree, termGraceMs, killGraceMs }?: {
     processGroup?: boolean | undefined;
+    processTree?: boolean | undefined;
     termGraceMs?: number | undefined;
     killGraceMs?: number | undefined;
 }): () => Promise<void>;

package/node_modules/@mininglamp-oss/octo-runtime-adapter-sdk/dist/process-cleanup.js

@@ -1,10 +1,11 @@
+import { execFile } from "node:child_process";
 import { setTimeout as delay } from "node:timers/promises";
 /**
  * 只回收调用方创建的进程/独立进程组；leader 退出不代表工具后代已退出。
  * R06：.octospec/tasks/pr1-yujiawei-review/assessment.md
  * 同一 close Promise 覆盖 TERM、KILL 和确认阶段，不扫描全机、不缓存历史 PGID。
  */
-export function createProcessCleanup(child, { processGroup = false, termGraceMs = 400, killGraceMs = 200 } = {}) {
+export function createProcessCleanup(child, { processGroup = false, processTree = false, termGraceMs = 400, killGraceMs = 200 } = {}) {
     let cleanup;
     let signalError;
     const grouped = processGroup && process.platform !== "win32" && child.pid !== undefined;
@@ -52,6 +53,23 @@ export function createProcessCleanup(child, { processGroup = false, termGraceMs
         return true;
     };
     return () => (cleanup ??= (async () => {
+        if (process.platform === "win32" && processTree && child.pid !== undefined && !exited()) {
+            await new Promise((resolve, reject) => {
+                execFile("taskkill", ["/PID", String(child.pid), "/T", "/F"], { windowsHide: true, timeout: 5000 }, (error) => {
+                    if (error && !exited())
+                        reject(Object.assign(new Error("PROCESS_TREE_CLEANUP_INCOMPLETE"), {
+                            code: "PROCESS_TREE_CLEANUP_INCOMPLETE"
+                        }));
+                    else
+                        resolve();
+                });
+            });
+            if (!(await wait(Date.now() + killGraceMs)))
+                throw Object.assign(new Error("PROCESS_CLEANUP_TIMEOUT"), {
+                    code: "PROCESS_CLEANUP_TIMEOUT"
+                });
+            return;
+        }
         // 无 PID 的 spawn 失败没有可回收的 OS 进程；测试注入的子进程仍接收终止通知。
         if (!exists()) {
             if (!exited() && child.pid === undefined)

package/node_modules/@mininglamp-oss/octo-runtime-adapter-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-sdk",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": {
@@ -8,7 +8,7 @@
     "./process-cleanup": "./dist/process-cleanup.js"
   },
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.1"
+    "@mininglamp-oss/octo-runtime-protocol": "1.1.0"
   },
   "types": "./dist/index.d.ts",
   "files": [

package/node_modules/@mininglamp-oss/octo-runtime-adapter-zcode-gui/dist/app-server.js

@@ -479,9 +479,27 @@ export async function* runZcodeAppServerTurn({ request, spec, spawnFn = defaultS
         request.signal?.removeEventListener("abort", abort);
         if (abortTimer)
             clearTimeout(abortTimer);
+        await closeZcodeResources(client, spec);
+    }
+}
+async function closeZcodeResources(client, spec) {
+    const failures = [];
+    try {
         await client.close();
+    }
+    catch (error) {
+        failures.push(error);
+    }
+    try {
         await spec.cleanup?.();
     }
+    catch (error) {
+        failures.push(error);
+    }
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length)
+        throw new AggregateError(failures, "ZCode resource cleanup failed");
 }
 class ZcodeAppServerClient {
     #child;

package/node_modules/@mininglamp-oss/octo-runtime-adapter-zcode-gui/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-zcode-gui",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.1",
-    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.0.1"
+    "@mininglamp-oss/octo-runtime-protocol": "1.1.0",
+    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.1.0"
   },
   "types": "./dist/index.d.ts",
   "files": [

package/node_modules/@mininglamp-oss/octo-runtime-cli/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "commit": "1505ce132bb0ae98afc3229a6eac6a7507849883",
+  "commit": "d064cfe78f6818d3c451ecf803a280245f4b0496",
   "dirty": false,
-  "buildTime": "2026-10-19T08:39:57.478Z"
+  "buildTime": "2026-10-21T06:46:27.212Z"
 }

package/node_modules/@mininglamp-oss/octo-runtime-cli/dist/extras.d.ts

@@ -1,4 +1,4 @@
-import { type ExtraDescriptor, type StoredExtra } from "@mininglamp-oss/octo-runtime-daemon";
+import { type ExtraDescriptor, type StoredExtra } from "@mininglamp-oss/octo-runtime-host-sdk";
 import { type RuntimePaths } from "./state.js";
 /** Generic full replacement: no platform-specific CLI fields or validation. */
 export declare function setExtra(paths: RuntimePaths, name: string, input: NodeJS.ReadableStream): Promise<unknown>;

package/node_modules/@mininglamp-oss/octo-runtime-cli/dist/extras.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { assertExtraName, assertStoredExtra, readExtraDirectory } from "@mininglamp-oss/octo-runtime-daemon";
+import { assertExtraName, assertStoredExtra, readExtraDirectory } from "@mininglamp-oss/octo-runtime-host-sdk";
 import { withSetupLock, writeJsonAtomic } from "./state.js";
 /** Generic full replacement: no platform-specific CLI fields or validation. */
 export async function setExtra(paths, name, input) {
@@ -38,7 +38,12 @@ export async function readExtra(paths, name) {
     // Invalid stored declarations carry a controlled read error through their loader.
     if (!entry.module)
         await entry.load();
-    return { name, module: entry.module, config: entry.config };
+    return {
+        name,
+        module: entry.module,
+        config: entry.config,
+        ...(entry.enabled === undefined ? {} : { enabled: entry.enabled })
+    };
 }
 export async function getExtra(paths, name) {
     assertExtraName(name);

package/node_modules/@mininglamp-oss/octo-runtime-cli/dist/foreground.d.ts

@@ -0,0 +1,4 @@
+import type { ExtraService } from "@mininglamp-oss/octo-runtime-host-sdk";
+import type { KernelService } from "@mininglamp-oss/octo-runtime-executor-kernel";
+/** CLI 持有前台服务；所有终止路径只清理、诊断及完成一次，不退出调用进程。 */
+export declare function runForegroundService(handle: ExtraService | KernelService, ready: () => void, failed: (error: unknown) => Promise<void>): Promise<number>;

package/node_modules/@mininglamp-oss/octo-runtime-cli/dist/foreground.js

@@ -0,0 +1,57 @@
+/** CLI 持有前台服务；所有终止路径只清理、诊断及完成一次，不退出调用进程。 */
+export function runForegroundService(handle, ready, failed) {
+    return new Promise((resolve) => {
+        const initialization = new AbortController();
+        let terminal = false;
+        const detach = () => {
+            process.off("SIGINT", stop);
+            process.off("SIGTERM", stop);
+        };
+        const finish = async (reason, error, closed) => {
+            if (terminal)
+                return;
+            terminal = true;
+            detach();
+            initialization.abort();
+            let complete = false;
+            let failure = error;
+            try {
+                try {
+                    complete = (closed ?? (await handle.close())).complete;
+                }
+                catch (cause) {
+                    failure ??= new Error("SERVICE_CLEANUP_INCOMPLETE", { cause });
+                }
+                if (reason === "closed")
+                    failure = new Error("SERVICE_PROCESS_EXITED", { cause: error });
+                if (failure !== undefined)
+                    await failed(failure);
+            }
+            finally {
+                resolve(complete ? (reason === "signal" && failure === undefined ? 0 : 1) : 5);
+            }
+        };
+        // 两个 signal、initialize 与 closed 可以同时完成，finish 在首个 await 前取得终态。
+        const stop = () => void finish("signal").catch(() => { });
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+        const initialized = Promise.resolve().then(() => handle.initialize({ signal: initialization.signal }));
+        void initialized
+            .then(() => {
+            if (!terminal) {
+                try {
+                    ready();
+                }
+                catch (error) {
+                    return finish("initialization", error);
+                }
+            }
+        }, (error) => finish("initialization", error))
+            .catch(() => { });
+        void handle.closed
+            .then(
+        // 初始化失败由其原始错误诊断；成功初始化后即使立即 closed 也必须报告失败。
+        (result) => initialized.then(() => finish("closed", undefined, result), () => { }), (error) => finish("closed", error))
+            .catch(() => { });
+    });
+}

package/node_modules/@mininglamp-oss/octo-runtime-cli/dist/help.d.ts

@@ -1,16 +1,3 @@
 export declare const cliVersion: string;
 export declare const cliVersionInfo: string;
-interface Command {
-    description: string;
-    usage?: string;
-    details?: string;
-    flags?: Record<string, string>;
-    children?: Record<string, Command>;
-}
-export declare function commandAt(path: string[]): Command;
-export declare function helpText(path?: string[]): string;
-export declare function validateCommand(positionals: string[], flags: Record<string, string | boolean>): {
-    path: string[];
-    help: boolean;
-};
-export {};
+export declare function helpText(component?: string): string;

package/node_modules/@mininglamp-oss/octo-runtime-cli/dist/help.js

@@ -1,5 +1,4 @@
 import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
 // Read the public release package, rather than the private CLI workspace version.
 const releasePackage = JSON.parse(readFileSync(new URL("../../../package.json", import.meta.url), "utf8"));
 export const cliVersion = releasePackage.version;
@@ -22,155 +21,75 @@ const validBuildTime = typeof buildTime === "string" &&
         (buildTime.includes(".") ? buildTime : buildTime.replace("Z", ".000Z"));
 const cliBuildInfo = `build:${validBuildTime ? buildTime : "unknown"}`;
 export const cliVersionInfo = `${cliVersion}\n${cliCommitInfo}\n${cliBuildInfo}`;
-const commands = {
-    description: "Manage the local Agent runtime, provider adapters, and background service.\nBuilt-in adapters work by default; no adapter configuration is required.",
-    children: {
-        adapter: {
-            description: "Inspect provider adapters",
-            children: {
-                list: { description: "List available provider adapters" },
-                probe: { description: "Check whether a provider adapter is ready", usage: "<type>" }
-            }
-        },
-        daemon: {
-            description: "Manage the background runtime service",
-            children: {
-                start: {
-                    description: "Start the service in the background",
-                    details: "Installs a missing current-user service and waits for local IPC readiness."
-                },
-                stop: { description: "Stop the background service" },
-                restart: { description: "Restart the background service" },
-                status: { description: "Show native service and local daemon status" },
-                install: {
-                    description: "Install the current-user service",
-                    flags: {
-                        "--no-autostart": "Disable automatic start at login",
-                        "--logs-dir <path>": "Enable metadata logs in this explicit directory"
-                    }
-                },
-                uninstall: {
-                    description: "Stop and remove the current-user service",
-                    details: "Preserves Runtime Home, identity, credentials, and logs."
-                },
-                run: {
-                    description: "Run the daemon in the foreground",
-                    flags: {
-                        "--quiet": "Suppress terminal lifecycle output",
-                        "--logs-dir <path>": "Enable metadata logs in this explicit directory"
-                    }
-                }
-            }
-        },
-        doctor: {
-            description: "Check local configuration, service, and daemon health",
-            flags: { "--json": "Output diagnostic checks as JSON (default)" }
-        },
-        extraset: {
-            description: "Save a complete Extra plugin configuration from stdin",
-            usage: "<name> < config.json",
-            details: "Reads {module, enabled?, config}. Saves to <home>/extras/<name>/config.json, shared by all profiles.\nRestart the daemon to apply changes. Credentials are never echoed."
-        },
-        extraget: {
-            description: "Print a saved Extra plugin configuration as complete JSON",
-            usage: "<name>",
-            details: "Reads <home>/extras/<name>/config.json without loading the plugin; profile directories are ignored.\nPrints the configuration file path to stderr; stdout contains only JSON."
-        },
-        status: { description: "Show local runtime status" },
-        version: { description: "Print the installed CLI version" },
-        help: { description: "Help about any command", usage: "[command]" },
-        playboard: {
-            description: "Run a development request from stdin and stream events",
-            usage: "< request.json",
-            details: "Starts a temporary daemon using real providers. For development and integration debugging.\nUses built-in adapters by default; no adapter configuration is required.\nRequires an installed, authenticated provider. Outputs NDJSON; diagnostics go to stderr.\nDefaults: codex, current directory, approval ask, 120-second timeout.\nOverride execution settings with contexts.items. Pending interactions fail explicitly.",
-            flags: { "--manifest PATH": "Optional advanced override; not required for built-in adapters" }
-        }
-    }
+const componentDescriptions = {
+    "executor-kernel": `Local Agent execution service. Runs requests through Provider adapters and
+supervises the execution worker used by Gateway, WeCom, WebUI and SDK clients.
+Install and authenticate your chosen Provider before running Agent tasks.
+
+Get started: octo-runtime executor-kernel start
+Check readiness: octo-runtime executor-kernel status`,
+    "channel-gateway": `Connects Octo IM Bots to local Agent execution. Receives messages, invokes
+the Executor Kernel and sends Agent replies back to Octo IM.
+
+Configure Bots: octo-runtime extraset channel-gateway < gateway.json
+Start: octo-runtime channel-gateway start
+Agent tasks also need: octo-runtime executor-kernel start`,
+    "channel-wecom": `Connects WeCom Bots to local Agent execution. Receives WeCom messages,
+invokes the Executor Kernel and sends Agent replies back to WeCom.
+
+Configure Bots: octo-runtime extraset channel-wecom < wecom.json
+Start: octo-runtime channel-wecom start
+Agent tasks also need: octo-runtime executor-kernel start`,
+    webui: `Local browser workspace for Agent conversations and projects.
+Uses the Executor Kernel for Agent execution; default URL: http://127.0.0.1:13888/.
+
+Configure port and sessionStorePath: octo-runtime extraset webui < webui.json
+Start: octo-runtime webui start
+Agent tasks also need: octo-runtime executor-kernel start`
 };
-const globalFlags = {
-    "--home PATH": "Runtime Home directory",
-    "--profile NAME": "Runtime profile (default: default)",
-    "--verbose": "Write detailed diagnostics to stderr"
-};
-for (const command of Object.values(commands.children.daemon.children)) {
-    if (command !== commands.children.daemon.children.run) {
-        command.flags = { ...command.flags, "--json": "Output JSON without progress messages" };
-    }
-}
-export function commandAt(path) {
-    let command = commands;
-    for (const [index, name] of path.entries()) {
-        const next = command.children?.[name];
-        if (!next)
-            throw new Error(`unknown command '${name}' for '${["octo-runtime", ...path.slice(0, index)].join(" ")}'; run octo-runtime help`);
-        command = next;
-    }
-    return command;
-}
-function rows(entries) {
-    const width = Math.max(...Object.keys(entries).map((key) => key.length));
-    return Object.entries(entries)
-        .map(([key, description]) => `  ${key.padEnd(width + 2)}${description}`)
-        .join("\n");
-}
-export function helpText(path = []) {
-    const command = commandAt(path);
-    const invocation = ["octo-runtime", ...path].join(" ");
-    const sections = [
-        ...(path.length ? [] : [`Octo Runtime CLI (${cliVersion})\n${cliCommitInfo}\n${cliBuildInfo}`]),
-        command.description,
-        ...(command.details ? [command.details] : []),
-        `Usage:\n  ${invocation}${command.children ? " [command]" : command.usage ? ` ${command.usage}` : ""} [flags]`,
-        ...(command.children
-            ? [
-                `Available Commands:\n${rows(Object.fromEntries(Object.entries(command.children).map(([name, child]) => [name, child.description])))}`
-            ]
-            : []),
-        // --manifest 保留解析和执行支持，只在开发者文档说明，不展示在普通帮助中。
-        `Flags:\n${rows({ ...Object.fromEntries(Object.entries(command.flags ?? {}).filter(([flag]) => flag !== "--manifest PATH")), "-h, --help": `Help for ${invocation}`, ...(path.length ? {} : { "-v, --version": "Print the installed CLI version" }) })}`,
-        `Global Flags:\n${rows(globalFlags)}`,
-        ...(path[0] === "playboard"
-            ? [
-                `Examples:\n  # Run a minimal request with Codex (bash/zsh)\n  octo-runtime playboard <<'JSON'\n  {\n    "inputs": [{"type": "text", "text": "Reply OK"}],\n    "contexts": {"schema": "octo.context-envelope/v3", "items": []},\n    "protocol_mode": "canonical"\n  }\nJSON\n\n  # Run a saved request\n  octo-runtime playboard < request.json`,
-                `Input:\n  inputs          Required ModelInputPart[] (text or image)\n  contexts        Required Context v3 envelope; empty items are valid\n  protocol_mode   native (default) or canonical\n  providerSession Optional provider binding for continuation\n  continuityMode  fresh or continue (requires providerSession)\n  sessionId       Optional caller session identity\n  agentSource     provisioned or preset`,
-                `Reference:\n  ${fileURLToPath(new URL("../README.md", import.meta.url))}`
-            ]
-            : []),
-        ...(command.children
-            ? [`Use "${invocation} [command] --help" for more information about a command.`]
-            : [])
-    ];
-    return sections.join("\n\n");
-}
-export function validateCommand(positionals, flags) {
-    const help = flags.help === true || positionals[0] === "help";
-    const requested = positionals[0] === "help" ? positionals.slice(1) : positionals;
-    const path = requested.slice(0, ["adapter", "daemon"].includes(requested[0]) ? 2 : 1);
-    const command = commandAt(path);
-    if (!help && ["extraset", "extraget"].includes(path[0]) && flags.profile !== undefined) {
-        throw new Error("Extra configuration belongs to Runtime Home; --profile is not supported for extraset or extraget");
-    }
-    if (help && requested.length > path.length && command.children)
-        throw new Error("unexpected arguments for help");
-    const allowed = new Set([
-        "help",
-        "version",
-        "home",
-        "profile",
-        "verbose",
-        ...Object.keys(command.flags ?? {}).map((flag) => flag
-            .split(" ")[0]
-            .slice(2)
-            .replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()))
-    ]);
-    for (const key of Object.keys(flags)) {
-        if (!allowed.has(key) || (key === "version" && path.length))
-            throw new Error(`unknown option --${key}`);
-    }
-    if (!help && !command.children) {
-        const expected = ["extraset", "extraget"].includes(path[0]) || path.join(" ") === "adapter probe" ? 1 : 0;
-        if (requested.length !== path.length + expected)
-            throw new Error(`invalid arguments; run ${["octo-runtime", ...path, "--help"].join(" ")}`);
-    }
-    return { path, help: help || Boolean(command.children) };
+export function helpText(component) {
+    if (component)
+        return `Octo Runtime: ${component}
+
+${componentDescriptions[component] ?? `Configured Extra service "${component}". Runs its registered module independently.\nConfiguration: octo-runtime extraget ${component}`}
+
+Usage: octo-runtime ${component} <command> [flags]
+
+Commands:
+  install       Register and enable this service (autostart on by default)
+  uninstall     Remove this service, preserving configuration and data
+  start         Install if needed, then start this service and wait for readiness
+  restart       Restart this service and wait for local readiness
+  stop          Stop this service, preserving its autostart setting
+  status        Show native service, IPC and component status
+  run           Run this component in the foreground
+
+Flags: --home <path> --profile <name> --manifest <path> --json --help
+Install: --autostart=true|false
+Kernel and Extras have independent services and autostart settings.
+An Extra may start before Kernel and connect when Kernel becomes available.`;
+    return `Octo Runtime CLI (${cliVersion})
+${cliVersionInfo.split("\n").slice(1).join("\n")}
+Manage the local Agent runtime and independent services.
+
+Usage:
+octo-runtime executor-kernel uninstall|install|start|restart|stop|status|run
+octo-runtime <extra-name> uninstall|install|start|restart|stop|status|run
+octo-runtime status [--json]
+octo-runtime adapter list
+octo-runtime adapter probe <type>
+octo-runtime doctor
+octo-runtime extraset <name> < config.json
+octo-runtime extraget <name>
+octo-runtime playboard < request.json
+
+Flags: --home <path> --profile <name> --manifest <path> --json
+Install: --autostart=true|false (defaults to true)
+Extras: channel-gateway, channel-wecom, webui, or a name saved by extraset.
+Components:
+  executor-kernel  Local Agent execution and worker supervision
+  channel-gateway Octo IM Bot messaging and Agent replies
+  channel-wecom   WeCom Bot messaging and Agent replies
+  webui           Local browser workspace for Agent conversations
+Use octo-runtime <component> --help for component commands.`;
 }