@agent-relay/dashboard-server 2.0.83-beta.0 → 2.0.85

package/dist/routes/reactions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reaction route handlers: add, remove, list reactions on messages.
+ *
+ * Proxies to the Relaycast `/v1/messages/:id/reactions` API.
+ */
+import type { Express } from 'express';
+import type { RouteContext } from '../lib/types.js';
+export declare function registerReactionRoutes(app: Express, ctx: RouteContext): void;
+//# sourceMappingURL=reactions.d.ts.map

package/dist/routes/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../src/routes/reactions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMpD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CA0E5E"}

package/dist/routes/reactions.js

@@ -0,0 +1,76 @@
+/**
+ * Reaction route handlers: add, remove, list reactions on messages.
+ *
+ * Proxies to the Relaycast `/v1/messages/:id/reactions` API.
+ */
+function param(value) {
+    return Array.isArray(value) ? value[0] : value;
+}
+export function registerReactionRoutes(app, ctx) {
+    /** GET /api/messages/:id/reactions */
+    app.get('/api/messages/:id/reactions', async (req, res) => {
+        const config = ctx.resolveRelaycastConfig();
+        if (!config) {
+            res.status(503).json({ error: 'Relaycast not configured' });
+            return;
+        }
+        const id = param(req.params.id);
+        try {
+            const upstream = await fetch(`${config.baseUrl}/v1/messages/${encodeURIComponent(id)}/reactions`, { headers: { Authorization: `Bearer ${config.apiKey}` } });
+            const data = await upstream.json().catch(() => ({}));
+            res.status(upstream.status).json(data);
+        }
+        catch (err) {
+            console.error('[dashboard] GET reactions error:', err);
+            res.status(500).json({ error: 'Internal server error' });
+        }
+    });
+    /** POST /api/messages/:id/reactions */
+    app.post('/api/messages/:id/reactions', async (req, res) => {
+        const config = ctx.resolveRelaycastConfig();
+        if (!config) {
+            res.status(503).json({ error: 'Relaycast not configured' });
+            return;
+        }
+        const id = param(req.params.id);
+        try {
+            const upstream = await fetch(`${config.baseUrl}/v1/messages/${encodeURIComponent(id)}/reactions`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${config.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(req.body),
+            });
+            const data = await upstream.json().catch(() => ({}));
+            res.status(upstream.status).json(data);
+        }
+        catch (err) {
+            console.error('[dashboard] POST reactions error:', err);
+            res.status(500).json({ error: 'Internal server error' });
+        }
+    });
+    /** DELETE /api/messages/:id/reactions/:emoji */
+    app.delete('/api/messages/:id/reactions/:emoji', async (req, res) => {
+        const config = ctx.resolveRelaycastConfig();
+        if (!config) {
+            res.status(503).json({ error: 'Relaycast not configured' });
+            return;
+        }
+        const id = param(req.params.id);
+        const emoji = param(req.params.emoji);
+        try {
+            const upstream = await fetch(`${config.baseUrl}/v1/messages/${encodeURIComponent(id)}/reactions/${encodeURIComponent(emoji)}`, {
+                method: 'DELETE',
+                headers: { Authorization: `Bearer ${config.apiKey}` },
+            });
+            const data = await upstream.json().catch(() => ({}));
+            res.status(upstream.status).json(data);
+        }
+        catch (err) {
+            console.error('[dashboard] DELETE reactions error:', err);
+            res.status(500).json({ error: 'Internal server error' });
+        }
+    });
+}
+//# sourceMappingURL=reactions.js.map

package/dist/routes/reactions.js.map

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

package/dist/routes/relay-config.d.ts

@@ -0,0 +1,4 @@
+import type { Express } from 'express';
+import type { RouteContext } from '../lib/types.js';
+export declare function registerRelayConfigRoutes(app: Express, ctx: RouteContext): void;
+//# sourceMappingURL=relay-config.d.ts.map

package/dist/routes/relay-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-config.d.ts","sourceRoot":"","sources":["../../src/routes/relay-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CA0F/E"}

package/dist/routes/relay-config.js

