@cogitator-ai/fastify 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cogitator Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,380 @@
+# @cogitator-ai/fastify
+
+Fastify server adapter for Cogitator AI runtime. Automatically generates REST API endpoints for agents, workflows, and swarms with SSE streaming, WebSocket support, and Swagger documentation.
+
+## Installation
+
+```bash
+npm install @cogitator-ai/fastify fastify
+# or
+pnpm add @cogitator-ai/fastify fastify
+```
+
+## Quick Start
+
+```typescript
+import Fastify from 'fastify';
+import { Cogitator, Agent } from '@cogitator-ai/core';
+import { cogitatorPlugin } from '@cogitator-ai/fastify';
+
+const fastify = Fastify({ logger: true });
+
+const cogitator = new Cogitator({
+  defaultBackend: 'openai',
+  backends: { openai: { apiKey: process.env.OPENAI_API_KEY } },
+});
+
+const chatAgent = new Agent({
+  name: 'chat',
+  instructions: 'You are a helpful assistant.',
+  model: 'gpt-4o-mini',
+});
+
+await fastify.register(cogitatorPlugin, {
+  cogitator,
+  agents: { chat: chatAgent },
+  prefix: '/api',
+  enableSwagger: true,
+});
+
+await fastify.listen({ port: 3000 });
+console.log('Server running on http://localhost:3000');
+```
+
+## Auto-generated Endpoints
+
+### Agents
+
+```
+GET    /api/agents                    - List all agents
+POST   /api/agents/:name/run          - Run agent (JSON response)
+POST   /api/agents/:name/stream       - Run agent (SSE stream)
+```
+
+### Threads (Memory)
+
+```
+GET    /api/threads/:id               - Get thread messages
+POST   /api/threads/:id/messages      - Add message to thread
+DELETE /api/threads/:id               - Delete thread
+```
+
+### Workflows
+
+```
+GET    /api/workflows                 - List all workflows
+POST   /api/workflows/:name/run       - Run workflow
+POST   /api/workflows/:name/stream    - Stream workflow events
+```
+
+### Swarms
+
+```
+GET    /api/swarms                    - List all swarms
+POST   /api/swarms/:name/run          - Run swarm
+POST   /api/swarms/:name/stream       - Stream swarm events
+GET    /api/swarms/:name/blackboard   - Get shared state
+```
+
+### Tools & Docs
+
+```
+GET    /api/tools                     - List all tools
+GET    /api/health                    - Health check
+GET    /api/docs                      - Swagger UI
+```
+
+## Configuration
+
+```typescript
+await fastify.register(cogitatorPlugin, {
+  cogitator,
+  agents: { chat: chatAgent, research: researchAgent },
+  workflows: { 'code-review': codeReviewWorkflow },
+  swarms: { 'dev-team': devTeamSwarm },
+  prefix: '/cogitator',
+  enableWebSocket: true,
+  enableSwagger: true,
+
+  // Authentication
+  auth: async (request) => {
+    const token = request.headers.authorization?.replace('Bearer ', '');
+    const user = await validateToken(token);
+    return { userId: user.id, roles: user.roles };
+  },
+
+  // Rate limiting (requires @fastify/rate-limit)
+  rateLimit: {
+    max: 100,
+    timeWindow: '1 minute',
+  },
+
+  // Swagger customization
+  swagger: {
+    title: 'My AI API',
+    description: 'AI-powered API endpoints',
+    version: '1.0.0',
+  },
+
+  // WebSocket options
+  websocket: {
+    path: '/ws',
+    pingInterval: 30000,
+  },
+});
+```
+
+## SSE Streaming
+
+The `/agents/:name/stream` endpoint returns Server-Sent Events:
+
+```typescript
+const response = await fetch('/api/agents/chat/stream', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ input: 'Hello!' }),
+});
+
+const reader = response.body.getReader();
+const decoder = new TextDecoder();
+
+while (true) {
+  const { done, value } = await reader.read();
+  if (done) break;
+
+  const lines = decoder.decode(value).split('\n');
+  for (const line of lines) {
+    if (line.startsWith('data: ')) {
+      const event = JSON.parse(line.slice(6));
+      console.log(event);
+      // { type: 'text-delta', id: '...', delta: 'Hello' }
+    }
+  }
+}
+```
+
+### Stream Events
+
+| Event Type        | Description                             |
+| ----------------- | --------------------------------------- |
+| `start`           | Stream started, includes message ID     |
+| `text-start`      | Text generation started                 |
+| `text-delta`      | Text chunk received                     |
+| `text-end`        | Text generation finished                |
+| `tool-call-start` | Tool execution started                  |
+| `tool-call-end`   | Tool execution finished                 |
+| `tool-result`     | Tool returned result                    |
+| `workflow`        | Workflow event (node started/completed) |
+| `swarm`           | Swarm event (agent started/completed)   |
+| `error`           | Error occurred                          |
+| `finish`          | Stream finished, includes usage stats   |
+
+## WebSocket Support
+
+Enable real-time bidirectional communication:
+
+```typescript
+await fastify.register(cogitatorPlugin, {
+  // ...
+  enableWebSocket: true,
+});
+```
+
+Client usage:
+
+```typescript
+const ws = new WebSocket('ws://localhost:3000/api/ws');
+
+ws.onmessage = (event) => {
+  const message = JSON.parse(event.data);
+  console.log(message);
+};
+
+// Run agent
+ws.send(
+  JSON.stringify({
+    type: 'run',
+    id: 'req-1',
+    payload: {
+      type: 'agent',
+      name: 'chat',
+      input: 'Hello!',
+    },
+  })
+);
+
+// Subscribe to channel
+ws.send(JSON.stringify({ type: 'subscribe', channel: 'updates' }));
+
+// Ping/pong
+ws.send(JSON.stringify({ type: 'ping' }));
+```
+
+### WebSocket Message Types
+
+| Type          | Direction     | Description              |
+| ------------- | ------------- | ------------------------ |
+| `ping`        | Client→Server | Heartbeat                |
+| `pong`        | Server→Client | Heartbeat response       |
+| `subscribe`   | Client→Server | Subscribe to channel     |
+| `subscribed`  | Server→Client | Subscription confirmed   |
+| `unsubscribe` | Client→Server | Unsubscribe from channel |
+| `run`         | Client→Server | Run agent/workflow/swarm |
+| `stop`        | Client→Server | Cancel running operation |
+| `event`       | Server→Client | Stream event             |
+| `error`       | Server→Client | Error message            |
+
+## Custom Streaming
+
+Use `FastifyStreamWriter` for custom streaming routes:
+
+```typescript
+import { FastifyStreamWriter, generateId } from '@cogitator-ai/fastify';
+
+fastify.post('/custom/stream', async (request, reply) => {
+  const writer = new FastifyStreamWriter(reply);
+  const messageId = generateId('msg');
+
+  writer.start(messageId);
+  const textId = generateId('txt');
+  writer.textStart(textId);
+
+  // Your streaming logic
+  writer.textDelta(textId, 'Hello ');
+  writer.textDelta(textId, 'World!');
+
+  writer.textEnd(textId);
+  writer.finish(messageId);
+  writer.close();
+});
+```
+
+## Optional Dependencies
+
+Install these packages to enable additional features:
+
+```bash
+# Swagger UI
+pnpm add @fastify/swagger @fastify/swagger-ui
+
+# Rate limiting
+pnpm add @fastify/rate-limit
+
+# WebSocket support
+pnpm add @fastify/websocket
+
+# Workflows support
+pnpm add @cogitator-ai/workflows
+
+# Swarms support
+pnpm add @cogitator-ai/swarms
+```
+
+## API Reference
+
+### cogitatorPlugin
+
+```typescript
+import { cogitatorPlugin } from '@cogitator-ai/fastify';
+
+await fastify.register(cogitatorPlugin, options);
+```
+
+### CogitatorPluginOptions
+
+```typescript
+interface CogitatorPluginOptions {
+  cogitator: Cogitator;
+  agents?: Record<string, Agent>;
+  workflows?: Record<string, Workflow>;
+  swarms?: Record<string, SwarmConfig>;
+  prefix?: string; // Default: '/cogitator'
+  auth?: AuthFunction;
+  rateLimit?: RateLimitConfig;
+  enableSwagger?: boolean; // Default: false
+  enableWebSocket?: boolean; // Default: false
+  swagger?: SwaggerConfig;
+  websocket?: WebSocketConfig;
+  requestTimeout?: number;
+}
+```
+
+### FastifyStreamWriter
+
+```typescript
+class FastifyStreamWriter {
+  constructor(reply: FastifyReply);
+  start(messageId: string): void;
+  textStart(id: string): void;
+  textDelta(id: string, delta: string): void;
+  textEnd(id: string): void;
+  toolCallStart(id: string, toolName: string): void;
+  toolCallDelta(id: string, argsTextDelta: string): void;
+  toolCallEnd(id: string): void;
+  toolResult(id: string, toolCallId: string, result: unknown): void;
+  workflowEvent(event: string, data: unknown): void;
+  swarmEvent(event: string, data: unknown): void;
+  error(message: string, code?: string): void;
+  finish(messageId: string, usage?: Usage): void;
+  close(): void;
+}
+```
+
+## Fastify Decorators
+
+The plugin adds decorators to the Fastify instance:
+
+```typescript
+// Access cogitator context
+fastify.cogitator.runtime; // Cogitator instance
+fastify.cogitator.agents; // Registered agents
+fastify.cogitator.workflows; // Registered workflows
+fastify.cogitator.swarms; // Registered swarms
+
+// Request decorators (in handlers)
+request.cogitatorAuth; // Auth context from auth hook
+request.cogitatorRequestId; // Unique request ID
+request.cogitatorStartTime; // Request start timestamp
+```
+
+## Error Handling
+
+All endpoints return consistent error responses:
+
+```json
+{
+  "error": {
+    "message": "Agent 'unknown' not found",
+    "code": "NOT_FOUND"
+  }
+}
+```
+
+Error codes map to HTTP status codes:
+
+- `INVALID_INPUT` → 400
+- `UNAUTHORIZED` → 401
+- `PERMISSION_DENIED` → 403
+- `NOT_FOUND` → 404
+- `RATE_LIMIT_EXCEEDED` → 429
+- `INTERNAL` → 500
+- `UNAVAILABLE` → 503
+- `UNIMPLEMENTED` → 501
+
+## JSON Schema Validation
+
+Fastify's built-in validation is used for all endpoints. Request schemas are exported:
+
+```typescript
+import {
+  AgentRunRequestSchema,
+  AgentRunResponseSchema,
+  AddMessageRequestSchema,
+  WorkflowRunRequestSchema,
+  SwarmRunRequestSchema,
+} from '@cogitator-ai/fastify';
+```
+
+## License
+
+MIT

