@dxo/studio 0.0.9 → 0.0.11

package/README.md

@@ -1,7 +1,25 @@
 # @dxo/studio
 
-**Placeholder — developer preview, API unstable.**
+DXO training workbench (developer preview). **WebUI is VMZ** — not a separate Vue app.
 
-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.
+## Two entry points
 
-Default future bind: loopback only. Remote deploy requires explicit auth (see Living design).
+| Entry                | What it does                                               |
+|----------------------|------------------------------------------------------------|
+| **`dxo studio`**     | VMZ **watch serve** + Rust inspect API → **browser**       |
+| **`dxo-studio.exe`** | Tauri desktop GUI (embedded VMZ static build + native API) |
+
+| Layer       | Path                                                         |
+|-------------|--------------------------------------------------------------|
+| Rust API    | `projects/compilers/dxo-studio`                              |
+| Rust GUI    | `projects/compilers/dxo-studio-tauri` → **`dxo-studio.exe`** |
+| TS launcher | `launcher/` → `dist/`                                        |
+| VMZ WebUI   | package root (`src/*.vmz`, `vmz.config.ts`)                  |
+
+```bash
+pnpm exec dxo studio
+pnpm --filter @dxo/studio dev          # VMZ only
+pnpm --filter @dxo/studio build:ui     # static profile for Tauri embed
+
+cargo build -p dxo-studio-tauri --release   # → target/release/dxo-studio.exe
+```

package/designs/styles/studio.css

@@ -0,0 +1,208 @@
+.studio {
+    font-family: ui-sans-serif, system-ui, sans-serif;
+    max-width: 56rem;
+    margin: 0 auto;
+    padding: 1.5rem;
+    color: #122;
+    background: #f7f8f6;
+    min-height: 100vh;
+}
+
+.studio__header {
+    display: flex;
+    justify-content: space-between;
+    align-items: baseline;
+    margin-bottom: 1.5rem;
+    border-bottom: 1px solid #ccd;
+    padding-bottom: 0.75rem;
+}
+
+.studio__brand {
+    color: inherit;
+    text-decoration: none;
+    font-size: 1.25rem;
+}
+
+.studio__nav {
+    display: flex;
+    gap: 1rem;
+}
+
+.studio__nav a {
+    color: #345;
+    text-decoration: none;
+    font-size: 0.95rem;
+}
+
+.studio__nav a:hover {
+    text-decoration: underline;
+}
+
+.studio__btn {
+    margin-top: 0.75rem;
+    margin-right: 0.5rem;
+    padding: 0.4rem 0.9rem;
+    border: 1px solid #9ab;
+    border-radius: 0.35rem;
+    background: #dfe8e0;
+    cursor: pointer;
+    font-size: 0.9rem;
+}
+
+.studio__btn:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+}
+
+.studio__btn--ghost {
+    background: transparent;
+}
+
+.studio__pick-list label {
+    display: flex;
+    gap: 0.5rem;
+    align-items: center;
+    cursor: pointer;
+}
+
+.studio__matrix td,
+.studio__matrix th {
+    text-align: center;
+    min-width: 2.5rem;
+}
+
+.studio__cell--warm {
+    background: #e8f0dc;
+}
+
+.studio__cell--hot {
+    background: #c5ddb0;
+    font-weight: 600;
+}
+
+.studio__samples {
+    list-style: none;
+    padding: 0;
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(8rem, 1fr));
+    gap: 0.75rem;
+}
+
+.studio__samples li {
+    border: 1px solid #dde;
+    padding: 0.35rem;
+    display: flex;
+    flex-direction: column;
+    gap: 0.35rem;
+}
+
+.studio__samples img {
+    width: 100%;
+    height: auto;
+    display: block;
+    background: #eef1ee;
+}
+
+.studio__upload .studio__file {
+    display: flex;
+    flex-direction: column;
+    gap: 0.35rem;
+    margin: 1rem 0;
+    font-size: 0.9rem;
+}
+
+.studio__preview img {
+    max-width: 16rem;
+    margin-top: 0.75rem;
+    border: 1px solid #ccd;
+}
+
+.studio__compare {
+    margin-top: 1.5rem;
+}
+
+.studio__panel h1 {
+    font-size: 1.5rem;
+    margin: 0 0 0.5rem;
+}
+
+.studio__panel h2 {
+    font-size: 1.1rem;
+    margin: 1.5rem 0 0.5rem;
+}
+
+.studio__hint,
+.studio__status,
+.studio__meta {
+    color: #456;
+    font-size: 0.9rem;
+}
+
+.studio__list {
+    list-style: none;
+    padding: 0;
+    margin: 1rem 0;
+}
+
+.studio__list li {
+    padding: 0.5rem 0;
+    border-bottom: 1px solid #dde;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.75rem;
+    align-items: baseline;
+}
+
+.studio__list--compact li {
+    font-size: 0.85rem;
+    font-family: ui-monospace, monospace;
+}
+
+.studio__badge {
+    font-size: 0.75rem;
+    padding: 0.1rem 0.4rem;
+    border-radius: 0.25rem;
+    background: #dde8e0;
+}
+
+.studio__table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 0.9rem;
+}
+
+.studio__table th,
+.studio__table td {
+    text-align: left;
+    padding: 0.35rem 0.5rem;
+    border-bottom: 1px solid #dde;
+}
+
+.studio__pre {
+    background: #eef1ee;
+    padding: 0.75rem;
+    overflow: auto;
+    font-size: 0.8rem;
+    max-height: 24rem;
+}
+
+.studio__tabs {
+    display: flex;
+    gap: 0.35rem;
+    margin: 0.5rem 0 0.75rem;
+}
+
+.studio__tab {
+    border: 1px solid #ccd;
+    background: #f7f8f7;
+    color: #334;
+    padding: 0.35rem 0.7rem;
+    cursor: pointer;
+    font: inherit;
+}
+
+.studio__tab--active {
+    background: #2a4;
+    color: #fff;
+    border-color: #2a4;
+}

