@shardworks/dashboard-apparatus 0.1.113

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAg/BD,CAAC;AACT,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @shardworks/dashboard-apparatus — The Dashboard.
+ *
+ * Web-based guild operations dashboard. Exposes the `dashboard-start` CLI
+ * tool which launches a local web server with a live operations UI including
+ * tabs for Overview, Clerk, Walker, Animator, and Codexes.
+ *
+ * Usage:
+ *   nsg dashboard start
+ *   nsg dashboard start --port 8080
+ *   nsg dashboard start --no-open
+ */
+export { createDashboard } from './dashboard.ts';
+declare const _default: import("@shardworks/nexus-core").Plugin;
+export default _default;
+//# 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;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;;AAIjD,wBAAiC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @shardworks/dashboard-apparatus — The Dashboard.
+ *
+ * Web-based guild operations dashboard. Exposes the `dashboard-start` CLI
+ * tool which launches a local web server with a live operations UI including
+ * tabs for Overview, Clerk, Walker, Animator, and Codexes.
+ *
+ * Usage:
+ *   nsg dashboard start
+ *   nsg dashboard start --port 8080
+ *   nsg dashboard start --no-open
+ */
+import { createDashboard } from "./dashboard.js";
+export { createDashboard } from "./dashboard.js";
+// ── Default export: the apparatus plugin ──────────────────────────
+export default createDashboard();
+//# 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;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,qEAAqE;AAErE,eAAe,eAAe,EAAE,CAAC"}