@@ -0,0 +1,81 @@
+import crypto from 'crypto';
+import path from 'path';
+export function registerRelayConfigRoutes(app, ctx) {
+    // Allow the workflow runner (or any local caller) to push a Relaycast API key
+    // into the dashboard without writing any files.
+    // In cloud deployments (WORKSPACE_TOKEN set), require a valid token.
+    app.post('/api/relay-config', (req, res) => {
+        const expectedToken = process.env.WORKSPACE_TOKEN;
+        if (expectedToken && ctx.mode !== 'standalone') {
+            const authHeader = req.headers.authorization;
+            const token = authHeader?.startsWith('Bearer ')
+                ? authHeader.substring(7)
+                : null;
+            if (!token) {
+                res.status(401).json({ error: 'Unauthorized - missing workspace token' });
+                return;
+            }
+            const tokenBuffer = Buffer.from(token);
+            const expectedBuffer = Buffer.from(expectedToken);
+            const isValidToken = tokenBuffer.length === expectedBuffer.length &&
+                crypto.timingSafeEqual(tokenBuffer, expectedBuffer);
+            if (!isValidToken) {
+                res.status(401).json({ error: 'Unauthorized - invalid workspace token' });
+                return;
+            }
+        }
+        const apiKey = typeof req.body?.apiKey === 'string' ? req.body.apiKey.trim() : '';
+        if (!apiKey) {
+            res.status(400).json({ ok: false, error: 'Missing "apiKey" field' });
+            return;
+        }
+        ctx.setRelayApiKey(apiKey);
+        res.json({ ok: true });
+    });
+    app.get('/api/relay-config', (req, res) => {
+        // In cloud deployments (WORKSPACE_TOKEN set), require a valid token.
+        // Skip auth check in standalone mode (local development).
+        const expectedToken = process.env.WORKSPACE_TOKEN;
+        if (expectedToken && ctx.mode !== 'standalone') {
+            const authHeader = req.headers.authorization;
+            const token = authHeader?.startsWith('Bearer ')
+                ? authHeader.substring(7)
+                : null;
+            if (!token) {
+                res.status(401).json({ error: 'Unauthorized - missing workspace token' });
+                return;
+            }
+            const tokenBuffer = Buffer.from(token);
+            const expectedBuffer = Buffer.from(expectedToken);
+            const isValidToken = tokenBuffer.length === expectedBuffer.length &&
+                crypto.timingSafeEqual(tokenBuffer, expectedBuffer);
+            if (!isValidToken) {
+                res.status(401).json({ error: 'Unauthorized - invalid workspace token' });
+                return;
+            }
+        }
+        const config = ctx.resolveRelaycastConfig();
+        if (!config) {
+            res.status(503).json({
+                success: false,
+                error: "Relaycast credentials not configured. Set RELAY_API_KEY or create .agent-relay/relaycast.json",
+            });
+            return;
+        }
+        if (!config.agentToken) {
+            res.status(503).json({
+                success: false,
+                error: 'Relaycast agent token is missing from relaycast.json',
+            });
+            return;
+        }
+        res.json({
+            success: true,
+            baseUrl: config.baseUrl,
+            apiKey: config.apiKey,
+            agentToken: config.agentToken,
+            agentName: config.agentName ?? path.basename(path.resolve(ctx.dataDir, '..')),
+        });
+    });
+}
+//# sourceMappingURL=relay-config.js.map

package/dist/routes/relay-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-config.js","sourceRoot":"","sources":["../../src/routes/relay-config.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,MAAM,UAAU,yBAAyB,CAAC,GAAY,EAAE,GAAiB;IACvE,8EAA8E;IAC9E,gDAAgD;IAChD,qEAAqE;IACrE,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC5D,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAClD,IAAI,aAAa,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;YAC7C,MAAM,KAAK,GAAG,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC;gBAC7C,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;gBACzB,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,YAAY,GAChB,WAAW,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM;gBAC5C,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAEtD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QACD,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3D,qEAAqE;QACrE,0DAA0D;QAC1D,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAClD,IAAI,aAAa,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;YAC7C,MAAM,KAAK,GAAG,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC;gBAC7C,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;gBACzB,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,YAAY,GAChB,WAAW,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM;gBAC5C,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAEtD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,+FAA+F;aACvG,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,sDAAsD;aAC9D,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/routes/settings.d.ts

@@ -0,0 +1,6 @@
+import type { Application } from 'express';
+/**
+ * Workspace settings and trajectory settings routes.
+ */
+export declare function registerSettingsRoutes(app: Application): void;
+//# sourceMappingURL=settings.d.ts.map

package/dist/routes/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAuH7D"}

package/dist/routes/settings.js