package/dist/api-server.d.ts

@@ -1,17 +1,15 @@
-import { type Server } from 'node:http';
-export type InspectApiServerOptions = {
-    host?: string;
-    port?: number;
-    runsRoot?: string;
-};
+import { type NativeInspectApiServerOptions } from '@dxo/core';
+export type InspectApiServerOptions = NativeInspectApiServerOptions;
 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. */
+/**
+ * Loopback inspect HTTP serve — thin TS wrapper over napi `create_inspect_api_server`.
+ * Do not reimplement the HTTP server or run-store reader in TypeScript.
+ */
 export declare function createInspectApiServer(options?: InspectApiServerOptions): Promise<InspectApiServer>;
 //# sourceMappingURL=api-server.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"api-server.d.ts","sourceRoot":"","sources":["../launcher/api-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0D,KAAK,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAEvH,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAEpE,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,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe7G"}

package/dist/api-server.js

@@ -1,147 +1,22 @@
-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. */
+import { createInspectApiServer as createNativeInspectApiServer } from '@dxo/core';
+/**
+ * Loopback inspect HTTP serve — thin TS wrapper over napi `create_inspect_api_server`.
+ * Do not reimplement the HTTP server or run-store reader in TypeScript.
+ */
 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 handle = createNativeInspectApiServer({
+        host: options.host,
+        port: options.port,
+        runsRoot: options.runsRoot,
     });
-    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()));
-        }),
+        host: handle.host,
+        port: handle.port,
+        url: handle.url,
+        runsRoot: handle.runsRoot,
+        close: async () => {
+            handle.close();
+        },
     };
 }
 //# sourceMappingURL=api-server.js.map

package/dist/api-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-server.js","sourceRoot":"","sources":["../src/api-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-server.js","sourceRoot":"","sources":["../launcher/api-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,IAAI,4BAA4B,EAAsC,MAAM,WAAW,CAAC;AAYvH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAAmC,EAAE;IAC9E,MAAM,MAAM,GAAG,4BAA4B,CAAC;QACxC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC7B,CAAC,CAAC;IACH,OAAO;QACH,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { createInspectApiServer, type InspectApiServer, type InspectApiServerOptions } from './api-server.js';
+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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../launcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

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

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../launcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,GAGzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAA+C,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/start.d.ts

@@ -1,18 +1,19 @@
 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;
+    /** Start VMZ watch serve for browser WebUI. Default true. */
+    webui?: boolean;
+    /** VMZ dev port; omit to auto-pick from 5173. */
+    webuiPort?: number;
 };
 export type StudioProcess = InspectApiServer & {
-    ui?: ChildProcess;
+    webui?: ChildProcess;
+    webuiUrl?: string;
     closeAll: () => Promise<void>;
 };
 /**
- * Start loopback inspect API and optionally the VMZ Studio dev app.
- * Binds API to 127.0.0.1 by default.
+ * `dxo studio`: Rust inspect API + VMZ watch serve → open in browser.
+ * Desktop GUI is `dxo-studio.exe` (Tauri), not this path.
  */
 export declare function startStudio(options?: StartStudioOptions): Promise<StudioProcess>;
 /** @deprecated Use {@link startStudio}. */

