@hope666/melu 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Melu 配置管理。
+ *
+ * 所有配置存储在 ~/.melu/config.json。
+ * API key 不在此处管理——直接从拦截到的请求头中获取。
+ */
+export declare const MELU_HOME: string;
+export declare const MODELS_DIR: string;
+export declare const MEMORIES_DIR: string;
+export declare const SOCKETS_DIR: string;
+export declare const STATS_DIR: string;
+export declare const PENDING_EXTRACTIONS_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare const PID_FILE: string;
+export declare const DEFAULT_MEMORY_NAME = "default";
+export declare const DEFAULT_PORT = 9800;
+export type MirrorName = "huggingface" | "modelscope";
+export declare const UI_LANGUAGES: readonly ["en", "zh-CN", "zh-TW", "ja", "ko", "fr", "ru", "de", "es", "pt"];
+export type UiLanguage = (typeof UI_LANGUAGES)[number];
+export declare const DEFAULT_UI_LANGUAGE: UiLanguage;
+export declare const EMBEDDING_MODEL_ID = "Qwen/Qwen3-Embedding-0.6B-GGUF";
+export declare const EMBEDDING_MODEL_FILE = "Qwen3-Embedding-0.6B-Q8_0.gguf";
+export declare const EMBEDDING_MODEL_PATH: string;
+export declare const EMBEDDING_MODEL_SOURCES: Record<MirrorName, {
+    label: string;
+    pageUrl: string;
+    downloadUrl: string;
+}>;
+export declare const UPSTREAM_ANTHROPIC = "https://api.anthropic.com";
+export interface MeluConfig {
+    port: number;
+    defaultMemory: string;
+    embeddingModel: string;
+    uiLanguage: UiLanguage | null;
+    mirror: MirrorName | null;
+    upstreamAnthropic: string;
+}
+export declare function isMirrorName(value: unknown): value is MirrorName;
+export declare function isUiLanguage(value: unknown): value is UiLanguage;
+export declare function loadConfig(): MeluConfig;
+export declare function saveConfig(config: MeluConfig): void;
+export declare function ensureDirs(): void;
+export declare function getMemoryPath(nameOrPath?: string | null): string;
+export declare function hasEmbeddingModel(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,SAAS,QAA2B,CAAC;AAClD,eAAO,MAAM,UAAU,QAA4B,CAAC;AACpD,eAAO,MAAM,YAAY,QAA8B,CAAC;AACxD,eAAO,MAAM,WAAW,QAA6B,CAAC;AACtD,eAAO,MAAM,SAAS,QAA2B,CAAC;AAClD,eAAO,MAAM,uBAAuB,QACwD,CAAC;AAC7F,eAAO,MAAM,WAAW,QAAiC,CAAC;AAC1D,eAAO,MAAM,QAAQ,QAA+B,CAAC;AAErD,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;AACtD,eAAO,MAAM,YAAY,6EAA8E,CAAC;AACxG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,eAAO,MAAM,mBAAmB,EAAE,UAAiB,CAAC;AAGpD,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AACnE,eAAO,MAAM,oBAAoB,mCAAmC,CAAC;AACrE,eAAO,MAAM,oBAAoB,QAAyC,CAAC;AAE3E,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,UAAU,EACV;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAcxD,CAAC;AAEF,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAeD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAahE;AA4BD,wBAAgB,UAAU,IAAI,UAAU,CAiBvC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAUnD;AAED,wBAAgB,UAAU,IAAI,IAAI,CAMjC;AAED,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAUhE;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/config.js

@@ -0,0 +1,135 @@
+/**
+ * Melu 配置管理。
+ *
+ * 所有配置存储在 ~/.melu/config.json。
+ * API key 不在此处管理——直接从拦截到的请求头中获取。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, isAbsolute, extname } from "node:path";
+export const MELU_HOME = join(homedir(), ".melu");
+export const MODELS_DIR = join(MELU_HOME, "models");
+export const MEMORIES_DIR = join(MELU_HOME, "memories");
+export const SOCKETS_DIR = join(MELU_HOME, "sockets");
+export const STATS_DIR = join(MELU_HOME, "stats");
+export const PENDING_EXTRACTIONS_DIR = process.env.MELU_PENDING_EXTRACTIONS_DIR?.trim() || join(MELU_HOME, "pending-extractions");
+export const CONFIG_FILE = join(MELU_HOME, "config.json");
+export const PID_FILE = join(MELU_HOME, "proxy.pid");
+export const DEFAULT_MEMORY_NAME = "default";
+export const DEFAULT_PORT = 9800;
+export const UI_LANGUAGES = ["en", "zh-CN", "zh-TW", "ja", "ko", "fr", "ru", "de", "es", "pt"];
+export const DEFAULT_UI_LANGUAGE = "en";
+// Embedding 模型
+export const EMBEDDING_MODEL_ID = "Qwen/Qwen3-Embedding-0.6B-GGUF";
+export const EMBEDDING_MODEL_FILE = "Qwen3-Embedding-0.6B-Q8_0.gguf";
+export const EMBEDDING_MODEL_PATH = join(MODELS_DIR, EMBEDDING_MODEL_FILE);
+export const EMBEDDING_MODEL_SOURCES = {
+    huggingface: {
+        label: "Hugging Face (Global)",
+        pageUrl: "https://huggingface.co/Qwen/Qwen3-Embedding-0.6B-GGUF/tree/main",
+        downloadUrl: "https://huggingface.co/Qwen/Qwen3-Embedding-0.6B-GGUF/resolve/main/Qwen3-Embedding-0.6B-Q8_0.gguf?download=true",
+    },
+    modelscope: {
+        label: "ModelScope (CN)",
+        pageUrl: "https://modelscope.cn/models/Qwen/Qwen3-Embedding-0.6B-GGUF/files",
+        downloadUrl: "https://modelscope.cn/models/Qwen/Qwen3-Embedding-0.6B-GGUF/resolve/master/Qwen3-Embedding-0.6B-Q8_0.gguf",
+    },
+};
+export const UPSTREAM_ANTHROPIC = "https://api.anthropic.com";
+const DEFAULT_CONFIG = {
+    port: DEFAULT_PORT,
+    defaultMemory: DEFAULT_MEMORY_NAME,
+    embeddingModel: EMBEDDING_MODEL_ID,
+    uiLanguage: null,
+    mirror: null,
+    upstreamAnthropic: UPSTREAM_ANTHROPIC,
+};
+const LEGACY_EMBEDDING_MODEL_IDS = new Set([
+    "onnx-community/Qwen3-Embedding-0.6B-ONNX",
+]);
+export function isMirrorName(value) {
+    return value === "huggingface" || value === "modelscope";
+}
+export function isUiLanguage(value) {
+    return (value === "en" ||
+        value === "zh-CN" ||
+        value === "zh-TW" ||
+        value === "ja" ||
+        value === "ko" ||
+        value === "fr" ||
+        value === "ru" ||
+        value === "de" ||
+        value === "es" ||
+        value === "pt");
+}
+function normalizeMirror(value) {
+    if (isMirrorName(value)) {
+        return value;
+    }
+    return null;
+}
+function normalizeUiLanguage(value) {
+    if (isUiLanguage(value)) {
+        return value;
+    }
+    return null;
+}
+function normalizeEmbeddingModel(value) {
+    if (typeof value !== "string" || value.trim() === "") {
+        return EMBEDDING_MODEL_ID;
+    }
+    if (LEGACY_EMBEDDING_MODEL_IDS.has(value)) {
+        return EMBEDDING_MODEL_ID;
+    }
+    return value;
+}
+export function loadConfig() {
+    if (existsSync(CONFIG_FILE)) {
+        try {
+            const raw = readFileSync(CONFIG_FILE, "utf-8");
+            const data = JSON.parse(raw);
+            return {
+                ...DEFAULT_CONFIG,
+                ...data,
+                embeddingModel: normalizeEmbeddingModel(data.embeddingModel),
+                uiLanguage: normalizeUiLanguage(data.uiLanguage),
+                mirror: normalizeMirror(data.mirror),
+            };
+        }
+        catch {
+            return { ...DEFAULT_CONFIG };
+        }
+    }
+    return { ...DEFAULT_CONFIG };
+}
+export function saveConfig(config) {
+    ensureDirs();
+    const normalized = {
+        ...DEFAULT_CONFIG,
+        ...config,
+        embeddingModel: normalizeEmbeddingModel(config.embeddingModel),
+        uiLanguage: normalizeUiLanguage(config.uiLanguage),
+        mirror: normalizeMirror(config.mirror),
+    };
+    writeFileSync(CONFIG_FILE, JSON.stringify(normalized, null, 2), "utf-8");
+}
+export function ensureDirs() {
+    for (const dir of [MELU_HOME, MODELS_DIR, MEMORIES_DIR, SOCKETS_DIR, STATS_DIR, PENDING_EXTRACTIONS_DIR]) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+export function getMemoryPath(nameOrPath) {
+    const name = nameOrPath ?? DEFAULT_MEMORY_NAME;
+    // 绝对路径或带路径分隔符的，直接使用（支持 U 盘等外部路径）
+    if (isAbsolute(name) || name.includes("/") || name.includes("\\")) {
+        return extname(name) === ".memory" ? name : name + ".memory";
+    }
+    // 否则视为 ~/.melu/memories/ 下的名称
+    return join(MEMORIES_DIR, name + ".memory");
+}
+export function hasEmbeddingModel() {
+    return existsSync(EMBEDDING_MODEL_PATH);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,uBAAuB,GAClC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAC7F,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAGjC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAExG,MAAM,CAAC,MAAM,mBAAmB,GAAe,IAAI,CAAC;AAEpD,eAAe;AACf,MAAM,CAAC,MAAM,kBAAkB,GAAG,gCAAgC,CAAC;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,gCAAgC,CAAC;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,uBAAuB,GAGhC;IACF,WAAW,EAAE;QACX,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,iEAAiE;QAC1E,WAAW,EACT,iHAAiH;KACpH;IACD,UAAU,EAAE;QACV,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE,mEAAmE;QAC5E,WAAW,EACT,2GAA2G;KAC9G;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAW9D,MAAM,cAAc,GAAe;IACjC,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,mBAAmB;IAClC,cAAc,EAAE,kBAAkB;IAClC,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;IACZ,iBAAiB,EAAE,kBAAkB;CACtC,CAAC;AAEF,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,0CAA0C;CAC3C,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,YAAY,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI,CACf,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO;gBACL,GAAG,cAAc;gBACjB,GAAG,IAAI;gBACP,cAAc,EAAE,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC;gBAC5D,UAAU,EAAE,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC;gBAChD,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;aACrC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,UAAU,EAAE,CAAC;IACb,MAAM,UAAU,GAAe;QAC7B,GAAG,cAAc;QACjB,GAAG,MAAM;QACT,cAAc,EAAE,uBAAuB,CAAC,MAAM,CAAC,cAAc,CAAC;QAC9D,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC;QAClD,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;KACvC,CAAC;IACF,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,uBAAuB,CAAC,EAAE,CAAC;QACzG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAA0B;IACtD,MAAM,IAAI,GAAG,UAAU,IAAI,mBAAmB,CAAC;IAE/C,iCAAiC;IACjC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC;IAC/D,CAAC;IAED,8BAA8B;IAC9B,OAAO,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC"}

package/dist/embedder-client.d.ts

@@ -0,0 +1,24 @@
+import { type EmbedderDaemonResponse, type EmbedderRequestType, getEmbedderDaemonSocketPath, isEmbedderDaemonRequest } from "./embedder-ipc.js";
+export interface EmbedderClientRequestOptions {
+    runId: string;
+    type: Exclude<EmbedderRequestType, "ping">;
+    texts: string[];
+    socketPath?: string;
+    timeoutMs?: number;
+}
+export interface EmbedderClientPingOptions {
+    runId: string;
+    socketPath?: string;
+    timeoutMs?: number;
+}
+export interface WaitForEmbedderDaemonOptions extends EmbedderClientPingOptions {
+    retryIntervalMs?: number;
+}
+export declare function requestEmbedderEmbeddings(options: EmbedderClientRequestOptions): Promise<Float32Array[]>;
+export declare function requestSingleEmbedderEmbedding(options: Omit<EmbedderClientRequestOptions, "texts"> & {
+    text: string;
+}): Promise<Float32Array>;
+export declare function pingEmbedderDaemon(options: EmbedderClientPingOptions): Promise<EmbedderDaemonResponse>;
+export declare function waitForEmbedderDaemonReady(options: WaitForEmbedderDaemonOptions): Promise<void>;
+export { getEmbedderDaemonSocketPath, isEmbedderDaemonRequest };
+//# sourceMappingURL=embedder-client.d.ts.map

package/dist/embedder-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder-client.d.ts","sourceRoot":"","sources":["../src/embedder-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,2BAA2B,EAC3B,uBAAuB,EAKxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA6B,SAAQ,yBAAyB;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4HD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,YAAY,EAAE,CAAC,CAuBzB;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAiBjC;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/embedder-client.js

@@ -0,0 +1,164 @@
+import { randomUUID } from "node:crypto";
+import { createConnection } from "node:net";
+import { getEmbedderDaemonSocketPath, isEmbedderDaemonRequest, isEmbedderRequestType, normalizeEmbedderTexts, encodeEmbedderMessage, tryParseEmbedderMessage, } from "./embedder-ipc.js";
+function connectSocket(socketPath, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const socket = createConnection({ path: socketPath });
+        let settled = false;
+        const settle = (error, value) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.removeAllListeners();
+            if (error) {
+                socket.destroy();
+                reject(error);
+                return;
+            }
+            resolve(value);
+        };
+        socket.setEncoding("utf8");
+        socket.setTimeout(timeoutMs, () => {
+            settle(new Error(`Timed out connecting to embedder daemon at ${socketPath}`));
+        });
+        socket.once("error", (error) => {
+            settle(error instanceof Error ? error : new Error(String(error)));
+        });
+        socket.once("connect", () => {
+            socket.setTimeout(0);
+            settle(null, socket);
+        });
+    });
+}
+async function sendEmbedderRequest(request, timeoutMs, socketPath) {
+    const socket = await connectSocket(socketPath, timeoutMs);
+    return new Promise((resolve, reject) => {
+        let buffer = "";
+        let settled = false;
+        const settle = (error, response) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.removeAllListeners();
+            socket.destroy();
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve(response);
+        };
+        const onData = (chunk) => {
+            buffer += chunk;
+            const newlineIndex = buffer.indexOf("\n");
+            if (newlineIndex === -1)
+                return;
+            const frame = buffer.slice(0, newlineIndex);
+            const parsed = tryParseEmbedderMessage(frame);
+            if (!parsed || typeof parsed !== "object") {
+                settle(new Error("Invalid response from embedder daemon"));
+                return;
+            }
+            const obj = parsed;
+            if (typeof obj.id !== "string" ||
+                typeof obj.run_id !== "string" ||
+                !isEmbedderRequestType(obj.type) ||
+                typeof obj.ok !== "boolean" ||
+                typeof obj.latency_ms !== "number") {
+                settle(new Error("Malformed response from embedder daemon"));
+                return;
+            }
+            const response = {
+                id: obj.id,
+                run_id: obj.run_id,
+                type: obj.type,
+                ok: obj.ok,
+                error: typeof obj.error === "string" ? obj.error : null,
+                latency_ms: obj.latency_ms,
+                embeddings: Array.isArray(obj.embeddings)
+                    ? obj.embeddings
+                        .filter((item) => Array.isArray(item))
+                        .map((vector) => vector.filter((value) => typeof value === "number"))
+                    : undefined,
+            };
+            settle(null, response);
+        };
+        socket.on("data", onData);
+        socket.once("error", (error) => {
+            settle(error instanceof Error ? error : new Error(String(error)));
+        });
+        socket.once("timeout", () => {
+            settle(new Error(`Timed out waiting for embedder daemon response at ${socketPath}`));
+        });
+        socket.once("close", () => {
+            if (!settled) {
+                settle(new Error("Embedder daemon closed the connection before responding"));
+            }
+        });
+        socket.write(encodeEmbedderMessage(request), "utf8", (error) => {
+            if (error) {
+                settle(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    });
+}
+export async function requestEmbedderEmbeddings(options) {
+    const texts = normalizeEmbedderTexts(options.texts);
+    if (texts.length === 0) {
+        throw new Error("Cannot request embeddings for empty texts");
+    }
+    const response = await sendEmbedderRequest({
+        id: randomUUID(),
+        run_id: options.runId,
+        type: options.type,
+        texts,
+    }, options.timeoutMs ?? 60_000, options.socketPath ?? getEmbedderDaemonSocketPath(options.runId));
+    if (!response.ok) {
+        throw new Error(response.error ?? "Embedder daemon returned an error");
+    }
+    const embeddings = response.embeddings ?? [];
+    return embeddings.map((vector) => new Float32Array(vector));
+}
+export async function requestSingleEmbedderEmbedding(options) {
+    const vectors = await requestEmbedderEmbeddings({
+        runId: options.runId,
+        type: options.type,
+        texts: [options.text],
+        socketPath: options.socketPath,
+        timeoutMs: options.timeoutMs,
+    });
+    if (vectors.length === 0) {
+        throw new Error("Embedder daemon returned no vectors");
+    }
+    return vectors[0];
+}
+export async function pingEmbedderDaemon(options) {
+    const response = await sendEmbedderRequest({
+        id: randomUUID(),
+        run_id: options.runId,
+        type: "ping",
+        texts: [],
+    }, options.timeoutMs ?? 10_000, options.socketPath ?? getEmbedderDaemonSocketPath(options.runId));
+    if (!response.ok) {
+        throw new Error(response.error ?? "Embedder daemon ping failed");
+    }
+    return response;
+}
+export async function waitForEmbedderDaemonReady(options) {
+    const retryIntervalMs = options.retryIntervalMs ?? 250;
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const startedAt = Date.now();
+    while (true) {
+        try {
+            await pingEmbedderDaemon(options);
+            return;
+        }
+        catch (error) {
+            if (Date.now() - startedAt >= timeoutMs) {
+                throw error instanceof Error ? error : new Error(String(error));
+            }
+            await new Promise((resolve) => setTimeout(resolve, retryIntervalMs));
+        }
+    }
+}
+export { getEmbedderDaemonSocketPath, isEmbedderDaemonRequest };
+//# sourceMappingURL=embedder-client.js.map

package/dist/embedder-client.js.map

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

package/dist/embedder-daemon-client.d.ts

@@ -0,0 +1,10 @@
+export type EmbedderRequestType = "query" | "memory";
+export interface EmbedderDaemonRequestOptions {
+    runId?: string | null;
+    socketPath?: string | null;
+    timeoutMs?: number;
+    type?: EmbedderRequestType;
+}
+export declare function embedLongTextViaDaemon(text: string, modelId: string, options?: EmbedderDaemonRequestOptions): Promise<Float32Array | null>;
+export declare function embedTextsViaDaemon(texts: string[], modelId: string, options?: EmbedderDaemonRequestOptions): Promise<Float32Array[] | null>;
+//# sourceMappingURL=embedder-daemon-client.d.ts.map

package/dist/embedder-daemon-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder-daemon-client.d.ts","sourceRoot":"","sources":["../src/embedder-daemon-client.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAqBD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAchC"}

package/dist/embedder-daemon-client.js

@@ -0,0 +1,185 @@
+import { createConnection } from "node:net";
+import { splitTextIntoOverlappingWindows } from "./text-chunking.js";
+import { buildEmbedderSocketPath, createMeluRuntimeContext, getMeluRuntimeContext, } from "./runtime-context.js";
+const DEFAULT_TIMEOUT_MS = 2500;
+export async function embedLongTextViaDaemon(text, modelId, options) {
+    const chunks = splitTextIntoOverlappingWindows(text);
+    if (chunks.length === 0)
+        return null;
+    const embeddings = await embedTextsViaDaemon(chunks, modelId, {
+        ...options,
+        type: options?.type ?? "query",
+    });
+    if (!embeddings || embeddings.length === 0)
+        return null;
+    if (embeddings.length === 1)
+        return embeddings[0];
+    return averageVectors(embeddings);
+}
+export async function embedTextsViaDaemon(texts, modelId, options) {
+    const normalizedTexts = texts
+        .map((text) => text.trim())
+        .filter((text) => text.length > 0);
+    if (normalizedTexts.length === 0)
+        return null;
+    const runtime = resolveRuntimeContext(options);
+    if (!runtime.embedderSocketPath)
+        return null;
+    const payload = await requestEmbeddings(runtime, normalizedTexts, modelId, options?.type ?? "query", options?.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    if (!payload)
+        return null;
+    return payload;
+}
+function resolveRuntimeContext(options) {
+    if (options?.runId) {
+        const runtime = createMeluRuntimeContext(options.runId);
+        return {
+            runId: runtime.runId,
+            embedderSocketPath: options.socketPath?.trim() || runtime.embedderSocketPath,
+        };
+    }
+    const runtime = getMeluRuntimeContext();
+    return {
+        runId: runtime.runId,
+        embedderSocketPath: options?.socketPath?.trim() || runtime.embedderSocketPath || buildEmbedderSocketPath(runtime.runId),
+    };
+}
+async function requestEmbeddings(runtime, texts, modelId, type, timeoutMs) {
+    return await new Promise((resolve) => {
+        const socket = createConnection({ path: runtime.embedderSocketPath });
+        socket.setEncoding("utf8");
+        let settled = false;
+        let buffer = "";
+        const request = {
+            id: randomRequestId(),
+            type,
+            texts,
+            model: modelId,
+            run_id: runtime.runId,
+        };
+        const timeout = setTimeout(() => {
+            fail(null);
+        }, timeoutMs);
+        const cleanup = () => {
+            clearTimeout(timeout);
+            socket.removeAllListeners();
+            try {
+                socket.destroy();
+            }
+            catch {
+                // Ignore cleanup failures.
+            }
+        };
+        const succeed = (vectors) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(vectors);
+        };
+        const fail = (_error) => {
+            succeed(null);
+        };
+        socket.on("connect", () => {
+            try {
+                socket.write(JSON.stringify(request) + "\n");
+            }
+            catch (error) {
+                fail(error);
+            }
+        });
+        socket.on("data", (chunk) => {
+            buffer += chunk;
+            const newlineIndex = buffer.indexOf("\n");
+            if (newlineIndex === -1)
+                return;
+            const line = buffer.slice(0, newlineIndex).trim();
+            if (!line) {
+                fail(new Error("empty embedder daemon response"));
+                return;
+            }
+            try {
+                const response = JSON.parse(line);
+                if (response.error) {
+                    fail(new Error(response.error));
+                    return;
+                }
+                const vectors = normalizeDaemonResponse(response);
+                if (!vectors || vectors.length === 0) {
+                    fail(new Error("invalid embedder daemon response"));
+                    return;
+                }
+                succeed(vectors);
+            }
+            catch (error) {
+                fail(error);
+            }
+        });
+        socket.on("error", () => {
+            fail(null);
+        });
+        socket.on("close", () => {
+            if (!settled) {
+                fail(null);
+            }
+        });
+    });
+}
+function normalizeDaemonResponse(response) {
+    if (Array.isArray(response.embeddings)) {
+        const vectors = response.embeddings
+            .map((entry) => normalizeVectorEntry(entry))
+            .filter((vector) => vector !== null);
+        return vectors.length > 0 ? vectors : null;
+    }
+    const singleVector = normalizeVectorEntry(response.embedding);
+    return singleVector ? [singleVector] : null;
+}
+function normalizeVectorEntry(value) {
+    if (!Array.isArray(value))
+        return null;
+    const vector = new Float32Array(value.length);
+    for (let i = 0; i < value.length; i++) {
+        const entry = Number(value[i]);
+        if (!Number.isFinite(entry))
+            return null;
+        vector[i] = entry;
+    }
+    return normalizeVector(vector);
+}
+function normalizeVector(vector) {
+    let norm = 0;
+    for (let i = 0; i < vector.length; i++) {
+        norm += vector[i] * vector[i];
+    }
+    if (norm <= 1e-12)
+        return vector;
+    const scale = 1 / Math.sqrt(norm);
+    for (let i = 0; i < vector.length; i++) {
+        vector[i] *= scale;
+    }
+    return vector;
+}
+function averageVectors(vectors) {
+    if (vectors.length === 0) {
+        throw new Error("Cannot average empty vectors");
+    }
+    const result = new Float32Array(vectors[0].length);
+    for (const vector of vectors) {
+        if (vector.length !== result.length) {
+            throw new Error("Vectors have different lengths");
+        }
+        for (let i = 0; i < vector.length; i++) {
+            result[i] += vector[i];
+        }
+    }
+    const scale = 1 / vectors.length;
+    for (let i = 0; i < result.length; i++) {
+        result[i] *= scale;
+    }
+    return normalizeVector(result);
+}
+function randomRequestId() {
+    return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+//# sourceMappingURL=embedder-daemon-client.js.map

package/dist/embedder-daemon-client.js.map

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

package/dist/embedder-daemon.d.ts

@@ -0,0 +1,11 @@
+export interface EmbedderDaemonOptions {
+    runId: string;
+    ownerPid?: number;
+    socketPath?: string;
+    modelId?: string;
+    idleTimeoutMs?: number;
+    idleCheckMs?: number;
+}
+export declare function startEmbedderDaemon(options: EmbedderDaemonOptions): Promise<void>;
+export declare function runEmbedderDaemonFromEnv(): Promise<void>;
+//# sourceMappingURL=embedder-daemon.d.ts.map

package/dist/embedder-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder-daemon.d.ts","sourceRoot":"","sources":["../src/embedder-daemon.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkRD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DvF;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB9D"}