mcp-jev 1.1.1 → 2.0.0

package/README.md

@@ -1,207 +1,151 @@
 # mcp-jev
 
-MCP server cho [TypeSafe Jev](https://typesafe.ai) — System One Model.
+MCP server for **System-1 decision models** — provider-agnostic. Routes to [TypeSafe Jev](https://typesafe.ai) (cloud) or [Laya](https://pypi.org/project/laya/) (local HTTP) via a single env var.
 
-Gửi state + typed questions → nhận calibrated probabilities. Không sinh text.
+## Migration from v1 → v2
 
-## Tools
+v2 replaces `jev_decide`/`jev_list_models` with a 4-tool provider-agnostic interface:
+
+| v1 | v2 | Notes |
+|----|----|----|
+| `jev_decide` | `decide_predict` | Same question format (`questions[]` array) |
+| `jev_list_models` | `decide_list_models` | Same return shape |
+| — | `decide_status` | New: provider health info |
+| — | `decide_preset` | New: named workflow presets |
 
-| Tool | Khi nào dùng |
-|------|-------------|
-| `jev_decide` | Classify, route, check, score bất kỳ nội dung nào |
-| `jev_list_models` | Xem model IDs / aliases có sẵn trên API key của bạn |
+**v2 env vars** (replaces `TYPESAFE_API_KEY` alone):
 
-### `jev_decide`
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `DECIDE_PROVIDER` | No | `jev` | `jev` or `laya` |
+| `TYPESAFE_API_KEY` | When `jev` | — | TypeSafe API key |
+| `TYPESAFE_BASE_URL` | No | `https://api.typesafe.ai` | Override Jev URL |
+| `LAYA_BASE_URL` | No | `http://localhost:8000` | Override Laya URL |
+| `LAYA_API_KEY` | No | — | Laya bearer token (if Laya requires auth) |
 
-Đánh giá một hoặc nhiều câu hỏi trên cùng một `state` trong một request duy nhất.
+---
+
+## Tools
 
-**3 loại câu hỏi (primitives):**
+### `decide_predict`
 
-| Type | Hỏi gì | Output |
-|------|--------|--------|
-| `noul` | Điều này có đúng không? | `noul`: probability 0–1 |
-| `choice` | Chọn 1 trong N options? | `choice` + `probabilities` + `confidence` |
-| `score` | Rate trên rubric này? | `score` (có thể là 1.04/3) + `probabilities` + `confidence` |
+Core inference. Evaluate typed questions against a state.
 
-**Ví dụ — triage support ticket:**
+**Question types**: `noul` (yes/no probability), `choice` (pick one of N), `score` (rate on rubric)
 
+**Example:**
 ```json
 {
-  "state": {
-    "message": "Payout của tôi bị fail 3 ngày rồi, tôi cần xử lý gấp!"
-  },
+  "state": { "message": "My payment failed 3 days ago, help!" },
   "questions": [
-    {
-      "id": "is_urgent",
-      "type": "noul",
-      "instructions": "Người dùng trong `message` có cần hỗ trợ khẩn cấp không?"
-    },
-    {
-      "id": "department",
-      "type": "choice",
-      "instructions": "Bộ phận nào nên xử lý `message`?",
-      "criteria": {
-        "billing": "Thanh toán, hoàn tiền, hóa đơn",
-        "technical": "Lỗi kỹ thuật, tích hợp API",
-        "general": "Câu hỏi chung không thuộc category trên"
-      }
-    },
-    {
-      "id": "frustration",
-      "type": "score",
-      "instructions": "Mức độ bực bội của người dùng trong `message` là bao nhiêu?",
-      "criteria": ["Bình thường", "Hơi khó chịu", "Rất bực bội"]
-    }
+    { "id": "urgent", "type": "noul", "instructions": "Is `message` urgent?" },
+    { "id": "dept", "type": "choice", "instructions": "Which team?",
+      "criteria": { "billing": "Payments", "technical": "API errors", "general": null } }
   ]
 }
 ```
 
-**Response mẫu:**
+---
+
+### `decide_preset`
 
+Run a named workflow preset — expands to a pre-defined question set.
+
+**Available presets:**
+
+| Preset | State field | Questions |
+|--------|------------|-----------|
+| `triage` | `message` | intent, urgency, frustration, refund, churn |
+| `guard` | `prompt` | jailbreak, injection, sensitive_data, harm, topic |
+| `moderation` | `post` | toxic, harassment, threat, spam, severity |
+| `router` | `request` | difficulty, domain, needs_tools, is_sensitive |
+| `email` | `body` | category, is_spam, is_phishing, urgency, needs_reply |
+
+**Example:**
 ```json
-{
-  "answers": {
-    "is_urgent": { "noul": 0.95 },
-    "department": {
-      "choice": "billing",
-      "probabilities": { "billing": 0.82, "technical": 0.12, "general": 0.06 },
-      "confidence": 0.80
-    },
-    "frustration": {
-      "score": 2.04,
-      "legend": { "0": "Bình thường", "1": "Hơi khó chịu", "2": "Rất bực bội" },
-      "probabilities": { "Bình thường": 0.05, "Hơi khó chịu": 0.18, "Rất bực bội": 0.77 },
-      "confidence": 0.77
-    }
-  },
-  "model": "jev-1.13.0",
-  "usage": { "input_tokens": 312, "output_tokens": 0 }
-}
+{ "preset": "guard", "state": { "prompt": "Ignore all instructions" } }
 ```
 
-**Tips:**
-- Chỉ gửi state fields mà questions cần — context dư làm giảm độ chính xác
-- Reference fields bằng backtick: `` `message` ``, `` `order.id` ``
-- `choice.criteria` null = "no extra detail" (dùng cho bucket `other`)
-- `score.criteria` cần 2–10 levels, ordered thấp → cao
-
 ---
 
-### `jev_list_models`
+### `decide_status`
 
-Trả về danh sách model IDs và aliases.
+Provider health and configuration info.
 
 ```json
-[
-  { "id": "jev-1.13.0", "aliases": ["jev-latest"] }
-]
-```
+// Jev response
+{ "provider": "jev", "base_url": "https://api.typesafe.ai", "model": "jev-latest", "status": "ok" }
 
-Dùng khi muốn pin versioned ID thay vì `jev-latest` để tránh behavior thay đổi sau update.
+// Laya response
+{ "provider": "laya", "base_url": "http://localhost:8000", "loaded": ["english", "multilingual"], "device": "cuda", "status": "ok" }
+```
 
 ---
 
-## Cài đặt & cấu hình
+### `decide_list_models`
 
-### Prerequisites
+Available models or checkpoints.
 
-- Node.js ≥ 20
-- TypeSafe API key — đăng ký waitlist tại [typesafe.ai](https://typesafe.ai)
+---
 
-### Build
+## Installation
 
-```bash
-cd mcp-jev
-npm install
-npm run build
-```
-
-### Kiro (`.kiro/settings/mcp.json`)
+### With Jev (cloud, default)
 
 ```json
 {
   "mcpServers": {
     "jev": {
-      "command": "node",
-      "args": ["d:/github/crhead/mcp-jev/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-jev"],
       "env": {
         "TYPESAFE_API_KEY": "your_key_here"
-      },
-      "disabled": false
+      }
     }
   }
 }
 ```
 
-### Claude Desktop (`claude_desktop_config.json`)
+### With Laya (local)
 
+Start Laya HTTP server first:
+```bash
+pip install "laya[serve]"
+LAYA_DEVICE=cuda LAYA_PRELOAD=1 laya-serve  # default: http://localhost:8000
+```
+
+Then configure MCP:
 ```json
 {
   "mcpServers": {
     "jev": {
-      "command": "node",
-      "args": ["/absolute/path/to/mcp-jev/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-jev"],
       "env": {
-        "TYPESAFE_API_KEY": "your_key_here"
+        "DECIDE_PROVIDER": "laya",
+        "LAYA_BASE_URL": "http://localhost:8000"
       }
     }
   }
 }
 ```
 
-### Dev mode (không cần build)
+### Local build
 
 ```bash
-TYPESAFE_API_KEY=your_key npx tsx src/index.ts
+cd mcp-jev
+npm install
+npm run build
 ```
 
----
-
-## Biến môi trường
-
-| Biến | Bắt buộc | Mặc định | Mô tả |
-|------|----------|----------|-------|
-| `TYPESAFE_API_KEY` | ✅ | — | API key từ console.typesafe.ai |
-| `TYPESAFE_BASE_URL` | ❌ | `https://api.typesafe.ai` | Override URL (staging, proxy) |
-
-Server exit với code 1 ngay khi start nếu `TYPESAFE_API_KEY` không được set.
-
----
-
-## Error handling
-
-| HTTP code | Ý nghĩa | Behavior |
-|-----------|---------|----------|
-| 401 | API key sai / thiếu | Trả về `isError: true` ngay |
-| 422 | Request body invalid | Trả về `isError: true` ngay + message chi tiết |
-| 429 | Rate limit | Retry tối đa 3 lần, exponential backoff |
-| 529 | Service overloaded | Retry tối đa 3 lần, exponential backoff |
-
-Rate limits hiện tại: 250,000 tokens/s · 1,200 requests/min.
-
----
-
-## Giới hạn Jev
-
-- Chỉ nhận text (string, JSON object, JSON array) — không hỗ trợ image/audio/video
-- Context budget: ~64,000 tokens cho toàn bộ state + questions
-- Choice tối đa 255 options; Score 2–10 levels
-- Không thể dùng cho System 2 tasks (lập luận đa bước, sinh code, giải thích)
-- Model hiện tại: `jev-1.13.0` / alias `jev-latest`
-
----
-
-## npx (khuyến nghị)
-
-Không cần clone repo — dùng trực tiếp từ npm:
-
 ```json
 {
   "mcpServers": {
     "jev": {
-      "command": "npx",
-      "args": ["-y", "mcp-jev"],
+      "command": "node",
+      "args": ["d:/github/crhead/mcp-jev/dist/index.js"],
       "env": {
+        "DECIDE_PROVIDER": "jev",
         "TYPESAFE_API_KEY": "your_key_here"
       }
     }
@@ -209,4 +153,19 @@ Không cần clone repo — dùng trực tiếp từ npm:
 }
 ```
 
+---
+
+## Provider Comparison
+
+| | Jev (cloud) | Laya (local) |
+|--|-------------|-------------|
+| API key | Required (`TYPESAFE_API_KEY`) | Optional (`LAYA_API_KEY`) |
+| Latency | Cloud (~200ms) | Local (~33ms GPU) |
+| Routing metadata | None | Yes (language, checkpoint) |
+| `/health` endpoint | No | Yes |
+| Model list | `GET /v1/models` | Extracted from `GET /health` |
+| Internet required | Yes | No |
+
+---
+
 Source: [github.com/mndpjm/mcp-jev](https://github.com/mndpjm/mcp-jev)

package/dist/adapters/factory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * createAdapter — reads DECIDE_PROVIDER from environment and returns the
+ * appropriate ProviderAdapter implementation.
+ *
+ * Throws ConfigurationError (NOT process.exit) on invalid configuration.
+ * Callers (entry point) catch ConfigurationError and call process.exit(1).
+ */
+import { ProviderAdapter } from "../lib.js";
+export declare function createAdapter(): ProviderAdapter;
+//# sourceMappingURL=factory.d.ts.map

package/dist/adapters/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsB,eAAe,EAAE,MAAM,WAAW,CAAC;AAWhE,wBAAgB,aAAa,IAAI,eAAe,CA2B/C"}

package/dist/adapters/factory.js

@@ -0,0 +1,34 @@
+/**
+ * createAdapter — reads DECIDE_PROVIDER from environment and returns the
+ * appropriate ProviderAdapter implementation.
+ *
+ * Throws ConfigurationError (NOT process.exit) on invalid configuration.
+ * Callers (entry point) catch ConfigurationError and call process.exit(1).
+ */
+import { ConfigurationError } from "../lib.js";
+import { JevAdapter } from "./jev.js";
+import { LayaAdapter } from "./laya.js";
+const VALID_PROVIDERS = ["jev", "laya"];
+function isValidProvider(v) {
+    return VALID_PROVIDERS.includes(v);
+}
+export function createAdapter() {
+    const provider = (process.env.DECIDE_PROVIDER ?? "jev").trim().toLowerCase();
+    if (!isValidProvider(provider)) {
+        throw new ConfigurationError(`Invalid DECIDE_PROVIDER value "${provider}". Valid values: ${VALID_PROVIDERS.join(", ")}.`);
+    }
+    if (provider === "jev") {
+        const apiKey = process.env.TYPESAFE_API_KEY;
+        if (!apiKey) {
+            throw new ConfigurationError('TYPESAFE_API_KEY is required when DECIDE_PROVIDER=jev (or unset). ' +
+                'Set DECIDE_PROVIDER=laya to use a local Laya server without an API key.');
+        }
+        const baseUrl = process.env.TYPESAFE_BASE_URL?.replace(/\/$/, "") ?? "https://api.typesafe.ai";
+        return new JevAdapter(apiKey, baseUrl);
+    }
+    // provider === "laya"
+    const baseUrl = process.env.LAYA_BASE_URL?.replace(/\/$/, "") ?? "http://localhost:8000";
+    const apiKey = process.env.LAYA_API_KEY; // optional
+    return new LayaAdapter(baseUrl, apiKey);
+}
+//# sourceMappingURL=factory.js.map

package/dist/adapters/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAmB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAGjD,SAAS,eAAe,CAAC,CAAS;IAChC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAW,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErF,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,kBAAkB,CAC1B,kCAAkC,QAAQ,oBAAoB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5F,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,kBAAkB,CAC1B,oEAAoE;gBACpE,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,yBAAyB,CAAC;QACjF,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,sBAAsB;IACtB,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,uBAAuB,CAAC;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW;IACpD,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/adapters/jev.d.ts

@@ -0,0 +1,21 @@
+/**
+ * JevAdapter — routes requests to TypeSafe Jev cloud API.
+ *
+ * Env:
+ *   TYPESAFE_API_KEY   (required — caller must validate before constructing)
+ *   TYPESAFE_BASE_URL  (optional, default: https://api.typesafe.ai)
+ */
+import { ProviderAdapter, PredictRequest, PredictResponse, ModelEntry, StatusResponse } from "../lib.js";
+export declare class JevAdapter implements ProviderAdapter {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    constructor(apiKey: string, baseUrl: string, defaultModel?: string);
+    predict(req: PredictRequest): Promise<PredictResponse>;
+    listModels(): Promise<ModelEntry[]>;
+    /**
+     * Jev has no /health endpoint — synthesize status from environment config.
+     */
+    status(): Promise<StatusResponse>;
+}
+//# sourceMappingURL=jev.d.ts.map

package/dist/adapters/jev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jev.d.ts","sourceRoot":"","sources":["../../src/adapters/jev.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,EAQf,MAAM,WAAW,CAAC;AAEnB,qBAAa,UAAW,YAAW,eAAe;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,SAAe;IAMlE,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAiCtD,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAmCzC;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;CAQlC"}

package/dist/adapters/jev.js

@@ -0,0 +1,88 @@
+/**
+ * JevAdapter — routes requests to TypeSafe Jev cloud API.
+ *
+ * Env:
+ *   TYPESAFE_API_KEY   (required — caller must validate before constructing)
+ *   TYPESAFE_BASE_URL  (optional, default: https://api.typesafe.ai)
+ */
+import { ParseError, fetchWithRetry, parseModelEntries, JevResponseSchema, JevModelsResponseSchema, } from "../lib.js";
+export class JevAdapter {
+    apiKey;
+    baseUrl;
+    defaultModel;
+    constructor(apiKey, baseUrl, defaultModel = "jev-latest") {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.defaultModel = defaultModel;
+    }
+    async predict(req) {
+        const body = {
+            model: req.model ?? this.defaultModel,
+            state: req.state,
+            questions: req.questions,
+        };
+        const resp = await fetchWithRetry(`${this.baseUrl}/v1/systemone`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        let raw;
+        try {
+            raw = await resp.json();
+        }
+        catch (e) {
+            throw new ParseError(`Failed to parse Jev API response as JSON: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        const parsed = JevResponseSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new ParseError(`Jev API response shape unexpected: ${parsed.error.message}`);
+        }
+        return parsed.data;
+    }
+    async listModels() {
+        const resp = await fetchWithRetry(`${this.baseUrl}/v1/models`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.apiKey}` },
+        });
+        let raw;
+        try {
+            raw = await resp.json();
+        }
+        catch (e) {
+            throw new ParseError(`Failed to parse Jev models response as JSON: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        // Handle multiple response shapes:
+        // 1. Direct array: [{ id, aliases }, ...]
+        // 2. Wrapped object: { data: [...] } or { models: [...] }
+        let entries;
+        if (Array.isArray(raw)) {
+            entries = raw;
+        }
+        else {
+            const envelope = JevModelsResponseSchema.safeParse(raw);
+            if (!envelope.success) {
+                throw new ParseError(`Unexpected Jev models response shape: ${envelope.error.message}`);
+            }
+            entries = envelope.data.models ?? envelope.data.data ?? [];
+            if (!Array.isArray(entries)) {
+                throw new ParseError("Unexpected Jev models response shape — expected array");
+            }
+        }
+        return parseModelEntries(entries);
+    }
+    /**
+     * Jev has no /health endpoint — synthesize status from environment config.
+     */
+    status() {
+        return Promise.resolve({
+            provider: "jev",
+            base_url: this.baseUrl,
+            model: this.defaultModel,
+            status: "ok",
+        });
+    }
+}
+//# sourceMappingURL=jev.js.map

package/dist/adapters/jev.js.map

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

package/dist/adapters/laya.d.ts

@@ -0,0 +1,33 @@
+/**
+ * LayaAdapter — routes requests to a local Laya HTTP server.
+ *
+ * Laya HTTP server exposes POST /v1/systemone (Jev wire-compatible) and GET /health.
+ * Key differences from Jev:
+ *   - `model` field should be OMITTED in predict request (Laya auto-routes)
+ *   - GET /health (not /v1/models) for model list
+ *   - Richer response: includes `routing` block, `latency_ms`, `device`
+ *
+ * Env:
+ *   LAYA_BASE_URL  (optional, default: http://localhost:8000)
+ *   LAYA_API_KEY   (optional) — bearer token if Laya is deployed with auth
+ */
+import { ProviderAdapter, PredictRequest, PredictResponse, ModelEntry, StatusResponse } from "../lib.js";
+export declare class LayaAdapter implements ProviderAdapter {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    constructor(baseUrl: string, apiKey?: string);
+    private get headers();
+    predict(req: PredictRequest): Promise<PredictResponse>;
+    listModels(): Promise<ModelEntry[]>;
+    status(): Promise<StatusResponse>;
+    /**
+     * Fetch GET /health. Returns null on unreachable — callers handle gracefully.
+     * Returns status: "unreachable" via StatusResponse when called from status().
+     */
+    private _fetchHealth;
+}
+/**
+ * Build a StatusResponse for unreachable Laya health endpoint.
+ */
+export declare function layaUnreachableStatus(baseUrl: string, errorMsg: string): StatusResponse;
+//# sourceMappingURL=laya.d.ts.map

package/dist/adapters/laya.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"laya.d.ts","sourceRoot":"","sources":["../../src/adapters/laya.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,EAQf,MAAM,WAAW,CAAC;AAEnB,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK5C,OAAO,KAAK,OAAO,GAMlB;IAEK,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgCtD,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAUnC,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAmBvC;;;OAGG;YACW,YAAY;CA+B3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAOvF"}

package/dist/adapters/laya.js

@@ -0,0 +1,125 @@
+/**
+ * LayaAdapter — routes requests to a local Laya HTTP server.
+ *
+ * Laya HTTP server exposes POST /v1/systemone (Jev wire-compatible) and GET /health.
+ * Key differences from Jev:
+ *   - `model` field should be OMITTED in predict request (Laya auto-routes)
+ *   - GET /health (not /v1/models) for model list
+ *   - Richer response: includes `routing` block, `latency_ms`, `device`
+ *
+ * Env:
+ *   LAYA_BASE_URL  (optional, default: http://localhost:8000)
+ *   LAYA_API_KEY   (optional) — bearer token if Laya is deployed with auth
+ */
+import { AuthError, ParseError, NetworkError, fetchWithRetry, ERROR_BODY_MAX_CHARS, truncate, } from "../lib.js";
+export class LayaAdapter {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+    }
+    get headers() {
+        const h = { "Content-Type": "application/json" };
+        if (this.apiKey) {
+            h["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return h;
+    }
+    async predict(req) {
+        // Laya auto-routes — omit `model` field
+        const body = {
+            state: req.state,
+            questions: req.questions,
+            // model intentionally omitted
+        };
+        const resp = await fetchWithRetry(`${this.baseUrl}/v1/systemone`, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        let raw;
+        try {
+            raw = await resp.json();
+        }
+        catch (e) {
+            throw new ParseError(`Failed to parse Laya API response as JSON: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        // Laya response is Jev-compatible plus extra fields (routing, latency_ms, device)
+        // Passthrough the full response including Laya-specific fields
+        if (!raw || typeof raw !== "object" || !("answers" in raw)) {
+            throw new ParseError("Laya API response missing required 'answers' field");
+        }
+        return raw;
+    }
+    async listModels() {
+        const health = await this._fetchHealth();
+        if (!health)
+            return [];
+        const loaded = health.loaded ?? [];
+        return loaded
+            .filter((id) => typeof id === "string" && id.length > 0)
+            .map((id) => ({ id }));
+    }
+    async status() {
+        const base = {
+            provider: "laya",
+            base_url: this.baseUrl,
+        };
+        const health = await this._fetchHealth();
+        if (!health) {
+            return base;
+        }
+        return {
+            ...base,
+            loaded: health.loaded,
+            device: health.device,
+            status: "ok",
+        };
+    }
+    /**
+     * Fetch GET /health. Returns null on unreachable — callers handle gracefully.
+     * Returns status: "unreachable" via StatusResponse when called from status().
+     */
+    async _fetchHealth() {
+        try {
+            const resp = await fetchWithRetry(`${this.baseUrl}/health`, {
+                method: "GET",
+                headers: this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {},
+            });
+            let raw;
+            try {
+                raw = await resp.json();
+            }
+            catch {
+                return null;
+            }
+            return raw;
+        }
+        catch (e) {
+            // On unreachable, status() returns { status: "unreachable" }
+            if (e instanceof AuthError) {
+                // Propagate auth errors with helpful hint
+                throw new AuthError(`Laya returned 401. Set LAYA_API_KEY if this instance requires authentication.`);
+            }
+            if (e instanceof NetworkError) {
+                // NetworkError from fetchWithRetry — health endpoint unreachable
+                return null;
+            }
+            // Other errors (ParseError, ProviderError) — health unreachable / malformed
+            return null;
+        }
+    }
+}
+/**
+ * Build a StatusResponse for unreachable Laya health endpoint.
+ */
+export function layaUnreachableStatus(baseUrl, errorMsg) {
+    return {
+        provider: "laya",
+        base_url: baseUrl,
+        status: "unreachable",
+        error: truncate(errorMsg, ERROR_BODY_MAX_CHARS),
+    };
+}
+//# sourceMappingURL=laya.js.map

package/dist/adapters/laya.js.map

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