package/dist/rig-types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Local type stubs for Walker rig documents read via Stacks readBook().
+ */
+export interface EngineInstance {
+    id: string;
+    designId: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    upstream: string[];
+    givensSpec: Record<string, unknown>;
+    yields?: unknown;
+    error?: string;
+    sessionId?: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+export interface RigDoc {
+    id: string;
+    writId: string;
+    status: 'running' | 'completed' | 'failed';
+    engines: EngineInstance[];
+    [key: string]: unknown;
+}
+//# sourceMappingURL=rig-types.d.ts.map

package/dist/rig-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rig-types.d.ts","sourceRoot":"","sources":["../src/rig-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/rig-types.js

@@ -0,0 +1,5 @@
+/**
+ * Local type stubs for Walker rig documents read via Stacks readBook().
+ */
+export {};
+//# sourceMappingURL=rig-types.js.map

package/dist/rig-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rig-types.js","sourceRoot":"","sources":["../src/rig-types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Dashboard HTTP server.
+ *
+ * Serves the web UI at / and REST API endpoints at /api/*.
+ * Uses only Node built-ins — no express or other dependencies.
+ */
+export interface DashboardServer {
+    port: number;
+    url: string;
+    close(): Promise<void>;
+}
+export declare function startServer(port: number): Promise<DashboardServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiRH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0BxE"}

package/dist/server.js

@@ -0,0 +1,284 @@
+/**
+ * Dashboard HTTP server.
+ *
+ * Serves the web UI at / and REST API endpoints at /api/*.
+ * Uses only Node built-ins — no express or other dependencies.
+ */
+import http from 'node:http';
+import { guild } from '@shardworks/nexus-core';
+import { getDashboardHtml } from "./html.js";
+// ── Helpers ───────────────────────────────────────────────────────
+function json(res, data, status = 200) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+        'Cache-Control': 'no-cache',
+    });
+    res.end(body);
+}
+function error(res, msg, status = 500) {
+    res.writeHead(status, { 'Content-Type': 'text/plain' });
+    res.end(msg);
+}
+async function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let raw = '';
+        req.on('data', chunk => { raw += chunk; });
+        req.on('end', () => {
+            try {
+                resolve(JSON.parse(raw || '{}'));
+            }
+            catch {
+                reject(new Error('Invalid JSON body'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+function parseQS(url) {
+    const qm = url.indexOf('?');
+    if (qm < 0)
+        return {};
+    return Object.fromEntries(new URLSearchParams(url.slice(qm + 1)));
+}
+function pathname(url) {
+    const qm = url.indexOf('?');
+    return qm < 0 ? url : url.slice(0, qm);
+}
+function tryApparatus(name) {
+    try {
+        return guild().apparatus(name);
+    }
+    catch {
+        return null;
+    }
+}
+// ── Request router ────────────────────────────────────────────────
+async function handleRequest(req, res) {
+    const method = req.method ?? 'GET';
+    const path = pathname(req.url ?? '/');
+    const qs = parseQS(req.url ?? '');
+    // ── Web UI ──────────────────────────────────────────────────────
+    if (path === '/' || path === '/index.html') {
+        const html = getDashboardHtml();
+        res.writeHead(200, {
+            'Content-Type': 'text/html; charset=utf-8',
+            'Content-Length': Buffer.byteLength(html),
+        });
+        res.end(html);
+        return;
+    }
+    // ── API: Overview ───────────────────────────────────────────────
+    if (path === '/api/overview' && method === 'GET') {
+        try {
+            const g = guild();
+            const config = g.guildConfig();
+            const plugins = [
+                ...g.kits().map(k => ({ id: k.id, version: k.version, type: 'kit' })),
+                ...g.apparatuses().map(a => ({ id: a.id, version: a.version, type: 'apparatus' })),
+            ].sort((a, b) => a.id.localeCompare(b.id));
+            const counts = {};
+            const clerk = tryApparatus('clerk');
+            if (clerk) {
+                counts.writs = await clerk.count();
+                counts.ready = await clerk.count({ status: 'ready' });
+                counts.active = await clerk.count({ status: 'active' });
+            }
+            const stacks = tryApparatus('stacks');
+            if (stacks) {
+                try {
+                    const sessions = stacks.readBook('animator', 'sessions');
+                    counts.sessions = await sessions.count();
+                    counts.runningSessions = await sessions.count([['status', '=', 'running']]);
+                }
+                catch { /* animator not installed */ }
+                try {
+                    const rigs = stacks.readBook('walker', 'rigs');
+                    counts.rigs = await rigs.count();
+                    counts.runningRigs = await rigs.count([['status', '=', 'running']]);
+                }
+                catch { /* walker not installed */ }
+            }
+            const scriptorium = tryApparatus('codexes');
+            if (scriptorium) {
+                const codexList = await scriptorium.list();
+                counts.codexes = codexList.length;
+                counts.codexNames = codexList.map(c => c.name);
+            }
+            json(res, { guild: config, plugins, counts });
+        }
+        catch (e) {
+            error(res, e.message);
+        }
+        return;
+    }
+    // ── API: Writs ──────────────────────────────────────────────────
+    if (path === '/api/writs' && method === 'GET') {
+        const clerk = tryApparatus('clerk');
+        if (!clerk) {
+            error(res, 'Clerk apparatus not installed', 404);
+            return;
+        }
+        try {
+            const filters = {};
+            if (qs.status)
+                filters.status = qs.status;
+            if (qs.type)
+                filters.type = qs.type;
+            filters.limit = qs.limit ? parseInt(qs.limit, 10) : 20;
+            filters.offset = qs.offset ? parseInt(qs.offset, 10) : 0;
+            const [writs, total] = await Promise.all([
+                clerk.list(filters),
+                clerk.count({ status: filters.status, type: filters.type }),
+            ]);
+            // Derive declared types from guild config
+            const clerkConfig = guild().guildConfig().clerk;
+            const types = ['mandate', ...(clerkConfig?.writTypes?.map(t => t.name) ?? [])];
+            json(res, { writs, total, types });
+        }
+        catch (e) {
+            error(res, e.message);
+        }
+        return;
+    }
+    if (path === '/api/writs' && method === 'POST') {
+        const clerk = tryApparatus('clerk');
+        if (!clerk) {
+            error(res, 'Clerk apparatus not installed', 404);
+            return;
+        }
+        try {
+            const body = await readBody(req);
+            const writ = await clerk.post({
+                title: body.title,
+                body: body.body,
+                ...(body.type ? { type: body.type } : {}),
+                ...(body.codex ? { codex: body.codex } : {}),
+            });
+            json(res, writ, 201);
+        }
+        catch (e) {
+            error(res, e.message, 400);
+        }
+        return;
+    }
+    // ── API: Writ transition ─────────────────────────────────────────
+    const transMatch = path.match(/^\/api\/writs\/([^/]+)\/transition$/);
+    if (transMatch && method === 'POST') {
+        const clerk = tryApparatus('clerk');
+        if (!clerk) {
+            error(res, 'Clerk apparatus not installed', 404);
+            return;
+        }
+        try {
+            const id = transMatch[1];
+            const body = await readBody(req);
+            const fields = {};
+            if (body.resolution)
+                fields.resolution = body.resolution;
+            const writ = await clerk.transition(id, body.to, Object.keys(fields).length ? fields : undefined);
+            json(res, writ);
+        }
+        catch (e) {
+            error(res, e.message, 400);
+        }
+        return;
+    }
+    // ── API: Sessions ────────────────────────────────────────────────
+    if (path === '/api/sessions' && method === 'GET') {
+        const stacks = tryApparatus('stacks');
+        if (!stacks) {
+            json(res, { sessions: [], total: 0 });
+            return;
+        }
+        try {
+            const sessions = stacks.readBook('animator', 'sessions');
+            const limit = qs.limit ? parseInt(qs.limit, 10) : 20;
+            const offset = qs.offset ? parseInt(qs.offset, 10) : 0;
+            const where = qs.status
+                ? [['status', '=', qs.status]]
+                : undefined;
+            const [rows, total] = await Promise.all([
+                sessions.find({ where, orderBy: ['startedAt', 'desc'], limit, offset }),
+                sessions.count(where),
+            ]);
+            json(res, { sessions: rows, total });
+        }
+        catch (e) {
+            json(res, { sessions: [], total: 0 });
+        }
+        return;
+    }
+    // ── API: Rigs ────────────────────────────────────────────────────
+    if (path === '/api/rigs' && method === 'GET') {
+        const stacks = tryApparatus('stacks');
+        if (!stacks) {
+            json(res, { rigs: [] });
+            return;
+        }
+        try {
+            const rigs = stacks.readBook('walker', 'rigs');
+            const where = qs.status
+                ? [['status', '=', qs.status]]
+                : undefined;
+            const rows = await rigs.find({
+                where,
+                orderBy: ['id', 'desc'],
+                limit: 100,
+            });
+            json(res, { rigs: rows });
+        }
+        catch (e) {
+            json(res, { rigs: [] });
+        }
+        return;
+    }
+    // ── API: Codexes ─────────────────────────────────────────────────
+    if (path === '/api/codexes' && method === 'GET') {
+        const scriptorium = tryApparatus('codexes');
+        if (!scriptorium) {
+            json(res, { codexes: [], drafts: [] });
+            return;
+        }
+        try {
+            const [codexes, drafts] = await Promise.all([
+                scriptorium.list(),
+                scriptorium.listDrafts(),
+            ]);
+            json(res, { codexes, drafts });
+        }
+        catch (e) {
+            error(res, e.message);
+        }
+        return;
+    }
+    // ── 404 ──────────────────────────────────────────────────────────
+    error(res, 'Not found', 404);
+}
+export async function startServer(port) {
+    const server = http.createServer(async (req, res) => {
+        try {
+            await handleRequest(req, res);
+        }
+        catch (e) {
+            if (!res.headersSent) {
+                error(res, e.message ?? 'Internal error');
+            }
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.listen(port, '127.0.0.1', resolve);
+        server.once('error', reject);
+    });
+    const addr = server.address();
+    const actualPort = addr.port;
+    return {
+        port: actualPort,
+        url: `http://127.0.0.1:${actualPort}`,
+        close: () => new Promise((resolve, reject) => {
+            server.close(err => err ? reject(err) : resolve());
+        }),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,12 @@
+/**
+ * dashboard-start tool — CLI-only.
+ *
+ * Starts the web dashboard server and opens the browser.
+ * Runs until the process is interrupted (Ctrl+C).
+ */
+import { z } from 'zod';
+export declare const dashboardStart: import("@shardworks/tools-apparatus").ToolDefinition<{
+    port: z.ZodOptional<z.ZodNumber>;
+    'no-open': z.ZodOptional<z.ZodBoolean>;
+}>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc;;;EAiDzB,CAAC"}

package/dist/tool.js

@@ -0,0 +1,62 @@
+/**
+ * dashboard-start tool — CLI-only.
+ *
+ * Starts the web dashboard server and opens the browser.
+ * Runs until the process is interrupted (Ctrl+C).
+ */
+import { execSync } from 'node:child_process';
+import process from 'node:process';
+import { z } from 'zod';
+import { tool } from '@shardworks/tools-apparatus';
+import { startServer } from "./server.js";
+export const dashboardStart = tool({
+    name: 'dashboard-start',
+    description: 'Start the guild web dashboard. Opens a browser and serves a live operations UI.',
+    callableBy: ['cli'],
+    params: {
+        port: z
+            .number()
+            .int()
+            .min(1024)
+            .max(65535)
+            .optional()
+            .describe('Port to listen on (default: 4242)'),
+        'no-open': z
+            .boolean()
+            .optional()
+            .describe('Skip opening the browser automatically'),
+    },
+    handler: async ({ port: portArg, 'no-open': noOpen }) => {
+        const port = portArg ?? 4242;
+        const server = await startServer(port);
+        const url = server.url;
+        console.log('');
+        console.log('  Guild Dashboard running at:');
+        console.log('');
+        console.log('    ' + url);
+        console.log('');
+        console.log('  Press Ctrl+C to stop.');
+        console.log('');
+        if (!noOpen) {
+            try {
+                const platform = process.platform;
+                if (platform === 'darwin')
+                    execSync('open ' + url, { stdio: 'ignore' });
+                else if (platform === 'win32')
+                    execSync('start "" ' + url, { stdio: 'ignore', shell: 'cmd.exe' });
+                else
+                    execSync('xdg-open ' + url + ' 2>/dev/null; true', { stdio: 'ignore', shell: '/bin/sh' });
+            }
+            catch {
+                // Browser open is best-effort; ignore errors
+            }
+        }
+        // Keep the process alive until Ctrl+C
+        await new Promise(resolve => {
+            process.once('SIGINT', async () => { await server.close(); resolve(); });
+            process.once('SIGTERM', async () => { await server.close(); resolve(); });
+        });
+        return { status: 'stopped', url };
+    },
+});
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iFAAiF;IAC9F,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,IAAI,CAAC;aACT,GAAG,CAAC,KAAK,CAAC;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,mCAAmC,CAAC;QAChD,SAAS,EAAE,CAAC;aACT,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,wCAAwC,CAAC;KACtD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,OAAO,IAAI,IAAI,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAEvB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;gBAClC,IAAI,QAAQ,KAAK,QAAQ;oBAAG,QAAQ,CAAC,OAAO,GAAG,GAAG,EAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;qBACtE,IAAI,QAAQ,KAAK,OAAO;oBAAE,QAAQ,CAAC,WAAW,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;;oBAC7F,QAAQ,CAAC,WAAW,GAAG,GAAG,GAAG,oBAAoB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACjG,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,MAAM,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAChC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAG,KAAK,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IACpC,CAAC;CACF,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Local type stubs for apparatus documents read via Stacks readBook().
+ * These mirror the shapes declared by the respective apparatus packages
+ * without importing from them (to keep dashboard dependencies minimal).
+ */
+/** Minimal shape of a session document from the Animator's sessions book. */
+export interface SessionDoc {
+    id: string;
+    status: 'running' | 'completed' | 'failed' | 'timeout';
+    startedAt: string;
+    endedAt?: string;
+    durationMs?: number;
+    provider: string;
+    exitCode?: number;
+    error?: string;
+    conversationId?: string;
+    providerSessionId?: string;
+    tokenUsage?: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    };
+    costUsd?: number;
+    metadata?: Record<string, unknown>;
+    output?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Local type stubs for apparatus documents read via Stacks readBook().
+ * These mirror the shapes declared by the respective apparatus packages
+ * without importing from them (to keep dashboard dependencies minimal).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@shardworks/dashboard-apparatus",
+  "version": "0.1.113",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shardworks/nexus",
+    "directory": "packages/plugins/dashboard"
+  },
+  "description": "The Dashboard — web-based guild operations dashboard apparatus",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "4.3.6",
+    "@shardworks/clerk-apparatus": "0.1.113",
+    "@shardworks/nexus-core": "0.1.113",
+    "@shardworks/stacks-apparatus": "0.1.113",
+    "@shardworks/tools-apparatus": "0.1.113"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}