@node-agent/local 0.0.0-stage → 0.1.0

package/dist/runtime/server.js

@@ -0,0 +1,336 @@
+// The runtime API: a small HTTP surface over the Runtime interface.
+//
+// The server owns no process table of its own; it forwards every request to the Runtime it was
+// constructed with. That keeps the transport (HTTP) separate from the policy (who may start what),
+// and lets one Runtime be used in-process by tests and out-of-process by a service entry.
+//
+// Authentication is a service bearer token. A runtime is not a public API: callers are a frontend
+// or a store, both of which already hold a service credential.
+import { createServer } from 'node:http';
+import { Link, Remote } from 'node-agent-bus';
+import { createHash } from 'node:crypto';
+import { timingSafeEqual } from 'node:crypto';
+import { RuntimeError, } from './base.js';
+function json(res, status, value) {
+    const body = JSON.stringify(value);
+    res.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': Buffer.byteLength(body),
+    });
+    res.end(body);
+}
+function equal(left, right) {
+    const a = Buffer.from(left);
+    const b = Buffer.from(right);
+    return a.length === b.length && timingSafeEqual(a, b);
+}
+async function bodyOf(req) {
+    const pieces = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const piece = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += piece.length;
+        if (size > 64 * 1024)
+            throw new RuntimeError('invalid_user', 'request body is too large');
+        pieces.push(piece);
+    }
+    if (size === 0)
+        return {};
+    try {
+        const parsed = JSON.parse(Buffer.concat(pieces).toString('utf8'));
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            throw new Error('body must be a JSON object');
+        return parsed;
+    }
+    catch (error) {
+        throw new RuntimeError('invalid_user', `invalid JSON body: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function text(value, field) {
+    if (typeof value !== 'string' || value.trim() === '')
+        throw new RuntimeError('invalid_user', `body.${field} must be a non-empty string`);
+    return value.trim();
+}
+function object(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function busView(handle) {
+    return {
+        kind: 'bus',
+        host: handle.host,
+        port: handle.port,
+        url: handle.url,
+        pid: handle.pid ?? null,
+        state: handle.state,
+    };
+}
+function nodeView(handle) {
+    return {
+        kind: 'node',
+        name: handle.name,
+        version: handle.version,
+        dir: handle.dir,
+        pid: handle.pid ?? null,
+        state: handle.state,
+    };
+}
+function statusOf(error) {
+    switch (error.code) {
+        case 'invalid_user':
+        case 'invalid_node':
+            return 400;
+        case 'bus_not_running':
+        case 'node_not_running':
+            return 404;
+        case 'spawn_failed':
+        case 'bus_start_failed':
+        case 'node_start_failed':
+            return 502;
+        default:
+            return 500;
+    }
+}
+/** The HTTP runtime service. `start()` binds; `stop()` releases the socket. */
+export class RuntimeServer {
+    runtime;
+    token;
+    host;
+    port;
+    logger;
+    server;
+    address;
+    constructor(options) {
+        if (options.token.trim() === '')
+            throw new RuntimeError('invalid_user', 'a runtime server needs a service token');
+        this.runtime = options.runtime;
+        this.token = options.token;
+        this.host = options.host ?? '127.0.0.1';
+        this.port = options.port ?? 0;
+        this.logger = options.logger;
+    }
+    get url() {
+        return this.address?.url;
+    }
+    async start() {
+        if (this.server !== undefined)
+            return this.address;
+        const server = createServer((req, res) => {
+            void this.handle(req, res);
+        });
+        server.on('upgrade', (req, socket, head) => {
+            void this.upgrade(req, socket, head);
+        });
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(this.port, this.host, () => {
+                server.off('error', reject);
+                resolve();
+            });
+        });
+        const address = server.address();
+        const port = typeof address === 'object' && address !== null ? address.port : this.port;
+        this.server = server;
+        this.address = { host: this.host, port, url: `http://${this.host}:${port}` };
+        this.logger?.info(`runtime api: ${this.address.url}`);
+        return this.address;
+    }
+    async stop() {
+        const server = this.server;
+        if (server === undefined)
+            return;
+        await new Promise((resolve) => server.close(() => resolve()));
+        this.server = undefined;
+        this.address = undefined;
+    }
+    authorized(req) {
+        const header = req.headers.authorization ?? '';
+        const prefix = 'Bearer ';
+        return header.startsWith(prefix) && equal(header.slice(prefix.length), this.token);
+    }
+    stackNodes() {
+        const raw = process.env.NODE_AGENT_RUNTIME_NODES ??
+            'history,agent,system,provider,notes,todo,timer,search,webui';
+        return raw
+            .split(',')
+            .map((one) => one.trim())
+            .filter((one) => one !== '');
+    }
+    /** A private WebSocket door onto the one shared bus. */
+    async upgrade(req, socket, head) {
+        const url = new URL(req.url ?? '/', 'http://runtime.local');
+        const match = /^\/bus\/([^/]+)$/.exec(url.pathname);
+        if (match === null || !this.authorized(req)) {
+            socket.destroy();
+            return;
+        }
+        const user = decodeURIComponent(match[1]);
+        const session = (await this.runtime.sessions(user));
+        if ((session.agents ?? []).length === 0) {
+            socket.destroy();
+            return;
+        }
+        const target = this.runtime.busTarget?.();
+        if (target === undefined) {
+            socket.destroy();
+            return;
+        }
+        const key = req.headers['sec-websocket-key'];
+        if (typeof key !== 'string' || key === '') {
+            socket.destroy();
+            return;
+        }
+        const accept = createHash('sha1')
+            .update(`${key}258EAFA5-E914-47DA-95CA-C5AB0DC85B11`)
+            .digest('base64');
+        socket.write('HTTP/1.1 101 Switching Protocols\r\n' +
+            'Upgrade: websocket\r\n' +
+            'Connection: Upgrade\r\n' +
+            `Sec-WebSocket-Accept: ${accept}\r\n\r\n`);
+        const link = new Link(socket, head);
+        const dial = new URL(target.url);
+        dial.searchParams.set('token', target.token);
+        const remote = new Remote(target.url, dial.toString());
+        const pending = [];
+        remote.receive((frame) => link.send(JSON.stringify(frame)), () => link.close());
+        link.receive((frame) => {
+            const text = JSON.stringify(frame);
+            if (!remote.send(text))
+                pending.push(text);
+        }, () => remote.close());
+        remote.dial().then(() => {
+            for (const text of pending)
+                remote.send(text);
+            pending.length = 0;
+        }, (error) => {
+            this.logger?.warn(`bus proxy: ${error instanceof Error ? error.message : String(error)}`);
+            link.close();
+        });
+    }
+    async handle(req, res) {
+        try {
+            const url = new URL(req.url ?? '/', 'http://runtime.local');
+            const path = url.pathname;
+            if (req.method === 'GET' && path === '/healthz') {
+                json(res, 200, { ok: true, service: 'runtime' });
+                return;
+            }
+            if (!this.authorized(req)) {
+                res.setHeader('www-authenticate', 'Bearer');
+                json(res, 401, {
+                    error: 'missing or wrong service token',
+                    code: 'unauthorized',
+                });
+                return;
+            }
+            if (req.method === 'GET' && path === '/whoami') {
+                json(res, 200, { ok: true, service: 'runtime' });
+                return;
+            }
+            const body = req.method === 'POST' ? await bodyOf(req) : {};
+            // User lifecycle. A user is the persistent boundary; destroying it removes only that home
+            // and that user's node table, never the shared bus or its processes.
+            if (req.method === 'POST' && (path === '/users/create' || path === '/create_user')) {
+                const user = text(body.user, 'user');
+                const handle = await this.runtime.createUser(user);
+                json(res, 201, { user: handle.user, home: handle.home, state: handle.state });
+                return;
+            }
+            if (req.method === 'POST' && (path === '/users/destroy' || path === '/destroy_user')) {
+                const user = text(body.user, 'user');
+                await this.runtime.destroyUser(user);
+                json(res, 200, { ok: true, user });
+                return;
+            }
+            // Bus lifecycle. One bus, shared nodes; a user is only a connection.
+            if (req.method === 'POST' && path === '/bus/launch') {
+                const handle = await this.runtime.launchBus(object(body.options));
+                json(res, 201, busView(handle));
+                return;
+            }
+            if (req.method === 'POST' && path === '/bus/stop') {
+                await this.runtime.stopBus();
+                json(res, 200, { ok: true });
+                return;
+            }
+            if (req.method === 'POST' && path === '/agents/create') {
+                const user = text(body.user, 'user');
+                const name = typeof body.name === 'string' && body.name.trim() !== '' ? body.name.trim() : user;
+                await this.runtime.createUser(user);
+                await this.runtime.launchBus();
+                for (const ref of this.stackNodes()) {
+                    const node = await this.runtime.launchNode(ref);
+                    await this.runtime.connect(user, node.name);
+                }
+                json(res, 200, { user, name, state: 'running' });
+                return;
+            }
+            if (req.method === 'POST' && path === '/agents/stop') {
+                const user = text(body.user, 'user');
+                const session = (await this.runtime.sessions(user));
+                for (const node of session.nodes ?? []) {
+                    if (typeof node.name === 'string')
+                        await this.runtime.disconnect(user, node.name);
+                }
+                json(res, 200, { user, stopped: true });
+                return;
+            }
+            // Node lifecycle.
+            if (req.method === 'POST' && path === '/node/launch') {
+                const node = text(body.node, 'node');
+                const handle = await this.runtime.launchNode(node, object(body.options));
+                json(res, 201, nodeView(handle));
+                return;
+            }
+            if (req.method === 'POST' && path === '/node/stop') {
+                const node = text(body.node, 'node');
+                await this.runtime.stopNode(node);
+                json(res, 200, { ok: true, node });
+                return;
+            }
+            // The composed operations.
+            if (req.method === 'POST' && (path === '/connect' || path === '/nodes/connect')) {
+                const user = text(body.user, 'user');
+                const node = text(body.node ?? body.name, 'name');
+                const handle = await this.runtime.connect(user, node, object(body.options));
+                json(res, 200, {
+                    user,
+                    name: handle.name,
+                    version: handle.version,
+                    started: false,
+                    running: handle.state === 'running',
+                    session: handle.name,
+                    dir: handle.dir,
+                    pid: handle.pid ?? null,
+                });
+                return;
+            }
+            if (req.method === 'POST' && (path === '/disconnect' || path === '/nodes/disconnect')) {
+                const user = text(body.user, 'user');
+                const node = text(body.node ?? body.name, 'name');
+                await this.runtime.disconnect(user, node);
+                json(res, 200, { ok: true, user, name: node, stopped: true });
+                return;
+            }
+            if (req.method === 'GET' && path === '/sessions') {
+                const asked = (url.searchParams.get('user') ?? '').trim();
+                json(res, 200, await this.runtime.sessions(asked === '' ? undefined : asked));
+                return;
+            }
+            json(res, 404, {
+                error: `no route: ${req.method ?? '?'} ${path}`,
+                code: 'not_found',
+            });
+        }
+        catch (error) {
+            if (error instanceof RuntimeError) {
+                json(res, statusOf(error), { error: error.message, code: error.code });
+                return;
+            }
+            this.logger?.error(`runtime api: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}`);
+            json(res, 500, { error: 'runtime request failed', code: 'internal' });
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/runtime/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/serve.d.ts

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

package/dist/serve.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+// node-agent: the headless core as a process — one runtime, one shared bus, every node on it.
+//
+// The order is deliberate:
+//
+//   1. runtime starts and binds the bus
+//   2. core and optional nodes start and register with that bus (global, not per user)
+//   3. the deployment's user is created
+//   4. that user is connected to the nodes this process started
+//
+// A node is a package root with `dist/serve.js`; the runtime starts it as a worker and waits for its manifest to
+// appear in the global registry. `NODE_AGENT_NODES` names extra package roots (comma separated);
+// `NODE_AGENT_USER` names the deployment user. Core nodes are connected to a private runtime service
+// user while they start, so system can call history before the deployment user exists.
+//
+//   NODE_AGENT_NODES=node-agent-webui node-agent
+//
+// NODE_AGENT_ACCESS_TOKEN puts the optional proxy in front of the page (src/proxy.ts): one token, one
+// login page, /bus and /events piped through. Unset, nothing is added and no port is opened.
+//
+// Stopping is SIGINT / SIGTERM, and nothing else.
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { SERVICE_TENANT, privateNodeToken } from 'node-agent-bus';
+import { busArgsOrExit } from './index.js';
+import { LocalRuntime } from './local.js';
+import { startProxy } from './proxy.js';
+const ARGS = busArgsOrExit('node-agent', { ownsBus: true });
+const PORT = ARGS.bind?.port ?? Number(process.env.NODE_AGENT_BUS_PORT ?? 0);
+const BIND = ARGS.bind?.host ?? process.env.NODE_AGENT_BUS_BIND ?? '127.0.0.1';
+// No store node here: this is the personal build, whose third-party nodes dial the local bus
+// themselves (`npx @node-agent/sdk .`) instead of being published and connected through a store.
+/** The package that runs the stack's setup once, after everything else is up. */
+const INTRODUCE = 'node-agent-introduce';
+const DEFAULT_NODES = 'node-agent-provider,node-agent-webui,node-agent-notes,node-agent-todo,node-agent-timer,node-agent-search,node-agent-introduce';
+const SIBLINGS = {
+    'node-agent-provider': {
+        env: 'NODE_AGENT_PROVIDER_ROOT',
+        fallback: '../../nodes/provider',
+    },
+};
+function specsFrom(value) {
+    const text = value.trim();
+    if (text === '')
+        return [];
+    return text.split(',').map((item) => {
+        const module = item.split(':')[0]?.trim() ?? '';
+        if (module === '')
+            throw new Error(`NODE_AGENT_NODES item "${item.trim()}" names no module`);
+        return { module };
+    });
+}
+function untilStopped() {
+    return new Promise((resolve) => {
+        process.once('SIGINT', () => resolve());
+        process.once('SIGTERM', () => resolve());
+    });
+}
+/** Resolve a node package to its root: env override, installed package, then a sibling checkout. */
+function rootOf(moduleName) {
+    const override = SIBLINGS[moduleName];
+    const configured = override === undefined ? undefined : process.env[override.env]?.trim();
+    if (configured)
+        return configured;
+    // The published launcher installs every core node as a dependency. Resolve the package first;
+    // the sibling path below is only for a source checkout that has not run npm install yet.
+    try {
+        const require = createRequire(import.meta.url);
+        let root = dirname(require.resolve(moduleName));
+        while (!existsSync(join(root, 'package.json')))
+            root = dirname(root);
+        return root;
+    }
+    catch {
+        const short = moduleName.startsWith('@')
+            ? (moduleName.split('/')[1] ?? moduleName)
+            : moduleName.replace(/^node-agent-/, '');
+        const local = fileURLToPath(new URL(`../../nodes/${short}`, import.meta.url));
+        if (existsSync(join(local, 'package.json')))
+            return local;
+        throw new Error(`cannot resolve Node package ${moduleName}`);
+    }
+}
+/** NODE_AGENT_PROXY_*: loopback HTTP by default, because the browser is normally on this host. */
+function proxyOptions(env, token, upstream) {
+    const bind = env.NODE_AGENT_PROXY_BIND?.trim() || '127.0.0.1';
+    const port = Number(env.NODE_AGENT_PROXY_PORT ?? 8080);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error(`NODE_AGENT_PROXY_PORT "${env.NODE_AGENT_PROXY_PORT}" is not a port`);
+    }
+    // Opt-in and off by default: a login over plain loopback HTTP must still be able to set a cookie.
+    const secure = env.NODE_AGENT_PROXY_SECURE === '1';
+    return { token, upstream, bind, port, secure };
+}
+async function main() {
+    let specs;
+    try {
+        specs = specsFrom(process.env.NODE_AGENT_NODES ?? DEFAULT_NODES);
+    }
+    catch (e) {
+        console.error(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+    const runtime = new LocalRuntime({
+        host: BIND,
+        basePort: PORT,
+        token: ARGS.token,
+        logger: console,
+    });
+    // 1. Runtime: bind the one bus every node and every user shares.
+    let bus;
+    try {
+        bus = await runtime.launchBus({ host: BIND, port: PORT, token: ARGS.token });
+    }
+    catch (e) {
+        console.error(`runtime failed to start (port ${PORT}): ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(1);
+    }
+    const names = [];
+    const userId = process.env.NODE_AGENT_USER?.trim() || 'default';
+    const userTenant = runtime.busUser(userId);
+    // The page advertises this, never the shared bus token: a node that presents it registers
+    // privately in this user's space and therefore appears in this user's UI.
+    const joinToken = privateNodeToken(bus.token, userTenant);
+    try {
+        // 2. Nodes: start and register globally. The service user is connected as each one arrives so
+        // core nodes can call each other during their own startup.
+        const core = ['node-agent-history', 'node-agent-agent', 'node-agent-system'].map(rootOf);
+        const roots = [
+            ...core,
+            ...specs.filter((spec) => spec.module !== INTRODUCE).map((spec) => rootOf(spec.module)),
+        ];
+        for (const root of roots) {
+            // NODE_AGENT_USER_TENANT is the deployment user's bus id: a node that has to speak as that
+            // user before anyone has called it (introduce seeds the user's transcript) needs the identity the
+            // caller would otherwise hand it.
+            const handle = await runtime.launchNode(root, {
+                dir: root,
+                env: { NODE_AGENT_USER_TENANT: userTenant, NODE_AGENT_JOIN_TOKEN: joinToken },
+            });
+            names.push(handle.name);
+            runtime.bus?.user(SERVICE_TENANT, true)?.connect(handle.name);
+        }
+        // 3. The deployment user exists only after the shared nodes do.
+        await runtime.createUser(userId);
+        // 4. Then grant that user every node this process started.
+        for (const name of names)
+            await runtime.connect(userId, name);
+        // 5. Last, start the node that owns the page. Its setup is the page's to run: the reader picks
+        //    a language there, and the node files the stack's first documents then. Nothing at startup
+        //    calls it -- a stack that is never visited stays uninitialized, and says so on its page.
+        for (const spec of specs.filter((one) => one.module === INTRODUCE)) {
+            const root = rootOf(spec.module);
+            const handle = await runtime.launchNode(root, {
+                dir: root,
+                env: { NODE_AGENT_USER_TENANT: userTenant, NODE_AGENT_JOIN_TOKEN: joinToken },
+            });
+            names.push(handle.name);
+            await runtime.connect(userId, handle.name);
+        }
+    }
+    catch (e) {
+        await runtime.stopAll();
+        console.error(`node-agent failed to come up: ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(1);
+    }
+    console.log(`bus: ${BIND}:${bus.port}`);
+    console.log(`nodes: ${names.join(', ')}`);
+    const user = runtime.bus?.user(runtime.busUser(userId));
+    console.log(`user: ${userId} -> ${[...(user?.nodes ?? [])].join(', ')}`);
+    // The webui prints the address it actually bound (port 0 gets a real port), so surface that line
+    // once it has had a moment to flush, without duplicating every node's log.
+    let webui;
+    if (names.includes('webui')) {
+        for (let attempt = 0; attempt < 40; attempt += 1) {
+            const match = runtime.nodeOutput('webui')?.match(/webui: (http:\/\/\S+)/);
+            if (match !== null && match !== undefined) {
+                webui = match[1];
+                console.log(`webui: ${webui}`);
+                break;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+    }
+    // The optional door. NODE_AGENT_ACCESS_TOKEN is the switch: unset, none of the below runs, no port
+    // is opened, and the lines above are the whole output exactly as before. It is deliberately not
+    // NODE_AGENT_TOKEN: that one is the bus credential and never leaves this host.
+    let proxy;
+    const accessToken = (process.env.NODE_AGENT_ACCESS_TOKEN ?? '').trim();
+    if (accessToken !== '') {
+        if (webui === undefined) {
+            console.error('proxy not started: the webui never printed its address');
+            process.exitCode = 1;
+        }
+        else {
+            try {
+                proxy = await startProxy(proxyOptions(process.env, accessToken, webui));
+                console.log(`proxy: ${proxy.url}`);
+            }
+            catch (e) {
+                console.error(`proxy failed to start: ${e instanceof Error ? e.message : String(e)}`);
+                process.exitCode = 1;
+            }
+        }
+    }
+    const connectUrl = proxy?.url ?? webui;
+    console.log('Ready to connect');
+    if (connectUrl === undefined) {
+        console.log('connect: no web UI enabled');
+    }
+    else {
+        console.log(`connect: ${connectUrl}`);
+    }
+    await untilStopped();
+    await proxy?.close();
+    await runtime.stopBus();
+}
+await main();
+process.exit(process.exitCode ?? 0);
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"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"}