@mininglamp-oss/octo-runtime 1.0.0 → 1.1.0

package/node_modules/@mininglamp-oss/octo-runtime-adapter-host/dist/socket-server.js

@@ -1,255 +0,0 @@
-import { chmod, lstat, mkdir, rm } from "node:fs/promises";
-import { dirname } from "node:path";
-import net from "node:net";
-import { randomUUID } from "node:crypto";
-import { spawnAdapterHost } from "./process.js";
-import { HostRunService } from "./host-run-service.js";
-import { createInputInvoke, contextItem } from "@mininglamp-oss/octo-runtime-protocol";
-import { readBoundedLines } from "@mininglamp-oss/octo-runtime-adapter-sdk";
-import { INVOKE_REQUEST_MAX_BYTES } from "@mininglamp-oss/octo-runtime-protocol";
-export async function startHostSocketServer(options) {
-    if (process.platform !== "win32") {
-        await mkdir(dirname(options.socketPath), { recursive: true });
-        try {
-            const stat = await lstat(options.socketPath);
-            if (!stat.isSocket())
-                throw new Error("HOST_SOCKET_PATH_INVALID");
-            await rm(options.socketPath);
-        }
-        catch (error) {
-            if (error.code !== "ENOENT")
-                throw error;
-        }
-    }
-    const processHost = await spawnAdapterHost({
-        entrypoint: options.hostEntrypoint,
-        manifest: options.manifestPath,
-        env: { ...process.env, OCTO_RUNTIME_HOME: options.homePath }
-    });
-    const configure = (request) => {
-        const adapterType = contextItem(request.contexts, "octo.execution", "adapter")?.payload.type;
-        const type = typeof adapterType === "string" ? adapterType : "codex";
-        const config = options.configurations?.(typeof request.runMetadata?.runtimeId === "string" ? request.runMetadata.runtimeId : undefined)?.[type];
-        return config
-            ? {
-                ...request,
-                agentConfig: {
-                    ...request.agentConfig,
-                    providerOptions: { ...request.agentConfig?.providerOptions, ...config.providerOptions }
-                }
-            }
-            : request;
-    };
-    const transport = {
-        list: (configs) => processHost.client.list(configs ?? options.configurations?.()),
-        probe: (type, config) => processHost.client.probe(type, config ?? options.configurations?.()?.[type]),
-        cancel: (id, reason) => processHost.client.cancel(id, reason),
-        respondInteraction: (id, response) => processHost.client.respondInteraction(id, response),
-        respondNative: (id, response) => processHost.client.respondNative(id, response),
-        invoke: createInputInvoke((input, environment) => transport.invokeFrames(input, environment)),
-        invokeFrames: (input, environment) => processHost.client.invokeFrames(configure(input), environment)
-    };
-    const host = new HostRunService(transport);
-    const connections = new Set();
-    let closing = false;
-    const server = net.createServer((socket) => {
-        connections.add(socket);
-        socket.once("close", () => connections.delete(socket));
-        socket.on("error", () => socket.destroy());
-        socket.setEncoding("utf8");
-        socket.setTimeout(5000, () => socket.destroy());
-        const stopInput = readBoundedLines(socket, INVOKE_REQUEST_MAX_BYTES, {
-            onError: () => socket.destroy(),
-            onClose: () => { },
-            onTooLarge: () => socket.end(`${JSON.stringify({ jsonrpc: "2.0", id: null, error: { code: -32000, message: "INVOKE_REQUEST_TOO_LARGE" } })}\n`),
-            onLine: (line) => {
-                stopInput();
-                socket.setTimeout(0);
-                void handle(line, socket);
-            }
-        });
-    });
-    const handle = async (line, socket) => {
-        let request;
-        try {
-            const value = JSON.parse(line);
-            if (!value ||
-                typeof value !== "object" ||
-                Array.isArray(value) ||
-                !("jsonrpc" in value) ||
-                value.jsonrpc !== "2.0" ||
-                !("method" in value) ||
-                typeof value.method !== "string")
-                throw new Error("HOST_RPC_INVALID");
-            request = value;
-            const params = request.params ?? {};
-            if (request.method === "agent_run.invoke") {
-                const receipt = await host.submit(params.input, {
-                    executionEnvOverrides: params.executionEnvOverrides
-                });
-                await streamHostRun({ ...request, params: { run_id: receipt.run_id } }, socket, host);
-                return;
-            }
-            if (request.method === "agent_run.subscribe") {
-                await streamHostRun(request, socket, host);
-                return;
-            }
-            let result;
-            switch (request.method) {
-                case "status":
-                    result = {
-                        ready: !closing &&
-                            processHost.child.exitCode === null &&
-                            processHost.child.signalCode === null,
-                        pid: process.pid,
-                        adapterHost: {
-                            pid: processHost.child.pid,
-                            state: processHost.child.exitCode === null && processHost.child.signalCode === null
-                                ? "ready"
-                                : "stopped"
-                        }
-                    };
-                    break;
-                case "adapter.list":
-                    result = await host.list(options.configurations?.(typeof params.runtimeId === "string" ? params.runtimeId : undefined));
-                    break;
-                case "agent_run.cancel":
-                    result = await host.cancelRun(String(params.run_id));
-                    break;
-                case "agent_run.respond":
-                    await host.respond(String(params.run_id), params.response);
-                    result = {};
-                    break;
-                case "agent_run.native.respond":
-                    await host.respondNativeRun(String(params.run_id), params.response);
-                    result = {};
-                    break;
-                case "lifecycle.drain":
-                    result = await host.drain(typeof params.timeoutMs === "number" ? params.timeoutMs : 5000);
-                    break;
-                default:
-                    if (!options.extension)
-                        throw new Error("HOST_METHOD_NOT_FOUND");
-                    result = await options.extension(request, host);
-            }
-            if (!socket.destroyed)
-                socket.end(`${JSON.stringify({ jsonrpc: "2.0", id: request.id, result })}\n`);
-        }
-        catch (error) {
-            if (!socket.destroyed)
-                socket.end(`${JSON.stringify({ jsonrpc: "2.0", id: request?.id, error: { code: -32001, message: error instanceof Error ? error.message : "HOST_REQUEST_FAILED" } })}\n`);
-        }
-    };
-    try {
-        await new Promise((resolve, reject) => {
-            server.once("error", reject);
-            server.listen(options.socketPath, resolve);
-        });
-        if (process.platform !== "win32")
-            await chmod(options.socketPath, 0o600);
-    }
-    catch (error) {
-        await processHost.close();
-        throw error;
-    }
-    return {
-        host,
-        hostProcess: processHost,
-        async close() {
-            if (closing)
-                return;
-            closing = true;
-            await host.close();
-            for (const socket of connections)
-                socket.destroy();
-            await new Promise((resolve) => server.close(() => resolve()));
-            await processHost.close();
-            if (process.platform !== "win32")
-                await rm(options.socketPath, { force: true });
-        }
-    };
-}
-async function write(socket, value) {
-    if (socket.destroyed)
-        return;
-    if (!socket.write(`${JSON.stringify(value)}\n`)) {
-        await new Promise((resolve, reject) => {
-            const cleanup = () => {
-                clearTimeout(timer);
-                socket.off("drain", drained);
-                socket.off("close", closed);
-            };
-            const drained = () => {
-                cleanup();
-                resolve();
-            };
-            const closed = () => {
-                cleanup();
-                reject(new Error("HOST_STREAM_CLOSED"));
-            };
-            const timer = setTimeout(closed, 5000);
-            socket.once("drain", drained);
-            socket.once("close", closed);
-        });
-    }
-}
-export async function streamHostRun(request, socket, host) {
-    const params = request.params ?? {};
-    if (Object.hasOwn(params, "options") || Object.hasOwn(params, "protocol_mode"))
-        throw new Error("EXECUTION_PROTOCOL_MISMATCH");
-    if (typeof params.run_id !== "string" || !params.run_id)
-        throw new Error("RUN_ID_REQUIRED");
-    let streamId = typeof params.stream_id === "string" ? params.stream_id : undefined;
-    const cursor = params.after_seq ?? 0;
-    if (typeof cursor !== "number")
-        throw new Error("STREAM_CURSOR_INVALID");
-    let after = cursor;
-    const release = host.acquireSubscription();
-    const subscription = `sub_${randomUUID()}`;
-    let started = false;
-    try {
-        while (!socket.destroyed) {
-            const page = host.read(params.run_id, streamId, after);
-            streamId = page.stream_id;
-            if (!started) {
-                await write(socket, {
-                    jsonrpc: "2.0",
-                    id: request.id,
-                    result: { subscription_id: subscription, ...page, events: undefined }
-                });
-                started = true;
-            }
-            for (const value of page.events) {
-                await write(socket, {
-                    jsonrpc: "2.0",
-                    method: "agent_run.event",
-                    params: {
-                        subscription_id: subscription,
-                        run_id: params.run_id,
-                        stream_id: streamId,
-                        seq: value.seq,
-                        event: value.event
-                    }
-                });
-                after = value.seq;
-            }
-            if ((page.terminal || params.follow === false) && after >= page.latest_seq) {
-                socket.end();
-                return;
-            }
-            if (!page.events.length)
-                await new Promise((resolve) => {
-                    const done = () => {
-                        clearTimeout(timer);
-                        socket.off("close", done);
-                        resolve();
-                    };
-                    const timer = setTimeout(done, 100);
-                    socket.once("close", done);
-                });
-        }
-    }
-    finally {
-        release();
-    }
-}

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

