@dxo/studio 0.0.0 → 0.0.9

package/README.md

@@ -1,3 +1,7 @@
 # @dxo/studio
 
-Placeholder package (0.0.0). Reserved for the DXO project.
+**Placeholder — developer preview, API unstable.**
+
+Future VMZ workbench for runs, system metrics, artifacts, model graphs, profiler, and UI playground. This package currently only wires protocol package versions; it does **not** listen on a port yet.
+
+Default future bind: loopback only. Remote deploy requires explicit auth (see Living design).

package/dist/api-server.d.ts

@@ -0,0 +1,17 @@
+import { type Server } from 'node:http';
+export type InspectApiServerOptions = {
+    host?: string;
+    port?: number;
+    runsRoot?: string;
+};
+export type InspectApiServer = {
+    host: string;
+    port: number;
+    url: string;
+    runsRoot: string;
+    server: Server;
+    close: () => Promise<void>;
+};
+/** Loopback HTTP API over the append-only inspect run store. */
+export declare function createInspectApiServer(options?: InspectApiServerOptions): Promise<InspectApiServer>;
+//# sourceMappingURL=api-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-server.d.ts","sourceRoot":"","sources":["../src/api-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAKtD,MAAM,MAAM,uBAAuB,GAAG;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAmIF,gEAAgE;AAChE,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoC7G"}

package/dist/api-server.js

@@ -0,0 +1,147 @@
+import { readFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import path from 'node:path';
+import { defaultRunsRoot, listRuns, readEvents, readRunMeta } from '@dxo/inspect';
+function json(res, status, body) {
+    const text = JSON.stringify(body);
+    res.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': Buffer.byteLength(text),
+        'access-control-allow-origin': '*',
+    });
+    res.end(text);
+}
+function notFound(res) {
+    json(res, 404, { error: 'not_found' });
+}
+function parsePath(url) {
+    const u = new URL(url, 'http://127.0.0.1');
+    return { pathname: u.pathname, searchParams: u.searchParams };
+}
+function metricsFromEvents(events) {
+    const out = [];
+    for (const event of events) {
+        if (event.type === 'metric/scalar')
+            out.push(event.metric);
+    }
+    return out;
+}
+function artifactsFromEvents(events) {
+    const out = [];
+    for (const event of events) {
+        if (event.type === 'artifact/ref')
+            out.push(event.artifact);
+    }
+    return out;
+}
+async function handleRequest(req, res, runsRoot) {
+    if (req.method !== 'GET') {
+        json(res, 405, { error: 'method_not_allowed' });
+        return;
+    }
+    const { pathname } = parsePath(req.url ?? '/');
+    if (pathname === '/api/health') {
+        json(res, 200, { ok: true, service: 'dxo-studio-api' });
+        return;
+    }
+    if (pathname === '/api/runs') {
+        const runs = await listRuns(runsRoot);
+        json(res, 200, { runs });
+        return;
+    }
+    const runMatch = /^\/api\/runs\/([^/]+)(\/.*)?$/.exec(pathname);
+    if (!runMatch) {
+        notFound(res);
+        return;
+    }
+    const runId = decodeURIComponent(runMatch[1]);
+    const sub = runMatch[2] ?? '';
+    if (sub === '' || sub === '/meta') {
+        const meta = await readRunMeta(runsRoot, runId);
+        if (!meta) {
+            notFound(res);
+            return;
+        }
+        json(res, 200, { meta });
+        return;
+    }
+    if (sub === '/events') {
+        const events = await readEvents(runsRoot, runId);
+        json(res, 200, { runId, events });
+        return;
+    }
+    if (sub === '/metrics') {
+        const events = await readEvents(runsRoot, runId);
+        json(res, 200, { runId, metrics: metricsFromEvents(events) });
+        return;
+    }
+    if (sub === '/artifacts') {
+        const events = await readEvents(runsRoot, runId);
+        json(res, 200, { runId, artifacts: artifactsFromEvents(events) });
+        return;
+    }
+    if (sub === '/checkpoints') {
+        const events = await readEvents(runsRoot, runId);
+        const checkpoints = artifactsFromEvents(events).filter((a) => a.kind === 'checkpoint');
+        json(res, 200, { runId, checkpoints });
+        return;
+    }
+    if (sub === '/model-graph') {
+        const abs = path.join(runsRoot, runId, 'artifacts', 'model-graph.json');
+        try {
+            const body = await readFile(abs, 'utf8');
+            json(res, 200, { runId, graph: JSON.parse(body) });
+        }
+        catch {
+            notFound(res);
+        }
+        return;
+    }
+    const artifactMatch = /^\/artifacts\/(.+)$/.exec(sub);
+    if (artifactMatch) {
+        const rel = decodeURIComponent(artifactMatch[1]);
+        const abs = path.join(runsRoot, runId, rel);
+        try {
+            const body = await readFile(abs, 'utf8');
+            json(res, 200, { runId, path: rel, body });
+        }
+        catch {
+            notFound(res);
+        }
+        return;
+    }
+    notFound(res);
+}
+/** Loopback HTTP API over the append-only inspect run store. */
+export async function createInspectApiServer(options = {}) {
+    const host = options.host ?? '127.0.0.1';
+    const port = options.port ?? 0;
+    const runsRoot = options.runsRoot ?? defaultRunsRoot();
+    const server = createServer((req, res) => {
+        void handleRequest(req, res, runsRoot).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            json(res, 500, { error: 'internal_error', message });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, host, () => resolve());
+    });
+    const addr = server.address();
+    if (!addr || typeof addr === 'string') {
+        throw new Error('failed to bind inspect API server');
+    }
+    const boundPort = addr.port;
+    const url = `http://${host}:${boundPort}`;
+    return {
+        host,
+        port: boundPort,
+        url,
+        runsRoot,
+        server,
+        close: () => new Promise((resolve, reject) => {
+            server.close((err) => (err ? reject(err) : resolve()));
+        }),
+    };
+}
+//# sourceMappingURL=api-server.js.map

