@mininglamp-oss/octo-runtime 1.1.0 → 1.1.2

package/apps/cli/dist/openclaw.js

@@ -1,7 +1,6 @@
 import { readFile, mkdir, writeFile, rename, lstat, chmod, rm } from "node:fs/promises";
 import { parseEnv, promisify } from "node:util";
 import { execFile } from "node:child_process";
-import { configuredCredential, validateImBots, octoCliEnvironment } from "@mininglamp-oss/octo-runtime-extra-channel-gateway";
 import { randomUUID } from "node:crypto";
 import { isIP } from "node:net";
 import { homedir, networkInterfaces } from "node:os";
@@ -103,15 +102,40 @@ export async function syncCliOpenClawToolEnvironment(runtimeRoot, extras) {
     if (!channel || channel.config.bots === undefined)
         return { written: false, restartRequired: false };
     const bots = channel.config.bots;
-    validateImBots(bots);
+    if (!Array.isArray(bots) || bots.length > 64)
+        throw new Error("IM_CONFIG_LIST_REQUIRED");
     let values;
-    for (const bot of bots) {
-        if (bot.enabled === false || bot.adapter.adapter_type !== "openclaw")
+    for (const value of bots) {
+        const bot = record(value);
+        if (!bot)
+            throw new Error("IM_CONFIG_INVALID");
+        if (bot.enabled === false || record(bot.adapter)?.adapter_type !== "openclaw")
             continue;
-        const token = configuredCredential(bot);
+        const token = typeof bot.bf_token === "string" ? bot.bf_token.trim() : undefined;
         if (!token)
             throw new Error("IM_CREDENTIALS_REQUIRED");
-        values = Object.fromEntries(octoCliEnvironment(bot.api_url, token).env_variables.map(({ key, value }) => [key, value]));
+        // CLI 仅校验自己要写入的工具身份；完整 Bot 配置由启动后的 Extra 校验。
+        // 不为 Kernel 的 dotenv 同步导入整个业务 Extra，否则未启动 Extra 缺包也会阻塞 Kernel。
+        if (!/^bf_[A-Za-z0-9_-]+$/.test(token))
+            throw new Error("IM_BOT_TOKEN_INVALID");
+        let url;
+        try {
+            if (typeof bot.api_url !== "string")
+                throw new Error();
+            url = new URL(bot.api_url);
+        }
+        catch {
+            throw new Error("IM_API_URL_INVALID");
+        }
+        if (url.username ||
+            url.password ||
+            url.search ||
+            url.hash ||
+            (url.protocol !== "https:" &&
+                !(url.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname))))
+            throw new Error("IM_API_URL_INVALID");
+        url.pathname = url.pathname.replace(/\/+$/, "").replace(/\/api$/, "");
+        values = { OCTO_BOT_TOKEN: token, OCTO_API_BASE_URL: url.href.replace(/\/+$/, "") };
     }
     if (!values)
         return { written: false, restartRequired: false };

package/apps/cli/dist/output.js

@@ -102,6 +102,9 @@ export function describeError(error, fallback = "COMMAND_FAILED") {
         SERVICE_NOT_INSTALLED: "Run this component's install command, then start it.",
         NOT_INSTALLED: "Run this component's install command, then start it.",
         EXTRA_NOT_REGISTERED: "Save this Extra's declaration with extraset before starting it.",
+        EXTRA_MANIFEST_DECLARATION_REQUIRED: "Add this Extra's name and module to the selected Home manifest.json (extras array), then retry.",
+        EXTRA_MODULE_MIGRATION_REQUIRED: "The saved module differs from manifest.json. Review both declarations, then save matching module text or omit module from the Extra configuration.",
+        MANIFEST_INVALID: "Check manifest.json: version must be 1 and adapters/extras must be valid arrays without duplicate keys.",
         MANAGER_UNAVAILABLE: "Run doctor and check the current user's native service manager.",
         COMPONENT_UNAVAILABLE: "Check component status and the service logs; the IPC or worker is not ready.",
         SERVICE_PROCESS_EXITED: "The service exited unexpectedly. Check its logs and configuration.",

package/apps/cli/dist/playboard.js

@@ -1,7 +1,7 @@
 import { defaultRuntimeHome, runtimePaths, readJsonFile } from "./state.js";
-import { initializeCliOpenClaw } from "./openclaw.js";
+import { loadCliManifest } from "./module-manifest.js";
+import { resolveAdapterModules } from "@mininglamp-oss/octo-runtime-adapter-sdk/module-manifest";
 import { readAdapterConfigurations, createKernelService } from "@mininglamp-oss/octo-runtime-executor-kernel";
-import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { componentEndpoint } from "@mininglamp-oss/octo-runtime-host-sdk";
 import { mkdtemp, rm } from "node:fs/promises";
@@ -67,15 +67,17 @@ export async function runPlayboard(options) {
     const temporary = await mkdtemp(join(tmpdir(), "octo-playboard-"));
     try {
         const paths = runtimePaths(home, profile);
-        await initializeCliOpenClaw(paths.profileRoot, options.env ?? process.env);
+        const manifest = await loadCliManifest(home, options.manifest);
         const configuration = await readJsonFile(paths.profileConfig);
         kernel = createKernelService({
             endpoint: process.platform === "win32" ? componentEndpoint(temporary) : join(temporary, "k.sock"),
-            workerEntrypoint: fileURLToPath(import.meta.resolve("@mininglamp-oss/octo-runtime-executor-kernel/runner")),
-            manifest: options.manifest
-                ? resolve(options.manifest)
-                : fileURLToPath(new URL("./default_adapters.json", import.meta.url)),
-            env: options.env ?? process.env,
+            workerEntrypoint: fileURLToPath(new URL("./worker.js", import.meta.url)),
+            adapterModules: resolveAdapterModules(manifest),
+            env: {
+                ...(options.env ?? process.env),
+                OCTO_RUNTIME_CLI_PROFILE_ROOT: paths.profileRoot,
+                OCTO_RUNTIME_CLI_SYNC_OPENCLAW_TOOLS: "0"
+            },
             adapterConfigurations: readAdapterConfigurations(paths.profileRoot, configuration?.adapters)
         });
         await kernel.initialize({ signal: controller.signal });

package/apps/cli/dist/status-output.d.ts

@@ -0,0 +1,10 @@
+import type { Writable } from "node:stream";
+import { type ExtraStatusRecord } from "@mininglamp-oss/octo-runtime-adapter-sdk";
+/** Bound stdout buffering without blocking Extras; report dropped records when the pipe drains. */
+export declare class StatusOutput {
+    #private;
+    private readonly output;
+    constructor(output: Writable);
+    readonly write: (record: ExtraStatusRecord) => void;
+    readonly close: () => void;
+}

package/apps/cli/dist/status-output.js

@@ -0,0 +1,65 @@
+import { extraStatusRecord } from "@mininglamp-oss/octo-runtime-adapter-sdk";
+/** Bound stdout buffering without blocking Extras; report dropped records when the pipe drains. */
+export class StatusOutput {
+    output;
+    #queue = [];
+    #bytes = 0;
+    #blocked = false;
+    #closed = false;
+    #dropped = 0;
+    #extra = "extra";
+    constructor(output) {
+        this.output = output;
+        output.on("error", this.close);
+    }
+    write = (record) => {
+        if (this.#closed)
+            return;
+        this.#extra = record.extra_type;
+        const line = `${JSON.stringify(record)}\n`;
+        if (this.#queue.length >= 128 || this.#bytes + Buffer.byteLength(line) > 1024 * 1024) {
+            this.#dropped = Math.min(Number.MAX_SAFE_INTEGER, this.#dropped + 1);
+            return;
+        }
+        this.#queue.push(line);
+        this.#bytes += Buffer.byteLength(line);
+        this.#flush();
+    };
+    #drain = () => {
+        this.#blocked = false;
+        this.#flush();
+    };
+    #flush() {
+        if (this.#closed || this.#blocked)
+            return;
+        while (this.#queue.length) {
+            const line = this.#queue.shift();
+            this.#bytes -= Buffer.byteLength(line);
+            try {
+                if (!this.output.write(line)) {
+                    this.#blocked = true;
+                    this.output.once("drain", this.#drain);
+                    return;
+                }
+            }
+            catch {
+                this.close();
+                return;
+            }
+        }
+        if (this.#dropped) {
+            const record = extraStatusRecord(this.#extra, "warn", "service.output_dropped", {
+                dropped_count: this.#dropped
+            });
+            this.#dropped = 0;
+            this.write(record);
+        }
+    }
+    close = () => {
+        this.#closed = true;
+        this.#queue = [];
+        this.#bytes = 0;
+        this.output.off("drain", this.#drain);
+        this.output.off("error", this.close);
+    };
+}

package/apps/cli/dist/worker.d.ts

@@ -0,0 +1 @@
+export {};

package/apps/cli/dist/worker.js

@@ -0,0 +1,18 @@
+// CLI 自有执行 worker。顶层 Kernel 仍由 CLI 调用进程创建；SDK 原生入口不使用此装配。
+import { loadManifestAdapters } from "@mininglamp-oss/octo-runtime-executor-kernel/manifest-adapters";
+import { serveWorker } from "@mininglamp-oss/octo-runtime-executor-kernel";
+import { readExtraDirectory } from "@mininglamp-oss/octo-runtime-host-sdk";
+import { dirname, join } from "node:path";
+const adapters = await loadManifestAdapters();
+// 旧显式清单允许省略 type；以所选实例真实类型判断，不猜包名，也不在父进程重复实例化。
+if (adapters.some((adapter) => adapter.metadata.type === "openclaw")) {
+    const profileRoot = process.env.OCTO_RUNTIME_CLI_PROFILE_ROOT;
+    if (!profileRoot)
+        throw new Error("CLI_PROFILE_ROOT_REQUIRED");
+    const { initializeCliOpenClaw, syncCliOpenClawToolEnvironment } = await import("./openclaw.js");
+    await initializeCliOpenClaw(profileRoot);
+    if (process.env.OCTO_RUNTIME_CLI_SYNC_OPENCLAW_TOOLS === "1")
+        await syncCliOpenClawToolEnvironment(profileRoot, await readExtraDirectory(join(dirname(profileRoot), "extras")));
+}
+// 产品连接准备完成后才建立既有 list/probe 握手；所有实例仅交给唯一 Core 注册一次。
+serveWorker(adapters);

package/dist/public/host.d.ts

@@ -2,5 +2,6 @@ export { createExtraService, ComponentStartError, componentEndpoint, componentSe
 export type { ExtraService, ExtraServiceOptions, ExtraServiceStatus, CleanupResult } from "@mininglamp-oss/octo-runtime-host-sdk";
 export { startNativeComponent } from "@mininglamp-oss/octo-runtime-host-sdk";
 export type { NativeComponentOptions } from "@mininglamp-oss/octo-runtime-host-sdk";
+export type { RuntimeLoggingOptions, ExtraStatusRecord } from "@mininglamp-oss/octo-runtime-host-sdk";
 export { createKernelService, ServiceInitializationError } from "./executor-kernel.js";
 export type { KernelService, KernelServiceOptions, KernelServiceStatus, ServiceCleanupResult, ServiceLifecycle, ServicePhase } from "./executor-kernel.js";

package/node_modules/@mininglamp-oss/octo-runtime-acp-client/package.json

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-antigravity",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
@@ -10,7 +10,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.1.0",
-    "@mininglamp-oss/octo-runtime-protocol": "1.1.0"
+    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.1.2",
+    "@mininglamp-oss/octo-runtime-protocol": "1.1.2"
   }
 }

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

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

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

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

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

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

package/node_modules/@mininglamp-oss/octo-runtime-adapter-grok-build/dist/adapter.d.ts

@@ -0,0 +1,54 @@
+import { spawnGrokBuildAcpClient as spawnAcpClient, type SpawnGrokBuildClientOptions as SpawnAcpClientOptions } from "./client.js";
+import { GrokBuildInteractionBridge as AcpApprovalBridge } from "./interactions.js";
+import { acpActmodeSelectionRequest } from "@mininglamp-oss/octo-runtime-adapter-acp";
+import { type AcpClient, type AcpUpdate } from "@mininglamp-oss/octo-runtime-acp-client";
+import { type ProbeResult, type ReasoningLevelMap, type AdapterInvocationContext, type CanonicalEvent, type InvokeRequest } from "@mininglamp-oss/octo-runtime-adapter-sdk";
+import { type InteractionResponse } from "@mininglamp-oss/octo-runtime-protocol";
+type JsonRecord = Record<string, unknown>;
+export interface AcpAdapterDefinition {
+    type: string;
+    provider: string;
+    command: string;
+    args?: readonly string[] | ((request: InvokeRequest) => readonly string[]);
+    env?: (request: InvokeRequest) => NodeJS.ProcessEnv;
+    protocolVersion?: string | number;
+    emptyLoadResultMeansMissing?: boolean;
+    probe?: () => Promise<ProbeResult>;
+    /** Grok Build 专用的握手、会话配置与交互策略，只在本包消费。 */
+    initialize?: (client: AcpClient, initialization: JsonRecord, request: InvokeRequest, env: NodeJS.ProcessEnv) => Promise<void>;
+    sessionParams?: (params: JsonRecord, request: InvokeRequest, fresh: boolean) => JsonRecord;
+    isMissingSessionError?: (error: unknown) => boolean;
+    configureSession?: (client: AcpClient, session: JsonRecord, sessionId: string, request: InvokeRequest) => AsyncIterable<CanonicalEvent>;
+    selectActmode?: typeof acpActmodeSelectionRequest;
+    controlInstructions?: "session";
+    reasoningLevels?: ReasoningLevelMap;
+    clientOptions?: (request: InvokeRequest, bridge: AcpApprovalBridge) => Pick<SpawnAcpClientOptions, "requestHandler" | "onRequestResponseWritten" | "onRequestResponseFailed">;
+    validatePromptResult?: (update: StandardAcpUpdate) => CanonicalEvent[];
+}
+export interface StandardAcpUpdate extends AcpUpdate {
+    sessionUpdate?: string;
+    content?: unknown;
+    text?: string;
+    toolCallId?: string;
+    name?: string;
+    title?: string;
+    rawInput?: unknown;
+    input?: unknown;
+    rawOutput?: unknown;
+    output?: unknown;
+    status?: string;
+}
+export declare function createGrokBuildAcpAdapter(definition: AcpAdapterDefinition, { acpClientFactory, command }?: {
+    acpClientFactory?: typeof spawnAcpClient;
+    command?: string;
+}): Readonly<{
+    metadata: {
+        mcp: true;
+        type: string;
+        agentSources: "provisioned"[];
+    };
+    probe: () => Promise<ProbeResult>;
+    respondInteraction(invocationId: string, response: InteractionResponse): Promise<void>;
+    invoke(request: InvokeRequest, context?: AdapterInvocationContext): AsyncGenerator<CanonicalEvent>;
+}>;
+export {};