@cogitator-ai/studio 0.1.0

package/dist/server/host-manager.js

@@ -0,0 +1,267 @@
+import { fork } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { existsSync, watch } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join, relative, sep } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+/** Files whose change reloads the project. */
+const WATCHED_ROOT_FILES = new Set(['cogitator.yml', '.env', 'package.json', 'tsconfig.json']);
+const IGNORED_DIRS = new Set([
+    'node_modules',
+    '.cogitator',
+    'dist',
+    '.git',
+    '.next',
+    'coverage',
+    'data',
+]);
+const DEBOUNCE_MS = 250;
+/** Whether a change of `path` (relative to the project) should reload it. */
+export function reloadsProject(path) {
+    const parts = path.split(sep).join('/').split('/');
+    if (parts.some((part) => IGNORED_DIRS.has(part)))
+        return false;
+    if (parts.length === 1)
+        return WATCHED_ROOT_FILES.has(parts[0]);
+    return parts[0] === 'src' || parts[0] === 'app' || parts[0] === 'lib';
+}
+function tsxLoader(projectDir) {
+    for (const base of [join(projectDir, 'package.json'), import.meta.url]) {
+        try {
+            return pathToFileURL(createRequire(base).resolve('tsx')).href;
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error('Cogitator Studio loads the project with tsx, which is not installed: add it with "npm install -D tsx"');
+}
+function hostEntry() {
+    const compiled = fileURLToPath(new URL('../host/main.js', import.meta.url));
+    return existsSync(compiled)
+        ? compiled
+        : fileURLToPath(new URL('../host/main.ts', import.meta.url));
+}
+/**
+ * Keeps the runtime host running for the studio: starts it, sends it
+ * requests, and starts it again when the project changes, so the studio
+ * process and the browser stay while the code reloads.
+ */
+export class HostManager {
+    options;
+    child;
+    status = { state: 'starting' };
+    pending = new Map();
+    waiters = [];
+    watcher;
+    debounce;
+    closed = false;
+    generation = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    get current() {
+        return this.status;
+    }
+    start() {
+        this.spawn();
+        if (this.options.watch !== false)
+            this.watchProject();
+    }
+    setStatus(status) {
+        this.status = status;
+        this.options.onStatus(status);
+        if (status.state === 'ready') {
+            for (const waiter of this.waiters.splice(0))
+                waiter.resolve();
+        }
+        else if (status.state === 'failed') {
+            for (const waiter of this.waiters.splice(0))
+                waiter.reject(new Error(status.error));
+        }
+    }
+    spawn() {
+        const generation = ++this.generation;
+        let loader;
+        try {
+            loader = tsxLoader(this.options.projectDir);
+        }
+        catch (error) {
+            this.setStatus({
+                state: 'failed',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+        this.setStatus({ state: 'starting' });
+        const child = fork(hostEntry(), [this.options.projectDir, this.options.studioDir], {
+            cwd: this.options.projectDir,
+            execArgv: ['--import', loader, '--enable-source-maps'],
+            stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
+            env: { ...process.env, COGITATOR_STUDIO: '1' },
+        });
+        this.child = child;
+        let stderrTail = '';
+        const relay = (stream) => (chunk) => {
+            const text = chunk.toString();
+            if (stream === 'stderr')
+                stderrTail = (stderrTail + text).slice(-4000);
+            for (const line of text.split('\n'))
+                if (line.trim())
+                    this.options.onOutput?.(line, stream);
+        };
+        child.stdout?.on('data', relay('stdout'));
+        child.stderr?.on('data', relay('stderr'));
+        const timer = setTimeout(() => {
+            if (generation !== this.generation || this.status.state !== 'starting')
+                return;
+            child.kill('SIGKILL');
+            this.setStatus({
+                state: 'failed',
+                error: `The project took longer than ${(this.options.loadTimeoutMs ?? 60_000) / 1000} s to load`,
+            });
+        }, this.options.loadTimeoutMs ?? 60_000);
+        timer.unref();
+        child.on('message', (message) => {
+            if (generation !== this.generation)
+                return;
+            switch (message.type) {
+                case 'ready':
+                    clearTimeout(timer);
+                    this.setStatus({
+                        state: 'ready',
+                        registry: message.registry,
+                        memory: message.memory,
+                        loadedAt: Date.now(),
+                    });
+                    break;
+                case 'load-failed':
+                    clearTimeout(timer);
+                    this.setStatus({ state: 'failed', error: message.error });
+                    break;
+                case 'event':
+                    this.options.onEvent(message.event);
+                    break;
+                case 'response': {
+                    const pending = this.pending.get(message.requestId);
+                    if (!pending)
+                        break;
+                    this.pending.delete(message.requestId);
+                    if (message.ok)
+                        pending.resolve(message.data);
+                    else
+                        pending.reject(new Error(message.error));
+                    break;
+                }
+            }
+        });
+        child.on('exit', (code, signal) => {
+            clearTimeout(timer);
+            if (generation !== this.generation)
+                return;
+            this.failPending('The project process stopped');
+            this.options.onLost('The project process stopped during the run');
+            if (this.closed)
+                return;
+            if (this.status.state === 'failed')
+                return;
+            const tail = stderrTail.trim().split('\n').slice(-12).join('\n');
+            this.setStatus({
+                state: 'failed',
+                error: `The project process exited (${signal ?? `code ${code}`})${tail ? `:\n${tail}` : ''}`,
+            });
+        });
+    }
+    failPending(reason) {
+        for (const pending of this.pending.values())
+            pending.reject(new Error(reason));
+        this.pending.clear();
+    }
+    stopChild() {
+        const child = this.child;
+        this.child = undefined;
+        if (child?.exitCode !== null || child.signalCode !== null)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const kill = setTimeout(() => child.kill('SIGKILL'), 3_000);
+            child.once('exit', () => {
+                clearTimeout(kill);
+                resolve();
+            });
+            child.kill('SIGTERM');
+        });
+    }
+    /** Starts the host again, with the project as it is now. */
+    async restart(reason) {
+        if (this.closed)
+            return;
+        this.generation++;
+        this.setStatus({ state: 'restarting', reason });
+        this.failPending(`The project reloaded: ${reason}`);
+        this.options.onLost(`The project reloaded during the run (${reason})`);
+        await this.stopChild();
+        if (!this.closed)
+            this.spawn();
+    }
+    watchProject() {
+        try {
+            this.watcher = watch(this.options.projectDir, { recursive: true }, (_event, file) => {
+                if (!file)
+                    return;
+                const path = relative(this.options.projectDir, join(this.options.projectDir, file.toString()));
+                if (!reloadsProject(path))
+                    return;
+                clearTimeout(this.debounce);
+                this.debounce = setTimeout(() => void this.restart(`${path} changed`), DEBOUNCE_MS);
+            });
+        }
+        catch (error) {
+            this.options.onOutput?.(`Cannot watch the project, reload by restarting cogitator dev: ${error instanceof Error ? error.message : String(error)}`, 'stderr');
+        }
+    }
+    /** Resolves once the project is loaded; rejects when it failed to load. */
+    ready(timeoutMs = 90_000) {
+        if (this.status.state === 'ready')
+            return Promise.resolve();
+        if (this.status.state === 'failed')
+            return Promise.reject(new Error(this.status.error));
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error('The project is still loading')), timeoutMs);
+            this.waiters.push({
+                resolve: () => {
+                    clearTimeout(timer);
+                    resolve();
+                },
+                reject: (error) => {
+                    clearTimeout(timer);
+                    reject(error);
+                },
+            });
+        });
+    }
+    /** Sends a request to the host once the project is loaded. */
+    async request(request) {
+        await this.ready();
+        const child = this.child;
+        if (!child?.connected)
+            throw new Error('The project process is not running');
+        const requestId = randomUUID();
+        return new Promise((resolve, reject) => {
+            this.pending.set(requestId, { resolve: (data) => resolve(data), reject });
+            child.send({ ...request, requestId }, (error) => {
+                if (!error)
+                    return;
+                this.pending.delete(requestId);
+                reject(error);
+            });
+        });
+    }
+    async close() {
+        this.closed = true;
+        clearTimeout(this.debounce);
+        this.watcher?.close();
+        this.failPending('Cogitator Studio is closing');
+        await this.stopChild();
+    }
+}
+//# sourceMappingURL=host-manager.js.map

