@cogitator-ai/koa 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +112 -0
  3. package/dist/app.d.ts +4 -0
  4. package/dist/app.d.ts.map +1 -0
  5. package/dist/app.js +29 -0
  6. package/dist/app.js.map +1 -0
  7. package/dist/index.d.ts +9 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +7 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/middleware/auth.d.ts +4 -0
  12. package/dist/middleware/auth.d.ts.map +1 -0
  13. package/dist/middleware/auth.js +19 -0
  14. package/dist/middleware/auth.js.map +1 -0
  15. package/dist/middleware/body-parser.d.ts +3 -0
  16. package/dist/middleware/body-parser.d.ts.map +1 -0
  17. package/dist/middleware/body-parser.js +21 -0
  18. package/dist/middleware/body-parser.js.map +1 -0
  19. package/dist/middleware/context.d.ts +4 -0
  20. package/dist/middleware/context.d.ts.map +1 -0
  21. package/dist/middleware/context.js +17 -0
  22. package/dist/middleware/context.js.map +1 -0
  23. package/dist/middleware/error-handler.d.ts +3 -0
  24. package/dist/middleware/error-handler.d.ts.map +1 -0
  25. package/dist/middleware/error-handler.js +29 -0
  26. package/dist/middleware/error-handler.js.map +1 -0
  27. package/dist/middleware/index.d.ts +5 -0
  28. package/dist/middleware/index.d.ts.map +1 -0
  29. package/dist/middleware/index.js +5 -0
  30. package/dist/middleware/index.js.map +1 -0
  31. package/dist/routes/agents.d.ts +4 -0
  32. package/dist/routes/agents.d.ts.map +1 -0
  33. package/dist/routes/agents.js +115 -0
  34. package/dist/routes/agents.js.map +1 -0
  35. package/dist/routes/health.d.ts +4 -0
  36. package/dist/routes/health.d.ts.map +1 -0
  37. package/dist/routes/health.js +18 -0
  38. package/dist/routes/health.js.map +1 -0
  39. package/dist/routes/index.d.ts +7 -0
  40. package/dist/routes/index.d.ts.map +1 -0
  41. package/dist/routes/index.js +7 -0
  42. package/dist/routes/index.js.map +1 -0
  43. package/dist/routes/swarms.d.ts +4 -0
  44. package/dist/routes/swarms.d.ts.map +1 -0
  45. package/dist/routes/swarms.js +176 -0
  46. package/dist/routes/swarms.js.map +1 -0
  47. package/dist/routes/threads.d.ts +4 -0
  48. package/dist/routes/threads.d.ts.map +1 -0
  49. package/dist/routes/threads.js +96 -0
  50. package/dist/routes/threads.js.map +1 -0
  51. package/dist/routes/tools.d.ts +4 -0
  52. package/dist/routes/tools.d.ts.map +1 -0
  53. package/dist/routes/tools.js +30 -0
  54. package/dist/routes/tools.js.map +1 -0
  55. package/dist/routes/workflows.d.ts +4 -0
  56. package/dist/routes/workflows.d.ts.map +1 -0
  57. package/dist/routes/workflows.js +110 -0
  58. package/dist/routes/workflows.js.map +1 -0
  59. package/dist/streaming/index.d.ts +3 -0
  60. package/dist/streaming/index.d.ts.map +1 -0
  61. package/dist/streaming/index.js +3 -0
  62. package/dist/streaming/index.js.map +1 -0
  63. package/dist/streaming/koa-stream-writer.d.ts +24 -0
  64. package/dist/streaming/koa-stream-writer.d.ts.map +1 -0
  65. package/dist/streaming/koa-stream-writer.js +74 -0
  66. package/dist/streaming/koa-stream-writer.js.map +1 -0
  67. package/dist/types.d.ts +164 -0
  68. package/dist/types.d.ts.map +1 -0
  69. package/dist/types.js +2 -0
  70. package/dist/types.js.map +1 -0
  71. package/dist/websocket/handler.d.ts +6 -0
  72. package/dist/websocket/handler.d.ts.map +1 -0
  73. package/dist/websocket/handler.js +161 -0
  74. package/dist/websocket/handler.js.map +1 -0
  75. package/dist/websocket/index.d.ts +2 -0
  76. package/dist/websocket/index.d.ts.map +1 -0
  77. package/dist/websocket/index.js +2 -0
  78. package/dist/websocket/index.js.map +1 -0
  79. package/package.json +67 -0
