feat(api-server): implement generation service and standalone server

- Added GenerationService class for handling response generation with support for tool calls and conversation history.
- Introduced standalone server entry point for starting the API server with configurable options.
- Created types for API server options, request/response structures, and transcript items.
- Implemented utility functions for handling HTTP requests and responses, including CORS support.
- Added support for processing '@<path>' commands to read file contents dynamically.
- Updated CLI package to include the new API server as a dependency and adjusted import paths.

Author: rifkybujana

package-lock.json

@@ -0,0 +1,103 @@
+# @kolosal-ai/api-server
+
+A standalone HTTP API server for Kolosal AI generation services.
+
+## Installation
+
+```bash
+npm install @kolosal-ai/api-server
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { startApiServer } from '@kolosal-ai/api-server';
+import { Config } from '@kolosal-ai/kolosal-ai-core';
+
+const config = new Config(/* your config options */);
+
+const server = await startApiServer(config, {
+  port: 8080,
+  host: '127.0.0.1',
+  enableCors: true
+});
+
+console.log(`Server running on http://127.0.0.1:${server.port}`);
+
+// Later, to close the server
+await server.close();
+```
+
+### API Endpoints
+
+#### Health Check
+- **GET** `/healthz` - Returns server health status
+
+#### Status
+- **GET** `/status` - Returns server status and configuration info
+
+#### Generate
+- **POST** `/v1/generate` - Generate AI responses
+
+**Request Body:**
+```json
+{
+  "input": "Your prompt here",
+  "stream": false,
+  "prompt_id": "optional-prompt-id",
+  "history": [],
+  "model": "optional-custom-model",
+  "api_key": "optional-custom-api-key", 
+  "base_url": "optional-custom-base-url",
+  "working_directory": "/optional/working/directory"
+}
+```
+
+**Response:**
+```json
+{
+  "output": "AI generated response",
+  "prompt_id": "prompt-id",
+  "messages": [],
+  "history": []
+}
+```
+
+### Advanced Usage
+
+You can also use the lower-level components for custom setups:
+
+```typescript
+import { ApiServerFactory, Router } from '@kolosal-ai/api-server';
+
+// Create a custom server with additional routes
+const config = /* your config */;
+const router = new Router();
+
+// Add custom routes
+router.addRoute('GET', '/custom', customHandler);
+
+// Create server with custom router
+const server = await ApiServerFactory.create(config, options);
+```
+
+## Features
+
+- **File Reference Support**: Use `@filename` syntax in prompts to include file contents
+- **Streaming Support**: Real-time response streaming
+- **CORS Support**: Configurable cross-origin resource sharing
+- **Custom Models**: Support for custom model configurations
+- **Working Directory**: Set custom working directories for file operations (automatically created if it doesn't exist)
+- **History Management**: Conversation history support
+
+## Dependencies
+
+This package requires:
+- `@kolosal-ai/kolosal-ai-core` - Core Kolosal AI functionality
+- `@google/genai` - Google Generative AI client
+
+## License
+
+Apache-2.0

packages/api-server/README.md

@@ -0,0 +1,51 @@
+{
+  "name": "@kolosal-ai/api-server",
+  "version": "0.1.3",
+  "description": "Kolosal AI API Server - HTTP server for AI generation services",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "node ../../scripts/build_package.js",
+    "start": "node dist/standalone.js",
+    "start:server": "node dist/standalone.js",
+    "start:server:debug": "DEBUG=1 node dist/standalone.js",
+    "start:server:port": "node dist/standalone.js",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@kolosal-ai/kolosal-ai-core": "file:../core",
+    "@google/genai": "1.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  },
+  "license": "Apache-2.0",
+  "keywords": [
+    "ai",
+    "api",
+    "server",
+    "http",
+    "kolosal"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kolosalAI/kolosal-cli.git",
+    "directory": "packages/api-server"
+  },
+  "bugs": {
+    "url": "https://github.com/kolosalAI/kolosal-cli/issues"
+  },
+  "homepage": "https://github.com/kolosalAI/kolosal-cli/tree/main/packages/api-server"
+}

packages/api-server/package.json

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Kolosal Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Main API server exports
+export { startApiServer } from './server.js';
+export type { ApiServerOptions, ApiServer } from './types/index.js';
+
+// Additional exports for advanced usage
+export { ApiServerFactory } from './server.factory.js';
+export { Router } from './router.js';
+export type { 
+  HttpContext, 
+  RouteHandler, 
+  Middleware,
+  GenerateRequest,
+  GenerateResponse,
+  GenerationResult,
+  TranscriptItem,
+  StreamEventCallback,
+  ContentStreamCallback
+} from './types/index.js';