@nylorun/runtime 0.4.0-beta → 0.6.0-beta

package/dist/cli.js

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-import { join } from "node:path";
-import { pathToFileURL } from "node:url";
-import { createRequire } from "node:module";
-import { ConfigurationCancelled, configureProvider, } from "./model/configure.js";
-import { loadProjectEnvironment } from "./environment.js";
-import { develop } from "./dev.js";
-const usage = `nylorun <configure|dev|start|studio>
-  dev [--no-studio] [--no-open]
-  start [entry]
-  configure
-  studio --agent-url <http(s)-url> [--port <n>] [--no-open]`;
-async function startStudio(agentServerUrl, open, port) {
-    let entry;
-    try {
-        entry = createRequire(join(process.cwd(), "package.json")).resolve("@nylorun/studio");
-    }
-    catch {
-        throw new Error("Install @nylorun/studio to use the Studio dashboard.");
-    }
-    const studio = await import(pathToFileURL(entry).href);
-    return studio.startStudio({
-        agentServerUrl,
-        open,
-        ...(port === undefined ? {} : { port }),
-    });
-}
-function parsePort(value) {
-    if (value === undefined)
-        return undefined;
-    const port = Number(value);
-    if (!Number.isInteger(port) || port < 1 || port > 65535)
-        throw new Error("--port must be an integer between 1 and 65535.");
-    return port;
-}
-async function main() {
-    const [command, ...args] = process.argv.slice(2);
-    if (!command || command === "--help" || command === "-h")
-        return void console.log(usage);
-    if (["configure", "dev", "start"].includes(command))
-        loadProjectEnvironment();
-    if (command === "start") {
-        if (args.length > 1 || args[0]?.startsWith("--"))
-            throw new Error(usage);
-        await (await import("./launcher.js")).start(args[0]);
-        return;
-    }
-    if (command === "dev") {
-        process.exitCode = await develop(args);
-        return;
-    }
-    if (command === "configure") {
-        if (args.length)
-            throw new Error(usage);
-        const controller = new AbortController();
-        const cancel = (signal) => controller.abort(new ConfigurationCancelled(signal));
-        process.once("SIGINT", () => cancel("SIGINT"));
-        process.once("SIGTERM", () => cancel("SIGTERM"));
-        await configureProvider({ signal: controller.signal });
-        return;
-    }
-    if (command !== "studio")
-        throw new Error(usage);
-    let agentUrl;
-    let port;
-    let open = true;
-    for (let index = 0; index < args.length; index += 1) {
-        const arg = args[index];
-        if (arg === "--agent-url") {
-            if (agentUrl !== undefined)
-                throw new Error("--agent-url may only be supplied once.");
-            agentUrl = args[++index];
-            if (!agentUrl || agentUrl.startsWith("--"))
-                throw new Error("--agent-url requires a value.");
-        }
-        else if (arg === "--port") {
-            if (port !== undefined)
-                throw new Error("--port may only be supplied once.");
-            port = parsePort(args[++index]);
-        }
-        else if (arg === "--no-open" && open)
-            open = false;
-        else
-            throw new Error(usage);
-    }
-    if (!agentUrl)
-        throw new Error("--agent-url is required.");
-    const dashboard = await startStudio(agentUrl, open, port);
-    console.log(`Studio on ${dashboard.address}`);
-    await new Promise((resolve, reject) => {
-        const close = () => void dashboard.close().then(resolve, reject);
-        process.once("SIGINT", close);
-        process.once("SIGTERM", close);
-    });
-}
-void main().catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exitCode =
-        error instanceof ConfigurationCancelled ? error.exitCode : 1;
-});

package/dist/dev-entry.js

@@ -1,2 +0,0 @@
-import { start } from "./launcher.js";
-await start(process.argv[2] ?? "src/index.ts", true);

package/dist/dev.d.ts

@@ -1,2 +0,0 @@
-/** Runs project development tooling without copying a supervisor into each application. */
-export declare function develop(args: readonly string[]): Promise<number>;

package/dist/dev.js

