molta 1.0.0 → 1.0.2

package/README.en.md

@@ -0,0 +1,119 @@
+<h1 align="center">Molta</h1>
+<h3 align="center">✨ Use MoltBot anywhere 🚀</h3>
+<p align="center"><a href="./README.md">中文</a></p>
+
+Molta is a lightweight HTTP gateway that forwards OpenAI-style `v1/chat/completions` requests to a local MoltBot (ClawdBot) gateway over WebSocket and returns compatible responses, so you can use MoltBot in existing clients.
+
+## Features
+- OpenAI-style endpoints: `/v1/chat/completions`, `/v1/models`
+- Built-in auth: Bearer token via `TOKEN`
+- Streaming responses (SSE)
+- Session reuse + quick new-session command
+
+## Quick Start
+> Requires Node.js 20+ (for local dev or npm install)
+
+### Option A: Install from npm
+```bash
+npm i -g molta
+molta
+```
+
+### Option B: Run with Docker
+```bash
+docker run --rm -p 8090:8090 \
+  -e TOKEN="<Your token>" \
+  -e CLAWD_TOKEN="<Your Clawd Token>" \
+  -e CLAWD_HOST="<Clawd host>" \
+  -e CLAWD_PORT=<Clawd port> \
+  ghcr.io/ve-ria/molta:latest
+```
+
+### Option C: Local development (Yarn 4.12.2)
+```bash
+yarn install
+yarn dev
+```
+
+Default listening address: `http://127.0.0.1:8090`.
+
+## Environment Variables
+Molta reads `.env` in the current directory and validates it (see `schema.json`).
+
+Required:
+- `TOKEN`: HTTP auth token
+- `CLAWD_TOKEN`: Clawd gateway auth token
+
+Optional:
+- `HOST`: bind host, default `localhost`
+- `PORT`: bind port, default `8090`
+- `CLAWD_HOST`: Clawd gateway host, default `localhost`
+  - Both Molta and Clawd in Docker: use Clawd container name or IP
+  - Molta in Docker, Clawd on host: use `host.docker.internal`
+  - Both on host: use `localhost`
+- `CLAWD_PORT`: Clawd gateway port, default `18789`
+
+Example:
+```bash
+TOKEN="<Your token>"
+HOST="127.0.0.1"
+PORT=8090
+CLAWD_HOST="127.0.0.1"
+CLAWD_PORT=18789
+CLAWD_TOKEN="<Your Clawd Token>"
+```
+
+## API
+### List models
+`GET /v1/models`
+
+Example response (`created` is current time):
+```json
+{
+  "object": "list",
+  "data": [
+    {
+      "id": "molta",
+      "object": "model",
+      "created": "2025-01-01T00:00:00.000Z",
+      "owned_by": "molta"
+    }
+  ]
+}
+```
+
+### Chat completions
+`POST /v1/chat/completions`
+
+Request body (OpenAI-compatible):
+```json
+{
+  "model": "molta",
+  "messages": [
+    { "role": "user", "content": "Hello" }
+  ],
+  "stream": false
+}
+```
+
+Auth:
+```
+Authorization: Bearer <TOKEN>
+```
+
+Streaming: set `stream=true` to receive SSE.
+
+## Sessions
+- Session ID is derived from `user` or `id` (falls back to `http`)
+- Send `/clawd-new` or `clawd-new` to force a new session
+
+## Run & Build (dev)
+```bash
+yarn build
+yarn start
+```
+
+## Project Layout
+- `src/router/chat/completions.ts`: main API logic
+- `src/services/gateway.ts`: Clawd gateway WebSocket client
+- `schema.json`: env validation schema

package/README.md

@@ -1,7 +1,8 @@
 <h1 align="center">Molta</h1>
 <h3 align="center">✨ 在任意地方使用 MoltBot 🚀</h3>
+<p align="center"><a href="./README.en.md">English</a></p>
 
-Molta 是一个轻量的 HTTP 网关：将类 OpenAI 的 `v1/chat/completions` 请求转发到本地 Clawd 网关（WebSocket），并返回兼容响应，方便你在现有客户端中直接使用 MoltBot。
+Molta 是一个轻量的 HTTP 网关：将类 OpenAI 的 `v1/chat/completions` 请求转发到本地 MoltBot(ClawdBot) 网关（WebSocket），并返回兼容响应，方便你在现有客户端中直接使用 MoltBot(ClawdBot)。
 
 ## 特性
 - OpenAI 风格接口：`/v1/chat/completions`、`/v1/models`