@@ -1,37 +0,0 @@
-{
-  "name": "@mininglamp-oss/octo-runtime-adapter-host",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./runner": {
-      "types": "./dist/runner.d.ts",
-      "import": "./dist/runner.js"
-    }
-  },
-  "dependencies": {
-    "@mininglamp-oss/octo-runtime-core": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-antigravity": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-claude-code": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-codebuddy": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-codex": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-hermes": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-kimi-code": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-mcode": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-openclaw": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-opencode": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-qodercli": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-qoderclicn": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-zcode-gui": "1.0.0",
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.0",
-    "@mininglamp-oss/octo-runtime-adapter-sdk": "1.0.0"
-  },
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ]
-}

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

@@ -1 +0,0 @@
-export declare function formatDaemonResult(value: unknown): string;

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

@@ -1,49 +0,0 @@
-function record(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : {};
-}
-export function formatDaemonResult(value) {
-    const result = record(value);
-    const service = record(result.service);
-    const application = record(result.readiness ?? result.application);
-    const action = result.action;
-    const lines = [
-        action === "start"
-            ? "Backend started successfully."
-            : action === "restart"
-                ? "Backend restarted successfully."
-                : action === "stop"
-                    ? "Backend stopped successfully."
-                    : action === "install"
-                        ? "Background service installed successfully."
-                        : action === "uninstall"
-                            ? "Background service removed. Runtime Home and credentials preserved."
-                            : `Backend: ${application.ready === true ? "ready" : "not ready"}`,
-        `Service: ${typeof service.state === "string" ? service.state : "unknown"} (${typeof service.manager === "string" ? service.manager : "unknown"})`
-    ];
-    if (action === "install")
-        lines.push(`Start at login: ${service.enabled === true ? "enabled" : "disabled"}`, "Start the backend: octo-runtime daemon start");
-    if (application.ready === true || application.extras !== undefined) {
-        const adapters = Array.isArray(application.adapters)
-            ? application.adapters.filter((item) => typeof item === "string")
-            : [];
-        lines.push(`Adapters (${adapters.length}): ${adapters.join(", ") || "none detected"}`);
-        const extras = Object.entries(record(application.extras));
-        const active = extras
-            .filter(([, state]) => record(state).phase === "loaded")
-            .map(([name]) => name);
-        lines.push(`Active Extras: ${active.join(", ") || "none"}`);
-        for (const [name, state] of extras) {
-            const phase = record(state).phase;
-            if (phase !== "loaded")
-                lines.push(`  ${name}: ${typeof phase === "string" ? phase : "unknown"}`);
-            if (Object.hasOwn(record(state), "status")) {
-                lines.push(`\nExtra ${name}:`, JSON.stringify(record(state).status, null, 2));
-            }
-            if (record(state).status_error)
-                lines.push(`  ${name}: status query failed (EXTRA_STATUS_FAILED)`);
-        }
-    }
-    return lines.join("\n");
-}

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