@@ -1,126 +0,0 @@
-import { spawn } from "node:child_process";
-import { createRequire } from "node:module";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { setTimeout as delay } from "node:timers/promises";
-/** Runs project development tooling without copying a supervisor into each application. */
-export async function develop(args) {
-    const usage = "Usage: nylorun dev [--no-studio] [--no-open]";
-    if (new Set(args).size !== args.length ||
-        args.some((arg) => !["--no-studio", "--no-open"].includes(arg)))
-        throw new Error(usage);
-    const port = Number(process.env.PORT ?? "3000");
-    if (!Number.isInteger(port) || port < 1 || port > 65535)
-        throw new Error("PORT must be an integer between 1 and 65535.");
-    const require = createRequire(join(process.cwd(), "package.json"));
-    let tsx;
-    try {
-        tsx = require.resolve("tsx/cli");
-    }
-    catch {
-        throw new Error("Install tsx in your project to use nylorun dev.");
-    }
-    if (!args.includes("--no-studio")) {
-        try {
-            require.resolve("@nylorun/studio");
-        }
-        catch {
-            throw new Error("Install @nylorun/studio or use nylorun dev --no-studio.");
-        }
-    }
-    const controller = new AbortController();
-    const children = new Set();
-    const exits = [];
-    let result = 0;
-    let force;
-    const stop = (code, signal = "SIGTERM") => {
-        if (controller.signal.aborted)
-            return;
-        result = code;
-        controller.abort();
-        for (const child of children)
-            child.kill(signal);
-        force = setTimeout(() => {
-            for (const child of children)
-                child.kill("SIGKILL");
-        }, 5_000);
-        force.unref();
-    };
-    const interrupt = () => stop(130, "SIGINT");
-    const terminate = () => stop(143);
-    process.once("SIGINT", interrupt);
-    process.once("SIGTERM", terminate);
-    const launch = (argv) => {
-        const child = spawn(process.execPath, argv, {
-            stdio: "inherit",
-            env: { ...process.env, NYLORUN_DEV: "1" },
-        });
-        children.add(child);
-        exits.push(new Promise((resolve) => {
-            child.once("error", (error) => {
-                console.error(`Could not start development process: ${error.message}`);
-                stop(1);
-            });
-            child.once("close", (code, signal) => {
-                children.delete(child);
-                stop(code ?? (signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : 1));
-                resolve();
-            });
-        }));
-    };
-    try {
-        launch([
-            tsx,
-            "watch",
-            fileURLToPath(new URL("./dev-entry.js", import.meta.url)),
-            "src/index.ts",
-        ]);
-        if (!args.includes("--no-studio")) {
-            const url = `http://127.0.0.1:${port}/agents/v1/agents`;
-            const deadline = Date.now() + 20_000;
-            let ready = false;
-            while (!controller.signal.aborted && Date.now() < deadline) {
-                try {
-                    const response = await fetch(url, {
-                        signal: AbortSignal.any([
-                            controller.signal,
-                            AbortSignal.timeout(500),
-                        ]),
-                    });
-                    ready = response.ok;
-                    await response.body?.cancel();
-                    if (ready)
-                        break;
-                }
-                catch {
-                    /* Watch mode may still be compiling or restarting the app. */
-                }
-                await delay(50, undefined, { signal: controller.signal }).catch(() => { });
-            }
-            if (!controller.signal.aborted) {
-                if (!ready)
-                    throw new Error(`Application did not become ready at ${url} within 20 seconds.`);
-                launch([
-                    fileURLToPath(new URL("./cli.js", import.meta.url)),
-                    "studio",
-                    "--agent-url",
-                    `http://localhost:${port}/agents`,
-                    ...(args.includes("--no-open") ? ["--no-open"] : []),
-                ]);
-            }
-        }
-        await Promise.all(exits);
-    }
-    catch (error) {
-        stop(1);
-        await Promise.all(exits);
-        throw error;
-    }
-    finally {
-        if (force !== undefined)
-            clearTimeout(force);
-        process.removeListener("SIGINT", interrupt);
-        process.removeListener("SIGTERM", terminate);
-    }
-    return result;
-}

package/dist/environment.d.ts

@@ -1,2 +0,0 @@
-export declare function loadProjectEnvironment(root?: string): void;
-export declare function saveEnvironment(root: string, updates: Record<string, string | undefined>, signal?: AbortSignal): Promise<void>;

package/dist/environment.js

