@mininglamp-oss/octo-runtime 1.0.0 → 1.1.0

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

@@ -1,4 +1,4 @@
-import { type NativeInteractionResponse } from "@mininglamp-oss/octo-runtime-protocol";
+import { type StreamLimitPolicy, type NativeInteractionResponse } from "@mininglamp-oss/octo-runtime-protocol";
 import type { AdapterOutput } from "./index.js";
 /** Bounded queue for provider callbacks; overflow fails the owning invocation. */
 export declare class DriverQueue<T> implements AsyncIterable<T> {
@@ -7,6 +7,8 @@ export declare class DriverQueue<T> implements AsyncIterable<T> {
     constructor(options?: {
         discardOnFailure?: boolean;
         onFailure?: (error: Error) => void;
+        limits?: Pick<StreamLimitPolicy, "adapterQueueItemMaxBytes" | "adapterQueueMaxBytes" | "adapterQueueMaxItems">;
+        boundary?: string;
     });
     push(value: T): void;
     close(error?: Error): void;
@@ -18,6 +20,7 @@ export declare class DriverQueue<T> implements AsyncIterable<T> {
 export declare class NativeInteractionBridge {
     #private;
     readonly queue: DriverQueue<AdapterOutput>;
+    constructor(limits?: Readonly<StreamLimitPolicy>);
     bindTransport(close: () => Promise<void>): void;
     request(requestId: string | number, payload: Record<string, unknown>, write: (payload: unknown) => Promise<void>, validate: (payload: Record<string, unknown>) => void, automatic?: Record<string, unknown>): void;
     respond(response: NativeInteractionResponse): Promise<void>;

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

@@ -1,4 +1,4 @@
-import { protocolError } from "@mininglamp-oss/octo-runtime-protocol";
+import { DEFAULT_STREAM_LIMIT_POLICY, protocolError, streamCapacityError } from "@mininglamp-oss/octo-runtime-protocol";
 /** Bounded queue for provider callbacks; overflow fails the owning invocation. */
 export class DriverQueue {
     options;
@@ -14,8 +14,30 @@ export class DriverQueue {
         if (this.#closed)
             return;
         const bytes = Buffer.byteLength(JSON.stringify(value));
-        if (bytes > 256 * 1024 || this.#items.length >= 4096 || this.#bytes + bytes > 4 * 1024 * 1024) {
-            this.close(Object.assign(new Error("STREAM_BUFFER_OVERFLOW"), { code: "STREAM_BUFFER_OVERFLOW" }));
+        const limits = this.options.limits ?? DEFAULT_STREAM_LIMIT_POLICY;
+        const boundary = this.options.boundary ?? "adapter.output_queue";
+        if (bytes > limits.adapterQueueItemMaxBytes) {
+            this.close(streamCapacityError("STREAM_QUEUE_ITEM_TOO_LARGE", {
+                boundary,
+                measuredBytes: bytes,
+                limitBytes: limits.adapterQueueItemMaxBytes
+            }));
+            return;
+        }
+        if (this.#items.length >= limits.adapterQueueMaxItems) {
+            this.close(streamCapacityError("STREAM_QUEUE_ITEMS_EXCEEDED", {
+                boundary,
+                itemCount: this.#items.length + 1,
+                limitItems: limits.adapterQueueMaxItems
+            }));
+            return;
+        }
+        if (this.#bytes + bytes > limits.adapterQueueMaxBytes) {
+            this.close(streamCapacityError("STREAM_QUEUE_BYTES_EXCEEDED", {
+                boundary,
+                measuredBytes: this.#bytes + bytes,
+                limitBytes: limits.adapterQueueMaxBytes
+            }));
             return;
         }
         if (this.#waiter) {
@@ -75,14 +97,24 @@ export class DriverQueue {
 }
 /** Owns raw reverse requests, acknowledged replies, expiry and teardown for one turn. */
 export class NativeInteractionBridge {
-    queue = new DriverQueue();
+    queue;
     #pending = new Map();
     #closed = false;
     #closeTransport;
+    #transportClosed;
     #seen = new Set();
+    constructor(limits) {
+        this.queue = new DriverQueue({ limits, boundary: "adapter.native_queue" });
+    }
     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) ||
@@ -98,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 });
@@ -110,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) {
@@ -125,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))
@@ -173,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.0",
+  "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.0"
+    "@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.d.ts

@@ -53,7 +53,7 @@ export declare class ZcodeEventNormalizer {
     normalize(event: ZcodeSessionEvent): CanonicalEvent[];
 }
 export declare function normalizeZcodeEvent(event: ZcodeSessionEvent, state: NormalizerState): CanonicalEvent[];
-export declare function runZcodeAppServerTurn({ request, spec, spawnFn, approvalBridge }: {
+export declare function runZcodeAppServerTurn({ request, spec, spawnFn, context, approvalBridge }: {
     request: InvokeRequest;
     spec: ZcodeAppServerCommand;
     context?: AdapterInvocationContext;

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

@@ -1,6 +1,6 @@
 import { createProcessCleanup } from "@mininglamp-oss/octo-runtime-adapter-sdk/process-cleanup";
 import { DriverQueue, watchLineLimit, initialControlInstructions, hasImageInput, freshFallbackInputText, providerInputText } from "@mininglamp-oss/octo-runtime-adapter-sdk";
-import { canonicalTerminalStatus } from "@mininglamp-oss/octo-runtime-protocol";
+import { canonicalTerminalStatus, resolveStreamLimitPolicy } from "@mininglamp-oss/octo-runtime-protocol";
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 const REQUEST_TIMEOUT_MS = 30_000;
@@ -322,7 +322,7 @@ export function normalizeZcodeEvent(event, state) {
     }
     return events;
 }
-export async function* runZcodeAppServerTurn({ request, spec, spawnFn = defaultSpawn, approvalBridge }) {
+export async function* runZcodeAppServerTurn({ request, spec, spawnFn = defaultSpawn, context, approvalBridge }) {
     if (hasImageInput(request))
         throw new Error("UNSUPPORTED_INPUT_MODALITY: zcode-gui does not encode image input");
     if (request.approvalMode === "assisted" || (request.approvalMode === "ask" && !approvalBridge))
@@ -335,6 +335,7 @@ export async function* runZcodeAppServerTurn({ request, spec, spawnFn = defaultS
         spawnFn,
         requestTimeoutMs: requestTimeout(request),
         autoApprove,
+        streamLimits: context?.streamLimits,
         permissionHandler: approvalBridge
             ? async (params, write) => {
                 const permission = {
@@ -478,16 +479,33 @@ 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;
     #pending = new Map();
-    #events = new DriverQueue({
-        onFailure: (error) => this.#failAll(error)
-    });
+    #events;
+    #streamLimits;
     #requestTimeoutMs;
     #autoApprove;
     #permissionHandler;
@@ -503,7 +521,13 @@ class ZcodeAppServerClient {
     #closePromise;
     #failure;
     #removeLineGuard;
-    constructor({ spec, spawnFn, requestTimeoutMs, autoApprove, permissionHandler }) {
+    constructor({ spec, spawnFn, requestTimeoutMs, autoApprove, streamLimits, permissionHandler }) {
+        this.#streamLimits = resolveStreamLimitPolicy(streamLimits);
+        this.#events = new DriverQueue({
+            limits: this.#streamLimits,
+            boundary: "zcode.event_queue",
+            onFailure: (error) => this.#failAll(error)
+        });
         this.#requestTimeoutMs = requestTimeoutMs;
         this.#autoApprove = autoApprove;
         this.#permissionHandler = permissionHandler;
@@ -525,9 +549,10 @@ class ZcodeAppServerClient {
         for (const source of [this.#child.stdin, this.#child.stdout, this.#child.stderr]) {
             source.on("error", (error) => this.#failAll(error));
         }
-        // S04：ZCode 不支持图片输入，所有原生行按普通 256 KiB 上限控制。
+        // ZCode 不支持图片输入，所有原生行使用本 invocation 的 Provider 上限。
         // .octospec/tasks/pr1-yujiawei-review/assessment.md
-        this.#removeLineGuard = watchLineLimit(this.#child.stdout, 256 * 1024, (error) => {
+        this.#removeLineGuard = watchLineLimit(this.#child.stdout, this.#streamLimits.rawMessageMaxBytes, (error) => {
+            Object.assign(error, { boundary: "zcode.stdout" });
             this.#failAll(error);
             this.#child.stdout.destroy();
         });
@@ -768,9 +793,8 @@ function failureReason(error) {
     return "session_resume_failed";
 }
 function errorCode(error) {
-    if (error instanceof Error &&
-        ["STREAM_BUFFER_OVERFLOW", "STREAM_EVENT_TOO_LARGE"].includes(error.message))
-        return error.message;
+    if (error instanceof Error && "code" in error && typeof error.code === "string")
+        return error.code;
     if (error instanceof ZcodeAppServerRpcError)
         return error.code;
     if (error instanceof ZcodeAppServerProcessError)

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.0",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "exports": "./dist/index.js",
   "dependencies": {
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.0.0"
+    "@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,4 +1,5 @@
 {
-  "commit": "62d10ac46e7c2c3505b42c362229f7b91f328e5b",
-  "dirty": false
+  "commit": "d064cfe78f6818d3c451ecf803a280245f4b0496",
+  "dirty": false,
+  "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;