@@ -10,8 +11,25 @@ Molta 是一个轻量的 HTTP 网关：将类 OpenAI 的 `v1/chat/completions`
 - 会话复用与快速创建新会话指令
 
 ## 快速开始
-> 需要 Node.js 20+ 与 Yarn 4.10.x
+> 需要 Node.js 20+（本地开发或 npm 安装时）
 
+### 方式 A：从 npm 安装
+```bash
+npm i -g molta
+molta
+```
+
+### 方式 B：Docker 运行
+```bash
+docker run --rm -p 8090:8090 \
+  -e TOKEN="<Your token>" \
+  -e CLAWD_TOKEN="<Your Clawd Token>" \
+  -e CLAWD_HOST="<Clawd host>" \
+  -e CLAWD_PORT=<Clawd port> \
+  ghcr.io/ve-ria/molta:latest
+```
+
+### 方式 C：本地开发（Yarn 4.12.0）
 ```bash
 yarn install
 yarn dev
@@ -20,7 +38,7 @@ yarn dev
 启动后默认监听 `http://127.0.0.1:8090`。
 
 ## 环境变量
-项目会读取 `.env` 并校验（见 `schema.json`）。
+项目会读取当前目录的 `.env` 并校验（见 `schema.json`）。
 
 必填：
 - `TOKEN`：HTTP 接口鉴权 Token
@@ -29,12 +47,11 @@ yarn dev
 可选：
 - `HOST`：监听地址，默认 `localhost`
 - `PORT`：监听端口，默认 `8090`
-- `CLAWD_HOST`：Clawd 网关地址，默认 `localhost`，
-  - 如您使用 Docker 部署 MoltBot(Clawd) 以及 Molta，请设置为`<Clawd Container ID>`，
-  - 如您使用NPM Binary部署 MoltBot(Clawd) 以及 Molta，请设置为`localhost`(如果使用 Docker 部署 MoltBot(Clawd) 但使用NPM Binary部署 Molta 也同样设置为此 HOST)
-  - 如您使用 Docker 部署 Molta 但使用NPM Binary部署 MoltBot(Clawd)，请设置为`host.docker.internal`
+- `CLAWD_HOST`：Clawd 网关地址，默认 `localhost`
+  - Molta 与 Clawd 都在 Docker：填 Clawd 容器名或容器 IP
+  - Molta 在 Docker、Clawd 在本机：填 `host.docker.internal`
+  - Molta 与 Clawd 都在本机：填 `localhost`
 - `CLAWD_PORT`：Clawd 网关端口，默认 `18789`
-- `CLAWD_AGENT_ID`：预留字段（当前实现中未使用）
 
 示例：
 ```bash
@@ -71,7 +88,7 @@ CLAWD_TOKEN="<Your Clawd Token>"
 请求体（兼容 OpenAI）：
 ```json
 {
-  "model": "clawd",
+  "model": "molta",
   "messages": [
     { "role": "user", "content": "你好" }
   ],
@@ -90,18 +107,12 @@ Authorization: Bearer <TOKEN>
 - 会话 ID 基于 `user` 或 `id` 字段生成；未提供则使用 `http`。
 - 发送 `/clawd-new` 或 `clawd-new` 可强制创建新会话。
 
-## 运行与构建
+## 运行与构建（开发者）
 ```bash
 yarn build
 yarn start
 ```
 
-安装并启动：
-```bash
-npm i -g molta
-molta
-```
-
 ## 目录结构
 - `src/router/chat/completions.ts`：主接口逻辑
 - `src/services/gateway.ts`：Clawd 网关 WebSocket 客户端

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "molta",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Use MoltBot anywhere",
   "type": "module",
   "packageManager": "yarn@4.12.0",
@@ -15,9 +15,7 @@
     "prepublishOnly": "yarn build && node scripts/add-shebang.cjs",
     "start": "node dist/index.js"
   },
-  "bin": {
-    "molta": "dist/index.js"
-  },
+  "bin": "dist/index.js",
   "files": [
     "dist",
     "schema.json"
@@ -25,10 +23,13 @@
   "dependencies": {
     "@elysiajs/node": "^1.4.3",
     "@elysiajs/openapi": "^1.4.14",
+    "@sinclair/typebox": "^0.34.48",
     "ajv": "^8.17.1",
     "dotenv": "^17.2.3",
     "elysia": "^1.4.22",
+    "file-type": "^21.3.0",
     "js-yaml": "^4.1.1",
+    "openapi-types": "^12.1.3",
     "supports-color": "^10.2.2",
     "typescript": "^5.9.3"
   },