@@ -1,64 +0,0 @@
-import { readFileSync, statSync } from "node:fs";
-import { writeFile, rename, rm } from "node:fs/promises";
-import { join } from "node:path";
-import { randomUUID } from "node:crypto";
-import { loadEnvFile } from "node:process";
-export function loadProjectEnvironment(root = process.cwd()) {
-    const file = join(root, ".env");
-    try {
-        if (statSync(file).isDirectory())
-            throw new Error("The .env directory must be migrated manually: back it up, create a .env file with MODEL_PROVIDER, MODEL and MODEL_PROVIDER_API_KEY, and move OAuth credentials to .nylorun/auth.json. See the Runtime migration guide.");
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return;
-        throw error;
-    }
-    loadEnvFile(file);
-}
-// Match complete dotenv assignments, including quoted multiline values.
-const assignment = /^(?:export\s+)?([\w]+)[\t ]*=[\t ]*(?:"[^"]*"|'[^']*'|`[^`]*`|[^#\r\n]*)([^\r\n]*)(?:\r?\n|$)/gm;
-export async function saveEnvironment(root, updates, signal) {
-    const file = join(root, ".env");
-    let contents = "";
-    try {
-        contents = readFileSync(file, "utf8");
-    }
-    catch (error) {
-        if (error.code !== "ENOENT")
-            throw error;
-    }
-    const encode = (value) => {
-        // Node's dotenv parser has no general quote-escaping syntax. Select a
-        // delimiter absent from the value rather than changing the credential.
-        for (const quote of ["'", '"', "`"]) {
-            if (!value.includes(quote) && !(quote === '"' && /\\[nr]/.test(value)))
-                return quote + value + quote;
-        }
-        throw new Error("This value contains all dotenv quote delimiters; set it through your process environment instead.");
-    };
-    const remaining = new Set(Object.keys(updates));
-    contents = contents.replace(assignment, (whole, key, suffix) => {
-        if (!(key in updates))
-            return whole;
-        if (!remaining.delete(key))
-            return "";
-        return updates[key] === undefined
-            ? ""
-            : `${key}=${encode(updates[key])}${suffix}\n`;
-    });
-    if (contents && !contents.endsWith("\n"))
-        contents += "\n";
-    for (const key of remaining)
-        if (updates[key] !== undefined)
-            contents += `${key}=${encode(updates[key])}\n`;
-    const temporary = join(root, `.env-${randomUUID()}.tmp`);
-    try {
-        await writeFile(temporary, contents, { mode: 0o600, signal });
-        signal?.throwIfAborted();
-        await rename(temporary, file);
-    }
-    finally {
-        await rm(temporary, { force: true });
-    }
-}

package/dist/launcher.d.ts

@@ -1 +0,0 @@
-export declare function start(entry?: string, development?: boolean): Promise<void>;

package/dist/launcher.js

@@ -1,28 +0,0 @@
-import { serve } from "@hono/node-server";
-import { resolve } from "node:path";
-import { pathToFileURL } from "node:url";
-import { loadProjectEnvironment } from "./environment.js";
-export async function start(entry = "dist/src/index.js", development = false) {
-    loadProjectEnvironment();
-    if (development)
-        process.env.NYLORUN_DEV = "1";
-    else
-        delete process.env.NYLORUN_DEV;
-    const port = Number(process.env.PORT ?? "3000");
-    if (!Number.isInteger(port) || port < 1 || port > 65535)
-        throw new Error("PORT must be an integer between 1 and 65535.");
-    const { default: app } = await import(pathToFileURL(resolve(entry)).href);
-    if (!app || typeof app.fetch !== "function")
-        throw new Error(`${entry} must export a Hono application with 'export default app' and a callable fetch.`);
-    const server = serve({ fetch: app.fetch.bind(app), port }, (info) => {
-        console.log(`Server is running on http://localhost:${info.port}`);
-    });
-    const stop = () => {
-        process.removeListener("SIGINT", stop);
-        process.removeListener("SIGTERM", stop);
-        server.close(() => process.exit(0));
-        setTimeout(() => process.exit(0), 5_000).unref();
-    };
-    process.once("SIGINT", stop);
-    process.once("SIGTERM", stop);
-}

package/dist/model/configure.d.ts

@@ -1,12 +0,0 @@
-import type { Readable, Writable } from "node:stream";
-export declare class ConfigurationCancelled extends Error {
-    readonly signal: "SIGINT" | "SIGTERM";
-    readonly exitCode: number;
-    constructor(signal: "SIGINT" | "SIGTERM");
-}
-export declare function configureProvider(options?: {
-    signal?: AbortSignal;
-    root?: string;
-    input?: Readable;
-    output?: Writable;
-}): Promise<void>;

package/dist/model/configure.js