package/dist/start.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../launcher/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,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAC3C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AA6BF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2B1F;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

@@ -4,7 +4,6 @@ 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,
@@ -13,20 +12,24 @@ function spawnVmzDev(apiUrl, port) {
     };
     const isWin = process.platform === 'win32';
     const cmd = isWin ? 'pnpm.cmd' : 'pnpm';
-    return spawn(cmd, ['exec', 'vmz', 'dev', '.'], {
-        cwd: studioAppRoot,
+    const args = ['exec', 'vmz', 'dev', '.'];
+    if (port) {
+        args.push('--port', String(port));
+    }
+    return spawn(cmd, args, {
+        cwd: packageRoot,
         env,
         stdio: 'inherit',
         shell: isWin,
     });
 }
 async function writeStudioApiBootstrap(apiUrl) {
-    const out = path.join(studioAppRoot, 'public', 'dxo-studio-api.js');
+    const out = path.join(packageRoot, '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.
+ * `dxo studio`: Rust inspect API + VMZ watch serve → open in browser.
+ * Desktop GUI is `dxo-studio.exe` (Tauri), not this path.
  */
 export async function startStudio(options = {}) {
     const api = await createInspectApiServer({
@@ -34,19 +37,23 @@ export async function startStudio(options = {}) {
         port: options.port ?? 4310,
         runsRoot: options.runsRoot,
     });
-    const uiEnabled = options.ui !== false;
-    let ui;
-    if (uiEnabled) {
+    const webuiEnabled = options.webui !== false;
+    let webui;
+    let webuiUrl;
+    if (webuiEnabled) {
         await writeStudioApiBootstrap(api.url);
-        ui = spawnVmzDev(api.url, options.uiPort);
+        webui = spawnVmzDev(api.url, options.webuiPort);
+        webuiUrl = options.webuiPort
+            ? `http://127.0.0.1:${options.webuiPort}`
+            : 'http://127.0.0.1:5173 (VMZ default; check terminal if port differs)';
     }
     const closeAll = async () => {
-        if (ui && !ui.killed) {
-            ui.kill();
+        if (webui && !webui.killed) {
+            webui.kill();
         }
         await api.close();
     };
-    return { ...api, ui, closeAll };
+    return { ...api, webui, webuiUrl, closeAll };
 }
 /** @deprecated Use {@link startStudio}. */
 export function createStudio(options = {}) {

package/dist/start.js.map

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

package/package.json

@@ -1,9 +1,9 @@
 {
     "name": "@dxo/studio",
-    "version": "0.0.9",
+    "version": "0.0.11",
     "type": "module",
-    "description": "DXO training / model workbench (VMZ app placeholder, API unstable)",
-    "license": "MIT OR Apache-2.0",
+    "description": "DXO training workbench — VMZ WebUI + launcher; desktop GUI is dxo-studio.exe",
+    "license": "Apache-2.0",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
     "exports": {
@@ -14,27 +14,43 @@
     },
     "files": [
         "dist",
+        "src",
+        "public",
+        "designs",
+        "vmz.config.ts",
         "README.md"
     ],
     "scripts": {
-        "build": "tsc -p tsconfig.json"
+        "build": "tsc -p tsconfig.json",
+        "build:ui": "vmz build --release --profile static .",
+        "dev": "vmz dev .",
+        "check": "vmz check ."
     },
     "dependencies": {
-        "@dxo/graph": "0.0.9",
-        "@dxo/inspect": "0.0.9"
+        "@dxo/core": "0.0.11",
+        "@dxo/graph": "0.0.11",
+        "@dxo/inspect": "0.0.11",
+        "@vmz/core": "^0.1.12"
     },
     "keywords": [
         "dxo",
         "studio",
         "tensorboard",
         "vmz",
-        "typescript"
+        "tauri",
+        "typescript",
+        "deep-learning"
     ],
-    "publishConfig": {
-        "access": "public"
-    },
+    "homepage": "https://github.com/ai4waifu/dxo-framework#readme",
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/ai4waifu/dxo-framework.git"
+        "url": "https://github.com/ai4waifu/dxo-framework.git",
+        "directory": "projects/runtimes/dxo-studio"
+    },
+    "bugs": {
+        "url": "https://github.com/ai4waifu/dxo-framework/issues"
+    },
+    "publishConfig": {
+        "access": "public"
     }
 }

package/public/dxo-studio-api.js

@@ -0,0 +1,2 @@
+// Overwritten by `dxo studio` / Tauri shell with the bound loopback API URL.
+window.__DXO_STUDIO_API__ = 'http://127.0.0.1:4310';

package/src/Application.vmz

@@ -0,0 +1,8 @@
+<template>
+  <script src="/dxo-studio-api.js"></script>
+  <slot />
+</template>
+
+<script client>
+export default class Application {}
+</script>

package/src/lib/api.ts

@@ -0,0 +1,32 @@
+/** Default Studio API base (loopback). Override with window.__DXO_STUDIO_API__. */
+export function studioApiBase(): string {
+    const w = globalThis as typeof globalThis & { __DXO_STUDIO_API__?: string };
+    if (typeof w.__DXO_STUDIO_API__ === 'string' && w.__DXO_STUDIO_API__.length > 0) {
+        return w.__DXO_STUDIO_API__.replace(/\/$/, '');
+    }
+    return 'http://127.0.0.1:4310';
+}
+
+export async function apiGet<T>(path: string): Promise<T> {
+    const url = `${studioApiBase()}${path.startsWith('/') ? path : `/${path}`}`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Studio API ${res.status} for ${path}`);
+    }
+    return (await res.json()) as T;
+}
+
+/** Loopback URL for run artifact bytes (images, etc.). */
+export function fileUrl(runId: string, rel: string): string {
+    const encoded = rel.split('/').map(encodeURIComponent).join('/');
+    return `${studioApiBase()}/api/runs/${encodeURIComponent(runId)}/files/${encoded}`;
+}
+
+/** Default `@dxo/ui` model-app serve base for Playground. */
+export function modelAppBase(): string {
+    const w = globalThis as typeof globalThis & { __DXO_MODEL_APP__?: string };
+    if (typeof w.__DXO_MODEL_APP__ === 'string' && w.__DXO_MODEL_APP__.length > 0) {
+        return w.__DXO_MODEL_APP__.replace(/\/$/, '');
+    }
+    return 'http://127.0.0.1:7860';
+}

package/src/pages/compare.vmz

@@ -0,0 +1,117 @@
+<template>
+  <main class="studio">
+    <header class="studio__header">
+      <a class="studio__brand" href="/"><strong>DXO Studio</strong></a>
+      <nav class="studio__nav">
+        <a href="/">Runs</a>
+        <a href="/compare">Compare</a>
+        <a href="/playground">Playground</a>
+      </nav>
+    </header>
+
+    <section class="studio__panel">
+      <h1>Compare runs</h1>
+      <p class="studio__hint">Select two or more runs to overlay scalar metrics.</p>
+      <p class="studio__status">{status}</p>
+
+      <ul class="studio__list studio__pick-list">
+        <li each={runs} as="run" key={run.runId}>
+          <label>
+            <input type="checkbox" checked={isSelected(run.runId)} onChange={() => toggleRun(run.runId)} />
+            {runLabel(run)}
+            <span class="studio__badge">{run.meta.status}</span>
+          </label>
+        </li>
+      </ul>
+
+      <button class="studio__btn" onClick={loadCompare} disabled={selected.length < 2}>Compare</button>
+
+      <div class="studio__compare" if={compareRows.length > 0}>
+        <h2>Metric overlay</h2>
+        <table class="studio__table">
+          <thead>
+            <tr>
+              <th>run</th>
+              <th>metric</th>
+              <th>step</th>
+              <th>value</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr each={compareRows} as="row" key={row.key}>
+              <td>{row.runLabel}</td>
+              <td>{row.name}</td>
+              <td>{row.step}</td>
+              <td>{row.value}</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </section>
+  </main>
+</template>
+
+<script client>
+import { apiGet } from '../lib/api.ts';
+
+export default class ComparePage {
+    status = 'loading…';
+    runs = [];
+    selected = [];
+    compareRows = [];
+
+    runLabel(run) {
+        return run.meta?.label ?? run.runId;
+    }
+
+    isSelected(runId) {
+        return this.selected.includes(runId);
+    }
+
+    toggleRun(runId) {
+        if (this.selected.includes(runId)) {
+            this.selected = this.selected.filter((id) => id !== runId);
+        } else {
+            this.selected = [...this.selected, runId];
+        }
+    }
+
+    async onMount() {
+        try {
+            const data = await apiGet('/api/runs');
+            this.runs = data.runs ?? [];
+            this.selected = this.runs.slice(0, Math.min(2, this.runs.length)).map((r) => r.runId);
+            this.status = `${this.runs.length} run(s) available`;
+        } catch (err) {
+            this.status = err instanceof Error ? err.message : String(err);
+        }
+    }
+
+    async loadCompare() {
+        if (this.selected.length < 2) return;
+        this.status = 'loading compare…';
+        try {
+            const q = encodeURIComponent(this.selected.join(','));
+            const data = await apiGet(`/api/compare?runs=${q}`);
+            const rows = [];
+            for (const s of data.series ?? []) {
+                const label = s.meta?.label ?? s.runId;
+                for (const m of s.metrics ?? []) {
+                    rows.push({
+                        key: `${s.runId}:${m.name}:${m.step}`,
+                        runLabel: label,
+                        name: m.name,
+                        step: m.step ?? '—',
+                        value: Number(m.value).toFixed(6),
+                    });
+                }
+            }
+            this.compareRows = rows;
+            this.status = rows.length ? `${rows.length} metric point(s)` : 'no metrics in selected runs';
+        } catch (err) {
+            this.status = err instanceof Error ? err.message : String(err);
+            this.compareRows = [];
+        }
+    }
+}
+</script>

package/src/pages/index.vmz

@@ -0,0 +1,60 @@
+<template>
+  <main class="studio">
+    <header class="studio__header">
+      <a class="studio__brand" href="/"><strong>DXO Studio</strong></a>
+      <nav class="studio__nav">
+        <a href="/">Runs</a>
+        <a href="/compare">Compare</a>
+        <a href="/playground">Playground</a>
+      </nav>
+    </header>
+
+    <section class="studio__panel">
+      <h1>Runs</h1>
+      <p class="studio__hint">Append-only inspect store — refresh reloads history after the trainer exits.</p>
+      <p class="studio__status">{status}</p>
+      <ul class="studio__list">
+        <li each={runs} as="run" key={run.runId}>
+          <a href={`/runs/${run.runId}`}>{runLabel(run)}</a>
+          <span class="studio__badge">{run.meta.status}</span>
+          <span class="studio__meta">{formatTime(run.meta.startedAtMs)}</span>
+        </li>
+      </ul>
+    </section>
+  </main>
+</template>
+
+<script client>
+import { apiGet } from '../lib/api.ts';
+
+export default class RunsPage {
+    status = 'loading…';
+    runs = [];
+
+    runLabel(run) {
+        return run.meta?.label ?? run.runId;
+    }
+
+    formatTime(ms) {
+        try {
+            return new Date(ms).toLocaleString();
+        } catch {
+            return String(ms);
+        }
+    }
+
+    async onMount() {
+        try {
+            const data = await apiGet('/api/runs');
+            this.runs = data.runs ?? [];
+            this.status =
+                this.runs.length === 0
+                    ? 'No runs yet. Train with inspect RunRecorder, then refresh.'
+                    : `${this.runs.length} run(s)`;
+        } catch (err) {
+            this.status = err instanceof Error ? err.message : String(err);
+            this.runs = [];
+        }
+    }
+}
+</script>

package/src/pages/playground.vmz

@@ -0,0 +1,91 @@
+<template>
+  <main class="studio">
+    <header class="studio__header">
+      <a class="studio__brand" href="/"><strong>DXO Studio</strong></a>
+      <nav class="studio__nav">
+        <a href="/">Runs</a>
+        <a href="/compare">Compare</a>
+        <a href="/playground">Playground</a>
+      </nav>
+    </header>
+
+    <section class="studio__panel studio__upload">
+      <h1>Image playground</h1>
+      <p class="studio__hint">
+        Upload an image to a loopback `@dxo/ui` model app (`defineModelApp`). Start serve separately on {appBase}.
+      </p>
+      <p class="studio__status">{status}</p>
+
+      <label class="studio__file">
+        <span>Image file</span>
+        <input type="file" accept="image/*" onChange={onFile} />
+      </label>
+
+      <button class="studio__btn" onClick={predict} disabled={!file}>Predict</button>
+      <button class="studio__btn studio__btn--ghost" onClick={cancel} disabled={!busy}>Cancel</button>
+
+      <div if={previewUrl} class="studio__preview">
+        <img src={previewUrl} alt="upload preview" />
+      </div>
+
+      <pre class="studio__pre" if={resultText}>{resultText}</pre>
+    </section>
+  </main>
+</template>
+
+<script client>
+import { modelAppBase } from '../lib/api.ts';
+
+export default class PlaygroundPage {
+    status = 'ready';
+    appBase = modelAppBase();
+    file = null;
+    previewUrl = '';
+    resultText = '';
+    busy = false;
+    #controller = null;
+
+    onFile(e) {
+        const input = e.target;
+        const f = input?.files?.[0];
+        this.file = f ?? null;
+        if (this.previewUrl) URL.revokeObjectURL(this.previewUrl);
+        this.previewUrl = f ? URL.createObjectURL(f) : '';
+        this.resultText = '';
+    }
+
+    async predict() {
+        if (!this.file) return;
+        this.#controller?.abort();
+        this.#controller = new AbortController();
+        this.busy = true;
+        this.status = 'predicting…';
+        this.resultText = '';
+        try {
+            const form = new FormData();
+            form.append('image', this.file);
+            const res = await fetch(`${this.appBase}/run`, {
+                method: 'POST',
+                body: form,
+                signal: this.#controller.signal,
+            });
+            if (!res.ok) throw new Error(`model app ${res.status}`);
+            const body = await res.json();
+            this.resultText = JSON.stringify(body, null, 2);
+            this.status = 'done';
+        } catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                this.status = 'cancelled';
+            } else {
+                this.status = err instanceof Error ? err.message : String(err);
+            }
+        } finally {
+            this.busy = false;
+        }
+    }
+
+    cancel() {
+        this.#controller?.abort();
+    }
+}
+</script>

package/src/pages/runs/[id].vmz

@@ -0,0 +1,295 @@
+<template>
+  <main class="studio">
+    <header class="studio__header">
+      <a class="studio__brand" href="/"><strong>DXO Studio</strong></a>
+      <nav class="studio__nav">
+        <a href="/">Runs</a>
+        <a href="/compare">Compare</a>
+        <a href="/playground">Playground</a>
+      </nav>
+    </header>
+
+    <section class="studio__panel">
+      <h1>Run {runId}</h1>
+      <p class="studio__status">{status}</p>
+
+      <h2>Metrics</h2>
+      <table class="studio__table">
+        <thead>
+          <tr><th>name</th><th>step</th><th>value</th></tr>
+        </thead>
+        <tbody>
+          <tr each={metrics} as="m" key={metricKey(m)}>
+            <td>{m.name}</td>
+            <td>{m.step ?? '—'}</td>
+            <td>{formatValue(m.value)}</td>
+          </tr>
+        </tbody>
+      </table>
+
+      <h2>Confusion matrix</h2>
+      <p class="studio__hint" if={!hasMatrix}>No confusion-matrix artifact.</p>
+      <table class="studio__table studio__matrix" if={hasMatrix}>
+        <thead>
+          <tr>
+            <th></th>
+            <th each={matrixLabels} as="lbl" key={lbl}>{lbl}</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr each={matrixRows} as="row" key={row.label}>
+            <th>{row.label}</th>
+            <td each={row.cells} as="cell" key={cell.key} class={cellClass(cell.value)}>{cell.value}</td>
+          </tr>
+        </tbody>
+      </table>
+
+      <h2>Image samples</h2>
+      <p class="studio__hint" if={samples.length === 0}>No image-samples artifact.</p>
+      <ul class="studio__samples" if={samples.length > 0}>
+        <li each={samples} as="s" key={s.uri}>
+          <img src={s.src} alt={s.caption} />
+          <span class="studio__meta">{s.caption}</span>
+        </li>
+      </ul>
+
+      <h2>Training events</h2>
+      <ul class="studio__list studio__list--compact">
+        <li each={trainEvents} as="e" key={eventKey(e)}><code>{e.type}</code> {summarize(e)}</li>
+      </ul>
+
+      <h2>Checkpoints</h2>
+      <ul class="studio__list">
+        <li each={checkpoints} as="c" key={c.uri}><code>{c.name}</code> · {c.uri}</li>
+      </ul>
+
+      <h2>Models</h2>
+      <p class="studio__hint">Module · Execution · Kernel are separate views — never one merged architecture diagram.</p>
+      <div class="studio__tabs">
+        <button class={tabClass('module')} onClick={() => selectGraphTab('module')}>Module</button>
+        <button class={tabClass('execution')} onClick={() => selectGraphTab('execution')}>Execution</button>
+        <button class={tabClass('kernel')} onClick={() => selectGraphTab('kernel')}>Kernel</button>
+      </div>
+      <p class="studio__meta" if={graphAvailability}>{graphAvailability}</p>
+      <pre class="studio__pre">{graphText}</pre>
+
+      <h2>Profiler</h2>
+      <p class="studio__hint" if={!hasProfile}>{profileHint}</p>
+      <ul class="studio__list studio__list--compact" if={hasProfile}>
+        <li each={profileSpans} as="s" key={spanKey(s)}>
+          <code>{s.category}</code> {s.name} · {s.startMs}–{s.endMs} ms
+        </li>
+      </ul>
+    </section>
+  </main>
+</template>
+
+<script client>
+import { apiGet, fileUrl } from '../../lib/api.ts';
+
+export default class RunDetailPage {
+    runId = '';
+    status = 'loading…';
+    metrics = [];
+    trainEvents = [];
+    checkpoints = [];
+    graphTab = 'module';
+    graphBundle = null;
+    graphText = '(none)';
+    graphAvailability = '';
+    hasMatrix = false;
+    matrixLabels = [];
+    matrixRows = [];
+    samples = [];
+    hasProfile = false;
+    profileHint = 'No profile-trace artifact (Titan spans required; timeline is never fabricated).';
+    profileSpans = [];
+
+    metricKey(m) {
+        return `${m.name}:${m.step ?? ''}:${m.wallTimeMs ?? ''}`;
+    }
+
+    eventKey(e) {
+        return `${e.type}:${e.wallTimeMs ?? ''}:${e.step ?? ''}:${e.epoch ?? ''}`;
+    }
+
+    spanKey(s) {
+        return `${s.category}:${s.name}:${s.startMs}:${s.endMs}`;
+    }
+
+    tabClass(tab) {
+        return this.graphTab === tab ? 'studio__tab studio__tab--active' : 'studio__tab';
+    }
+
+    selectGraphTab(tab) {
+        this.graphTab = tab;
+        this.renderGraphTab();
+    }
+
+    renderGraphTab() {
+        const bundle = this.graphBundle;
+        if (!bundle) {
+            this.graphText = '(no model-graph artifact)';
+            this.graphAvailability = '';
+            return;
+        }
+        const g = bundle[this.graphTab] ?? bundle.module;
+        const avail = g.availability === 'unavailable'
+            ? `unavailable: ${g.unavailableReason ?? 'n/a'}`
+            : `view=${g.view} · nodes=${(g.nodes ?? []).length}`;
+        this.graphAvailability = avail;
+        this.graphText = JSON.stringify(g, null, 2);
+    }
+
+    formatValue(v) {
+        return Number(v).toFixed(6);
+    }
+
+    cellClass(v) {
+        const n = Number(v);
+        if (n >= 5) return 'studio__cell--hot';
+        if (n >= 2) return 'studio__cell--warm';
+        return '';
+    }
+
+    summarize(e) {
+        if (e.type === 'train/batch') return `epoch=${e.epoch} step=${e.step} loss=${e.loss}`;
+        if (e.type === 'train/epoch_end') return `epoch=${e.epoch} meanLoss=${e.meanLoss}`;
+        if (e.type === 'run/end') return `status=${e.status}`;
+        return '';
+    }
+
+    buildMatrix(data) {
+        const labels = data.labels ?? [];
+        const matrix = data.matrix ?? [];
+        this.matrixLabels = labels;
+        this.matrixRows = labels.map((label, i) => ({
+            label,
+            cells: (matrix[i] ?? []).map((value, j) => ({
+                key: `${i}:${j}`,
+                value,
+            })),
+        }));
+        this.hasMatrix = labels.length > 0;
+    }
+
+    buildSamples(data) {
+        const list = data.samples ?? [];
+        this.samples = list.map((s) => {
+            const parts = [];
+            if (s.label !== undefined) parts.push(`label=${s.label}`);
+            if (s.pred !== undefined) parts.push(`pred=${s.pred}`);
+            return {
+                uri: s.uri,
+                src: fileUrl(this.runId, s.uri),
+                caption: parts.join(' · ') || s.uri,
+            };
+        });
+    }
+
+    normalizeGraphArtifact(raw) {
+        if (!raw || typeof raw !== 'object') return null;
+        if (raw.format === 'dxo-model-graph-bundle') return raw;
+        if (raw.format === 'dxo-model-graph') {
+            const emptyExec = {
+                format: 'dxo-model-graph',
+                version: 0,
+                view: 'execution',
+                availability: 'unavailable',
+                unavailableReason: 'legacy module-only artifact',
+                nodes: [],
+                edges: [],
+            };
+            const emptyKernel = {
+                format: 'dxo-model-graph',
+                version: 0,
+                view: 'kernel',
+                availability: 'unavailable',
+                unavailableReason: 'legacy module-only artifact',
+                nodes: [],
+                edges: [],
+            };
+            return {
+                format: 'dxo-model-graph-bundle',
+                version: 0,
+                module: raw.view === 'module' ? raw : {
+                    format: 'dxo-model-graph',
+                    version: 0,
+                    view: 'module',
+                    availability: 'unavailable',
+                    unavailableReason: 'legacy artifact was not module view',
+                    nodes: [],
+                    edges: [],
+                },
+                execution: raw.view === 'execution' ? raw : emptyExec,
+                kernel: raw.view === 'kernel' ? raw : emptyKernel,
+            };
+        }
+        return null;
+    }
+
+    async onMount() {
+        const parts = location.pathname.split('/').filter(Boolean);
+        this.runId = parts[1] ?? '';
+        if (!this.runId) {
+            this.status = 'missing run id';
+            return;
+        }
+        try {
+            const [metaRes, metricsRes, eventsRes, ckRes] = await Promise.all([
+                apiGet(`/api/runs/${encodeURIComponent(this.runId)}/meta`),
+                apiGet(`/api/runs/${encodeURIComponent(this.runId)}/metrics`),
+                apiGet(`/api/runs/${encodeURIComponent(this.runId)}/events`),
+                apiGet(`/api/runs/${encodeURIComponent(this.runId)}/checkpoints`),
+            ]);
+            this.status = metaRes.meta?.status ?? 'unknown';
+            this.metrics = metricsRes.metrics ?? [];
+            this.trainEvents = (eventsRes.events ?? []).filter(
+                (e) => String(e.type).startsWith('train/') || e.type === 'run/start' || e.type === 'run/end',
+            );
+            this.checkpoints = ckRes.checkpoints ?? [];
+            try {
+                const g = await apiGet(`/api/runs/${encodeURIComponent(this.runId)}/model-graph`);
+                this.graphBundle = this.normalizeGraphArtifact(g.graph ?? g);
+                this.renderGraphTab();
+            } catch {
+                this.graphBundle = null;
+                this.renderGraphTab();
+            }
+            try {
+                const cm = await apiGet(`/api/runs/${encodeURIComponent(this.runId)}/confusion-matrix`);
+                this.buildMatrix(cm.confusionMatrix ?? cm);
+            } catch {
+                this.hasMatrix = false;
+            }
+            try {
+                const imgs = await apiGet(`/api/runs/${encodeURIComponent(this.runId)}/image-samples`);
+                this.buildSamples(imgs.imageSamples ?? imgs);
+            } catch {
+                this.samples = [];
+            }
+            try {
+                const pr = await apiGet(`/api/runs/${encodeURIComponent(this.runId)}/profile-trace`);
+                const trace = pr.profileTrace ?? pr.trace ?? pr;
+                const spans = (trace.spans ?? []).filter(
+                    (s) => s && (s.category === 'kernel' || s.category === 'transfer' || s.category === 'readback' || s.category === 'op'),
+                );
+                if (trace.availability === 'unavailable' || spans.length === 0) {
+                    this.hasProfile = false;
+                    this.profileHint = trace.unavailableReason
+                        ?? 'ProfileTrace unavailable (no Titan spans; timeline not fabricated).';
+                    this.profileSpans = [];
+                } else {
+                    this.hasProfile = true;
+                    this.profileSpans = spans;
+                }
+            } catch {
+                this.hasProfile = false;
+                this.profileHint = 'No profile-trace artifact (Titan spans required; timeline is never fabricated).';
+            }
+        } catch (err) {
+            this.status = err instanceof Error ? err.message : String(err);
+        }
+    }
+}
+</script>

package/vmz.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from '@vmz/vmz';
+
+/** Studio WebUI — VMZ dev watch (`dxo studio`) + static build for Tauri embed. */
+export default defineConfig({
+    delivery: {
+        default: 'node',
+        profiles: {
+            node: { host: 'node', assembly: 'node-ssr' },
+            static: { host: 'browser', assembly: 'static-cdn' },
+        },
+    },
+});