@mininglamp-oss/octo-runtime 1.0.1 → 1.1.1

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

@@ -1,6 +1,7 @@
-/** 宿主可选的结构化日志；只接受执行元数据，磁盘写入隔离在有界 Worker。 */
+/** Optional metadata logging; bounded queues isolate filesystem writes in a dedicated worker. */
 import { isAbsolute } from "node:path";
 import { Worker } from "node:worker_threads";
+import { extraStatusRecord } from "./service-status.js";
 export const noopRuntimeLog = () => { };
 const strings = new Set([
     "run_id",
@@ -30,11 +31,15 @@ export function assertRuntimeLogging(options) {
     if (options !== undefined &&
         (!options || typeof options.directory !== "string" || !isAbsolute(options.directory)))
         throw new TypeError("LOG_DIRECTORY_MUST_BE_ABSOLUTE");
+    if (options?.statusOutput !== undefined && typeof options.statusOutput !== "function")
+        throw new TypeError("LOG_STATUS_OUTPUT_INVALID");
 }
 /** F31：.octospec/tasks/gateway-august-feature-assessment/assessment.md */
 export class RuntimeLogging {
     #worker;
     #pending = 0;
+    #statusPending = 0;
+    #statusOutput;
     #closed = false;
     #closing;
     #done;
@@ -42,27 +47,31 @@ export class RuntimeLogging {
         assertRuntimeLogging(options);
         if (!options)
             return;
+        this.#statusOutput = options.statusOutput;
         try {
             this.#worker = new Worker(new URL("./runtime-log-worker.js", import.meta.url), {
-                workerData: options
+                workerData: { directory: options.directory }
             });
         }
         catch {
-            this.#closed = true;
             return;
         }
         this.#worker.on("message", (message) => {
-            if (message === "written")
-                this.#pending = Math.max(0, this.#pending - 1);
+            if (typeof message === "object") {
+                if (message.written)
+                    this.#statusPending = Math.max(0, this.#statusPending - 1);
+                else
+                    this.#pending = Math.max(0, this.#pending - 1);
+            }
             if (message === "closed")
                 this.#done?.();
         });
         this.#worker.on("error", () => {
-            this.#closed = true;
+            this.#worker = undefined;
             this.#done?.();
         });
         this.#worker.on("exit", () => {
-            this.#closed = true;
+            this.#worker = undefined;
             this.#done?.();
         });
         this.#worker.unref();
@@ -74,13 +83,39 @@ export class RuntimeLogging {
         return (level, event, data) => this.#write("extra", name, level, event, data);
     }
     #write(source, extra, level, event, data) {