@@ -1,155 +0,0 @@
-import { join } from "node:path";
-import { createInterface } from "node:readline/promises";
-import { saveEnvironment } from "../environment.js";
-import { ProjectCredentialStore } from "./auth-store.js";
-import { modelsFor } from "./models.js";
-export class ConfigurationCancelled extends Error {
-    signal;
-    exitCode;
-    constructor(signal) {
-        super(`Provider configuration cancelled (${signal}).`);
-        this.signal = signal;
-        this.exitCode = signal === "SIGINT" ? 130 : 143;
-    }
-}
-// Internal options also allow isolated prompt tests without changing process globals.
-export async function configureProvider(options = {}) {
-    const root = options.root ?? process.cwd();
-    const output = options.output ?? process.stdout;
-    const controller = new AbortController();
-    const signal = controller.signal;
-    const forwardAbort = () => controller.abort(options.signal.reason);
-    options.signal?.throwIfAborted();
-    let enteredKey;
-    let enteredEnvironment = {};
-    const oauthStore = new ProjectCredentialStore(join(root, ".nylorun", "auth.json"), join(root, ".env", "auth.json"));
-    const store = {
-        read: (id) => oauthStore.read(id),
-        list: () => oauthStore.list(),
-        delete: (id) => oauthStore.delete(id),
-        async modify(id, fn) {
-            const next = await fn(await oauthStore.read(id));
-            if (next?.type === "api_key") {
-                if (next.key === "")
-                    throw new Error("An API key is required.");
-                enteredKey = next.key;
-                enteredEnvironment = { ...next.env };
-                return next;
-            }
-            return oauthStore.modify(id, async () => next);
-        },
-    };
-    const models = modelsFor({ provider: "", model: "" }, store);
-    const providers = models.getProviders();
-    const prompt = createInterface({
-        input: options.input ?? process.stdin,
-        output,
-    });
-    const onInt = () => controller.abort(new ConfigurationCancelled("SIGINT"));
-    const onClose = () => controller.abort(new Error("Configuration input closed before setup completed."));
-    const closeOnAbort = () => prompt.close();
-    prompt.on("SIGINT", onInt);
-    prompt.on("close", onClose);
-    signal.addEventListener("abort", closeOnAbort, { once: true });
-    options.signal?.addEventListener("abort", forwardAbort, { once: true });
-    if (options.signal?.aborted)
-        forwardAbort();
-    async function question(message) {
-        signal.throwIfAborted();
-        return prompt.question(message, { signal });
-    }
-    try {
-        signal.throwIfAborted();
-        output.write("0. Custom OpenAI-compatible provider\n");
-        providers.forEach((provider, index) => output.write(`${index + 1}. ${provider.name} (${provider.id})\n`));
-        const choice = Number(await question("Choose a provider: "));
-        if (choice === 0) {
-            const baseUrl = (await question("OpenAI-compatible base URL: "))
-                .trim()
-                .replace(/\/$/, "");
-            const model = (await question("Model id: ")).trim();
-            if (!baseUrl || !model)
-                throw new Error("A base URL and model id are required.");
-            const selection = {
-                provider: "custom",
-                model,
-                custom: { baseUrl },
-            };
-            const customModels = modelsFor(selection, store);
-            if (!(await customModels.checkAuth("custom", { signal })))
-                await customModels.login("custom", "api_key", interaction());
-            await save(selection);
-        }
-        else {
-            const chosen = providers[choice - 1];
-            if (!chosen)
-                throw new Error("Choose a listed provider.");
-            const available = models.getModels(chosen.id);
-            available.forEach((model, index) => output.write(`${index + 1}. ${model.name} (${model.id})\n`));
-            const model = available[Number(await question("Choose a model: ")) - 1];
-            if (!model)
-                throw new Error("Choose a listed model.");
-            if (!(await models.checkAuth(chosen.id, { signal }))) {
-                let method = chosen.auth.apiKey
-                    ? "api_key"
-                    : "oauth";
-                if (chosen.auth.apiKey && chosen.auth.oauth) {
-                    const answer = (await question("Choose authentication: 1. API key (default), 2. OAuth: ")).trim();
-                    if (answer && !["1", "2"].includes(answer))
-                        throw new Error("Choose authentication 1 or 2.");
-                    if (answer === "2")
-                        method = "oauth";
-                }
-                await models.login(chosen.id, method, interaction());
-            }
-            await save({ provider: chosen.id, model: model.id });
-        }
-        signal.throwIfAborted();
-        output.write("Provider configuration saved.\n");
-    }
-    catch (error) {
-        throw signal.aborted ? signal.reason : error;
-    }
-    finally {
-        options.signal?.removeEventListener("abort", forwardAbort);
-        signal.removeEventListener("abort", closeOnAbort);
-        prompt.removeListener("SIGINT", onInt);
-        prompt.removeListener("close", onClose);
-        prompt.close();
-    }
-    function interaction() {
-        return {
-            signal,
-            prompt: async (item) => {
-                if (item.type !== "select")
-                    return question(item.message + ": ");
-                item.options.forEach((option, index) => output.write(`${index + 1}. ${option.label}\n`));
-                const answer = (await question(item.message + " ")).trim();
-                const option = item.options.find((option) => option.id === answer) ??
-                    item.options[Number(answer) - 1];
-                if (!option)
-                    throw new Error("Choose a listed authentication option.");
-                return option.id;
-            },
-            notify: (event) => {
-                output.write(("url" in event
-                    ? event.url
-                    : "verificationUri" in event
-                        ? event.verificationUri
-                        : event.message) + "\n");
-            },
-        };
-    }
-    async function save(selection) {
-        signal.throwIfAborted();
-        await saveEnvironment(root, {
-            ...enteredEnvironment,
-            MODEL_PROVIDER: selection.provider,
-            MODEL: selection.model,
-            MODEL_PROVIDER_BASE_URL: selection.custom?.baseUrl,
-            ...(enteredKey === undefined
-                ? {}
-                : { MODEL_PROVIDER_API_KEY: enteredKey }),
-        }, signal);
-    }
-}