agent-tasks 1.1.0

package/dist/transport/rest.js

@@ -0,0 +1,382 @@
+// =============================================================================
+// agent-tasks — REST transport
+//
+// Lightweight HTTP API using only node:http. No framework dependencies.
+// Serves both the JSON API and the static web UI.
+// =============================================================================
+import { readFileSync, realpathSync, existsSync } from 'fs';
+import { join, extname, resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { TasksError, ValidationError } from '../types.js';
+const MAX_BODY_SIZE = 65536;
+function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > MAX_BODY_SIZE) {
+                req.destroy();
+                reject(new ValidationError('Request body too large (max 64KB).'));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            try {
+                const raw = Buffer.concat(chunks).toString('utf-8');
+                if (!raw.trim()) {
+                    resolve({});
+                    return;
+                }
+                const parsed = JSON.parse(raw);
+                if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+                    reject(new ValidationError('Request body must be a JSON object.'));
+                    return;
+                }
+                resolve(parsed);
+            }
+            catch {
+                reject(new ValidationError('Invalid JSON in request body.'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+};
+export function createRouter(ctx) {
+    const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf8'));
+    const routes = [];
+    const uiDir = resolve(join(__dirname, '..', 'ui'));
+    function route(method, path, handler) {
+        const paramNames = [];
+        const pattern = path.replace(/:(\w+)/g, (_match, name) => {
+            paramNames.push(name);
+            return '([^/]+)';
+        });
+        routes.push({ method, pattern: new RegExp(`^${pattern}$`), paramNames, handler });
+    }
+    function json(res, data, status = 200) {
+        res.writeHead(status, {
+            'Content-Type': 'application/json',
+            'Access-Control-Allow-Origin': '*',
+            'X-Content-Type-Options': 'nosniff',
+        });
+        res.end(JSON.stringify(data));
+    }
+    // -----------------------------------------------------------------------
+    // API routes
+    // -----------------------------------------------------------------------
+    route('GET', '/health', (_req, res) => {
+        json(res, {
+            status: 'ok',
+            version: pkg.version,
+            uptime: process.uptime(),
+            tasks: ctx.tasks.list().length,
+        });
+    });
+    route('GET', '/api/tasks', (req, res) => {
+        const url = new URL(req.url, `http://${req.headers.host}`);
+        json(res, ctx.tasks.list({
+            status: url.searchParams.get('status') ?? undefined,
+            assigned_to: url.searchParams.get('assigned_to') ?? undefined,
+            stage: url.searchParams.get('stage') ?? undefined,
+            project: url.searchParams.get('project') ?? undefined,
+            limit: url.searchParams.has('limit')
+                ? parseInt(url.searchParams.get('limit'), 10)
+                : undefined,
+        }));
+    });
+    route('GET', '/api/tasks/:id', (_req, res, params) => {
+        const task = ctx.tasks.getById(parseInt(params.id, 10));
+        if (!task) {
+            json(res, { error: 'Task not found' }, 404);
+            return;
+        }
+        json(res, task);
+    });
+    route('GET', '/api/tasks/:id/artifacts', (req, res, params) => {
+        const url = new URL(req.url, `http://${req.headers.host}`);
+        const stage = url.searchParams.get('stage') ?? undefined;
+        try {
+            json(res, ctx.tasks.getArtifacts(parseInt(params.id, 10), stage));
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    route('GET', '/api/tasks/:id/dependencies', (_req, res, params) => {
+        try {
+            json(res, ctx.tasks.getDependencies(parseInt(params.id, 10)));
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    route('GET', '/api/dependencies', (_req, res) => {
+        json(res, ctx.tasks.getAllDependencies());
+    });
+    route('GET', '/api/pipeline', (req, res) => {
+        const url = new URL(req.url, `http://${req.headers.host}`);
+        const project = url.searchParams.get('project') ?? undefined;
+        json(res, { stages: ctx.tasks.getPipelineStages(project) });
+    });
+    route('GET', '/api/overview', (_req, res) => {
+        json(res, {
+            tasks: ctx.tasks.list(),
+            dependencies: ctx.tasks.getAllDependencies(),
+            artifactCounts: ctx.tasks.getArtifactCounts(),
+            commentCounts: ctx.comments.countByTask(),
+            subtaskProgress: ctx.tasks.getAllSubtaskProgress(),
+            stages: ctx.tasks.getPipelineStages(),
+        });
+    });
+    route('POST', '/api/tasks', async (req, res) => {
+        try {
+            const body = await parseBody(req);
+            const task = ctx.tasks.create({
+                title: body.title,
+                description: body.description,
+                assign_to: body.assign_to,
+                stage: body.stage,
+                priority: body.priority,
+                project: body.project,
+                tags: body.tags,
+                parent_id: body.parent_id,
+            }, body.created_by || 'api');
+            json(res, task, 201);
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    route('PUT', '/api/tasks/:id/stage', async (req, res, params) => {
+        try {
+            const body = await parseBody(req);
+            const taskId = parseInt(params.id, 10);
+            const targetStage = body.stage;
+            const task = ctx.tasks.getById(taskId);
+            if (!task) {
+                json(res, { error: 'Task not found' }, 404);
+                return;
+            }
+            const stages = ctx.tasks.getPipelineStages(task.project ?? undefined);
+            const currentIdx = stages.indexOf(task.stage);
+            const targetIdx = stages.indexOf(targetStage);
+            if (targetIdx > currentIdx) {
+                json(res, ctx.tasks.advance(taskId, targetStage));
+            }
+            else if (targetIdx < currentIdx) {
+                json(res, ctx.tasks.regress(taskId, targetStage, body.reason));
+            }
+            else {
+                json(res, task);
+            }
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    route('GET', '/api/tasks/:id/subtasks', (_req, res, params) => {
+        try {
+            json(res, ctx.tasks.getSubtasks(parseInt(params.id, 10)));
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    route('GET', '/api/tasks/:id/comments', (_req, res, params) => {
+        try {
+            json(res, ctx.comments.list(parseInt(params.id, 10)));
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    route('POST', '/api/tasks/:id/comments', async (req, res, params) => {
+        try {
+            const body = await parseBody(req);
+            const comment = ctx.comments.add(parseInt(params.id, 10), body.agent_id || 'api', body.content, body.parent_comment_id);
+            json(res, comment, 201);
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    route('GET', '/api/search', (req, res) => {
+        const url = new URL(req.url, `http://${req.headers.host}`);
+        const query = url.searchParams.get('q') ?? '';
+        try {
+            json(res, ctx.tasks.search(query, {
+                project: url.searchParams.get('project') ?? undefined,
+                limit: url.searchParams.has('limit')
+                    ? parseInt(url.searchParams.get('limit'), 10)
+                    : undefined,
+            }));
+        }
+        catch (err) {
+            if (err instanceof TasksError) {
+                json(res, { error: err.message }, err.statusCode);
+            }
+            else {
+                json(res, { error: 'Internal error' }, 500);
+            }
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Static file serving
+    // -----------------------------------------------------------------------
+    function serveStatic(req, res) {
+        let pathname = new URL(req.url, `http://${req.headers.host}`).pathname;
+        if (pathname === '/' || pathname === '')
+            pathname = '/index.html';
+        let decoded;
+        try {
+            decoded = decodeURIComponent(pathname);
+        }
+        catch {
+            res.writeHead(400);
+            res.end('Bad request');
+            return;
+        }
+        if (decoded.includes('\0') || decoded.includes('..')) {
+            res.writeHead(403);
+            res.end('Forbidden');
+            return;
+        }
+        const filePath = join(uiDir, decoded);
+        let realPath;
+        try {
+            realPath = realpathSync(filePath);
+        }
+        catch {
+            res.writeHead(404);
+            res.end('Not found');
+            return;
+        }
+        const realUiDir = realpathSync(uiDir);
+        if (!realPath.startsWith(realUiDir)) {
+            res.writeHead(403);
+            res.end('Forbidden');
+            return;
+        }
+        try {
+            const content = readFileSync(realPath);
+            const ext = extname(realPath);
+            const contentType = MIME_TYPES[ext] || 'application/octet-stream';
+            res.writeHead(200, {
+                'Content-Type': contentType,
+                'X-Content-Type-Options': 'nosniff',
+            });
+            res.end(content);
+        }
+        catch {
+            res.writeHead(500);
+            res.end('Internal error');
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Request dispatcher
+    // -----------------------------------------------------------------------
+    return (req, res) => {
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204, {
+                'Access-Control-Allow-Origin': '*',
+                'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
+                'Access-Control-Allow-Headers': 'Content-Type',
+            });
+            res.end();
+            return;
+        }
+        const url = new URL(req.url, `http://${req.headers.host}`);
+        const pathname = url.pathname;
+        for (const r of routes) {
+            if (r.method !== req.method)
+                continue;
+            const match = pathname.match(r.pattern);
+            if (!match)
+                continue;
+            const params = {};
+            r.paramNames.forEach((name, i) => {
+                params[name] = decodeURIComponent(match[i + 1]);
+            });
+            try {
+                const result = r.handler(req, res, params);
+                if (result instanceof Promise) {
+                    result.catch((err) => {
+                        if (!res.writableEnded) {
+                            if (err instanceof TasksError) {
+                                json(res, { error: err.message }, err.statusCode);
+                            }
+                            else {
+                                json(res, { error: 'Internal error' }, 500);
+                            }
+                        }
+                    });
+                }
+            }
+            catch (err) {
+                if (!res.writableEnded) {
+                    if (err instanceof TasksError) {
+                        json(res, { error: err.message }, err.statusCode);
+                    }
+                    else {
+                        json(res, { error: 'Internal error' }, 500);
+                    }
+                }
+            }
+            return;
+        }
+        if (req.method === 'GET' && existsSync(uiDir)) {
+            serveStatic(req, res);
+        }
+        else {
+            json(res, { error: 'Not found' }, 404);
+        }
+    };
+}
+//# sourceMappingURL=rest.js.map

package/dist/transport/rest.js.map

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

package/dist/transport/ws.d.ts

@@ -0,0 +1,10 @@
+import { WebSocketServer } from 'ws';
+import type { Server } from 'http';
+import type { AppContext } from '../context.js';
+export interface WebSocketHandle {
+    wss: WebSocketServer;
+    broadcast(message: string): void;
+    close(): void;
+}
+export declare function setupWebSocket(httpServer: Server, ctx: AppContext): WebSocketHandle;
+//# sourceMappingURL=ws.d.ts.map

package/dist/transport/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/transport/ws.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAa,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAShD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,eAAe,CAAC;IACrB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,IAAI,CAAC;CACf;AA+BD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,eAAe,CAwInF"}

package/dist/transport/ws.js

@@ -0,0 +1,177 @@
+// =============================================================================
+// agent-tasks — WebSocket transport
+//
+// Real-time event streaming to connected UI clients.
+// Full state sent on connect; individual events streamed after.
+// =============================================================================
+import { WebSocketServer, WebSocket } from 'ws';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname_ws = dirname(fileURLToPath(import.meta.url));
+const MAX_WS_MESSAGE_SIZE = 4096;
+const MAX_WS_CONNECTIONS = 50;
+const PING_INTERVAL_MS = 30_000;
+const VALID_EVENT_TYPES = new Set([
+    '*',
+    'task:created',
+    'task:updated',
+    'task:claimed',
+    'task:advanced',
+    'task:regressed',
+    'task:completed',
+    'task:failed',
+    'task:cancelled',
+    'task:deleted',
+    'artifact:created',
+    'dependency:added',
+    'dependency:removed',
+    'pipeline:configured',
+    'comment:created',
+    'collaborator:added',
+    'collaborator:removed',
+    'approval:requested',
+    'approval:approved',
+    'approval:rejected',
+]);
+export function setupWebSocket(httpServer, ctx) {
+    const wss = new WebSocketServer({ server: httpServer, maxPayload: MAX_WS_MESSAGE_SIZE });
+    const clients = new Map();
+    wss.on('connection', (ws) => {
+        if (wss.clients.size > MAX_WS_CONNECTIONS) {
+            ws.close(1013, 'Too many connections');
+            return;
+        }
+        const state = {
+            alive: true,
+            subscribedEvents: new Set(),
+            unsub: ctx.events.on('*', (event) => {
+                if (ws.readyState !== WebSocket.OPEN)
+                    return;
+                if (state.subscribedEvents.size > 0) {
+                    if (!state.subscribedEvents.has('*') && !state.subscribedEvents.has(event.type)) {
+                        return;
+                    }
+                }
+                ws.send(JSON.stringify(event));
+            }),
+        };
+        clients.set(ws, state);
+        sendFullState(ws, ctx);
+        ws.on('pong', () => {
+            state.alive = true;
+        });
+        ws.on('message', (raw) => {
+            let parsed;
+            try {
+                parsed = JSON.parse(raw.toString());
+            }
+            catch {
+                ws.send(JSON.stringify({ type: 'error', message: 'Invalid JSON' }));
+                return;
+            }
+            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+                ws.send(JSON.stringify({ type: 'error', message: 'Message must be a JSON object' }));
+                return;
+            }
+            const msg = parsed;
+            if (typeof msg.type !== 'string') {
+                ws.send(JSON.stringify({ type: 'error', message: 'Missing type field' }));
+                return;
+            }
+            switch (msg.type) {
+                case 'refresh':
+                    sendFullState(ws, ctx);
+                    break;
+                case 'subscribe': {
+                    const events = msg.events;
+                    if (!Array.isArray(events)) {
+                        ws.send(JSON.stringify({
+                            type: 'error',
+                            message: '"events" must be an array of event type strings',
+                        }));
+                        break;
+                    }
+                    state.subscribedEvents.clear();
+                    for (const e of events) {
+                        if (typeof e === 'string' && VALID_EVENT_TYPES.has(e)) {
+                            state.subscribedEvents.add(e);
+                        }
+                    }
+                    ws.send(JSON.stringify({ type: 'subscribed', events: [...state.subscribedEvents] }));
+                    break;
+                }
+                default: {
+                    const safeType = String(msg.type)
+                        .slice(0, 64)
+                        .replace(/[<>&"']/g, '');
+                    ws.send(JSON.stringify({ type: 'error', message: `Unknown message type: ${safeType}` }));
+                }
+            }
+        });
+        ws.on('error', () => {
+            const s = clients.get(ws);
+            if (s) {
+                s.unsub();
+                clients.delete(ws);
+            }
+        });
+        ws.on('close', () => {
+            const s = clients.get(ws);
+            if (s) {
+                s.unsub();
+                clients.delete(ws);
+            }
+        });
+    });
+    const pingInterval = setInterval(() => {
+        for (const [ws, state] of clients) {
+            if (!state.alive) {
+                ws.terminate();
+                clients.delete(ws);
+                continue;
+            }
+            state.alive = false;
+            ws.ping();
+        }
+    }, PING_INTERVAL_MS);
+    pingInterval.unref();
+    return {
+        wss,
+        broadcast(message) {
+            for (const [ws] of clients) {
+                if (ws.readyState === WebSocket.OPEN) {
+                    ws.send(message);
+                }
+            }
+        },
+        close() {
+            clearInterval(pingInterval);
+            for (const [ws, state] of clients) {
+                state.unsub();
+                ws.close(1001, 'Server shutting down');
+            }
+            clients.clear();
+            wss.close();
+        },
+    };
+}
+function sendFullState(ws, ctx) {
+    const pkg = JSON.parse(readFileSync(join(__dirname_ws, '..', '..', 'package.json'), 'utf8'));
+    try {
+        ws.send(JSON.stringify({
+            type: 'state',
+            version: pkg.version,
+            tasks: ctx.tasks.list(),
+            dependencies: ctx.tasks.getAllDependencies(),
+            artifactCounts: ctx.tasks.getArtifactCounts(),
+            commentCounts: ctx.comments.countByTask(),
+            subtaskProgress: ctx.tasks.getAllSubtaskProgress(),
+            stages: ctx.tasks.getPipelineStages(),
+        }));
+    }
+    catch {
+        /* ignore send errors on closed sockets */
+    }
+}
+//# sourceMappingURL=ws.js.map

package/dist/transport/ws.js.map

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