@mininglamp-oss/octo-runtime 1.0.0 → 1.1.0

package/node_modules/@mininglamp-oss/octo-runtime-daemon/dist/runtime/supervisor.js

@@ -1,245 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { delimiter, dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { DaemonRuntimeError } from "./errors.js";
-import { removeFile, writeJsonAtomic } from "./home.js";
-import { callDaemon, probeDaemon } from "./runtime-contract.js";
-const closedChildren = new WeakSet();
-export async function startManagedDaemon(options) {
-    const nodePath = resolveNode(options.sdk);
-    const runnerPath = options.sdk.distribution?.runnerPath ?? fileURLToPath(new URL("./runner.js", import.meta.url));
-    if (!existsSync(runnerPath)) {
-        throw new DaemonRuntimeError("DISTRIBUTION_MISSING", "distribution", false, `embedded runner is missing: ${runnerPath}`);
-    }
-    removeFile(options.paths.shutdownFile);
-    const session = {
-        schema_version: 1,
-        nonce: options.nonce,
-        parent_pid: process.pid,
-        home: options.paths.home,
-        account_root: options.account.root,
-        profiles: [...options.profiles],
-        subject: options.subject,
-        modules: options.sdk.modules ?? [],
-        extras: options.sdk.extras ?? [],
-        socket_path: options.paths.socket,
-        pid_path: options.paths.pidFile,
-        ...(options.sdk.logging ? { log_directory: options.sdk.logging.directory } : {}),
-        shutdown_file: options.paths.shutdownFile,
-        supervisor_state: options.paths.supervisorState,
-        ...(options.sdk.distribution?.manifestPath
-            ? { manifest_path: options.sdk.distribution.manifestPath }
-            : {}),
-        ...(options.sdk.distribution?.adapterHostEntrypoint
-            ? { adapter_host_entrypoint: options.sdk.distribution.adapterHostEntrypoint }
-            : {})
-    };
-    writeJsonAtomic(options.paths.sessionFile, session, true);
-    const child = spawn(nodePath, [runnerPath, "--session", options.paths.sessionFile], {
-        argv0: "octo-runtime-daemon",
-        cwd: dirname(runnerPath),
-        detached: false,
-        shell: false,
-        windowsHide: true,
-        stdio: ["ignore", "ignore", "inherit"],
-        env: childEnvironment(options.paths)
-    });
-    child.once("close", () => {
-        closedChildren.add(child);
-    });
-    const supervised = { child, nonce: options.nonce, paths: options.paths };
-    const startupTimeout = options.sdk.startupTimeoutMs ?? 30_000;
-    const deadline = Date.now() + startupTimeout;
-    for (;;) {
-        if (child.exitCode !== null || child.signalCode !== null) {
-            throw new DaemonRuntimeError("DAEMON_EXITED", "daemon", true, `embedded runner exited before readiness (code=${child.exitCode ?? "none"}, signal=${child.signalCode ?? "none"})`);
-        }
-        const status = await probeDaemon(options.paths.socket);
-        if (status?.ready)
-            return { supervised, status };
-        if (Date.now() >= deadline) {
-            await stopManagedDaemon(supervised).catch(() => undefined);
-            throw new DaemonRuntimeError("DAEMON_START_TIMEOUT", "daemon", true, `embedded runtime was not ready within ${startupTimeout}ms`);
-        }
-        await delay(250);
-    }
-}
-export async function stopManagedDaemon(supervised) {
-    let cleanupFailed = false;
-    try {
-        await callDaemon(supervised.paths.socket, { method: "lifecycle.drain", params: { timeoutMs: 5_000 } }, 7_000);
-    }
-    catch (error) {
-        cleanupFailed = error instanceof Error && error.message === "EXTRA_DISPOSE_FAILED";
-        // Shutdown must continue even if cleanup fails or the endpoint is unavailable.
-    }
-    writeJsonAtomic(supervised.paths.shutdownFile, {
-        nonce: supervised.nonce,
-        requested_at: new Date().toISOString()
-    });
-    if (await waitForExit(supervised.child, 5_000)) {
-        cleanup(supervised.paths);
-        if (cleanupFailed)
-            throw new DaemonRuntimeError("EXTRA_DISPOSE_FAILED", "shutdown", false, "Extra cleanup failed before process exit");
-        return;
-    }
-    await terminateOwnedChild(supervised.child);
-    if (!(await waitForExit(supervised.child, 5_000))) {
-        throw new DaemonRuntimeError("SHUTDOWN_INCOMPLETE", "shutdown", false, "embedded runtime process tree did not exit");
-    }
-    if (await probeDaemon(supervised.paths.socket, 500)) {
-        throw new DaemonRuntimeError("SHUTDOWN_INCOMPLETE", "shutdown", false, "embedded daemon IPC is still reachable after shutdown");
-    }
-    cleanup(supervised.paths);
-    if (cleanupFailed)
-        throw new DaemonRuntimeError("EXTRA_DISPOSE_FAILED", "shutdown", false, "Extra cleanup failed before process exit");
-}
-export async function runtimeStatus(supervised) {
-    if (supervised.child.exitCode !== null || supervised.child.signalCode !== null)
-        return undefined;
-    return probeDaemon(supervised.paths.socket);
-}
-function resolveNode(options) {
-    const explicit = options.distribution?.nodePath;
-    if (explicit)
-        return assertNode24(explicit);
-    const resourcesPath = process.resourcesPath;
-    if (resourcesPath) {
-        const executable = process.platform === "win32" ? "node.exe" : "node";
-        for (const candidate of [
-            join(resourcesPath, "runtime", "node", "bin", executable),
-            join(resourcesPath, "embedded-runtime", "node", "bin", executable)
-        ]) {
-            if (existsSync(candidate))
-                return assertNode24(candidate);
-        }
-        if (!options.development) {
-            throw new DaemonRuntimeError("NODE_RUNTIME_MISSING", "distribution", false, "packaged embedded runtime is missing its pinned Node.js 24 executable");
-        }
-    }
-    if (!process.versions.electron && Number(process.versions.node.split(".")[0]) >= 24)
-        return process.execPath;
-    if (options.development) {
-        const pathNode = findOnPath(process.platform === "win32" ? "node.exe" : "node");
-        if (pathNode)
-            return assertNode24(pathNode);
-    }
-    throw new DaemonRuntimeError("NODE_RUNTIME_MISSING", "distribution", false, "Embedded Runtime requires a pinned Node.js 24 runtime");
-}
-function assertNode24(path) {
-    if (!existsSync(path))
-        throw new DaemonRuntimeError("NODE_RUNTIME_MISSING", "distribution", false, `Node executable is missing: ${path}`);
-    const result = spawnSync(path, ["--version"], {
-        encoding: "utf8",
-        windowsHide: true,
-        shell: false
-    });
-    const version = String(result.stdout || result.stderr).trim();
-    if (result.status !== 0 || Number(/^v?(\d+)/.exec(version)?.[1] ?? 0) < 24) {
-        throw new DaemonRuntimeError("NODE_RUNTIME_INVALID", "distribution", false, `Embedded Runtime requires Node.js 24+: ${path} (${version || "unavailable"})`);
-    }
-    return path;
-}
-function findOnPath(executable) {
-    for (const directory of (process.env.PATH ?? "").split(delimiter)) {
-        const candidate = directory ? join(directory, executable) : undefined;
-        if (candidate && existsSync(candidate))
-            return candidate;
-    }
-    return undefined;
-}
-export function childEnvironment(paths) {
-    const env = {
-        PATH: process.env.PATH ?? "",
-        HOME: process.env.HOME ?? process.env.USERPROFILE ?? "",
-        LANG: process.env.LANG ?? "en_US.UTF-8",
-        OCTO_RUNTIME_HOME: paths.home,
-        ...(process.env.OCTO_RUNTIME_DEBUG === "1" ? { OCTO_RUNTIME_DEBUG: "1" } : {})
-    };
-    // Preserve the host's explicit network routing, including loopback bypasses.
-    // Do not inherit arbitrary application credentials into the runtime process.
-    for (const key of [
-        "HTTP_PROXY",
-        "HTTPS_PROXY",
-        "ALL_PROXY",
-        "NO_PROXY",
-        "http_proxy",
-        "https_proxy",
-        "all_proxy",
-        "no_proxy"
-    ]) {
-        if (process.env[key] !== undefined)
-            env[key] = process.env[key];
-    }
-    if (process.platform === "win32") {
-        for (const key of [
-            "SystemRoot",
-            "SystemDrive",
-            "COMSPEC",
-            "PATHEXT",
-            "TEMP",
-            "TMP",
-            "USERPROFILE",
-            "APPDATA",
-            "LOCALAPPDATA",
-            "NUMBER_OF_PROCESSORS",
-            "PROCESSOR_ARCHITECTURE"
-        ]) {
-            const value = environmentValue(key);
-            if (value)
-                env[key] = value;
-        }
-    }
-    return env;
-}
-function environmentValue(name) {
-    const key = Object.keys(process.env).find((candidate) => candidate.toLowerCase() === name.toLowerCase());
-    return key ? process.env[key] : undefined;
-}
-async function terminateOwnedChild(child) {
-    if (!child.pid || child.exitCode !== null || child.signalCode !== null)
-        return;
-    if (process.platform === "win32") {
-        await new Promise((resolve, reject) => {
-            const killer = spawn("taskkill", ["/PID", String(child.pid), "/T", "/F"], {
-                windowsHide: true,
-                shell: false,
-                stdio: "ignore"
-            });
-            killer.once("error", reject);
-            killer.once("exit", (code) => code === 0 || code === 128 ? resolve() : reject(new Error(`taskkill exited with ${code}`)));
-        });
-    }
-    else {
-        child.kill("SIGTERM");
-        if (!(await waitForExit(child, 2_000)))
-            child.kill("SIGKILL");
-    }
-}
-function waitForExit(child, timeoutMs) {
-    if (closedChildren.has(child))
-        return Promise.resolve(true);
-    return new Promise((resolve) => {
-        const timer = setTimeout(() => {
-            cleanupListener();
-            resolve(false);
-        }, timeoutMs);
-        const onExit = () => {
-            clearTimeout(timer);
-            cleanupListener();
-            resolve(true);
-        };
-        const cleanupListener = () => {
-            child.off("close", onExit);
-        };
-        child.once("close", onExit);
-    });
-}
-function cleanup(paths) {
-    for (const path of [paths.shutdownFile, paths.sessionFile, paths.supervisorState])
-        removeFile(path);
-}
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/node_modules/@mininglamp-oss/octo-runtime-daemon/dist/runtime/types.d.ts

@@ -1,116 +0,0 @@
-import type { InputInvoke, InputFrames, NativeInteractionResponse, InteractionResponse } from "@mininglamp-oss/octo-runtime-protocol";
-import type { HostedAdapterMetadata } from "@mininglamp-oss/octo-runtime-adapter-host";
-import type { ExtraDescriptor } from "../extra-config.js";
-import type { ExtraPluginModule, ExtraStatus, JsonObject } from "../extras.js";
-import type { RuntimeLoggingOptions } from "@mininglamp-oss/octo-runtime-adapter-sdk";
-export type { RuntimeLoggingOptions } from "@mininglamp-oss/octo-runtime-adapter-sdk";
-export interface DaemonModuleDescriptor {
-    id: string;
-    module: string;
-    exportName: string;
-}
-export type DaemonPhase = "idle" | "preparing-home" | "enrolling" | "starting" | "running" | "degraded" | "stopping" | "stopped" | "error";
-export interface DaemonDistribution {
-    nodePath?: string;
-    runnerPath?: string;
-    /** 显式 JSON 覆盖的兼容入口；SDK 默认不读取清单，也不读取 CLI 的默认资源。 */
-    manifestPath?: string;
-    /** 宿主选择的独立 Host JS 入口：在该子进程中直接 import 并注册 Adapter，不能在 main 中执行。 */
-    adapterHostEntrypoint?: string;
-}
-export interface DaemonRuntimeOptions {
-    logging?: RuntimeLoggingOptions;
-    appId: string;
-    home: string;
-    distribution?: DaemonDistribution;
-    development?: boolean;
-    modules?: readonly DaemonModuleDescriptor[];
-    extras?: readonly ExtraDescriptor[];
-    startupTimeoutMs?: number;
-    healthPollIntervalMs?: number;
-    platform?: NodeJS.Platform;
-}
-export interface AccountSubject {
-    type: "user";
-    id: string;
-}
-export interface AuthorizedTenant {
-    id: string;
-    name?: string;
-}
-export interface StartAccountOptions {
-    subject: AccountSubject;
-    tenants: readonly AuthorizedTenant[];
-}
-export interface ProfileHealth {
-    tenantId: string;
-    profile: string;
-    runtimeId?: string;
-    state: "pending" | "ready" | "offline";
-    reasonCode?: string;
-    observedAt: number;
-}
-export interface DaemonProblem {
-    code: string;
-    scope: "distribution" | "home" | "enrollment" | "daemon" | "profile" | "shutdown";
-    retryable: boolean;
-    profile?: string;
-    message: string;
-}
-export interface DaemonHealth {
-    phase: DaemonPhase;
-    generation: number;
-    accountKey?: string;
-    machineId?: string;
-    home: string;
-    local: {
-        ready: boolean;
-        pid?: number;
-        adapterHostReady: boolean;
-        socketReachable: boolean;
-    };
-    modules: Record<string, unknown>;
-    extras?: Record<string, ExtraStatus>;
-    profiles: readonly ProfileHealth[];
-    problem?: DaemonProblem;
-    observedAt: number;
-}
-export interface DaemonRuntime {
-    /** 加载可序列化声明；适用于 JSON 配置，由 daemon runner 装配插件。 */
-    loadExtra(descriptor: ExtraDescriptor): Promise<Record<string, ExtraStatus>>;
-    /**
-     * 在宿主 Node 进程加载完整 Extra，可注入 loadContexts 等业务函数。
-     * 适用于 Buddy/自研 CLI 从内存、数据库或 HTTP 动态读取每轮 Context；
-     * 更新函数读取的数据无需重载插件，替换函数引用或 JSON 配置则先 unload 再 load。
-     * dependencies 不进入 JSON/IPC；SDK 提供执行端口，复用原 daemon 与独立 AdapterHost，
-     * 并负责状态、取消及卸载/退出清理。宿主不创建插件内部对象。
-     * .octospec/tasks/sdk-host-extra-contexts/brief.md
-     */
-    loadExtra<D extends object>(module: ExtraPluginModule<D>, config: JsonObject, dependencies: Readonly<D>): Promise<Record<string, ExtraStatus>>;
-    /** 停止整个 Extra 并等待清理；清理失败不得继续加载同名实例。 */
-    unloadExtra(name: string): Promise<Record<string, ExtraStatus>>;
-    extraStatus(): Promise<Record<string, ExtraStatus>>;
-    extraStatus(name: string): Promise<JsonObject>;
-    startModule(id: string, config: unknown): Promise<unknown>;
-    stopModule(id: string): Promise<void>;
-    requestModule<T = unknown>(id: string, method: string, params?: Record<string, unknown>): Promise<T>;
-    invoke: InputInvoke;
-    invokeFrames: InputFrames;
-    listAdapters(runtimeId?: string): Promise<HostedAdapterMetadata[]>;
-    cancelRun(runId: string): Promise<{
-        cancelled: boolean;
-    }>;
-    respondRun(runId: string, response: InteractionResponse): Promise<void>;
-    respondNativeRun(runId: string, response: NativeInteractionResponse): Promise<void>;
-    subscribeRun(input: {
-        runId: string;
-        streamId?: string;
-        afterSeq?: number;
-        signal?: AbortSignal;
-    }): AsyncIterable<Record<string, unknown>>;
-    startAccount(options: StartAccountOptions): Promise<DaemonHealth>;
-    reconcileTenants(tenants: readonly AuthorizedTenant[]): Promise<DaemonHealth>;
-    stop(reason?: "logout" | "account-switch" | "quit" | "reconfigure"): Promise<void>;
-    health(): DaemonHealth;
-    onHealth(listener: (health: DaemonHealth) => void): () => void;
-}

package/node_modules/@mininglamp-oss/octo-runtime-daemon/dist/runtime/version.d.ts

@@ -1 +0,0 @@
-export declare const DAEMON_RUNTIME_VERSION = "1.0.0";

package/node_modules/@mininglamp-oss/octo-runtime-daemon/dist/runtime/version.js

@@ -1 +0,0 @@
-export const DAEMON_RUNTIME_VERSION = "1.0.0";

package/node_modules/@mininglamp-oss/octo-runtime-daemon/dist/runtime-endpoint.d.ts

@@ -1,2 +0,0 @@
-/** Resolve the resident Runtime control endpoint for an already-normalized Home. */
-export declare function runtimeControlEndpoint(home: string, platform?: NodeJS.Platform): string;

package/node_modules/@mininglamp-oss/octo-runtime-daemon/dist/runtime-endpoint.js

@@ -1,9 +0,0 @@
-import { createHash } from "node:crypto";
-import { join } from "node:path";
-/** Resolve the resident Runtime control endpoint for an already-normalized Home. */
-export function runtimeControlEndpoint(home, platform = process.platform) {
-    if (platform !== "win32")
-        return join(home, "sockets", "octo-runtime-daemon.sock");
-    const homeId = createHash("sha256").update(home.toLowerCase()).digest("hex").slice(0, 16);
-    return `\\\\.\\pipe\\octo-runtime-${homeId}`;
-}

package/node_modules/@mininglamp-oss/octo-runtime-daemon/dist/server.d.ts

@@ -1,67 +0,0 @@
-import { type AdapterHostProcess } from "@mininglamp-oss/octo-runtime-adapter-host";
-import { DaemonModules, type DaemonModuleRegistration, type DaemonModuleContext } from "./modules.js";
-import type { AdapterProbeOptions } from "@mininglamp-oss/octo-runtime-adapter-sdk";
-import { type Server } from "node:net";
-import { type RuntimeLoggingOptions } from "@mininglamp-oss/octo-runtime-adapter-sdk";
-import { HostRunService } from "@mininglamp-oss/octo-runtime-adapter-host";
-import { ExtraPlugins, type ExtraRegistration } from "./extras.js";
-export interface StartDaemonServerOptions {
-    logging?: RuntimeLoggingOptions;
-    extras?: readonly ExtraRegistration[];
-    modules?: DaemonModuleRegistration[];
-    account?: DaemonModuleContext["account"];
-    localRuntimes?: Array<{
-        profile: string;
-        runtimeId?: string;
-        root: string;
-        adapterConfigurations?: Record<string, AdapterProbeOptions>;
-    }>;
-    homePath?: string;
-    pidPath?: string;
-    /** Process-owned state, separate from persistent Home/profile configuration. */
-    stateDirectory?: string;
-    /** Enables foreground lifecycle messages when launched in the foreground. */
-    consoleOutput?: boolean;
-    socketPath: string;
-    manifestPath?: string;
-    hostEntrypoint: string;
-    /** Test/embedding override for the capped adapter-host restart schedule. */
-    adapterHostRestartDelaysMs?: readonly number[];
-    /** Maximum adapter-host RPC readiness handshake time. */
-    adapterHostReadyTimeoutMs?: number;
-}
-/** Non-secret process metadata returned by `status` and suitable for support output. */
-export interface DaemonRuntimeInfo {
-    homePath?: string;
-    pidPath?: string;
-    socketPath: string;
-    manifestPath?: string;
-    adapterHost: {
-        pid: number | null;
-        entrypoint: string;
-        state: "ready" | "restarting";
-        restartAttempt: number;
-    };
-    adapters: string[];
-}
-/** Everything the daemon owns for one process lifetime; `close()` tears the whole
- * stack down in the reverse order it was brought up and removes the socket file. */
-export interface DaemonApplication {
-    server: Server;
-    host: HostRunService;
-    hostProcess: AdapterHostProcess;
-    runtime: DaemonRuntimeInfo;
-    modules: DaemonModules;
-    extras: ExtraPlugins;
-    close(): Promise<void>;
-}
-/**
- * Bring up the daemon: spawn the adapter-host child,
- * construct the execution service, register optional modules, and listen on
- * the Unix control socket. Partial-startup failures unwind in reverse. Each socket
- * connection carries exactly one request line (see `handleRequestLine`).
- */
-export declare function startDaemonServer({ homePath, modules: registrations, extras: extraRegistrations, account, localRuntimes, pidPath, stateDirectory, socketPath, manifestPath, hostEntrypoint, logging, consoleOutput, adapterHostRestartDelaysMs, adapterHostReadyTimeoutMs }: StartDaemonServerOptions): Promise<DaemonApplication>;
-/** Capped staircase for repeated adapter-host crashes. The last delay repeats
- * indefinitely so a local crash loop never exhausts the service-manager burst. */
-export declare function adapterHostRestartDelayMs(attempt: number, delays?: readonly number[]): number;