package/dist/api-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-server.js","sourceRoot":"","sources":["../src/api-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AACtD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAmB,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiBnG,SAAS,IAAI,CAAC,GAAuC,EAAE,MAAc,EAAE,IAAa;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;QAClB,cAAc,EAAE,iCAAiC;QACjD,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACzC,6BAA6B,EAAE,GAAG;KACrC,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,GAAuC;IACrD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC1B,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC3C,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAwB;IAC/C,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAwB;IACjD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,KAAK,UAAU,aAAa,CACxB,GAAwC,EACxC,GAAuC,EACvC,QAAgB;IAEhB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAChD,OAAO;IACX,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IAE/C,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACxD,OAAO;IACX,CAAC;IAED,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAiB,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzB,OAAO;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,+BAA+B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,QAAQ,CAAC,GAAG,CAAC,CAAC;QACd,OAAO;IACX,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE9B,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,QAAQ,CAAC,GAAG,CAAC,CAAC;YACd,OAAO;QACX,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzB,OAAO;IACX,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAClC,OAAO;IACX,CAAC;IAED,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9D,OAAO;IACX,CAAC;IAED,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO;IACX,CAAC;IAED,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QACvF,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QACvC,OAAO;IACX,CAAC;IAED,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACxE,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACL,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACX,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAE,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACL,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACX,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAAmC,EAAE;IAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC;IAEvD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,KAAK,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACjD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;IAC5B,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,SAAS,EAAE,CAAC;IAE1C,OAAO;QACH,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,GAAG;QACH,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CACR,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;KACT,CAAC;AACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createInspectApiServer, type InspectApiServer, type InspectApiServerOptions } from './api-server.js';
+export { createStudio, type StartStudioOptions, type StudioProcess, startStudio, studioVersion } from './start.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createInspectApiServer } from './api-server.js';
+export { createStudio, startStudio, studioVersion } from './start.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAuD,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,YAAY,EAA+C,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/start.d.ts