@@ -1,11 +0,0 @@
-export declare function temporaryDaemonEndpoint(directory: string, platform?: NodeJS.Platform): string;
-export declare function startTemporaryDaemon(options: {
-    home: string;
-    profile: string;
-    manifest: string;
-    env: NodeJS.ProcessEnv;
-    signal: AbortSignal;
-}): Promise<{
-    socket: string;
-    close(): Promise<void>;
-}>;

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

@@ -1,109 +0,0 @@
-import { spawn } from "node:child_process";
-import { mkdtemp, realpath, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { createHash } from "node:crypto";
-import { reapOrphanedInvocationManifest } from "@mininglamp-oss/octo-runtime-daemon";
-import { probeDaemon } from "@mininglamp-oss/octo-runtime-daemon/runtime/runtime-contract";
-export function temporaryDaemonEndpoint(directory, platform = process.platform) {
-    return platform === "win32"
-        ? `\\\\.\\pipe\\octo-playboard-${createHash("sha256").update(directory).digest("hex").slice(0, 16)}`
-        : join(directory, "daemon.sock");
-}
-export async function startTemporaryDaemon(options) {
-    options.signal.throwIfAborted();
-    const directory = await mkdtemp(join(await realpath(tmpdir()), "octo-playboard-"));
-    const socket = temporaryDaemonEndpoint(directory);
-    const child = spawn(process.execPath, [
-        fileURLToPath(new URL("../../daemon/dist/index.js", import.meta.url)),
-        "--execution-only",
-        "--profile",
-        options.profile,
-        "--home",
-        options.home,
-        "--manifest",
-        options.manifest,
-        "--socket",
-        socket,
-        "--pid-file",
-        join(directory, "daemon.pid"),
-        "--state-directory",
-        directory
-    ], {
-        argv0: "octo-runtime-playboard-daemon",
-        env: options.env,
-        stdio: ["ignore", "pipe", "pipe", "ipc"],
-        windowsHide: true
-    });
-    // Neither daemon diagnostics nor readiness messages belong on stdout.
-    child.stdout?.on("data", (chunk) => process.stderr.write(chunk));
-    child.stderr?.on("data", (chunk) => process.stderr.write(chunk));
-    const exited = new Promise((resolve) => {
-        child.once("error", () => resolve(1));
-        child.once("exit", (code) => resolve(code));
-    });
-    let closing;
-    const close = () => (closing ??= (async () => {
-        if (child.exitCode === null && child.signalCode === null)
-            child.kill("SIGTERM");
-        let timer;
-        let timedOut = false;
-        const code = await Promise.race([
-            exited,
-            new Promise((resolve) => {
-                timer = setTimeout(() => {
-                    timedOut = true;
-                    child.kill("SIGKILL");
-                    void exited.then(resolve);
-                }, 40_000);
-            })
-        ]).finally(() => clearTimeout(timer));
-        // Reap only this invocation's manifest, including unexpected daemon death.
-        const reap = await reapOrphanedInvocationManifest(join(directory, "invocations.json"));
-        if (reap.reason === "daemon_alive" || reap.reason === "unsupported_identity")
-            throw new Error("PLAYBOARD_DAEMON_CLEANUP_INCOMPLETE");
-        await rm(directory, { recursive: true, force: true });
-        if (timedOut)
-            throw new Error("PLAYBOARD_DAEMON_SHUTDOWN_TIMEOUT");
-        if (code !== 0)
-            throw new Error("PLAYBOARD_DAEMON_EXITED_ABNORMALLY");
-    })());
-    try {
-        await new Promise((resolve, reject) => {
-            const timer = setTimeout(() => finish(new Error("PLAYBOARD_DAEMON_START_TIMEOUT")), 30_000);
-            const abort = () => finish(new Error("playboard daemon startup cancelled"));
-            const message = (value) => {
-                if (value && typeof value === "object" && "type" in value && value.type === "daemon.ready")
-                    finish();
-            };
-            let settled = false;
-            const finish = (error) => {
-                if (settled)
-                    return;
-                settled = true;
-                clearTimeout(timer);
-                options.signal.removeEventListener("abort", abort);
-                child.removeListener("message", message);
-                if (error)
-                    reject(error);
-                else
-                    resolve();
-            };
-            child.on("message", message);
-            options.signal.addEventListener("abort", abort, { once: true });
-            void exited.then(() => finish(new Error("PLAYBOARD_DAEMON_START_FAILED")));
-            if (options.signal.aborted)
-                abort();
-        });
-        const status = await probeDaemon(socket);
-        if (!status?.ready)
-            throw new Error("PLAYBOARD_DAEMON_NOT_READY");
-        options.signal.throwIfAborted();
-        return { socket, close };
-    }
-    catch (error) {
-        await close();
-        throw error;
-    }
-}

package/node_modules/@mininglamp-oss/octo-runtime-core/dist/index.d.ts

@@ -1,2 +0,0 @@
-export { resolveLocalContext, localRuntimeLimits } from "./context.js";
-export { prepareInvokeInput } from "./invoke-input.js";

package/node_modules/@mininglamp-oss/octo-runtime-core/dist/index.js

@@ -1,2 +0,0 @@
-export { resolveLocalContext, localRuntimeLimits } from "./context.js";
-export { prepareInvokeInput } from "./invoke-input.js";

package/node_modules/@mininglamp-oss/octo-runtime-core/dist/invoke-input.d.ts

@@ -1,7 +0,0 @@
-import { type InvokeRequest } from "@mininglamp-oss/octo-runtime-protocol";
-/** One caller-owned snapshot, with no persistent session or daemon state. */
-export declare function prepareInvokeInput(value: unknown): {
-    adapterType: string;
-    protocolMode: "native" | "canonical";
-    request: InvokeRequest;
-};

package/node_modules/@mininglamp-oss/octo-runtime-core/package.json

@@ -1,14 +0,0 @@
-{
-  "name": "@mininglamp-oss/octo-runtime-core",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "exports": "./dist/index.js",
-  "dependencies": {
-    "@mininglamp-oss/octo-runtime-protocol": "1.0.0"
-  },
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ]
-}

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

