@cogitator-ai/openai-compat 0.1.0

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,78 @@
+# @cogitator-ai/openai-compat
+
+OpenAI Assistants API compatibility layer for Cogitator. Use OpenAI SDK clients with Cogitator backend.
+
+## Installation
+
+```bash
+pnpm add @cogitator-ai/openai-compat
+```
+
+## Usage
+
+### Start the Server
+
+```typescript
+import { createOpenAIServer } from '@cogitator-ai/openai-compat';
+import { Cogitator } from '@cogitator-ai/core';
+
+const cogitator = new Cogitator();
+const server = createOpenAIServer(cogitator, {
+  port: 3001,
+  apiKey: 'your-api-key', // Optional auth
+});
+
+await server.start();
+```
+
+### Use with OpenAI SDK
+
+```typescript
+import OpenAI from 'openai';
+
+const openai = new OpenAI({
+  baseURL: 'http://localhost:3001/v1',
+  apiKey: 'your-api-key',
+});
+
+// Create an assistant
+const assistant = await openai.beta.assistants.create({
+  name: 'My Assistant',
+  instructions: 'You are a helpful assistant',
+  model: 'ollama/llama3.2:3b',
+});
+
+// Create a thread
+const thread = await openai.beta.threads.create();
+
+// Add a message
+await openai.beta.threads.messages.create(thread.id, {
+  role: 'user',
+  content: 'Hello!',
+});
+
+// Run the assistant
+const run = await openai.beta.threads.runs.create(thread.id, {
+  assistant_id: assistant.id,
+});
+```
+
+### Supported Endpoints
+
+- `POST /v1/assistants` - Create assistant
+- `GET /v1/assistants` - List assistants
+- `DELETE /v1/assistants/:id` - Delete assistant
+- `POST /v1/threads` - Create thread
+- `GET /v1/threads/:id` - Get thread
+- `POST /v1/threads/:id/messages` - Add message
+- `GET /v1/threads/:id/messages` - List messages
+- `POST /v1/threads/:id/runs` - Create run
+- `GET /v1/threads/:id/runs/:id` - Get run status
+
+## Documentation
+
+See the [Cogitator documentation](https://github.com/eL1fe/cogitator) for full API reference.
+
+## License
+
+MIT

package/dist/client/openai-adapter.d.ts

@@ -0,0 +1,107 @@
+/**
+ * OpenAI SDK Adapter
+ *
+ * Allows using the OpenAI SDK to interact with Cogitator.
+ * Creates an in-process adapter that can be used with the SDK's baseURL.
+ */
+import { type Cogitator } from '@cogitator-ai/core';
+import type { Tool } from '@cogitator-ai/types';
+import { ThreadManager } from './thread-manager';
+import type { Assistant, Run, CreateRunRequest, SubmitToolOutputsRequest } from '../types/openai-types';
+/**
+ * OpenAI SDK Adapter
+ *
+ * @example
+ * ```typescript
+ * import OpenAI from 'openai';
+ * import { createOpenAIAdapter } from '@cogitator-ai/openai-compat';
+ *
+ * const adapter = createOpenAIAdapter(cogitator, {
+ *   tools: [calculator, datetime],
+ * });
+ *
+ * const openai = new OpenAI({
+ *   apiKey: 'not-needed',
+ *   baseURL: adapter.baseURL,
+ * });
+ *
+ * // Use OpenAI SDK as normal
+ * const assistant = await openai.beta.assistants.create({
+ *   model: 'gpt-4o',
+ *   name: 'My Assistant',
+ * });
+ * ```
+ */
+export declare class OpenAIAdapter {
+    private cogitator;
+    private threadManager;
+    private runs;
+    private tools;
+    constructor(cogitator: Cogitator, options?: {
+        tools?: Tool[];
+    });
+    /**
+     * Get the thread manager for direct access
+     */
+    getThreadManager(): ThreadManager;
+    createAssistant(params: {
+        model: string;
+        name?: string;
+        instructions?: string;
+        tools?: unknown[];
+        metadata?: Record<string, string>;
+        temperature?: number;
+    }): Assistant;
+    getAssistant(id: string): Assistant | undefined;
+    updateAssistant(id: string, updates: Partial<{
+        model: string;
+        name: string;
+        instructions: string;
+        tools: unknown[];
+        metadata: Record<string, string>;
+        temperature: number;
+    }>): Assistant | undefined;
+    deleteAssistant(id: string): boolean;
+    listAssistants(): Assistant[];
+    private toAssistant;
+    createThread(metadata?: Record<string, string>): import("..").Thread;
+    getThread(id: string): import("..").Thread | undefined;
+    deleteThread(id: string): boolean;
+    addMessage(threadId: string, params: {
+        role: 'user' | 'assistant';
+        content: string;
+        metadata?: Record<string, string>;
+    }): import("..").Message | undefined;
+    getMessage(threadId: string, messageId: string): import("..").Message | undefined;
+    listMessages(threadId: string, options?: {
+        limit?: number;
+        order?: 'asc' | 'desc';
+        after?: string;
+        before?: string;
+        run_id?: string;
+    }): import("..").Message[];
+    /**
+     * Create and execute a run
+     */
+    createRun(threadId: string, request: CreateRunRequest): Promise<Run>;
+    /**
+     * Get a run by ID
+     */
+    getRun(threadId: string, runId: string): Run | undefined;
+    /**
+     * Cancel a run
+     */
+    cancelRun(threadId: string, runId: string): Run | undefined;
+    /**
+     * Submit tool outputs for a run that requires action
+     */
+    submitToolOutputs(threadId: string, runId: string, request: SubmitToolOutputsRequest): Promise<Run | undefined>;
+    private executeRun;
+}
+/**
+ * Create an OpenAI adapter for Cogitator
+ */
+export declare function createOpenAIAdapter(cogitator: Cogitator, options?: {
+    tools?: Tool[];
+}): OpenAIAdapter;
+//# sourceMappingURL=openai-adapter.d.ts.map

package/dist/client/openai-adapter.d.ts.map

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

package/dist/client/openai-adapter.js

@@ -0,0 +1,265 @@
+/**
+ * OpenAI SDK Adapter
+ *
+ * Allows using the OpenAI SDK to interact with Cogitator.
+ * Creates an in-process adapter that can be used with the SDK's baseURL.
+ */
+import { Agent } from '@cogitator-ai/core';
+import { ThreadManager } from './thread-manager';
+import { nanoid } from 'nanoid';
+/**
+ * OpenAI SDK Adapter
+ *
+ * @example
+ * ```typescript
+ * import OpenAI from 'openai';
+ * import { createOpenAIAdapter } from '@cogitator-ai/openai-compat';
+ *
+ * const adapter = createOpenAIAdapter(cogitator, {
+ *   tools: [calculator, datetime],
+ * });
+ *
+ * const openai = new OpenAI({
+ *   apiKey: 'not-needed',
+ *   baseURL: adapter.baseURL,
+ * });
+ *
+ * // Use OpenAI SDK as normal
+ * const assistant = await openai.beta.assistants.create({
+ *   model: 'gpt-4o',
+ *   name: 'My Assistant',
+ * });
+ * ```
+ */
+export class OpenAIAdapter {
+    cogitator;
+    threadManager;
+    runs = new Map();
+    tools;
+    constructor(cogitator, options) {
+        this.cogitator = cogitator;
+        this.threadManager = new ThreadManager();
+        this.tools = options?.tools ?? [];
+    }
+    /**
+     * Get the thread manager for direct access
+     */
+    getThreadManager() {
+        return this.threadManager;
+    }
+    createAssistant(params) {
+        const stored = this.threadManager.createAssistant(params);
+        return this.toAssistant(stored);
+    }
+    getAssistant(id) {
+        const stored = this.threadManager.getAssistant(id);
+        return stored ? this.toAssistant(stored) : undefined;
+    }
+    updateAssistant(id, updates) {
+        const stored = this.threadManager.updateAssistant(id, updates);
+        return stored ? this.toAssistant(stored) : undefined;
+    }
+    deleteAssistant(id) {
+        return this.threadManager.deleteAssistant(id);
+    }
+    listAssistants() {
+        return this.threadManager.listAssistants().map((s) => this.toAssistant(s));
+    }
+    toAssistant(stored) {
+        return {
+            id: stored.id,
+            object: 'assistant',
+            created_at: stored.created_at,
+            name: stored.name,
+            description: null,
+            model: stored.model,
+            instructions: stored.instructions,
+            tools: stored.tools,
+            metadata: stored.metadata,
+            temperature: stored.temperature,
+        };
+    }
+    createThread(metadata) {
+        return this.threadManager.createThread(metadata);
+    }
+    getThread(id) {
+        return this.threadManager.getThread(id);
+    }
+    deleteThread(id) {
+        return this.threadManager.deleteThread(id);
+    }
+    addMessage(threadId, params) {
+        return this.threadManager.addMessage(threadId, params);
+    }
+    getMessage(threadId, messageId) {
+        return this.threadManager.getMessage(threadId, messageId);
+    }
+    listMessages(threadId, options) {
+        return this.threadManager.listMessages(threadId, options);
+    }
+    /**
+     * Create and execute a run
+     */
+    async createRun(threadId, request) {
+        const assistant = this.threadManager.getAssistant(request.assistant_id);
+        if (!assistant) {
+            throw new Error(`Assistant ${request.assistant_id} not found`);
+        }
+        const thread = this.threadManager.getThread(threadId);
+        if (!thread) {
+            throw new Error(`Thread ${threadId} not found`);
+        }
+        const runId = `run_${nanoid()}`;
+        const now = Math.floor(Date.now() / 1000);
+        const run = {
+            id: runId,
+            object: 'thread.run',
+            created_at: now,
+            thread_id: threadId,
+            assistant_id: request.assistant_id,
+            status: 'queued',
+            required_action: null,
+            last_error: null,
+            expires_at: now + 600,
+            started_at: null,
+            cancelled_at: null,
+            failed_at: null,
+            completed_at: null,
+            incomplete_details: null,
+            model: request.model ?? assistant.model,
+            instructions: request.instructions ?? assistant.instructions,
+            tools: (request.tools ?? assistant.tools),
+            metadata: request.metadata ?? {},
+            usage: null,
+            temperature: request.temperature ?? assistant.temperature,
+            top_p: request.top_p,
+            max_prompt_tokens: request.max_prompt_tokens,
+            max_completion_tokens: request.max_completion_tokens,
+            truncation_strategy: request.truncation_strategy,
+            response_format: request.response_format,
+            tool_choice: request.tool_choice,
+            parallel_tool_calls: request.parallel_tool_calls,
+        };
+        const abortController = new AbortController();
+        this.runs.set(runId, { run, abortController });
+        if (request.additional_messages) {
+            for (const msg of request.additional_messages) {
+                this.threadManager.addMessage(threadId, msg);
+            }
+        }
+        this.executeRun(runId, threadId, assistant, request).catch((error) => {
+            const state = this.runs.get(runId);
+            if (state) {
+                state.run.status = 'failed';
+                state.run.failed_at = Math.floor(Date.now() / 1000);
+                state.run.last_error = {
+                    code: 'server_error',
+                    message: error instanceof Error ? error.message : String(error),
+                };
+            }
+        });
+        return run;
+    }
+    /**
+     * Get a run by ID
+     */
+    getRun(threadId, runId) {
+        const state = this.runs.get(runId);
+        if (state?.run.thread_id === threadId) {
+            return state.run;
+        }
+        return undefined;
+    }
+    /**
+     * Cancel a run
+     */
+    cancelRun(threadId, runId) {
+        const state = this.runs.get(runId);
+        if (state?.run.thread_id === threadId) {
+            state.abortController.abort();
+            state.run.status = 'cancelled';
+            state.run.cancelled_at = Math.floor(Date.now() / 1000);
+            return state.run;
+        }
+        return undefined;
+    }
+    /**
+     * Submit tool outputs for a run that requires action
+     */
+    async submitToolOutputs(threadId, runId, request) {
+        const state = this.runs.get(runId);
+        if (state?.run.thread_id !== threadId) {
+            return undefined;
+        }
+        if (state.run.status !== 'requires_action') {
+            throw new Error('Run is not waiting for tool outputs');
+        }
+        if (!state.toolOutputs) {
+            state.toolOutputs = new Map();
+        }
+        for (const output of request.tool_outputs) {
+            state.toolOutputs.set(output.tool_call_id, output.output);
+        }
+        state.run.status = 'in_progress';
+        state.run.required_action = null;
+        return state.run;
+    }
+    async executeRun(runId, threadId, assistant, request) {
+        const state = this.runs.get(runId);
+        if (!state)
+            return;
+        state.run.status = 'in_progress';
+        state.run.started_at = Math.floor(Date.now() / 1000);
+        try {
+            const messages = this.threadManager.getMessagesForLLM(threadId);
+            const agent = new Agent({
+                name: assistant.name ?? 'assistant',
+                model: request.model ?? assistant.model,
+                instructions: request.instructions ?? assistant.instructions ?? '',
+                temperature: request.temperature ?? assistant.temperature,
+                tools: this.tools,
+            });
+            const lastUserMessage = messages.filter((m) => m.role === 'user').pop();
+            if (!lastUserMessage) {
+                throw new Error('No user message found');
+            }
+            const result = await this.cogitator.run(agent, {
+                input: lastUserMessage.content,
+                threadId,
+            });
+            if (state.abortController.signal.aborted) {
+                return;
+            }
+            if (result.output) {
+                this.threadManager.addAssistantMessage(threadId, result.output, assistant.id, runId);
+            }
+            state.run.status = 'completed';
+            state.run.completed_at = Math.floor(Date.now() / 1000);
+            state.run.usage = result.usage
+                ? {
+                    prompt_tokens: result.usage.inputTokens,
+                    completion_tokens: result.usage.outputTokens,
+                    total_tokens: result.usage.totalTokens,
+                }
+                : null;
+        }
+        catch (error) {
+            if (state.abortController.signal.aborted) {
+                return;
+            }
+            state.run.status = 'failed';
+            state.run.failed_at = Math.floor(Date.now() / 1000);
+            state.run.last_error = {
+                code: 'server_error',
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+/**
+ * Create an OpenAI adapter for Cogitator
+ */
+export function createOpenAIAdapter(cogitator, options) {
+    return new OpenAIAdapter(cogitator, options);
+}
+//# sourceMappingURL=openai-adapter.js.map

package/dist/client/openai-adapter.js.map

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

package/dist/client/thread-manager.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Thread Manager
+ *
+ * Manages the mapping between OpenAI threads and Cogitator internal state.
+ */
+import type { Thread, Message, CreateMessageRequest } from '../types/openai-types';
+export interface StoredThread {
+    thread: Thread;
+    messages: Message[];
+}
+export interface StoredAssistant {
+    id: string;
+    name: string | null;
+    model: string;
+    instructions: string | null;
+    tools: unknown[];
+    metadata: Record<string, string>;
+    temperature?: number;
+    created_at: number;
+}
+/**
+ * Manages threads, messages, and assistants in memory
+ *
+ * In production, this should be backed by a database
+ */
+export declare class ThreadManager {
+    private threads;
+    private assistants;
+    private files;
+    createAssistant(params: {
+        model: string;
+        name?: string;
+        instructions?: string;
+        tools?: unknown[];
+        metadata?: Record<string, string>;
+        temperature?: number;
+    }): StoredAssistant;
+    getAssistant(id: string): StoredAssistant | undefined;
+    updateAssistant(id: string, updates: Partial<Omit<StoredAssistant, 'id' | 'created_at'>>): StoredAssistant | undefined;
+    deleteAssistant(id: string): boolean;
+    listAssistants(): StoredAssistant[];
+    createThread(metadata?: Record<string, string>): Thread;
+    getThread(id: string): Thread | undefined;
+    deleteThread(id: string): boolean;
+    addMessage(threadId: string, request: CreateMessageRequest): Message | undefined;
+    getMessage(threadId: string, messageId: string): Message | undefined;
+    listMessages(threadId: string, options?: {
+        limit?: number;
+        order?: 'asc' | 'desc';
+        after?: string;
+        before?: string;
+        run_id?: string;
+    }): Message[];
+    /**
+     * Get messages in Cogitator format for LLM calls
+     */
+    getMessagesForLLM(threadId: string): {
+        role: 'user' | 'assistant';
+        content: string;
+    }[];
+    /**
+     * Add an assistant message (from LLM response)
+     */
+    addAssistantMessage(threadId: string, content: string, assistantId: string, runId: string): Message | undefined;
+    addFile(content: Buffer, filename: string): {
+        id: string;
+        filename: string;
+        created_at: number;
+    };
+    getFile(id: string): {
+        id: string;
+        content: Buffer;
+        filename: string;
+        created_at: number;
+    } | undefined;
+    deleteFile(id: string): boolean;
+    private normalizeContent;
+    private extractTextContent;
+}
+//# sourceMappingURL=thread-manager.d.ts.map

package/dist/client/thread-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-manager.d.ts","sourceRoot":"","sources":["../../src/client/thread-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,KAAK,CAA4F;IAEzG,eAAe,CAAC,MAAM,EAAE;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,eAAe;IAiBnB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIrD,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,YAAY,CAAC,CAAC,GAAG,eAAe,GAAG,SAAS;IAQtH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIpC,cAAc,IAAI,eAAe,EAAE;IAInC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAavD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,GAAG,SAAS;IA6BhF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAKpE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACvC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,EAAE;IAqCb;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE;IAStF;;OAEG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,GAAG,SAAS;IAmCtB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAShG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAItG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,kBAAkB;CAM3B"}