@nylorun/runtime 0.5.0-beta → 0.6.0-beta

package/dist/session/index.d.ts

@@ -0,0 +1,2 @@
+export { createSessionHandle, resolveWait, type OpenSessionOptions, type SessionHandle, type SessionRuntime, } from "./handle.js";
+export { getDefaultRuntime, setDefaultRuntime, installDefaultRuntimeFactory, } from "./default.js";

package/dist/session/index.js

@@ -0,0 +1,2 @@
+export { createSessionHandle, resolveWait, } from "./handle.js";
+export { getDefaultRuntime, setDefaultRuntime, installDefaultRuntimeFactory, } from "./default.js";

package/dist/sessions/host.d.ts

@@ -1,4 +1,5 @@
-import type { BuiltAgent, ExecutionInput, ModelAdapter, RunResult } from "@nylorun/harness";
+import type { BuiltAgent, JsonObject, ModelAdapter } from "@nylorun/core/define";
+import type { ExecutionInput, ExecutionState, RunResult } from "@nylorun/harness";
 import type { CanonicalEvent, SessionStore, StoredSession, SessionSummary } from "./store.js";
 export interface SubmitOptions {
     readonly runId?: string;
@@ -8,6 +9,8 @@ export interface SubmitOptions {
     readonly secrets?: readonly string[];
     readonly onEvent?: (event: CanonicalEvent) => void;
     readonly started?: Record<string, unknown>;
+    /** Seed `ExecutionState.state` when creating a new checkpoint (openSession). */
+    readonly sessionState?: JsonObject;
 }
 /** The built-in single-process coordinator. Storage adapters do not implement execution. */
 export declare class SessionHost {
@@ -21,9 +24,16 @@ export declare class SessionHost {
     private key;
     read(agentId: string, sessionId: string): Promise<StoredSession | undefined>;
     list(agentId: string): Promise<readonly SessionSummary[]>;
+    delete(agentId: string, sessionId: string): Promise<boolean>;
     subscribe(agentId: string, sessionId: string, listener: (event: CanonicalEvent) => void): () => void;
     submit(agent: BuiltAgent<any, any>, sessionId: string, input: ExecutionInput, options: SubmitOptions): Promise<RunResult<any>>;
     cancel(agent: BuiltAgent<any, any>, sessionId: string): Promise<void>;
     interrupt(agent: BuiltAgent<any, any>, sessionId: string, input: ExecutionInput, options: SubmitOptions): Promise<RunResult<any>>;
     close(): Promise<void>;
 }
+/**
+ * Map DX `wait-resolve` onto harness approve/respond/settle using wait metadata.
+ * Engine `ExecutionInput` already includes `wait-resolve`; resume is wired via
+ * existing interaction/deferred kinds until full wait-id resume lands.
+ */
+export declare function resolveEngineInput(state: ExecutionState | undefined, input: ExecutionInput): ExecutionInput;

package/dist/sessions/host.js

@@ -1,4 +1,5 @@
-import { isHarnessError } from "@nylorun/harness";
+import { HarnessError, isHarnessError } from "@nylorun/core/define";
+import { bindingFromAgent, createRunState, run, } from "@nylorun/harness/run";
 import { scrub } from "../redact.js";
 /** The built-in single-process coordinator. Storage adapters do not implement execution. */
 export class SessionHost {
@@ -26,6 +27,19 @@ export class SessionHost {
             ? { ...session, status: "interrupted" }
             : session);
     }
+    async delete(agentId, sessionId) {
+        const key = this.key(agentId, sessionId);
+        if (this.active.has(key))
+            throw new Error("Cannot delete a session while a run is active");
+        if ("delete" in this.store && typeof this.store.delete === "function")
+            return this.store.delete(agentId, sessionId);
+        const existing = await this.store.get(agentId, sessionId);
+        if (!existing)
+            return false;
+        // Stores without delete: archive by removing via put tombstone is not supported;
+        // require ManagedSessionStore.delete or memorySessions.delete.
+        throw new Error("Session store does not support delete");
+    }
     subscribe(agentId, sessionId, listener) {
         const key = this.key(agentId, sessionId);
         let listeners = this.listeners.get(key);
@@ -144,17 +158,21 @@ export class SessionHost {
                     ...(typeof input === "string" ? { input } : {}),
                 });
                 await save();
-                const result = await agent.run({
-                    state: document.state,
-                    input,
+                const binding = bindingFromAgent(agent);
+                const engineInput = resolveEngineInput(document.state, input);
+                const state = ensureEngineState(binding, document.state, options.sessionState);
+                const result = await run({
+                    binding,
+                    state,
+                    input: engineInput,
                     info: options.info,
                     signal: controller.signal,
                     onModelCall: options.onModelCall,
                     onEvent: (event) => {
                         add(event.type, event);
                     },
-                    record: async (state) => {
-                        document = { ...document, state };
+                    record: async (next) => {
+                        document = { ...document, state: next };
                         await save();
                     },
                 });
@@ -235,7 +253,9 @@ export class SessionHost {
                 throw new Error("This session was interrupted; reconcile its external effects before cancellation.");
             if (stored?.state?.status !== "paused")
                 return;
-            const result = await agent.run({
+            const binding = bindingFromAgent(agent);
+            const result = await run({
+                binding,
                 state: stored.state,
                 input: { kind: "continue" },
                 signal: AbortSignal.abort(new Error("Paused execution cancelled")),
@@ -289,3 +309,51 @@ export class SessionHost {
             await this.store.close();
     }
 }
+function ensureEngineState(binding, existing, sessionState) {
+    if (existing) {
+        if (!sessionState || Object.keys(existing.state ?? {}).length > 0)
+            return existing;
+        return {
+            ...existing,
+            state: { ...(existing.state ?? {}), ...sessionState },
+        };
+    }
+    return createRunState(binding, {
+        ...(sessionState ? { state: sessionState } : {}),
+    });
+}
+/**
+ * Map DX `wait-resolve` onto harness approve/respond/settle using wait metadata.
+ * Engine `ExecutionInput` already includes `wait-resolve`; resume is wired via
+ * existing interaction/deferred kinds until full wait-id resume lands.
+ */
+export function resolveEngineInput(state, input) {
+    if (typeof input !== "object" || !("kind" in input) || input.kind !== "wait-resolve")
+        return input;
+    const call = state?.plan?.calls.find((item) => item.wait?.waitId === input.waitId);
+    if (!call)
+        throw new HarnessError("execution.invalid-input", "No pending wait matches waitId");
+    if (call.status === "interaction" && call.interaction) {
+        if (call.interaction.kind === "approval")
+            return {
+                kind: "approve",
+                interactionId: call.interaction.id,
+                approved: input.value !== false && input.value !== "false",
+            };
+        return {
+            kind: "respond",
+            interactionId: call.interaction.id,
+            value: input.value ?? null,
+        };
+    }
+    if (call.status === "deferred")
+        return {
+            kind: "settle",
+            invocationId: call.invocationId,
+            outcome: {
+                kind: "completed",
+                output: input.value ?? null,
+            },
+        };
+    throw new HarnessError("execution.invalid-input", "Wait is no longer pending");
+}

package/dist/sessions/store.d.ts

@@ -32,6 +32,7 @@ export interface SessionStore {
     get(agentId: string, sessionId: string): Promise<StoredSession | undefined>;
     put(agentId: string, sessionId: string, session: StoredSession): Promise<void>;
     list(agentId: string): Promise<readonly SessionSummary[]>;
+    delete?(agentId: string, sessionId: string): Promise<boolean>;
 }
 export interface ManagedSessionStore extends SessionStore {
     close(): Promise<void>;

package/dist/sessions/store.js

@@ -26,5 +26,8 @@ export function memorySessions() {
                 .map(sessionSummary)
                 .sort((a, b) => b.startedAt - a.startedAt);
         },
+        async delete(agentId, sessionId) {
+            return documents.delete(key(agentId, sessionId));
+        },
     };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nylorun/runtime",
-  "version": "0.5.0-beta",
-  "description": "Portable agent runtime, Hono protocol router, model providers, and the Nylorun CLI.",
+  "version": "0.6.0-beta",
+  "description": "SQLite agent execution host and model providers.",
   "type": "module",
   "license": "Apache-2.0",
   "repository": {
@@ -10,10 +10,7 @@
     "directory": "runtime"
   },
   "engines": {
-    "node": ">=22.19.0"
-  },
-  "bin": {
-    "nylorun": "dist/cli.js"
+    "node": ">=24.0.0"
   },
   "exports": {
     ".": {
@@ -23,6 +20,15 @@
     "./node": {
       "types": "./dist/node/index.d.ts",
       "import": "./dist/node/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/runtime.d.ts",
+      "import": "./dist/core/runtime.js"
+    },
+    "./server": "./dist/core/main.js",
+    "./configuration": {
+      "types": "./dist/configuration.d.ts",
+      "import": "./dist/configuration.js"
     }
   },
   "files": [
@@ -41,15 +47,14 @@
     "typecheck": "node ../scripts/check-typescript-version.mjs && tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "prepack": "npm run build",
-    "clean": "node -e \"import('node:fs').then(({rmSync})=>rmSync('dist',{recursive:true,force:true}))\""
+    "clean": "node -e \"import('node:fs').then(({rmSync})=>rmSync('dist',{recursive:true,force:true}))\"",
+    "start": "node dist/core/main.js"
   },
   "dependencies": {
     "@earendil-works/pi-ai": "0.85.1",
     "@hono/node-server": "^2.1.1",
-    "@nylorun/harness": "0.13.0-beta"
-  },
-  "peerDependencies": {
-    "hono": "^4.13.7"
+    "@nylorun/harness": "0.15.0-beta",
+    "@nylorun/core": "0.1.1-beta"
   },
   "devDependencies": {
     "@types/node": "^26.5.0",

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

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,33 +0,0 @@
-import { serve } from "@hono/node-server";
-import { resolve } from "node:path";
-import { pathToFileURL } from "node:url";
-import { installNodeModelFactory, installRuntimeLifecycle, } from "./model/defaults.js";
-import { piModel } from "./model/pi-model.js";
-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 shutdowns = new Set();
-    installRuntimeLifecycle((close) => shutdowns.add(close));
-    installNodeModelFactory((options) => piModel({ onPreview: options.onPreview, media: options.media }));
-    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);
-        void Promise.allSettled([...shutdowns].map((close) => close())).then(() => server.close());
-        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>;