package/dist/server/host-manager.js.map

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

package/dist/server/server.d.ts

@@ -0,0 +1,41 @@
+import type { HostStatus } from '../protocol.js';
+import { StudioStore, type Pricer } from './store.js';
+export interface StudioOptions {
+    projectDir: string;
+    /** Interface to listen on, `127.0.0.1` unless the studio should be reachable from other machines. */
+    host?: string;
+    /** Port to listen on (default 4321); the next free one is taken when it is busy, unless `strictPort`. */
+    port?: number;
+    strictPort?: boolean;
+    /**
+     * Token every request must carry when the studio listens beyond loopback.
+     * A random one is made when it is not given.
+     */
+    token?: string;
+    /** Reload the project when its files change (default `true`). */
+    watch?: boolean;
+    /** Where the history lives, `.cogitator/studio` in the project by default. */
+    studioDir?: string;
+    /** Output of the project's code and studio notices. */
+    log?: (line: string, stream: 'stdout' | 'stderr') => void;
+    /** Prices model calls; the model registry by default. */
+    price?: Pricer;
+}
+export interface StudioHandle {
+    url: string;
+    port: number;
+    /** The token in `url`, when the studio listens beyond loopback. */
+    token?: string;
+    store: StudioStore;
+    hostStatus(): HostStatus;
+    /** Resolves once the project is loaded, rejects when it failed. */
+    ready(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Starts Cogitator Studio for the project in `projectDir`: the runtime host
+ * that runs the project, and the web app to chat with its agents, read
+ * traces and costs, approve tool calls, run workflows and fork runs.
+ */
+export declare function startStudio(options: StudioOptions): Promise<StudioHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,UAAU,EAAwC,MAAM,gBAAgB,CAAC;AAEpG,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yGAAyG;IACzG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAC1D,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,IAAI,UAAU,CAAC;IACzB,mEAAmE;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAiHD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoV/E"}