@hyorman/copilot-proxy-core 1.0.0

package/out/types.d.ts

@@ -0,0 +1,291 @@
+export interface StructuredMessageContent {
+    type: string;
+    text: string;
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | StructuredMessageContent[] | null;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+export interface ChatCompletionRequest {
+    messages: ChatMessage[];
+    model: string;
+    stream?: boolean;
+    tools?: FunctionTool[];
+    tool_choice?: 'none' | 'auto' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+    stop?: string | string[];
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    user?: string;
+}
+export interface FunctionTool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+        strict?: boolean;
+    };
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface CompletionRequest {
+    model: string;
+    prompt: string | string[];
+    max_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    n?: number;
+    stream?: boolean;
+    stop?: string | string[];
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    user?: string;
+}
+export interface CompletionChoice {
+    index: number;
+    text: string;
+    finish_reason: string;
+    logprobs: null;
+}
+export interface CompletionResponse {
+    id: string;
+    object: 'text_completion';
+    created: number;
+    model: string;
+    choices: CompletionChoice[];
+    usage: ChatCompletionUsage;
+}
+export interface EmbeddingRequest {
+    input: string | string[];
+    model: string;
+    encoding_format?: 'float' | 'base64';
+    dimensions?: number;
+    user?: string;
+}
+export interface EmbeddingObject {
+    object: 'embedding';
+    embedding: number[];
+    index: number;
+}
+export interface EmbeddingResponse {
+    object: 'list';
+    data: EmbeddingObject[];
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface ModelObject {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+}
+export interface ModelsListResponse {
+    object: 'list';
+    data: ModelObject[];
+}
+export interface OpenAIErrorResponse {
+    error: {
+        message: string;
+        type: string;
+        param: string | null;
+        code: string | null;
+    };
+}
+export interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage: ChatCompletionUsage;
+    service_tier: string | null;
+    system_fingerprint: string | null;
+}
+export interface ChatCompletionChoice {
+    index: number;
+    message: ChatCompletionMessage;
+    logprobs: object | null;
+    finish_reason: 'stop' | 'tool_calls' | 'length' | 'content_filter' | null;
+}
+export interface ChatCompletionMessage {
+    role: 'assistant';
+    content: string | null;
+    refusal?: string | null;
+    annotations?: unknown[];
+    tool_calls?: ToolCall[];
+}
+export interface ChatCompletionUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    prompt_tokens_details?: {
+        cached_tokens: number;
+        audio_tokens: number;
+    };
+    completion_tokens_details?: {
+        reasoning_tokens: number;
+        audio_tokens: number;
+        accepted_prediction_tokens: number;
+        rejected_prediction_tokens: number;
+    };
+}
+export interface ChatCompletionChunkDelta {
+    role?: string;
+    content?: string | null;
+    tool_calls?: ToolCallChunk[];
+}
+export interface ToolCallChunk {
+    index: number;
+    id?: string;
+    type?: 'function';
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+export interface ChatCompletionChunkChoice {
+    delta: ChatCompletionChunkDelta;
+    index: number;
+    finish_reason: 'stop' | 'tool_calls' | 'length' | 'content_filter' | '' | null;
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: ChatCompletionChunkChoice[];
+}
+export interface ResponseInputItem {
+    type?: 'message';
+    role: 'user' | 'assistant' | 'system';
+    content: string | ResponseContentItem[];
+}
+export interface ResponseContentItem {
+    type: 'input_text' | 'output_text';
+    text: string;
+}
+export interface CreateResponseRequest {
+    model: string;
+    input: string | ResponseInputItem[];
+    instructions?: string;
+    stream?: boolean;
+    temperature?: number;
+    max_output_tokens?: number;
+    top_p?: number;
+    store?: boolean;
+    metadata?: Record<string, string>;
+    tools?: FunctionTool[] | any[];
+    tool_choice?: 'none' | 'auto' | 'required' | {
+        type: 'function';
+        name: string;
+    };
+    previous_response_id?: string;
+    parallel_tool_calls?: boolean;
+    user?: string;
+    skills?: import('./skills/types.js').SkillAttachment[];
+}
+export interface ResponseOutputItem {
+    type: 'message';
+    id: string;
+    status: 'completed' | 'in_progress' | 'failed';
+    role: 'assistant';
+    content: ResponseOutputContent[];
+}
+export interface ResponseOutputContent {
+    type: 'output_text';
+    text: string;
+    annotations: unknown[];
+}
+export interface ResponseObject {
+    id: string;
+    object: 'response';
+    created_at: number;
+    status: 'completed' | 'failed' | 'in_progress' | 'cancelled' | 'queued' | 'incomplete';
+    background: boolean;
+    completed_at: number | null;
+    conversation: {
+        id: string;
+    } | null;
+    error: {
+        message: string;
+        type: string;
+        code: string;
+    } | null;
+    incomplete_details: {
+        reason: string;
+    } | null;
+    instructions: string | null;
+    max_output_tokens: number | null;
+    max_tool_calls: number | null;
+    model: string;
+    output: ResponseOutputItemUnion[];
+    output_text: string;
+    parallel_tool_calls: boolean;
+    previous_response_id: string | null;
+    reasoning: {
+        effort: string | null;
+        generate_summary: string | null;
+        summary: string | null;
+    } | null;
+    service_tier: string | null;
+    temperature: number;
+    text: {
+        format: {
+            type: string;
+        };
+    } | null;
+    tool_choice: 'none' | 'auto' | 'required' | {
+        type: 'function';
+        name: string;
+    } | string;
+    tools: unknown[];
+    top_p: number;
+    truncation: 'auto' | 'disabled';
+    usage: {
+        input_tokens: number;
+        input_tokens_details: {
+            cached_tokens: number;
+        };
+        output_tokens: number;
+        output_tokens_details: {
+            reasoning_tokens: number;
+        };
+        total_tokens: number;
+    } | null;
+    user: string | null;
+    metadata: Record<string, string>;
+}
+export interface ResponseFunctionCallItem {
+    type: 'function_call';
+    id: string;
+    call_id: string;
+    name: string;
+    arguments: string;
+    status: 'completed' | 'in_progress';
+}
+export interface ResponseFunctionCallOutputItem {
+    type: 'function_call_output';
+    call_id: string;
+    output: string;
+}
+export type ResponseOutputItemUnion = ResponseOutputItem | ResponseFunctionCallItem;

package/out/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/out/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/out/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared Utilities
+ *
+ * Common helpers used across the server, routes, and runner modules.
+ */
+import type { NextFunction, Request, Response } from 'express';
+import { OpenAIErrorResponse } from './types.js';
+import { Message, MessageAttachment } from './assistants/types.js';
+export declare function generateId(prefix: string): string;
+export declare function errorResponse(message: string, type?: string, param?: string | null, code?: string | null): OpenAIErrorResponse;
+export declare function notFoundError(resource: string): OpenAIErrorResponse;
+export interface CreateMessageOptions {
+    threadId: string;
+    messageId: string;
+    content: string;
+    role?: 'user' | 'assistant';
+    assistantId?: string | null;
+    runId?: string | null;
+    attachments?: MessageAttachment[];
+    metadata?: Record<string, string>;
+    status?: 'completed' | 'in_progress' | 'incomplete';
+}
+export declare function createMessage(opts: CreateMessageOptions): Message;
+export declare function generateApiToken(): string;
+export declare function setApiTokens(tokens: string[]): void;
+export declare function addApiToken(token: string): void;
+export declare function removeApiToken(token: string): void;
+export declare function authMiddleware(req: Request, res: Response, next: NextFunction): void | Response<any, Record<string, any>>;

package/out/utils.js

@@ -0,0 +1,81 @@
+/**
+ * Shared Utilities
+ *
+ * Common helpers used across the server, routes, and runner modules.
+ */
+import { randomBytes } from 'crypto';
+// ==================== ID Generation ====================
+const ID_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+const ID_LENGTH = 24;
+export function generateId(prefix) {
+    let id = '';
+    for (let i = 0; i < ID_LENGTH; i++) {
+        id += ID_CHARS.charAt(Math.floor(Math.random() * ID_CHARS.length));
+    }
+    return `${prefix}_${id}`;
+}
+// ==================== Error Response ====================
+export function errorResponse(message, type = 'invalid_request_error', param = null, code = null) {
+    return {
+        error: { message, type, param, code }
+    };
+}
+export function notFoundError(resource) {
+    return errorResponse(`No ${resource} found`, 'invalid_request_error', null, 'resource_not_found');
+}
+export function createMessage(opts) {
+    const now = Math.floor(Date.now() / 1000);
+    const isCompleted = (opts.status ?? 'completed') === 'completed';
+    return {
+        id: opts.messageId,
+        object: 'thread.message',
+        created_at: now,
+        thread_id: opts.threadId,
+        status: opts.status ?? 'completed',
+        incomplete_details: null,
+        completed_at: isCompleted ? now : null,
+        incomplete_at: null,
+        role: opts.role ?? 'user',
+        content: [{
+                type: 'text',
+                text: { value: opts.content, annotations: [] }
+            }],
+        assistant_id: opts.assistantId ?? null,
+        run_id: opts.runId ?? null,
+        attachments: opts.attachments ?? [],
+        metadata: opts.metadata ?? {}
+    };
+}
+// ==================== Auth Middleware ====================
+export function generateApiToken() {
+    return 'cpx_' + randomBytes(32).toString('hex');
+}
+let validTokens = new Set();
+export function setApiTokens(tokens) {
+    validTokens = new Set(tokens);
+}
+export function addApiToken(token) {
+    validTokens.add(token);
+}
+export function removeApiToken(token) {
+    validTokens.delete(token);
+}
+export function authMiddleware(req, res, next) {
+    if (validTokens.size === 0) {
+        return next();
+    }
+    const authHeader = req.headers.authorization;
+    if (!authHeader) {
+        return res.status(401).json(errorResponse('Missing authorization header. Include "Authorization: Bearer <token>" header.', 'authentication_error', 'authorization', 'missing_authorization'));
+    }
+    const parts = authHeader.split(' ');
+    if (parts.length !== 2 || parts[0] !== 'Bearer') {
+        return res.status(401).json(errorResponse('Invalid authorization header format. Use "Authorization: Bearer <token>".', 'authentication_error', 'authorization', 'invalid_authorization_format'));
+    }
+    const token = parts[1];
+    if (!validTokens.has(token)) {
+        return res.status(401).json(errorResponse('Invalid API token.', 'authentication_error', 'authorization', 'invalid_token'));
+    }
+    next();
+}
+//# sourceMappingURL=utils.js.map

package/out/utils.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@hyorman/copilot-proxy-core",
+  "version": "1.0.0",
+  "description": "Core shared library for Copilot Proxy",
+  "type": "module",
+  "main": "out/index.js",
+  "types": "out/index.d.ts",
+  "license": "MIT",
+  "author": "hyorman",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hyorman/copilot-proxy.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "out"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "morgan": "^1.10.0",
+    "multer": "^2.1.1"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.14",
+    "@types/morgan": "^1.9.4",
+    "@types/multer": "^2.1.0",
+    "@types/node": "^18.11.18",
+    "typescript": "^5.4.0",
+    "vitest": "^4.0.18"
+  }
+}