-        if (!this.#worker || this.#closed || this.#pending >= 128)
+        if (this.#closed)
+            return;
+        if (extra) {
+            try {
+                const status = extraStatusRecord(extra, level, event, data);
+                if (status) {
+                    // Sink and mirror fail independently; neither failure may affect service recovery.
+                    try {
+                        const result = this.#statusOutput?.(status);
+                        // TypeScript permits async functions in void sinks; observe rejection without waiting.
+                        if (result && typeof result.then === "function")
+                            void Promise.resolve(result).catch(() => undefined);
+                    }
+                    catch {
+                        /* A host sink failure must not suppress the independent file mirror. */
+                    }
+                    if (this.#worker && this.#statusPending < 128) {
+                        this.#worker.postMessage({ extra, status: true, line: `${JSON.stringify(status)}\n` });
+                        this.#statusPending++;
+                    }
+                }
+            }
+            catch {
+                /* Untrusted diagnostic getters must not escape into service execution. */
+            }
+        }
+        if (!this.#worker || this.#pending >= 128)
             return;
         try {
             if (!["info", "warn", "error"].includes(level) || !/^[a-z][a-z0-9_.-]{0,63}$/.test(event))
                 return;
             const safe = {};
-            // 不做任意对象脱敏或正文截断：白名单之外的字段直接不读取、不序列化。
+            // Ignore unknown fields entirely instead of serializing or truncating arbitrary bodies.
             for (const key of strings) {
                 const value = data?.[key];
                 if (typeof value === "string" &&
@@ -105,7 +140,7 @@ export class RuntimeLogging {
             this.#pending++;
         }
         catch {
-            /* 日志不能中断执行，包括恶意 getter 或已退出的 Worker。 */
+            /* Diagnostics cannot interrupt execution, including getter errors or an exited worker. */
         }
     }
     close() {

package/node_modules/@mininglamp-oss/octo-runtime-adapter-sdk/dist/service-status.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeLogLevel } from "./runtime-log.js";
+export interface ExtraStatusRecord {
+    time: string;
+    level: RuntimeLogLevel;
+    source: "extra";
+    extra_type: string;
+    event: string;
+    data: Record<string, string | number>;
+}
+/** Rebuild status records from a separate allowlist, including when reading persisted files. */
+export declare function extraStatusRecord(extra: string, level: RuntimeLogLevel, event: string, data?: Readonly<Record<string, unknown>>, time?: string): ExtraStatusRecord | undefined;

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

@@ -0,0 +1,70 @@
+const events = new Set([
+    "service.initializing",
+    "service.ready",
+    "service.closing",
+    "service.closed",
+    "service.failed",
+    "service.cleanup_incomplete",
+    "service.output_dropped",
+    "kernel.available",
+    "kernel.unavailable",
+    "channel.connecting",
+    "channel.connected",
+    "channel.disconnected",
+    "channel.connection_failed",
+    "channel.retry_started",
+    "channel.retry_scheduled",
+    "channel.stopped",
+    "channel.diagnostic"
+]);
+const states = new Set([
+    "created",
+    "initializing",
+    "ready",
+    "closing",
+    "closed",
+    "failed",
+    "connecting",
+    "online",
+    "retrying",
+    "stopped",
+    "available",
+    "unavailable"
+]);
+/** Rebuild status records from a separate allowlist, including when reading persisted files. */
+export function extraStatusRecord(extra, level, event, data, time = new Date().toISOString()) {
+    if (!/^[a-z][a-z0-9-]{0,63}$/.test(extra) ||
+        !["info", "warn", "error"].includes(level) ||
+        !events.has(event))
+        return;
+    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(time) ||
+        !Number.isFinite(Date.parse(time)))
+        return;
+    if (event === "channel.diagnostic" && data?.code !== "IM_DISPOSE_FAILED")
+        return;
+    const safe = {};
+    for (const key of ["state", "code", "endpoint_id"]) {
+        const value = data?.[key];
+        if (typeof value !== "string")
+            continue;
+        if (key === "state"
+            ? states.has(value)
+            : key === "endpoint_id"
+                ? /^[a-f0-9]{64}$/.test(value)
+                : /^[A-Z][A-Z0-9_]{0,95}$/.test(value))
+            safe[key] = value;
+    }
+    for (const key of ["attempt", "delay_ms", "dropped_count"]) {
+        const value = data?.[key];
+        if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0)
+            safe[key] = value;
+    }
+    return Object.freeze({
+        time,
+        level,
+        source: "extra",
+        extra_type: extra,
+        event,
+        data: Object.freeze(safe)
+    });
+}

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

@@ -1,14 +1,16 @@
 {
   "name": "@mininglamp-oss/octo-runtime-adapter-sdk",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "private": true,
   "type": "module",
   "exports": {
     ".": "./dist/index.js",
-    "./process-cleanup": "./dist/process-cleanup.js"
+    "./process-cleanup": "./dist/process-cleanup.js",
+    "./module-manifest": "./dist/module-manifest.js"
   },
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.1"
+    "@mininglamp-oss/octo-runtime-protocol": "1.1.1",
+    "import-meta-resolve": "4.2.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.1",
   "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.1",
+    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.1.1"
   },
   "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": "20c377136288a55356300bd3d4a755d0f19a23ee",
   "dirty": false,
-  "buildTime": "2026-10-19T08:39:57.478Z"
+  "buildTime": "2026-10-22T07:38:35.134Z"
 }

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

@@ -1,6 +1,8 @@
-import { type ExtraDescriptor, type StoredExtra } from "@mininglamp-oss/octo-runtime-daemon";
+import { type ExtraRegistration, type StoredExtra } from "@mininglamp-oss/octo-runtime-host-sdk";
 import { type RuntimePaths } from "./state.js";
+import { type ModuleManifest } from "@mininglamp-oss/octo-runtime-adapter-sdk/module-manifest";
 /** Generic full replacement: no platform-specific CLI fields or validation. */
 export declare function setExtra(paths: RuntimePaths, name: string, input: NodeJS.ReadableStream): Promise<unknown>;
-export declare function readExtra(paths: RuntimePaths, name: string): Promise<ExtraDescriptor>;
+/** CLI 将模块目录与业务配置装配；仅 load 时解析/import，禁用项及未启动项不执行模块。 */
+export declare function readExtra(paths: RuntimePaths, name: string, manifest: ModuleManifest): Promise<ExtraRegistration>;
 export declare function getExtra(paths: RuntimePaths, name: string): Promise<StoredExtra>;

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

@@ -1,6 +1,7 @@
 import { join } from "node:path";
-import { assertExtraName, assertStoredExtra, readExtraDirectory } from "@mininglamp-oss/octo-runtime-daemon";
+import { assertExtraName, assertStoredExtra, readStoredExtra } from "@mininglamp-oss/octo-runtime-host-sdk";
 import { withSetupLock, writeJsonAtomic } from "./state.js";
+import { resolveModuleSpecifier } from "@mininglamp-oss/octo-runtime-adapter-sdk/module-manifest";
 /** Generic full replacement: no platform-specific CLI fields or validation. */
 export async function setExtra(paths, name, input) {
     assertExtraName(name);
@@ -29,28 +30,31 @@ export async function setExtra(paths, name, input) {
         return { saved: true, name, file, reload_required: true };
     });
 }
-export async function readExtra(paths, name) {
+/** CLI 将模块目录与业务配置装配；仅 load 时解析/import，禁用项及未启动项不执行模块。 */
+export async function readExtra(paths, name, manifest) {
     assertExtraName(name);
-    const entries = await readExtraDirectory(join(paths.home, "extras"));
-    const entry = entries.find((item) => item.name === name);
+    const stored = await getExtra(paths, name);
+    const entry = manifest.extras.find((item) => item.name === name);
     if (!entry)
-        throw new Error("EXTRA_NOT_REGISTERED");
-    // 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 };
-}
-export async function getExtra(paths, name) {
-    assertExtraName(name);
-    const entries = await readExtraDirectory(join(paths.home, "extras"));
-    const entry = entries.find((item) => item.name === name);
-    if (!entry)
-        throw new Error("EXTRA_NOT_REGISTERED");
-    if (!entry.module)
-        await entry.load();
+        throw new Error("EXTRA_MANIFEST_DECLARATION_REQUIRED");
+    if (stored.module !== undefined && stored.module !== entry.module)
+        throw new Error("EXTRA_MODULE_MIGRATION_REQUIRED");
     return {
+        name,
         module: entry.module,
-        ...(entry.enabled === undefined ? {} : { enabled: entry.enabled }),
-        config: entry.config
+        config: stored.config,
+        enabled: stored.enabled,
+        load: () => import(resolveModuleSpecifier(entry.module, entry.sourceManifest))
     };
 }
+export async function getExtra(paths, name) {
+    assertExtraName(name);
+    try {
+        return await readStoredExtra(join(paths.home, "extras"), name);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            throw new Error("EXTRA_NOT_REGISTERED", { cause: error });
+        throw error;
+    }
+}

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;