@@ -0,0 +1,164 @@
1
+ import type { Context, Next } from 'koa';
2
+ import type { Cogitator, Agent } from '@cogitator-ai/core';
3
+ import type { Message, ToolCall, ToolResult, RunResult, Workflow, WorkflowResult, WorkflowState, SwarmConfig, SwarmResult, SwarmRunOptions, StreamingWorkflowEvent, SwarmEvent, SwarmMessage } from '@cogitator-ai/types';
4
+ export type { Message, ToolCall, ToolResult, RunResult, Workflow, WorkflowResult, WorkflowState, SwarmConfig, SwarmResult, SwarmRunOptions, StreamingWorkflowEvent, SwarmEvent, SwarmMessage, };
5
+ export interface AuthContext {
6
+ userId?: string;
7
+ roles?: string[];
8
+ permissions?: string[];
9
+ metadata?: Record<string, unknown>;
10
+ }
11
+ export type AuthFunction = (ctx: Context) => Promise<AuthContext | undefined> | AuthContext | undefined;
12
+ export interface WebSocketConfig {
13
+ path?: string;
14
+ pingInterval?: number;
15
+ pingTimeout?: number;
16
+ maxPayloadSize?: number;
17
+ }
18
+ export interface CogitatorAppOptions {
19
+ cogitator: Cogitator;
20
+ agents?: Record<string, Agent>;
21
+ workflows?: Record<string, Workflow<WorkflowState>>;
22
+ swarms?: Record<string, SwarmConfig>;
23
+ auth?: AuthFunction;
24
+ enableWebSocket?: boolean;
25
+ websocket?: WebSocketConfig;
26
+ }
27
+ export interface CogitatorState {
28
+ cogitator: RouteContext;
29
+ auth?: AuthContext;
30
+ requestId: string;
31
+ startTime: number;
32
+ }
33
+ export interface RouteContext {
34
+ cogitator: Cogitator;
35
+ agents: Record<string, Agent>;
36
+ workflows: Record<string, Workflow<WorkflowState>>;
37
+ swarms: Record<string, SwarmConfig>;
38
+ }
39
+ export type KoaMiddleware = (ctx: Context, next: Next) => Promise<void>;
40
+ export interface AgentListResponse {
41
+ agents: Array<{
42
+ name: string;
43
+ description?: string;
44
+ tools: string[];
45
+ }>;
46
+ }
47
+ export interface AgentRunRequest {
48
+ input: string;
49
+ context?: Record<string, unknown>;
50
+ threadId?: string;
51
+ }
52
+ export interface AgentRunResponse {
53
+ output: string;
54
+ threadId?: string;
55
+ usage: {
56
+ inputTokens: number;
57
+ outputTokens: number;
58
+ totalTokens: number;
59
+ };
60
+ toolCalls: ToolCall[];
61
+ }
62
+ export interface ThreadResponse {
63
+ id: string;
64
+ messages: Message[];
65
+ metadata?: Record<string, unknown>;
66
+ createdAt: number;
67
+ updatedAt: number;
68
+ }
69
+ export interface AddMessageRequest {
70
+ role: 'user' | 'assistant' | 'system';
71
+ content: string;
72
+ metadata?: Record<string, unknown>;
73
+ }
74
+ export interface ToolListResponse {
75
+ tools: Array<{
76
+ name: string;
77
+ description?: string;
78
+ parameters: Record<string, unknown>;
79
+ }>;
80
+ }
81
+ export interface WorkflowListResponse {
82
+ workflows: Array<{
83
+ name: string;
84
+ entryPoint: string;
85
+ nodes: string[];
86
+ }>;
87
+ }
88
+ export interface WorkflowRunRequest {
89
+ input?: Record<string, unknown>;
90
+ options?: {
91
+ maxConcurrency?: number;
92
+ maxIterations?: number;
93
+ checkpoint?: boolean;
94
+ };
95
+ }
96
+ export interface WorkflowRunResponse {
97
+ workflowId: string;
98
+ workflowName: string;
99
+ state: WorkflowState;
100
+ duration: number;
101
+ nodeResults: Record<string, {
102
+ output: unknown;
103
+ duration: number;
104
+ }>;
105
+ }
106
+ export interface SwarmListResponse {
107
+ swarms: Array<{
108
+ name: string;
109
+ strategy: string;
110
+ agents: string[];
111
+ }>;
112
+ }
113
+ export interface SwarmRunRequest {
114
+ input: string;
115
+ context?: Record<string, unknown>;
116
+ threadId?: string;
117
+ timeout?: number;
118
+ }
119
+ export interface SwarmRunResponse {
120
+ swarmId: string;
121
+ swarmName: string;
122
+ strategy: string;
123
+ output: unknown;
124
+ agentResults: Record<string, unknown>;
125
+ usage: {
126
+ totalTokens: number;
127
+ totalCost: number;
128
+ elapsedTime: number;
129
+ };
130
+ }
131
+ export interface BlackboardResponse {
132
+ sections: Record<string, unknown>;
133
+ }
134
+ export interface HealthResponse {
135
+ status: 'ok' | 'degraded' | 'error';
136
+ version?: string;
137
+ uptime: number;
138
+ timestamp: number;
139
+ checks?: Record<string, {
140
+ status: 'ok' | 'error';
141
+ message?: string;
142
+ }>;
143
+ }
144
+ export interface ErrorResponse {
145
+ error: {
146
+ message: string;
147
+ code?: string;
148
+ details?: unknown;
149
+ };
150
+ }
151
+ export interface WebSocketMessage {
152
+ type: 'subscribe' | 'unsubscribe' | 'run' | 'stop' | 'ping';
153
+ id?: string;
154
+ channel?: string;
155
+ payload?: unknown;
156
+ }
157
+ export interface WebSocketResponse {
158
+ type: 'subscribed' | 'unsubscribed' | 'event' | 'error' | 'pong';
159
+ id?: string;
160
+ channel?: string;
161
+ payload?: unknown;
162
+ error?: string;
163
+ }
164
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,6 @@
1
+ import type { Server as HttpServer } from 'http';
2
+ import type { RouteContext, WebSocketConfig } from '../types.js';
3
+ type WebSocketServerType = import('ws').WebSocketServer;
4
+ export declare function setupWebSocket(server: HttpServer, ctx: RouteContext, config?: WebSocketConfig): Promise<WebSocketServerType | null>;
5
+ export {};
6
+ //# sourceMappingURL=handler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/websocket/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,KAAK,EAGV,YAAY,EACZ,eAAe,EAChB,MAAM,aAAa,CAAC;AAKrB,KAAK,mBAAmB,GAAG,OAAO,IAAI,EAAE,eAAe,CAAC;AAexD,wBAAsB,cAAc,CAClC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,YAAY,EACjB,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAiErC"}
@@ -0,0 +1,161 @@
1
+ import { generateId } from '@cogitator-ai/server-shared';
2
+ const clients = new Map();
3
+ export async function setupWebSocket(server, ctx, config = {}) {
4
+ try {
5
+ const { WebSocketServer } = await import('ws');
6
+ const wss = new WebSocketServer({
7
+ server,
8
+ path: config.path || '/ws',
9
+ maxPayload: config.maxPayloadSize || 1024 * 1024,
10
+ });
11
+ const pingInterval = config.pingInterval || 30000;
12
+ wss.on('connection', (ws) => {
13
+ const clientState = {
14
+ id: generateId('ws'),
15
+ subscriptions: new Map(),
16
+ };
17
+ clients.set(ws, clientState);
18
+ let alive = true;
19
+ const heartbeat = setInterval(() => {
20
+ if (!alive) {
21
+ clearInterval(heartbeat);
22
+ ws.terminate();
23
+ return;
24
+ }
25
+ alive = false;
26
+ ws.ping();
27
+ }, pingInterval);
28
+ ws.on('pong', () => {
29
+ alive = true;
30
+ });
31
+ ws.on('message', async (data) => {
32
+ try {
33
+ const message = JSON.parse(data.toString());
34
+ await handleMessage(ws, message, ctx, clientState);
35
+ }
36
+ catch (error) {
37
+ sendResponse(ws, {
38
+ type: 'error',
39
+ error: error instanceof Error ? error.message : 'Invalid message',
40
+ });
41
+ }
42
+ });
43
+ ws.on('close', () => {
44
+ clearInterval(heartbeat);
45
+ clientState.abortController?.abort();
46
+ clients.delete(ws);
47
+ });
48
+ ws.on('error', () => {
49
+ clearInterval(heartbeat);
50
+ clientState.abortController?.abort();
51
+ clients.delete(ws);
52
+ });
53
+ });
54
+ console.log('[CogitatorKoa] WebSocket enabled');
55
+ return wss;
56
+ }
57
+ catch {
58
+ console.warn('[CogitatorKoa] WebSocket setup failed (ws package not installed)');
59
+ return null;
60
+ }
61
+ }
62
+ async function handleMessage(ws, message, ctx, state) {
63
+ switch (message.type) {
64
+ case 'ping':
65
+ sendResponse(ws, { type: 'pong' });
66
+ break;
67
+ case 'subscribe':
68
+ if (message.channel) {
69
+ state.subscriptions.set(message.channel, {
70
+ channel: message.channel,
71
+ callback: (data) => {
72
+ sendResponse(ws, { type: 'event', channel: message.channel, payload: data });
73
+ },
74
+ });
75
+ sendResponse(ws, { type: 'subscribed', channel: message.channel });
76
+ }
77
+ break;
78
+ case 'unsubscribe':
79
+ if (message.channel) {
80
+ state.subscriptions.delete(message.channel);
81
+ sendResponse(ws, { type: 'unsubscribed', channel: message.channel });
82
+ }
83
+ break;
84
+ case 'run':
85
+ await handleRun(ws, message, ctx, state);
86
+ break;
87
+ case 'stop':
88
+ state.abortController?.abort();
89
+ state.abortController = undefined;
90
+ break;
91
+ }
92
+ }
93
+ async function handleRun(ws, message, ctx, state) {
94
+ const payload = message.payload;
95
+ if (!payload?.type || !payload?.name || !payload?.input) {
96
+ sendResponse(ws, { type: 'error', id: message.id, error: 'Invalid run payload' });
97
+ return;
98
+ }
99
+ state.abortController = new AbortController();
100
+ try {
101
+ if (payload.type === 'agent') {
102
+ const agent = ctx.agents[payload.name];
103
+ if (!agent) {
104
+ sendResponse(ws, {
105
+ type: 'error',
106
+ id: message.id,
107
+ error: `Agent '${payload.name}' not found`,
108
+ });
109
+ return;
110
+ }
111
+ const result = await ctx.cogitator.run(agent, {
112
+ input: payload.input,
113
+ context: payload.context,
114
+ stream: true,
115
+ onToken: (token) => {
116
+ sendResponse(ws, {
117
+ type: 'event',
118
+ id: message.id,
119
+ payload: { type: 'token', delta: token },
120
+ });
121
+ },
122
+ onToolCall: (toolCall) => {
123
+ sendResponse(ws, {
124
+ type: 'event',
125
+ id: message.id,
126
+ payload: { type: 'tool-call', ...toolCall },
127
+ });
128
+ },
129
+ onToolResult: (toolResult) => {
130
+ sendResponse(ws, {
131
+ type: 'event',
132
+ id: message.id,
133
+ payload: { type: 'tool-result', ...toolResult },
134
+ });
135
+ },
136
+ });
137
+ sendResponse(ws, { type: 'event', id: message.id, payload: { type: 'complete', result } });
138
+ }
139
+ }
140
+ catch (error) {
141
+ if (state.abortController?.signal.aborted) {
142
+ sendResponse(ws, { type: 'event', id: message.id, payload: { type: 'cancelled' } });
143
+ }
144
+ else {
145
+ sendResponse(ws, {
146
+ type: 'error',
147
+ id: message.id,
148
+ error: error instanceof Error ? error.message : 'Unknown error',
149
+ });
150
+ }
151
+ }
152
+ }
153
+ function sendResponse(ws, response) {
154
+ try {
155
+ if (ws.readyState === 1) {
156
+ ws.send(JSON.stringify(response));
157
+ }
158
+ }
159
+ catch { }
160
+ }
161
+ //# sourceMappingURL=handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/websocket/handler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export { setupWebSocket } from './handler.js';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { setupWebSocket } from './handler.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
package/package.json ADDED
@@ -0,0 +1,67 @@
1
+ {
2
+ "name": "@cogitator-ai/koa",
3
+ "version": "0.1.0",
4
+ "description": "Koa server adapter for Cogitator AI runtime",
5
+ "type": "module",
6
+ "exports": {
7
+ ".": {
8
+ "types": "./dist/index.d.ts",
9
+ "import": "./dist/index.js"
10
+ }
11
+ },
12
+ "main": "./dist/index.js",
13
+ "types": "./dist/index.d.ts",
14
+ "files": [
15
+ "dist"
16
+ ],
17
+ "dependencies": {
18
+ "@cogitator-ai/core": "0.17.5",
19
+ "@cogitator-ai/types": "0.19.3",
20
+ "@cogitator-ai/server-shared": "0.1.0"
21
+ },
22
+ "peerDependencies": {
23
+ "koa": ">=2.15.0",
24
+ "@koa/router": ">=12.0.0"
25
+ },
26
+ "optionalDependencies": {
27
+ "ws": "^8.0.0",
28
+ "@cogitator-ai/swarms": "0.4.7",
29
+ "@cogitator-ai/workflows": "0.5.4"
30
+ },
31
+ "devDependencies": {
32
+ "@types/koa": "^2.15.0",
33
+ "@types/koa__router": "^12.0.0",
34
+ "@types/ws": "^8.5.0",
35
+ "koa": "^2.15.0",
36
+ "@koa/router": "^13.1.0",
37
+ "typescript": "^5.6.0",
38
+ "ws": "^8.18.0",
39
+ "@cogitator-ai/swarms": "0.4.7",
40
+ "@cogitator-ai/workflows": "0.5.4"
41
+ },
42
+ "repository": {
43
+ "type": "git",
44
+ "url": "https://github.com/cogitator-ai/Cogitator-AI.git",
45
+ "directory": "packages/koa"
46
+ },
47
+ "license": "MIT",
48
+ "keywords": [
49
+ "cogitator",
50
+ "ai",
51
+ "agents",
52
+ "koa",
53
+ "server",
54
+ "api",
55
+ "streaming",
56
+ "sse",
57
+ "websocket",
58
+ "llm",
59
+ "middleware"
60
+ ],
61
+ "scripts": {
62
+ "build": "tsc",
63
+ "dev": "tsc --watch",
64
+ "typecheck": "tsc --noEmit",
65
+ "clean": "rm -rf dist"
66
+ }
67
+ }