package/dist/hooks/auth.d.ts

@@ -0,0 +1,4 @@
+import type { onRequestHookHandler } from 'fastify';
+import type { AuthFunction } from '../types.js';
+export declare function createAuthHook(authFn?: AuthFunction): onRequestHookHandler;
+//# sourceMappingURL=auth.d.ts.map

package/dist/hooks/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/hooks/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,oBAAoB,CAqB1E"}

package/dist/hooks/auth.js

@@ -0,0 +1,23 @@
+import { generateId } from '../streaming/helpers.js';
+export function createAuthHook(authFn) {
+    return async (request, reply) => {
+        request.cogitatorRequestId = generateId('req');
+        request.cogitatorStartTime = Date.now();
+        if (!authFn) {
+            return;
+        }
+        try {
+            const auth = await authFn(request);
+            request.cogitatorAuth = auth;
+        }
+        catch {
+            return reply.status(401).send({
+                error: {
+                    message: 'Unauthorized',
+                    code: 'UNAUTHORIZED',
+                },
+            });
+        }
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/hooks/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/hooks/auth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,OAAO,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;QAC5D,OAAO,CAAC,kBAAkB,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAExC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC5B,KAAK,EAAE;oBACL,OAAO,EAAE,cAAc;oBACvB,IAAI,EAAE,cAAc;iBACrB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/error-handler.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyError, FastifyRequest, FastifyReply } from 'fastify';
+export declare function errorHandler(error: FastifyError, _request: FastifyRequest, reply: FastifyReply): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/hooks/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/hooks/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1E,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,YAAY,GAClB,IAAI,CAwBN"}

package/dist/hooks/error-handler.js

@@ -0,0 +1,24 @@
+import { CogitatorError, ERROR_STATUS_CODES, ErrorCode } from '@cogitator-ai/types';
+export function errorHandler(error, _request, reply) {
+    if (reply.sent) {
+        return;
+    }
+    if (CogitatorError.isCogitatorError(error)) {
+        const statusCode = ERROR_STATUS_CODES[error.code] || 500;
+        reply.status(statusCode).send({
+            error: {
+                message: error.message,
+                code: error.code,
+            },
+        });
+        return;
+    }
+    console.error('[CogitatorPlugin] Unhandled error:', error);
+    reply.status(500).send({
+        error: {
+            message: 'Internal server error',
+            code: ErrorCode.INTERNAL_ERROR,
+        },
+    });
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/hooks/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/hooks/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEpF,MAAM,UAAU,YAAY,CAC1B,KAAmB,EACnB,QAAwB,EACxB,KAAmB;IAEnB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,IAAI,cAAc,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;QACzD,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;YAC5B,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB;SACF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;IAE3D,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACrB,KAAK,EAAE;YACL,OAAO,EAAE,uBAAuB;YAChC,IAAI,EAAE,SAAS,CAAC,cAAc;SAC/B;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { createAuthHook } from './auth.js';
+export { errorHandler } from './error-handler.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,3 @@
+export { createAuthHook } from './auth.js';
+export { errorHandler } from './error-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { cogitatorPlugin } from './plugin.js';
+export type { CogitatorPluginOptions, CogitatorContext, AuthContext, AuthFunction, RateLimitConfig, SwaggerConfig, WebSocketConfig, AgentListResponse, AgentRunRequest, AgentRunResponse, ThreadResponse, AddMessageRequest, ToolListResponse, WorkflowListResponse, WorkflowRunRequest, WorkflowRunResponse, WorkflowStatusResponse, SwarmListResponse, SwarmRunRequest, SwarmRunResponse, BlackboardResponse, HealthResponse, ErrorResponse, WebSocketMessage, WebSocketResponse, OpenAPISpec, } from './types.js';
+export { AgentRunRequestSchema, AgentRunResponseSchema, AddMessageRequestSchema, WorkflowRunRequestSchema, SwarmRunRequestSchema, } from './types.js';
+export { FastifyStreamWriter } from './streaming/index.js';
+export type { StreamEvent, Usage } from './streaming/protocol.js';
+export { createStartEvent, createTextStartEvent, createTextDeltaEvent, createTextEndEvent, createToolCallStartEvent, createToolCallDeltaEvent, createToolCallEndEvent, createToolResultEvent, createErrorEvent, createFinishEvent, createWorkflowEvent, createSwarmEvent, } from './streaming/protocol.js';
+export { generateId, encodeSSE, encodeDone } from './streaming/helpers.js';
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { cogitatorPlugin } from './plugin.js';
+export { AgentRunRequestSchema, AgentRunResponseSchema, AddMessageRequestSchema, WorkflowRunRequestSchema, SwarmRunRequestSchema, } from './types.js';
+export { FastifyStreamWriter } from './streaming/index.js';
+export { createStartEvent, createTextStartEvent, createTextDeltaEvent, createTextEndEvent, createToolCallStartEvent, createToolCallDeltaEvent, createToolCallEndEvent, createToolResultEvent, createErrorEvent, createFinishEvent, createWorkflowEvent, createSwarmEvent, } from './streaming/protocol.js';
+export { generateId, encodeSSE, encodeDone } from './streaming/helpers.js';
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA+B9C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyPluginAsync } from 'fastify';
+import type { CogitatorPluginOptions } from './types.js';
+export declare const cogitatorPlugin: FastifyPluginAsync<CogitatorPluginOptions>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,SAAS,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAoB,MAAM,YAAY,CAAC;AA0G3E,eAAO,MAAM,eAAe,4CAG1B,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,90 @@
+import fp from 'fastify-plugin';
+import { createAuthHook, errorHandler } from './hooks/index.js';
+import { healthRoutes, agentRoutes, threadRoutes, toolRoutes, workflowRoutes, swarmRoutes, } from './routes/index.js';
+const cogitatorPluginImpl = async (fastify, opts) => {
+    const context = {
+        runtime: opts.cogitator,
+        agents: opts.agents ?? {},
+        workflows: opts.workflows ?? {},
+        swarms: opts.swarms ?? {},
+    };
+    fastify.decorate('cogitator', context);
+    fastify.decorateRequest('cogitatorAuth', undefined);
+    fastify.decorateRequest('cogitatorRequestId', '');
+    fastify.decorateRequest('cogitatorStartTime', 0);
+    fastify.addHook('onRequest', createAuthHook(opts.auth));
+    if (opts.rateLimit) {
+        try {
+            const rateLimitModule = await import('@fastify/rate-limit');
+            await fastify.register(rateLimitModule.default, {
+                max: opts.rateLimit.max,
+                timeWindow: opts.rateLimit.timeWindow,
+                keyGenerator: opts.rateLimit.keyGenerator,
+                errorResponseBuilder: opts.rateLimit.errorResponseBuilder,
+            });
+        }
+        catch {
+            fastify.log.warn('@fastify/rate-limit not installed, skipping rate limiting');
+        }
+    }
+    const prefix = opts.prefix ?? '/cogitator';
+    await fastify.register(async (instance) => {
+        await instance.register(healthRoutes);
+        await instance.register(agentRoutes);
+        await instance.register(threadRoutes);
+        await instance.register(toolRoutes);
+        await instance.register(workflowRoutes);
+        await instance.register(swarmRoutes);
+        if (opts.enableSwagger) {
+            try {
+                const swaggerModule = await import('@fastify/swagger');
+                const swaggerUiModule = await import('@fastify/swagger-ui');
+                await instance.register(swaggerModule.default, {
+                    openapi: {
+                        info: {
+                            title: opts.swagger?.title ?? 'Cogitator API',
+                            description: opts.swagger?.description ?? 'AI Agent Runtime API',
+                            version: opts.swagger?.version ?? '1.0.0',
+                            contact: opts.swagger?.contact,
+                            license: opts.swagger?.license,
+                        },
+                        servers: opts.swagger?.servers ?? [{ url: '/', description: 'Current server' }],
+                        tags: [
+                            { name: 'agents', description: 'Agent operations' },
+                            { name: 'threads', description: 'Thread/memory operations' },
+                            { name: 'tools', description: 'Tool operations' },
+                            { name: 'workflows', description: 'Workflow operations' },
+                            { name: 'swarms', description: 'Swarm operations' },
+                            { name: 'health', description: 'Health check endpoints' },
+                        ],
+                    },
+                });
+                await instance.register(swaggerUiModule.default, {
+                    routePrefix: '/docs',
+                });
+            }
+            catch {
+                fastify.log.warn('@fastify/swagger not installed, skipping Swagger UI');
+            }
+        }
+        if (opts.enableWebSocket) {
+            try {
+                const websocketModule = await import('@fastify/websocket');
+                await instance.register(websocketModule.default);
+                const { websocketRoutes } = await import('./websocket/handler.js');
+                await instance.register(websocketRoutes, { path: opts.websocket?.path });
+            }
+            catch {
+                fastify.log.warn('@fastify/websocket not installed, skipping WebSocket support');
+            }
+        }
+    }, { prefix });
+    fastify.setErrorHandler((error, request, reply) => {
+        errorHandler(error, request, reply);
+    });
+};
+export const cogitatorPlugin = fp(cogitatorPluginImpl, {
+    fastify: '5.x',
+    name: '@cogitator-ai/fastify',
+});
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGhC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,MAAM,mBAAmB,GAA+C,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAC9F,MAAM,OAAO,GAAqB;QAChC,OAAO,EAAE,IAAI,CAAC,SAAS;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;KAC1B,CAAC;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEvC,OAAO,CAAC,eAAe,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IACpD,OAAO,CAAC,eAAe,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,eAAe,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC;IAEjD,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC5D,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE;gBAC9C,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG;gBACvB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU;gBACrC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY;gBACzC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB;aAC1D,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC;IAE3C,MAAM,OAAO,CAAC,QAAQ,CACpB,KAAK,EAAE,QAAQ,EAAE,EAAE;QACjB,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACtC,MAAM,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACtC,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACxC,MAAM,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAErC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBACvD,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;gBAE5D,MAAM,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE;oBAC7C,OAAO,EAAE;wBACP,IAAI,EAAE;4BACJ,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,eAAe;4BAC7C,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,sBAAsB;4BAChE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO;4BACzC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO;4BAC9B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO;yBAC/B;wBACD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;wBAC/E,IAAI,EAAE;4BACJ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;4BACnD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;4BAC5D,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE;4BACjD,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,qBAAqB,EAAE;4BACzD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;4BACnD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;yBAC1D;qBACF;iBACF,CAAC,CAAC;gBAEH,MAAM,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE;oBAC/C,WAAW,EAAE,OAAO;iBACrB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBAC3D,MAAM,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAEjD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBACnE,MAAM,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC,EACD,EAAE,MAAM,EAAE,CACX,CAAC;IAEF,OAAO,CAAC,eAAe,CAAC,CAAC,KAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC9D,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC,mBAAmB,EAAE;IACrD,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,uBAAuB;CAC9B,CAAC,CAAC"}

package/dist/routes/agents.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyPluginAsync } from 'fastify';
+export declare const agentRoutes: FastifyPluginAsync;
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/routes/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAUlD,eAAO,MAAM,WAAW,EAAE,kBA6IzB,CAAC"}