@@ -0,0 +1,24 @@
+import { type ChildProcess } from 'node:child_process';
+import { type InspectApiServer, type InspectApiServerOptions } from './api-server.js';
+export type StartStudioOptions = InspectApiServerOptions & {
+    /** Start the VMZ dev server for `projects/studio`. Default true. */
+    ui?: boolean;
+    /** VMZ dev port; 0 picks a free port when supported. */
+    uiPort?: number;
+};
+export type StudioProcess = InspectApiServer & {
+    ui?: ChildProcess;
+    closeAll: () => Promise<void>;
+};
+/**
+ * Start loopback inspect API and optionally the VMZ Studio dev app.
+ * Binds API to 127.0.0.1 by default.
+ */
+export declare function startStudio(options?: StartStudioOptions): Promise<StudioProcess>;
+/** @deprecated Use {@link startStudio}. */
+export declare function createStudio(options?: StartStudioOptions): {
+    kind: 'launcher';
+    options: StartStudioOptions;
+};
+export declare function studioVersion(): string;
+//# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAI9D,OAAO,EAA0B,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE9G,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GAAG;IACvD,oEAAoE;IACpE,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAC3C,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AA0BF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAsB1F;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,OAAO,GAAE,kBAAuB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAEhH;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/start.js

@@ -0,0 +1,58 @@
+import { spawn } from 'node:child_process';
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createInspectApiServer } from './api-server.js';
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const studioAppRoot = path.resolve(packageRoot, '../../studio');
+function spawnVmzDev(apiUrl, port) {
+    const env = {
+        ...process.env,
+        DXO_STUDIO_API: apiUrl,
+        ...(port ? { PORT: String(port), VMZ_PORT: String(port) } : {}),
+    };
+    const isWin = process.platform === 'win32';
+    const cmd = isWin ? 'pnpm.cmd' : 'pnpm';
+    return spawn(cmd, ['exec', 'vmz', 'dev', '.'], {
+        cwd: studioAppRoot,
+        env,
+        stdio: 'inherit',
+        shell: isWin,
+    });
+}
+async function writeStudioApiBootstrap(apiUrl) {
+    const out = path.join(studioAppRoot, 'public', 'dxo-studio-api.js');
+    await writeFile(out, `window.__DXO_STUDIO_API__=${JSON.stringify(apiUrl)};\n`, 'utf8');
+}
+/**
+ * Start loopback inspect API and optionally the VMZ Studio dev app.
+ * Binds API to 127.0.0.1 by default.
+ */
+export async function startStudio(options = {}) {
+    const api = await createInspectApiServer({
+        host: options.host ?? '127.0.0.1',
+        port: options.port ?? 4310,
+        runsRoot: options.runsRoot,
+    });
+    const uiEnabled = options.ui !== false;
+    let ui;
+    if (uiEnabled) {
+        await writeStudioApiBootstrap(api.url);
+        ui = spawnVmzDev(api.url, options.uiPort);
+    }
+    const closeAll = async () => {
+        if (ui && !ui.killed) {
+            ui.kill();
+        }
+        await api.close();
+    };
+    return { ...api, ui, closeAll };
+}
+/** @deprecated Use {@link startStudio}. */
+export function createStudio(options = {}) {
+    return { kind: 'launcher', options };
+}
+export function studioVersion() {
+    return 'dxo-studio@0.1.0-preview';
+}
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

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

package/package.json

@@ -1,10 +1,40 @@
 {
-  "name": "@dxo/studio",
-  "version": "0.0.0",
-  "description": "DXO placeholder — not for production use.",
-  "license": "MIT",
-  "private": false,
-  "files": [
-    "README.md"
-  ]
+    "name": "@dxo/studio",
+    "version": "0.0.9",
+    "type": "module",
+    "description": "DXO training / model workbench (VMZ app placeholder, API unstable)",
+    "license": "MIT OR Apache-2.0",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.json"
+    },
+    "dependencies": {
+        "@dxo/graph": "0.0.9",
+        "@dxo/inspect": "0.0.9"
+    },
+    "keywords": [
+        "dxo",
+        "studio",
+        "tensorboard",
+        "vmz",
+        "typescript"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ai4waifu/dxo-framework.git"
+    }
 }