@@ -1,9 +0,0 @@
-export { RUNTIME_RUN_CONTRACT } from "@mininglamp-oss/octo-runtime-protocol";
-export { prepareRunContext } from "@mininglamp-oss/octo-runtime-adapter-host";
-export * from "./server.js";
-export * from "./modules.js";
-export * from "./extras.js";
-export * from "./extra-config.js";
-export * from "./runtime/index.js";
-export { reapOrphanedInvocationManifest } from "./invocation-manifest.js";
-export * from "./context-loader.js";

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

@@ -1,9 +0,0 @@
-export { RUNTIME_RUN_CONTRACT } from "@mininglamp-oss/octo-runtime-protocol";
-export { prepareRunContext } from "@mininglamp-oss/octo-runtime-adapter-host";
-export * from "./server.js";
-export * from "./modules.js";
-export * from "./extras.js";
-export * from "./extra-config.js";
-export * from "./runtime/index.js";
-export { reapOrphanedInvocationManifest } from "./invocation-manifest.js";
-export * from "./context-loader.js";

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

@@ -1,55 +0,0 @@
-import type { HostRunService } from "@mininglamp-oss/octo-runtime-adapter-host";
-import { type RuntimeLog } from "@mininglamp-oss/octo-runtime-adapter-sdk";
-export interface DaemonModuleContext {
-    log?: RuntimeLog;
-    host: HostRunService;
-    homePath: string;
-    signal: AbortSignal;
-    account?: {
-        subject: {
-            type: "user";
-            id: string;
-        };
-        profiles: Array<{
-            tenantId: string;
-            profile: string;
-            runtimeId: string;
-            root: string;
-        }>;
-        machineId: string;
-    };
-}
-export interface DaemonModule {
-    readonly status: unknown;
-    start(): Promise<void>;
-    handle?(request: {
-        method: string;
-        params?: Record<string, unknown>;
-    }): Promise<unknown>;
-    beginDrain?(): void;
-    waitForDrained?(timeoutMs: number): Promise<void>;
-    close(): Promise<void>;
-}
-export interface DaemonModuleRegistration {
-    id: string;
-    create(context: DaemonModuleContext, config: unknown): DaemonModule | Promise<DaemonModule>;
-    /** Only an explicit config enables a module at daemon startup. */
-    config?: unknown;
-}
-export declare class DaemonModules {
-    #private;
-    private readonly context;
-    private readonly logForModule;
-    static validate(registrations: readonly DaemonModuleRegistration[]): void;
-    constructor(registrations: readonly DaemonModuleRegistration[], context: Omit<DaemonModuleContext, "signal">, logForModule?: (name: string) => RuntimeLog);
-    get status(): Record<string, unknown>;
-    startConfigured(): void;
-    start(id: string, config: unknown): Promise<unknown>;
-    stop(id: string): Promise<void>;
-    request(id: string, request: {
-        method: string;
-        params?: Record<string, unknown>;
-    }): Promise<unknown>;
-    drain(timeoutMs: number): Promise<void>;
-    close(): Promise<void>;
-}