@@ -0,0 +1,119 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Workspace settings and trajectory settings routes.
+ */
+export function registerSettingsRoutes(app) {
+    // GET /api/settings - Get all workspace settings with documentation.
+    app.get('/api/settings', async (_req, res) => {
+        try {
+            const { readRelayConfig, shouldStoreInRepo, getTrajectoriesStorageDescription } = await import('@agent-relay/config/trajectory-config');
+            const config = readRelayConfig();
+            return res.json({
+                success: true,
+                settings: {
+                    trajectories: {
+                        storeInRepo: shouldStoreInRepo(),
+                        storageLocation: getTrajectoriesStorageDescription(),
+                        description: 'Trajectories record the journey of agent work using the PDERO paradigm (Plan, Design, Execute, Review, Observe). They capture decisions, phase transitions, and retrospectives.',
+                        benefits: [
+                            'Track why decisions were made, not just what was built',
+                            'Enable session recovery when agents crash or context is lost',
+                            'Provide learning data for future agents working on similar tasks',
+                            'Create an audit trail of agent work for review',
+                        ],
+                        learnMore: 'https://pdero.com',
+                        optInReason: 'Enable "Store in repo" to version-control your trajectories alongside your code. This is useful for teams who want to review agent decision-making processes.',
+                    },
+                },
+                config,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error('[api] Settings error:', err);
+            return res.status(500).json({
+                success: false,
+                error: message,
+            });
+        }
+    });
+    // GET /api/settings/trajectory - Get trajectory storage settings.
+    app.get('/api/settings/trajectory', async (_req, res) => {
+        try {
+            const { readRelayConfig, shouldStoreInRepo, getTrajectoriesStorageDescription } = await import('@agent-relay/config/trajectory-config');
+            const config = readRelayConfig();
+            return res.json({
+                success: true,
+                settings: {
+                    storeInRepo: shouldStoreInRepo(),
+                    storageLocation: getTrajectoriesStorageDescription(),
+                },
+                config: config.trajectories || {},
+                documentation: {
+                    title: 'Trajectory Storage',
+                    description: 'Trajectories record the journey of agent work using the PDERO paradigm (Plan, Design, Execute, Review, Observe).',
+                    whatIsIt: 'A trajectory captures not just what an agent built, but WHY it made specific decisions. This includes phase transitions, key decisions with reasoning, and retrospective summaries.',
+                    benefits: [
+                        'Understand agent decision-making for code review',
+                        'Enable session recovery if agents crash',
+                        'Train future agents on your codebase patterns',
+                        'Create audit trails of AI work',
+                    ],
+                    storeInRepoExplanation: 'When enabled, trajectories are stored in .trajectories/ in your repo and can be committed to source control. When disabled (default), they are stored in your user directory (~/.config/agent-relay/trajectories/).',
+                    learnMore: 'https://pdero.com',
+                },
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error('[api] Settings trajectory error:', err);
+            return res.status(500).json({
+                success: false,
+                error: message,
+            });
+        }
+    });
+    // PUT /api/settings/trajectory - Update trajectory storage settings.
+    app.put('/api/settings/trajectory', async (req, res) => {
+        try {
+            const { storeInRepo } = req.body;
+            if (typeof storeInRepo !== 'boolean') {
+                return res.status(400).json({
+                    success: false,
+                    error: 'storeInRepo must be a boolean',
+                });
+            }
+            const { getRelayConfigPath, readRelayConfig } = await import('@agent-relay/config/trajectory-config');
+            const { getProjectPaths } = await import('@agent-relay/config');
+            const { projectRoot: _projectRoot } = getProjectPaths();
+            const config = readRelayConfig();
+            config.trajectories = {
+                ...config.trajectories,
+                storeInRepo,
+            };
+            const configPath = getRelayConfigPath();
+            const configDir = path.dirname(configPath);
+            if (!fs.existsSync(configDir)) {
+                fs.mkdirSync(configDir, { recursive: true });
+            }
+            fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+            return res.json({
+                success: true,
+                settings: {
+                    storeInRepo,
+                    storageLocation: storeInRepo ? 'repo (.trajectories/)' : 'user (~/.config/agent-relay/trajectories/)',
+                },
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error('[api] Settings trajectory update error:', err);
+            return res.status(500).json({
+                success: false,
+                error: message,
+            });
+        }
+    });
+}
+//# sourceMappingURL=settings.js.map

package/dist/routes/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAgB;IACrD,qEAAqE;IACrE,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;YACxI,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;YAEjC,OAAO,GAAG,CAAC,IAAI,CAAC;gBACd,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE;oBACR,YAAY,EAAE;wBACZ,WAAW,EAAE,iBAAiB,EAAE;wBAChC,eAAe,EAAE,iCAAiC,EAAE;wBACpD,WAAW,EAAE,iLAAiL;wBAC9L,QAAQ,EAAE;4BACR,wDAAwD;4BACxD,8DAA8D;4BAC9D,kEAAkE;4BAClE,gDAAgD;yBACjD;wBACD,SAAS,EAAE,mBAAmB;wBAC9B,WAAW,EAAE,+JAA+J;qBAC7K;iBACF;gBACD,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;YAC5C,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kEAAkE;IAClE,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;YACxI,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;YAEjC,OAAO,GAAG,CAAC,IAAI,CAAC;gBACd,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE;oBACR,WAAW,EAAE,iBAAiB,EAAE;oBAChC,eAAe,EAAE,iCAAiC,EAAE;iBACrD;gBACD,MAAM,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;gBACjC,aAAa,EAAE;oBACb,KAAK,EAAE,oBAAoB;oBAC3B,WAAW,EAAE,kHAAkH;oBAC/H,QAAQ,EAAE,qLAAqL;oBAC/L,QAAQ,EAAE;wBACR,kDAAkD;wBAClD,yCAAyC;wBACzC,+CAA+C;wBAC/C,gCAAgC;qBACjC;oBACD,sBAAsB,EAAE,qNAAqN;oBAC7O,SAAS,EAAE,mBAAmB;iBAC/B;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YACvD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAEjC,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBAC1B,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,+BAA+B;iBACvC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,EAAE,kBAAkB,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;YACtG,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAChE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,eAAe,EAAE,CAAC;YAExD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;YACjC,MAAM,CAAC,YAAY,GAAG;gBACpB,GAAG,MAAM,CAAC,YAAY;gBACtB,WAAW;aACZ,CAAC;YAEF,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE9D,OAAO,GAAG,CAAC,IAAI,CAAC;gBACd,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE;oBACR,WAAW;oBACX,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,4CAA4C;iBACtG;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;YAC9D,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/routes/spawn.d.ts

@@ -0,0 +1,74 @@
+import type { Application } from 'express';
+interface ActiveWorkerLike {
+    name: string;
+    cli: string;
+    task: string;
+    team?: string;
+    spawnerName?: string;
+    spawnedAt: number;
+    pid?: number;
+}
+interface SpawnReaderLike {
+    getActiveWorkers(): ActiveWorkerLike[];
+    hasWorker(name: string): boolean;
+    getWorkerOutput(name: string, limit?: number): string[] | undefined;
+    getWorkerRawOutput(name: string): string | undefined;
+    sendWorkerInput(name: string, data: string): Promise<boolean>;
+}
+interface RelayAdapterLike {
+    spawn: (request: {
+        name: string;
+        cli: string;
+        task?: string;
+        team?: string;
+        cwd?: string;
+        interactive?: boolean;
+        shadowMode?: string;
+        shadowOf?: string;
+        spawnerName?: string;
+        userId?: string;
+        continueFrom?: string;
+        includeWorkflowConventions?: boolean;
+    }) => Promise<{
+        success: boolean;
+        name?: string;
+        error?: string;
+    }>;
+    release: (name: string) => Promise<{
+        success: boolean;
+        name?: string;
+        error?: string;
+    }>;
+}
+interface SpawnPresenceEvent {
+    type: string;
+    agent: {
+        name: string;
+    };
+    cli?: string;
+    task?: string;
+    spawnedBy?: string;
+    releasedBy?: string;
+    timestamp: string;
+}
+export interface SpawnRouteDeps {
+    dataDir: string;
+    projectRoot?: string;
+    relayAdapter: RelayAdapterLike;
+    spawnReader?: SpawnReaderLike;
+    agentCwdMap: Map<string, string>;
+    isAgentOnline: (agentName: string) => boolean;
+    resolveWorkspaceId: (req: {
+        query?: Record<string, unknown>;
+        body?: Record<string, unknown>;
+        headers?: Record<string, unknown>;
+    }) => string | undefined;
+    broadcastData: () => Promise<void>;
+    broadcastPresence: (event: SpawnPresenceEvent) => void;
+}
+/**
+ * Spawn, logs, repositories, and trajectory routes.
+ */
+export declare function registerSpawnRoutes(app: Application, deps: SpawnRouteDeps): void;
+export {};
+//# sourceMappingURL=spawn.d.ts.map

package/dist/routes/spawn.d.ts.map

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