@cogitator-ai/express 0.2.0

package/dist/swagger/generator.js

@@ -0,0 +1,486 @@
+export function generateOpenAPISpec(ctx, config) {
+    const spec = {
+        openapi: '3.0.3',
+        info: {
+            title: config.title || 'Cogitator API',
+            description: config.description || 'AI Agent Runtime API',
+            version: config.version || '1.0.0',
+            contact: config.contact,
+            license: config.license,
+        },
+        servers: config.servers || [{ url: ctx.config.basePath, description: 'Default server' }],
+        tags: [
+            { name: 'health', description: 'Health check endpoints' },
+            { name: 'agents', description: 'Agent execution endpoints' },
+            { name: 'threads', description: 'Thread/conversation management' },
+            { name: 'tools', description: 'Tool discovery' },
+            { name: 'workflows', description: 'Workflow execution' },
+            { name: 'swarms', description: 'Multi-agent swarm execution' },
+        ],
+        paths: {},
+        components: {
+            schemas: generateSchemas(),
+            securitySchemes: {
+                bearerAuth: {
+                    type: 'http',
+                    scheme: 'bearer',
+                },
+            },
+        },
+    };
+    spec.paths['/health'] = {
+        get: {
+            tags: ['health'],
+            summary: 'Health check',
+            responses: {
+                200: {
+                    description: 'Service is healthy',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/HealthResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+    spec.paths['/ready'] = {
+        get: {
+            tags: ['health'],
+            summary: 'Readiness check',
+            responses: {
+                200: { description: 'Service is ready' },
+            },
+        },
+    };
+    spec.paths['/agents'] = {
+        get: {
+            tags: ['agents'],
+            summary: 'List all agents',
+            responses: {
+                200: {
+                    description: 'List of agents',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/AgentListResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+    for (const [name] of Object.entries(ctx.agents)) {
+        spec.paths[`/agents/${name}/run`] = {
+            post: {
+                tags: ['agents'],
+                summary: `Run agent: ${name}`,
+                requestBody: {
+                    required: true,
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/AgentRunRequest' },
+                        },
+                    },
+                },
+                responses: {
+                    200: {
+                        description: 'Agent execution result',
+                        content: {
+                            'application/json': {
+                                schema: { $ref: '#/components/schemas/AgentRunResponse' },
+                            },
+                        },
+                    },
+                    404: { description: 'Agent not found' },
+                },
+            },
+        };
+        spec.paths[`/agents/${name}/stream`] = {
+            post: {
+                tags: ['agents'],
+                summary: `Stream agent: ${name}`,
+                requestBody: {
+                    required: true,
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/AgentRunRequest' },
+                        },
+                    },
+                },
+                responses: {
+                    200: {
+                        description: 'SSE stream',
+                        content: { 'text/event-stream': {} },
+                    },
+                },
+            },
+        };
+    }
+    spec.paths['/threads/{id}'] = {
+        get: {
+            tags: ['threads'],
+            summary: 'Get thread by ID',
+            parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+            responses: {
+                200: {
+                    description: 'Thread data',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ThreadResponse' },
+                        },
+                    },
+                },
+                503: { description: 'Memory not configured' },
+            },
+        },
+        delete: {
+            tags: ['threads'],
+            summary: 'Delete thread',
+            parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+            responses: {
+                204: { description: 'Thread deleted' },
+            },
+        },
+    };
+    spec.paths['/threads/{id}/messages'] = {
+        post: {
+            tags: ['threads'],
+            summary: 'Add message to thread',
+            parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+            requestBody: {
+                required: true,
+                content: {
+                    'application/json': {
+                        schema: { $ref: '#/components/schemas/AddMessageRequest' },
+                    },
+                },
+            },
+            responses: {
+                201: { description: 'Message added' },
+            },
+        },
+    };
+    spec.paths['/tools'] = {
+        get: {
+            tags: ['tools'],
+            summary: 'List all tools',
+            responses: {
+                200: {
+                    description: 'List of tools',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ToolListResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+    spec.paths['/workflows'] = {
+        get: {
+            tags: ['workflows'],
+            summary: 'List all workflows',
+            responses: {
+                200: {
+                    description: 'List of workflows',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/WorkflowListResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+    for (const [name] of Object.entries(ctx.workflows)) {
+        spec.paths[`/workflows/${name}/run`] = {
+            post: {
+                tags: ['workflows'],
+                summary: `Run workflow: ${name}`,
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/WorkflowRunRequest' },
+                        },
+                    },
+                },
+                responses: {
+                    200: {
+                        description: 'Workflow result',
+                        content: {
+                            'application/json': {
+                                schema: { $ref: '#/components/schemas/WorkflowRunResponse' },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+        spec.paths[`/workflows/${name}/stream`] = {
+            post: {
+                tags: ['workflows'],
+                summary: `Stream workflow: ${name}`,
+                responses: {
+                    200: {
+                        description: 'SSE stream',
+                        content: { 'text/event-stream': {} },
+                    },
+                },
+            },
+        };
+    }
+    spec.paths['/swarms'] = {
+        get: {
+            tags: ['swarms'],
+            summary: 'List all swarms',
+            responses: {
+                200: {
+                    description: 'List of swarms',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/SwarmListResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+    for (const [name] of Object.entries(ctx.swarms)) {
+        spec.paths[`/swarms/${name}/run`] = {
+            post: {
+                tags: ['swarms'],
+                summary: `Run swarm: ${name}`,
+                requestBody: {
+                    required: true,
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/SwarmRunRequest' },
+                        },
+                    },
+                },
+                responses: {
+                    200: {
+                        description: 'Swarm result',
+                        content: {
+                            'application/json': {
+                                schema: { $ref: '#/components/schemas/SwarmRunResponse' },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+        spec.paths[`/swarms/${name}/stream`] = {
+            post: {
+                tags: ['swarms'],
+                summary: `Stream swarm: ${name}`,
+                responses: {
+                    200: {
+                        description: 'SSE stream',
+                        content: { 'text/event-stream': {} },
+                    },
+                },
+            },
+        };
+        spec.paths[`/swarms/${name}/blackboard`] = {
+            get: {
+                tags: ['swarms'],
+                summary: `Get blackboard: ${name}`,
+                responses: {
+                    200: {
+                        description: 'Blackboard state',
+                        content: {
+                            'application/json': {
+                                schema: { $ref: '#/components/schemas/BlackboardResponse' },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+    }
+    return spec;
+}
+function generateSchemas() {
+    return {
+        HealthResponse: {
+            type: 'object',
+            properties: {
+                status: { type: 'string', enum: ['ok', 'degraded', 'error'] },
+                uptime: { type: 'number' },
+                timestamp: { type: 'number' },
+            },
+        },
+        AgentListResponse: {
+            type: 'object',
+            properties: {
+                agents: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string' },
+                            description: { type: 'string' },
+                            tools: { type: 'array', items: { type: 'string' } },
+                        },
+                    },
+                },
+            },
+        },
+        AgentRunRequest: {
+            type: 'object',
+            required: ['input'],
+            properties: {
+                input: { type: 'string' },
+                context: { type: 'object' },
+                threadId: { type: 'string' },
+            },
+        },
+        AgentRunResponse: {
+            type: 'object',
+            properties: {
+                output: { type: 'string' },
+                threadId: { type: 'string' },
+                usage: {
+                    type: 'object',
+                    properties: {
+                        inputTokens: { type: 'number' },
+                        outputTokens: { type: 'number' },
+                        totalTokens: { type: 'number' },
+                    },
+                },
+                toolCalls: { type: 'array' },
+            },
+        },
+        ThreadResponse: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                messages: { type: 'array' },
+                createdAt: { type: 'number' },
+                updatedAt: { type: 'number' },
+            },
+        },
+        AddMessageRequest: {
+            type: 'object',
+            required: ['role', 'content'],
+            properties: {
+                role: { type: 'string', enum: ['user', 'assistant', 'system'] },
+                content: { type: 'string' },
+                metadata: { type: 'object' },
+            },
+        },
+        ToolListResponse: {
+            type: 'object',
+            properties: {
+                tools: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string' },
+                            description: { type: 'string' },
+                            parameters: { type: 'object' },
+                        },
+                    },
+                },
+            },
+        },
+        WorkflowListResponse: {
+            type: 'object',
+            properties: {
+                workflows: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string' },
+                            entryPoint: { type: 'string' },
+                            nodes: { type: 'array', items: { type: 'string' } },
+                        },
+                    },
+                },
+            },
+        },
+        WorkflowRunRequest: {
+            type: 'object',
+            properties: {
+                input: { type: 'object' },
+                options: { type: 'object' },
+            },
+        },
+        WorkflowRunResponse: {
+            type: 'object',
+            properties: {
+                workflowId: { type: 'string' },
+                workflowName: { type: 'string' },
+                state: { type: 'object' },
+                duration: { type: 'number' },
+                nodeResults: { type: 'object' },
+            },
+        },
+        SwarmListResponse: {
+            type: 'object',
+            properties: {
+                swarms: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string' },
+                            strategy: { type: 'string' },
+                            agents: { type: 'array', items: { type: 'string' } },
+                        },
+                    },
+                },
+            },
+        },
+        SwarmRunRequest: {
+            type: 'object',
+            required: ['input'],
+            properties: {
+                input: { type: 'string' },
+                context: { type: 'object' },
+                threadId: { type: 'string' },
+                timeout: { type: 'number' },
+            },
+        },
+        SwarmRunResponse: {
+            type: 'object',
+            properties: {
+                swarmId: { type: 'string' },
+                swarmName: { type: 'string' },
+                strategy: { type: 'string' },
+                output: {},
+                agentResults: { type: 'object' },
+                usage: {
+                    type: 'object',
+                    properties: {
+                        totalTokens: { type: 'number' },
+                        totalCost: { type: 'number' },
+                        elapsedTime: { type: 'number' },
+                    },
+                },
+            },
+        },
+        BlackboardResponse: {
+            type: 'object',
+            properties: {
+                sections: { type: 'object' },
+            },
+        },
+        ErrorResponse: {
+            type: 'object',
+            properties: {
+                error: {
+                    type: 'object',
+                    properties: {
+                        message: { type: 'string' },
+                        code: { type: 'string' },
+                    },
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/swagger/generator.js.map

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

package/dist/swagger/index.d.ts

@@ -0,0 +1,3 @@
+export { generateOpenAPISpec } from './generator.js';
+export { serveSwaggerUI } from './ui.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/swagger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swagger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/swagger/index.js

@@ -0,0 +1,3 @@
+export { generateOpenAPISpec } from './generator.js';
+export { serveSwaggerUI } from './ui.js';
+//# sourceMappingURL=index.js.map

package/dist/swagger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swagger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/swagger/ui.d.ts

@@ -0,0 +1,4 @@
+import type { Request, Response } from 'express';
+import type { OpenAPISpec } from '../types.js';
+export declare function serveSwaggerUI(spec: OpenAPISpec): (_req: Request, res: Response) => void;
+//# sourceMappingURL=ui.d.ts.map

package/dist/swagger/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/swagger/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,IACtC,MAAM,OAAO,EAAE,KAAK,QAAQ,UAqCrC"}

package/dist/swagger/ui.js

@@ -0,0 +1,39 @@
+export function serveSwaggerUI(spec) {
+    return (_req, res) => {
+        const html = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${spec.info.title} - API Documentation</title>
+  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui.css">
+  <style>
+    body { margin: 0; padding: 0; }
+    .swagger-ui .topbar { display: none; }
+  </style>
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui-bundle.js"></script>
+  <script>
+    window.onload = () => {
+      SwaggerUIBundle({
+        spec: ${JSON.stringify(spec)},
+        dom_id: '#swagger-ui',
+        deepLinking: true,
+        presets: [
+          SwaggerUIBundle.presets.apis,
+          SwaggerUIBundle.SwaggerUIStandalonePreset
+        ],
+        layout: "BaseLayout"
+      });
+    };
+  </script>
+</body>
+</html>`;
+        res.setHeader('Content-Type', 'text/html');
+        res.send(html);
+    };
+}
+//# sourceMappingURL=ui.js.map

package/dist/swagger/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/swagger/ui.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG;;;;;;WAMN,IAAI,CAAC,IAAI,CAAC,KAAK;;;;;;;;;;;;;gBAaV,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;;;QAY5B,CAAC;QAEL,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}