@staticn0va/wigolo 0.1.0 → 0.1.2

package/dist/logger.js

@@ -1,39 +1,80 @@
-import { getConfig } from './config.js';
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getConfig } from "./config.js";
 const LEVEL_PRIORITY = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
 };
+let tuiLogPath = null;
+function getTuiLogPath() {
+  if (!tuiLogPath) {
+    const dataDir = getConfig().dataDir;
+    mkdirSync(dataDir, { recursive: true });
+    tuiLogPath = join(dataDir, "init.log");
+  }
+  return tuiLogPath;
+}
+function appendToLogFile(line) {
+  try {
+    appendFileSync(getTuiLogPath(), line + "\n");
+  } catch {
+  }
+}
 function writeJson(level, module, msg, data) {
-    const line = JSON.stringify({
-        ts: new Date().toISOString(),
-        level,
-        msg,
-        module,
-        ...(data ? { data } : {}),
-    });
-    process.stderr.write(line + '\n');
+  const line = JSON.stringify({
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    level,
+    msg,
+    module,
+    ...data ? { data } : {}
+  });
+  if (process.env.WIGOLO_TUI_MODE === "true") {
+    appendToLogFile(line);
+    return;
+  }
+  process.stderr.write(line + "\n");
 }
 function writeText(level, module, msg, data) {
-    const ts = new Date().toISOString();
-    const dataStr = data ? ' ' + Object.entries(data).map(([k, v]) => `${k}=${v}`).join(' ') : '';
-    process.stderr.write(`[${ts}] ${level.toUpperCase().padEnd(5)} [${module}] ${msg}${dataStr}\n`);
+  const ts = (/* @__PURE__ */ new Date()).toISOString();
+  const dataStr = data ? " " + Object.entries(data).map(([k, v]) => `${k}=${v}`).join(" ") : "";
+  const line = `[${ts}] ${level.toUpperCase().padEnd(5)} [${module}] ${msg}${dataStr}`;
+  if (process.env.WIGOLO_TUI_MODE === "true") {
+    appendToLogFile(line);
+    return;
+  }
+  process.stderr.write(line + "\n");
+}
+let suppressionFloor = null;
+function setLogSuppression(level) {
+  suppressionFloor = level;
 }
-export function createLogger(module) {
-    const config = getConfig();
-    const minPriority = LEVEL_PRIORITY[config.logLevel];
-    const write = config.logFormat === 'json' ? writeJson : writeText;
-    function log(level, msg, data) {
-        if (LEVEL_PRIORITY[level] >= minPriority) {
-            write(level, module, msg, data);
-        }
+function getLogSuppression() {
+  return suppressionFloor;
+}
+function createLogger(module) {
+  const config = getConfig();
+  const minPriority = LEVEL_PRIORITY[config.logLevel];
+  const write = config.logFormat === "json" ? writeJson : writeText;
+  function log(level, msg, data) {
+    if (suppressionFloor !== null && LEVEL_PRIORITY[level] < LEVEL_PRIORITY[suppressionFloor]) {
+      return;
+    }
+    if (LEVEL_PRIORITY[level] >= minPriority) {
+      write(level, module, msg, data);
     }
-    return {
-        debug: (msg, data) => log('debug', msg, data),
-        info: (msg, data) => log('info', msg, data),
-        warn: (msg, data) => log('warn', msg, data),
-        error: (msg, data) => log('error', msg, data),
-    };
+  }
+  return {
+    debug: (msg, data) => log("debug", msg, data),
+    info: (msg, data) => log("info", msg, data),
+    warn: (msg, data) => log("warn", msg, data),
+    error: (msg, data) => log("error", msg, data)
+  };
 }
+export {
+  createLogger,
+  getLogSuppression,
+  setLogSuppression
+};
 //# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAKxC,MAAM,cAAc,GAA6B;IAC/C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AASF,SAAS,SAAS,CAAC,KAAe,EAAE,MAAc,EAAE,GAAW,EAAE,IAA8B;IAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,KAAK;QACL,GAAG;QACH,MAAM;QACN,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,KAAe,EAAE,MAAc,EAAE,GAAW,EAAE,IAA8B;IAC7F,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,KAAK,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAElE,SAAS,GAAG,CAAC,KAAe,EAAE,GAAW,EAAE,IAA8B;QACvE,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;YACzC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KAC9C,CAAC;AACJ,CAAC"}
+{"version":3,"sources":["../src/logger.ts"],"sourcesContent":["import { appendFileSync, mkdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { getConfig } from './config.js';\n\ntype LogLevel = 'debug' | 'info' | 'warn' | 'error';\ntype Module = 'fetch' | 'search' | 'crawl' | 'cache' | 'extract' | 'searxng' | 'server' | 'cli' | 'jsonld' | 'repl' | 'embedding' | 'research' | 'agent' | 'structured-data' | 'reranker' | 'mode' | 'language-filter' | 'playwright-tier' | 'python-worker' | 'providers';\n\nconst LEVEL_PRIORITY: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nexport interface Logger {\n  debug(msg: string, data?: Record<string, unknown>): void;\n  info(msg: string, data?: Record<string, unknown>): void;\n  warn(msg: string, data?: Record<string, unknown>): void;\n  error(msg: string, data?: Record<string, unknown>): void;\n}\n\nlet tuiLogPath: string | null = null;\n\nfunction getTuiLogPath(): string {\n  if (!tuiLogPath) {\n    const dataDir = getConfig().dataDir;\n    mkdirSync(dataDir, { recursive: true });\n    tuiLogPath = join(dataDir, 'init.log');\n  }\n  return tuiLogPath;\n}\n\nfunction appendToLogFile(line: string): void {\n  try {\n    appendFileSync(getTuiLogPath(), line + '\\n');\n  } catch {\n    // best effort — don't crash the TUI\n  }\n}\n\nfunction writeJson(level: LogLevel, module: string, msg: string, data?: Record<string, unknown>): void {\n  const line = JSON.stringify({\n    ts: new Date().toISOString(),\n    level,\n    msg,\n    module,\n    ...(data ? { data } : {}),\n  });\n  if (process.env.WIGOLO_TUI_MODE === 'true') {\n    appendToLogFile(line);\n    return;\n  }\n  process.stderr.write(line + '\\n');\n}\n\nfunction writeText(level: LogLevel, module: string, msg: string, data?: Record<string, unknown>): void {\n  const ts = new Date().toISOString();\n  const dataStr = data ? ' ' + Object.entries(data).map(([k, v]) => `${k}=${v}`).join(' ') : '';\n  const line = `[${ts}] ${level.toUpperCase().padEnd(5)} [${module}] ${msg}${dataStr}`;\n  if (process.env.WIGOLO_TUI_MODE === 'true') {\n    appendToLogFile(line);\n    return;\n  }\n  process.stderr.write(line + '\\n');\n}\n\n// Runtime suppression floor — set by CLI commands (eg. doctor) that need a\n// clean human-readable output and don't want logger lines from cache, search,\n// etc. interleaved with their own. Levels strictly below the floor are\n// dropped. `null` (default) means honour only the per-logger config level.\nlet suppressionFloor: LogLevel | null = null;\n\nexport function setLogSuppression(level: LogLevel | null): void {\n  suppressionFloor = level;\n}\n\nexport function getLogSuppression(): LogLevel | null {\n  return suppressionFloor;\n}\n\nexport function createLogger(module: Module): Logger {\n  const config = getConfig();\n  const minPriority = LEVEL_PRIORITY[config.logLevel];\n  const write = config.logFormat === 'json' ? writeJson : writeText;\n\n  function log(level: LogLevel, msg: string, data?: Record<string, unknown>): void {\n    if (suppressionFloor !== null && LEVEL_PRIORITY[level] < LEVEL_PRIORITY[suppressionFloor]) {\n      return;\n    }\n    if (LEVEL_PRIORITY[level] >= minPriority) {\n      write(level, module, msg, data);\n    }\n  }\n\n  return {\n    debug: (msg, data) => log('debug', msg, data),\n    info: (msg, data) => log('info', msg, data),\n    warn: (msg, data) => log('warn', msg, data),\n    error: (msg, data) => log('error', msg, data),\n  };\n}\n"],"mappings":"AAAA,SAAS,gBAAgB,iBAAiB;AAC1C,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAK1B,MAAM,iBAA2C;AAAA,EAC/C,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AASA,IAAI,aAA4B;AAEhC,SAAS,gBAAwB;AAC/B,MAAI,CAAC,YAAY;AACf,UAAM,UAAU,UAAU,EAAE;AAC5B,cAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AACtC,iBAAa,KAAK,SAAS,UAAU;AAAA,EACvC;AACA,SAAO;AACT;AAEA,SAAS,gBAAgB,MAAoB;AAC3C,MAAI;AACF,mBAAe,cAAc,GAAG,OAAO,IAAI;AAAA,EAC7C,QAAQ;AAAA,EAER;AACF;AAEA,SAAS,UAAU,OAAiB,QAAgB,KAAa,MAAsC;AACrG,QAAM,OAAO,KAAK,UAAU;AAAA,IAC1B,KAAI,oBAAI,KAAK,GAAE,YAAY;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,EACzB,CAAC;AACD,MAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C,oBAAgB,IAAI;AACpB;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,OAAO,IAAI;AAClC;AAEA,SAAS,UAAU,OAAiB,QAAgB,KAAa,MAAsC;AACrG,QAAM,MAAK,oBAAI,KAAK,GAAE,YAAY;AAClC,QAAM,UAAU,OAAO,MAAM,OAAO,QAAQ,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI;AAC3F,QAAM,OAAO,IAAI,EAAE,KAAK,MAAM,YAAY,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,KAAK,GAAG,GAAG,OAAO;AAClF,MAAI,QAAQ,IAAI,oBAAoB,QAAQ;AAC1C,oBAAgB,IAAI;AACpB;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,OAAO,IAAI;AAClC;AAMA,IAAI,mBAAoC;AAEjC,SAAS,kBAAkB,OAA8B;AAC9D,qBAAmB;AACrB;AAEO,SAAS,oBAAqC;AACnD,SAAO;AACT;AAEO,SAAS,aAAa,QAAwB;AACnD,QAAM,SAAS,UAAU;AACzB,QAAM,cAAc,eAAe,OAAO,QAAQ;AAClD,QAAM,QAAQ,OAAO,cAAc,SAAS,YAAY;AAExD,WAAS,IAAI,OAAiB,KAAa,MAAsC;AAC/E,QAAI,qBAAqB,QAAQ,eAAe,KAAK,IAAI,eAAe,gBAAgB,GAAG;AACzF;AAAA,IACF;AACA,QAAI,eAAe,KAAK,KAAK,aAAa;AACxC,YAAM,OAAO,QAAQ,KAAK,IAAI;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,CAAC,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI;AAAA,IAC5C,MAAM,CAAC,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;AAAA,IAC1C,MAAM,CAAC,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;AAAA,IAC1C,OAAO,CAAC,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI;AAAA,EAC9C;AACF;","names":[]}

package/dist/pdf-parse.d.js

@@ -0,0 +1 @@
+//# sourceMappingURL=pdf-parse.d.js.map

package/dist/pdf-parse.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,20 @@
+import type { Extractor, SearchEngine } from '../types.js';
+export interface LoadedPlugin {
+    name: string;
+    version: string;
+    path: string;
+    hasExtractor: boolean;
+    hasSearchEngine: boolean;
+}
+export interface PluginLoadError {
+    pluginName: string;
+    message: string;
+}
+export interface PluginLoadResult {
+    extractors: Extractor[];
+    searchEngines: SearchEngine[];
+    loaded: LoadedPlugin[];
+    errors: PluginLoadError[];
+}
+export declare function loadPlugins(): Promise<PluginLoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAqBD,wBAAsB,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA2J7D"}

package/dist/plugins/loader.js

@@ -0,0 +1,157 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { getConfig } from "../config.js";
+import { createLogger } from "../logger.js";
+import { validatePluginExports } from "./validate.js";
+const log = createLogger("server");
+function readPluginPackageJson(pluginDir) {
+  const pkgPath = join(pluginDir, "package.json");
+  if (!existsSync(pkgPath)) {
+    return null;
+  }
+  try {
+    const raw = readFileSync(pkgPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function loadPlugins() {
+  const config = getConfig();
+  const pluginsDir = config.pluginsDir;
+  const result = {
+    extractors: [],
+    searchEngines: [],
+    loaded: [],
+    errors: []
+  };
+  if (!existsSync(pluginsDir)) {
+    log.debug("plugins directory does not exist, skipping", { path: pluginsDir });
+    return result;
+  }
+  let entries;
+  try {
+    entries = readdirSync(pluginsDir);
+  } catch (err) {
+    log.warn("failed to read plugins directory", {
+      path: pluginsDir,
+      error: String(err)
+    });
+    return result;
+  }
+  const seenExtractorNames = /* @__PURE__ */ new Set();
+  const seenEngineNames = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    const pluginDir = join(pluginsDir, entry);
+    let stat;
+    try {
+      stat = statSync(pluginDir);
+    } catch {
+      continue;
+    }
+    if (!stat.isDirectory()) {
+      continue;
+    }
+    const pkgJson = readPluginPackageJson(pluginDir);
+    const pluginName = pkgJson?.name ?? entry;
+    if (pkgJson === null) {
+      if (existsSync(join(pluginDir, "package.json"))) {
+        result.errors.push({
+          pluginName: entry,
+          message: `failed to parse package.json in ${pluginDir}`
+        });
+      }
+      continue;
+    }
+    if (!pkgJson.main) {
+      result.errors.push({
+        pluginName,
+        message: `plugin ${pluginName} has no main field in package.json`
+      });
+      continue;
+    }
+    const entryPath = join(pluginDir, pkgJson.main);
+    if (!existsSync(entryPath)) {
+      result.errors.push({
+        pluginName,
+        message: `entry point not found: ${entryPath}`
+      });
+      continue;
+    }
+    let mod;
+    try {
+      const fileUrl = pathToFileURL(entryPath).href;
+      mod = await import(fileUrl);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      result.errors.push({
+        pluginName,
+        message: `failed to load plugin ${pluginName}: ${message}`
+      });
+      log.warn("plugin import failed", { plugin: pluginName, error: message });
+      continue;
+    }
+    const validation = validatePluginExports(mod);
+    if (validation.errors.length > 0) {
+      for (const errMsg of validation.errors) {
+        result.errors.push({ pluginName, message: errMsg });
+      }
+      log.warn("plugin validation failed", { plugin: pluginName, errors: validation.errors });
+    }
+    let registered = false;
+    if (validation.hasExtractor) {
+      const extractor = mod.extractor;
+      if (seenExtractorNames.has(extractor.name)) {
+        log.warn("duplicate extractor name, skipping", {
+          plugin: pluginName,
+          extractorName: extractor.name
+        });
+      } else {
+        seenExtractorNames.add(extractor.name);
+        result.extractors.push(extractor);
+        registered = true;
+        log.info("loaded plugin extractor", {
+          plugin: pluginName,
+          extractorName: extractor.name
+        });
+      }
+    }
+    if (validation.hasSearchEngine) {
+      const engine = mod.searchEngine;
+      if (seenEngineNames.has(engine.name)) {
+        log.warn("duplicate search engine name, skipping", {
+          plugin: pluginName,
+          engineName: engine.name
+        });
+      } else {
+        seenEngineNames.add(engine.name);
+        result.searchEngines.push(engine);
+        registered = true;
+        log.info("loaded plugin search engine", {
+          plugin: pluginName,
+          engineName: engine.name
+        });
+      }
+    }
+    if (registered) {
+      result.loaded.push({
+        name: pluginName,
+        version: pkgJson.version ?? "0.0.0",
+        path: pluginDir,
+        hasExtractor: validation.hasExtractor,
+        hasSearchEngine: validation.hasSearchEngine
+      });
+    }
+  }
+  log.info("plugin loading complete", {
+    extractors: result.extractors.length,
+    searchEngines: result.searchEngines.length,
+    errors: result.errors.length
+  });
+  return result;
+}
+export {
+  loadPlugins
+};
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/loader.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { getConfig } from '../config.js';\nimport { createLogger } from '../logger.js';\nimport { validatePluginExports } from './validate.js';\nimport type { Extractor, SearchEngine } from '../types.js';\n\nconst log = createLogger('server');\n\nexport interface LoadedPlugin {\n  name: string;\n  version: string;\n  path: string;\n  hasExtractor: boolean;\n  hasSearchEngine: boolean;\n}\n\nexport interface PluginLoadError {\n  pluginName: string;\n  message: string;\n}\n\nexport interface PluginLoadResult {\n  extractors: Extractor[];\n  searchEngines: SearchEngine[];\n  loaded: LoadedPlugin[];\n  errors: PluginLoadError[];\n}\n\ninterface PluginPackageJson {\n  name?: string;\n  version?: string;\n  main?: string;\n}\n\nfunction readPluginPackageJson(pluginDir: string): PluginPackageJson | null {\n  const pkgPath = join(pluginDir, 'package.json');\n  if (!existsSync(pkgPath)) {\n    return null;\n  }\n  try {\n    const raw = readFileSync(pkgPath, 'utf-8');\n    return JSON.parse(raw) as PluginPackageJson;\n  } catch {\n    return null;\n  }\n}\n\nexport async function loadPlugins(): Promise<PluginLoadResult> {\n  const config = getConfig();\n  const pluginsDir = config.pluginsDir;\n\n  const result: PluginLoadResult = {\n    extractors: [],\n    searchEngines: [],\n    loaded: [],\n    errors: [],\n  };\n\n  if (!existsSync(pluginsDir)) {\n    log.debug('plugins directory does not exist, skipping', { path: pluginsDir });\n    return result;\n  }\n\n  let entries: string[];\n  try {\n    entries = readdirSync(pluginsDir);\n  } catch (err) {\n    log.warn('failed to read plugins directory', {\n      path: pluginsDir,\n      error: String(err),\n    });\n    return result;\n  }\n\n  const seenExtractorNames = new Set<string>();\n  const seenEngineNames = new Set<string>();\n\n  for (const entry of entries) {\n    const pluginDir = join(pluginsDir, entry);\n\n    let stat;\n    try {\n      stat = statSync(pluginDir);\n    } catch {\n      continue;\n    }\n\n    // statSync follows symlinks, so this also handles symlinked plugin dirs\n    if (!stat.isDirectory()) {\n      continue;\n    }\n\n    const pkgJson = readPluginPackageJson(pluginDir);\n    const pluginName = pkgJson?.name ?? entry;\n\n    if (pkgJson === null) {\n      // Check if there is a package.json at all\n      if (existsSync(join(pluginDir, 'package.json'))) {\n        result.errors.push({\n          pluginName: entry,\n          message: `failed to parse package.json in ${pluginDir}`,\n        });\n      }\n      continue;\n    }\n\n    if (!pkgJson.main) {\n      result.errors.push({\n        pluginName,\n        message: `plugin ${pluginName} has no main field in package.json`,\n      });\n      continue;\n    }\n\n    const entryPath = join(pluginDir, pkgJson.main);\n    if (!existsSync(entryPath)) {\n      result.errors.push({\n        pluginName,\n        message: `entry point not found: ${entryPath}`,\n      });\n      continue;\n    }\n\n    let mod: Record<string, unknown>;\n    try {\n      const fileUrl = pathToFileURL(entryPath).href;\n      mod = (await import(fileUrl)) as Record<string, unknown>;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      result.errors.push({\n        pluginName,\n        message: `failed to load plugin ${pluginName}: ${message}`,\n      });\n      log.warn('plugin import failed', { plugin: pluginName, error: message });\n      continue;\n    }\n\n    const validation = validatePluginExports(mod);\n\n    if (validation.errors.length > 0) {\n      for (const errMsg of validation.errors) {\n        result.errors.push({ pluginName, message: errMsg });\n      }\n      log.warn('plugin validation failed', { plugin: pluginName, errors: validation.errors });\n    }\n\n    let registered = false;\n\n    if (validation.hasExtractor) {\n      const extractor = mod.extractor as Extractor;\n      if (seenExtractorNames.has(extractor.name)) {\n        log.warn('duplicate extractor name, skipping', {\n          plugin: pluginName,\n          extractorName: extractor.name,\n        });\n      } else {\n        seenExtractorNames.add(extractor.name);\n        result.extractors.push(extractor);\n        registered = true;\n        log.info('loaded plugin extractor', {\n          plugin: pluginName,\n          extractorName: extractor.name,\n        });\n      }\n    }\n\n    if (validation.hasSearchEngine) {\n      const engine = mod.searchEngine as SearchEngine;\n      if (seenEngineNames.has(engine.name)) {\n        log.warn('duplicate search engine name, skipping', {\n          plugin: pluginName,\n          engineName: engine.name,\n        });\n      } else {\n        seenEngineNames.add(engine.name);\n        result.searchEngines.push(engine);\n        registered = true;\n        log.info('loaded plugin search engine', {\n          plugin: pluginName,\n          engineName: engine.name,\n        });\n      }\n    }\n\n    if (registered) {\n      result.loaded.push({\n        name: pluginName,\n        version: pkgJson.version ?? '0.0.0',\n        path: pluginDir,\n        hasExtractor: validation.hasExtractor,\n        hasSearchEngine: validation.hasSearchEngine,\n      });\n    }\n  }\n\n  log.info('plugin loading complete', {\n    extractors: result.extractors.length,\n    searchEngines: result.searchEngines.length,\n    errors: result.errors.length,\n  });\n\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,26 @@
+import type { Extractor, SearchEngine } from '../types.js';
+export interface PluginRegistryState {
+    extractors: Array<{
+        name: string;
+        pluginName: string;
+    }>;
+    searchEngines: Array<{
+        name: string;
+        pluginName: string;
+    }>;
+    pluginCount: number;
+}
+export declare class PluginRegistry {
+    private extractors;
+    private engines;
+    private pluginNames;
+    registerExtractor(extractor: Extractor, pluginName: string): void;
+    registerSearchEngine(engine: SearchEngine, pluginName: string): void;
+    getExtractors(): Extractor[];
+    getSearchEngines(): SearchEngine[];
+    getExtractorByName(name: string): Extractor | undefined;
+    getSearchEngineByName(name: string): SearchEngine | undefined;
+    getState(): PluginRegistryState;
+    clear(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3D,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAqB;IAExC,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAgBjE,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAgBpE,aAAa,IAAI,SAAS,EAAE;IAI5B,gBAAgB,IAAI,YAAY,EAAE;IAIlC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIvD,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI7D,QAAQ,IAAI,mBAAmB;IAc/B,KAAK,IAAI,IAAI;CAKd"}

package/dist/plugins/registry.js

@@ -0,0 +1,71 @@
+import { createLogger } from "../logger.js";
+const log = createLogger("server");
+class PluginRegistry {
+  extractors = [];
+  engines = [];
+  pluginNames = /* @__PURE__ */ new Set();
+  registerExtractor(extractor, pluginName) {
+    if (this.extractors.some((r) => r.extractor.name === extractor.name)) {
+      log.warn("duplicate extractor name, ignoring", {
+        name: extractor.name,
+        plugin: pluginName
+      });
+      return;
+    }
+    this.extractors.push({ extractor, pluginName });
+    this.pluginNames.add(pluginName);
+    log.debug("registered plugin extractor", {
+      name: extractor.name,
+      plugin: pluginName
+    });
+  }
+  registerSearchEngine(engine, pluginName) {
+    if (this.engines.some((r) => r.engine.name === engine.name)) {
+      log.warn("duplicate search engine name, ignoring", {
+        name: engine.name,
+        plugin: pluginName
+      });
+      return;
+    }
+    this.engines.push({ engine, pluginName });
+    this.pluginNames.add(pluginName);
+    log.debug("registered plugin search engine", {
+      name: engine.name,
+      plugin: pluginName
+    });
+  }
+  getExtractors() {
+    return this.extractors.map((r) => r.extractor);
+  }
+  getSearchEngines() {
+    return this.engines.map((r) => r.engine);
+  }
+  getExtractorByName(name) {
+    return this.extractors.find((r) => r.extractor.name === name)?.extractor;
+  }
+  getSearchEngineByName(name) {
+    return this.engines.find((r) => r.engine.name === name)?.engine;
+  }
+  getState() {
+    return {
+      extractors: this.extractors.map((r) => ({
+        name: r.extractor.name,
+        pluginName: r.pluginName
+      })),
+      searchEngines: this.engines.map((r) => ({
+        name: r.engine.name,
+        pluginName: r.pluginName
+      })),
+      pluginCount: this.pluginNames.size
+    };
+  }
+  clear() {
+    this.extractors = [];
+    this.engines = [];
+    this.pluginNames.clear();
+  }
+}
+export {
+  PluginRegistry
+};
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/registry.ts"],"sourcesContent":["import { createLogger } from '../logger.js';\nimport type { Extractor, SearchEngine } from '../types.js';\n\nconst log = createLogger('server');\n\ninterface RegisteredExtractor {\n  extractor: Extractor;\n  pluginName: string;\n}\n\ninterface RegisteredSearchEngine {\n  engine: SearchEngine;\n  pluginName: string;\n}\n\nexport interface PluginRegistryState {\n  extractors: Array<{ name: string; pluginName: string }>;\n  searchEngines: Array<{ name: string; pluginName: string }>;\n  pluginCount: number;\n}\n\nexport class PluginRegistry {\n  private extractors: RegisteredExtractor[] = [];\n  private engines: RegisteredSearchEngine[] = [];\n  private pluginNames = new Set<string>();\n\n  registerExtractor(extractor: Extractor, pluginName: string): void {\n    if (this.extractors.some(r => r.extractor.name === extractor.name)) {\n      log.warn('duplicate extractor name, ignoring', {\n        name: extractor.name,\n        plugin: pluginName,\n      });\n      return;\n    }\n    this.extractors.push({ extractor, pluginName });\n    this.pluginNames.add(pluginName);\n    log.debug('registered plugin extractor', {\n      name: extractor.name,\n      plugin: pluginName,\n    });\n  }\n\n  registerSearchEngine(engine: SearchEngine, pluginName: string): void {\n    if (this.engines.some(r => r.engine.name === engine.name)) {\n      log.warn('duplicate search engine name, ignoring', {\n        name: engine.name,\n        plugin: pluginName,\n      });\n      return;\n    }\n    this.engines.push({ engine, pluginName });\n    this.pluginNames.add(pluginName);\n    log.debug('registered plugin search engine', {\n      name: engine.name,\n      plugin: pluginName,\n    });\n  }\n\n  getExtractors(): Extractor[] {\n    return this.extractors.map(r => r.extractor);\n  }\n\n  getSearchEngines(): SearchEngine[] {\n    return this.engines.map(r => r.engine);\n  }\n\n  getExtractorByName(name: string): Extractor | undefined {\n    return this.extractors.find(r => r.extractor.name === name)?.extractor;\n  }\n\n  getSearchEngineByName(name: string): SearchEngine | undefined {\n    return this.engines.find(r => r.engine.name === name)?.engine;\n  }\n\n  getState(): PluginRegistryState {\n    return {\n      extractors: this.extractors.map(r => ({\n        name: r.extractor.name,\n        pluginName: r.pluginName,\n      })),\n      searchEngines: this.engines.map(r => ({\n        name: r.engine.name,\n        pluginName: r.pluginName,\n      })),\n      pluginCount: this.pluginNames.size,\n    };\n  }\n\n  clear(): void {\n    this.extractors = [];\n    this.engines = [];\n    this.pluginNames.clear();\n  }\n}\n"],"mappings":"AAAA,SAAS,oBAAoB;AAG7B,MAAM,MAAM,aAAa,QAAQ;AAkB1B,MAAM,eAAe;AAAA,EAClB,aAAoC,CAAC;AAAA,EACrC,UAAoC,CAAC;AAAA,EACrC,cAAc,oBAAI,IAAY;AAAA,EAEtC,kBAAkB,WAAsB,YAA0B;AAChE,QAAI,KAAK,WAAW,KAAK,OAAK,EAAE,UAAU,SAAS,UAAU,IAAI,GAAG;AAClE,UAAI,KAAK,sCAAsC;AAAA,QAC7C,MAAM,UAAU;AAAA,QAChB,QAAQ;AAAA,MACV,CAAC;AACD;AAAA,IACF;AACA,SAAK,WAAW,KAAK,EAAE,WAAW,WAAW,CAAC;AAC9C,SAAK,YAAY,IAAI,UAAU;AAC/B,QAAI,MAAM,+BAA+B;AAAA,MACvC,MAAM,UAAU;AAAA,MAChB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAAA,EAEA,qBAAqB,QAAsB,YAA0B;AACnE,QAAI,KAAK,QAAQ,KAAK,OAAK,EAAE,OAAO,SAAS,OAAO,IAAI,GAAG;AACzD,UAAI,KAAK,0CAA0C;AAAA,QACjD,MAAM,OAAO;AAAA,QACb,QAAQ;AAAA,MACV,CAAC;AACD;AAAA,IACF;AACA,SAAK,QAAQ,KAAK,EAAE,QAAQ,WAAW,CAAC;AACxC,SAAK,YAAY,IAAI,UAAU;AAC/B,QAAI,MAAM,mCAAmC;AAAA,MAC3C,MAAM,OAAO;AAAA,MACb,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAAA,EAEA,gBAA6B;AAC3B,WAAO,KAAK,WAAW,IAAI,OAAK,EAAE,SAAS;AAAA,EAC7C;AAAA,EAEA,mBAAmC;AACjC,WAAO,KAAK,QAAQ,IAAI,OAAK,EAAE,MAAM;AAAA,EACvC;AAAA,EAEA,mBAAmB,MAAqC;AACtD,WAAO,KAAK,WAAW,KAAK,OAAK,EAAE,UAAU,SAAS,IAAI,GAAG;AAAA,EAC/D;AAAA,EAEA,sBAAsB,MAAwC;AAC5D,WAAO,KAAK,QAAQ,KAAK,OAAK,EAAE,OAAO,SAAS,IAAI,GAAG;AAAA,EACzD;AAAA,EAEA,WAAgC;AAC9B,WAAO;AAAA,MACL,YAAY,KAAK,WAAW,IAAI,QAAM;AAAA,QACpC,MAAM,EAAE,UAAU;AAAA,QAClB,YAAY,EAAE;AAAA,MAChB,EAAE;AAAA,MACF,eAAe,KAAK,QAAQ,IAAI,QAAM;AAAA,QACpC,MAAM,EAAE,OAAO;AAAA,QACf,YAAY,EAAE;AAAA,MAChB,EAAE;AAAA,MACF,aAAa,KAAK,YAAY;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,QAAc;AACZ,SAAK,aAAa,CAAC;AACnB,SAAK,UAAU,CAAC;AAChB,SAAK,YAAY,MAAM;AAAA,EACzB;AACF;","names":[]}

package/dist/plugins/validate.d.ts

@@ -0,0 +1,9 @@
+export declare function validateExtractor(value: unknown): boolean;
+export declare function validateSearchEngine(value: unknown): boolean;
+export interface PluginValidationResult {
+    hasExtractor: boolean;
+    hasSearchEngine: boolean;
+    errors: string[];
+}
+export declare function validatePluginExports(mod: unknown): PluginValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/plugins/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/plugins/validate.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoBzD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB5D;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CA+C1E"}

package/dist/plugins/validate.js

@@ -0,0 +1,79 @@
+import { createLogger } from "../logger.js";
+const log = createLogger("server");
+function validateExtractor(value) {
+  if (value === null || value === void 0 || typeof value !== "object") {
+    return false;
+  }
+  const obj = value;
+  if (typeof obj.name !== "string" || obj.name.length === 0) {
+    return false;
+  }
+  if (typeof obj.canHandle !== "function") {
+    return false;
+  }
+  if (typeof obj.extract !== "function") {
+    return false;
+  }
+  return true;
+}
+function validateSearchEngine(value) {
+  if (value === null || value === void 0 || typeof value !== "object") {
+    return false;
+  }
+  const obj = value;
+  if (typeof obj.name !== "string" || obj.name.length === 0) {
+    return false;
+  }
+  if (typeof obj.search !== "function") {
+    return false;
+  }
+  return true;
+}
+function validatePluginExports(mod) {
+  const result = {
+    hasExtractor: false,
+    hasSearchEngine: false,
+    errors: []
+  };
+  if (mod === null || mod === void 0 || typeof mod !== "object") {
+    result.errors.push("plugin module is null or not an object");
+    return result;
+  }
+  const exports = mod;
+  if ("extractor" in exports) {
+    if (validateExtractor(exports.extractor)) {
+      result.hasExtractor = true;
+      log.debug("valid extractor export found", {
+        name: exports.extractor.name
+      });
+    } else {
+      result.errors.push(
+        "extractor export exists but does not match the Extractor interface (requires: name: string, canHandle: function, extract: function)"
+      );
+    }
+  }
+  if ("searchEngine" in exports) {
+    if (validateSearchEngine(exports.searchEngine)) {
+      result.hasSearchEngine = true;
+      log.debug("valid searchEngine export found", {
+        name: exports.searchEngine.name
+      });
+    } else {
+      result.errors.push(
+        "searchEngine export exists but does not match the SearchEngine interface (requires: name: string, search: function)"
+      );
+    }
+  }
+  if (!result.hasExtractor && !result.hasSearchEngine && result.errors.length === 0) {
+    result.errors.push(
+      "plugin exports neither a valid extractor nor a valid searchEngine"
+    );
+  }
+  return result;
+}
+export {
+  validateExtractor,
+  validatePluginExports,
+  validateSearchEngine
+};
+//# sourceMappingURL=validate.js.map

package/dist/plugins/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/validate.ts"],"sourcesContent":["import { createLogger } from '../logger.js';\n\nconst log = createLogger('server');\n\nexport function validateExtractor(value: unknown): boolean {\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return false;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.name !== 'string' || obj.name.length === 0) {\n    return false;\n  }\n\n  if (typeof obj.canHandle !== 'function') {\n    return false;\n  }\n\n  if (typeof obj.extract !== 'function') {\n    return false;\n  }\n\n  return true;\n}\n\nexport function validateSearchEngine(value: unknown): boolean {\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return false;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.name !== 'string' || obj.name.length === 0) {\n    return false;\n  }\n\n  if (typeof obj.search !== 'function') {\n    return false;\n  }\n\n  return true;\n}\n\nexport interface PluginValidationResult {\n  hasExtractor: boolean;\n  hasSearchEngine: boolean;\n  errors: string[];\n}\n\nexport function validatePluginExports(mod: unknown): PluginValidationResult {\n  const result: PluginValidationResult = {\n    hasExtractor: false,\n    hasSearchEngine: false,\n    errors: [],\n  };\n\n  if (mod === null || mod === undefined || typeof mod !== 'object') {\n    result.errors.push('plugin module is null or not an object');\n    return result;\n  }\n\n  const exports = mod as Record<string, unknown>;\n\n  if ('extractor' in exports) {\n    if (validateExtractor(exports.extractor)) {\n      result.hasExtractor = true;\n      log.debug('valid extractor export found', {\n        name: (exports.extractor as { name: string }).name,\n      });\n    } else {\n      result.errors.push(\n        'extractor export exists but does not match the Extractor interface (requires: name: string, canHandle: function, extract: function)',\n      );\n    }\n  }\n\n  if ('searchEngine' in exports) {\n    if (validateSearchEngine(exports.searchEngine)) {\n      result.hasSearchEngine = true;\n      log.debug('valid searchEngine export found', {\n        name: (exports.searchEngine as { name: string }).name,\n      });\n    } else {\n      result.errors.push(\n        'searchEngine export exists but does not match the SearchEngine interface (requires: name: string, search: function)',\n      );\n    }\n  }\n\n  if (!result.hasExtractor && !result.hasSearchEngine && result.errors.length === 0) {\n    result.errors.push(\n      'plugin exports neither a valid extractor nor a valid searchEngine',\n    );\n  }\n\n  return result;\n}\n"],"mappings":"AAAA,SAAS,oBAAoB;AAE7B,MAAM,MAAM,aAAa,QAAQ;AAE1B,SAAS,kBAAkB,OAAyB;AACzD,MAAI,UAAU,QAAQ,UAAU,UAAa,OAAO,UAAU,UAAU;AACtE,WAAO;AAAA,EACT;AAEA,QAAM,MAAM;AAEZ,MAAI,OAAO,IAAI,SAAS,YAAY,IAAI,KAAK,WAAW,GAAG;AACzD,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,IAAI,cAAc,YAAY;AACvC,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,IAAI,YAAY,YAAY;AACrC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,SAAS,qBAAqB,OAAyB;AAC5D,MAAI,UAAU,QAAQ,UAAU,UAAa,OAAO,UAAU,UAAU;AACtE,WAAO;AAAA,EACT;AAEA,QAAM,MAAM;AAEZ,MAAI,OAAO,IAAI,SAAS,YAAY,IAAI,KAAK,WAAW,GAAG;AACzD,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,IAAI,WAAW,YAAY;AACpC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAQO,SAAS,sBAAsB,KAAsC;AAC1E,QAAM,SAAiC;AAAA,IACrC,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,QAAQ,CAAC;AAAA,EACX;AAEA,MAAI,QAAQ,QAAQ,QAAQ,UAAa,OAAO,QAAQ,UAAU;AAChE,WAAO,OAAO,KAAK,wCAAwC;AAC3D,WAAO;AAAA,EACT;AAEA,QAAM,UAAU;AAEhB,MAAI,eAAe,SAAS;AAC1B,QAAI,kBAAkB,QAAQ,SAAS,GAAG;AACxC,aAAO,eAAe;AACtB,UAAI,MAAM,gCAAgC;AAAA,QACxC,MAAO,QAAQ,UAA+B;AAAA,MAChD,CAAC;AAAA,IACH,OAAO;AACL,aAAO,OAAO;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,kBAAkB,SAAS;AAC7B,QAAI,qBAAqB,QAAQ,YAAY,GAAG;AAC9C,aAAO,kBAAkB;AACzB,UAAI,MAAM,mCAAmC;AAAA,QAC3C,MAAO,QAAQ,aAAkC;AAAA,MACnD,CAAC;AAAA,IACH,OAAO;AACL,aAAO,OAAO;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,OAAO,gBAAgB,CAAC,OAAO,mBAAmB,OAAO,OAAO,WAAW,GAAG;AACjF,WAAO,OAAO;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/providers/embed-provider.d.ts

@@ -0,0 +1,11 @@
+export interface EmbedProvider {
+    /** Embed a batch of strings; returns one Float32Array per input. */
+    embed(texts: string[]): Promise<Float32Array[]>;
+    /** Dimensionality of embeddings produced by this provider. */
+    readonly dim: number;
+    /** Model identifier (for cache invalidation / provenance). */
+    readonly modelId: string;
+}
+export declare function getEmbedProvider(): Promise<EmbedProvider>;
+export declare function _resetEmbedProviderForTest(): void;
+//# sourceMappingURL=embed-provider.d.ts.map

package/dist/providers/embed-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-provider.d.ts","sourceRoot":"","sources":["../../src/providers/embed-provider.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChD,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAezD;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/providers/embed-provider.js

@@ -0,0 +1,24 @@
+import { createLogger } from "../logger.js";
+const log = createLogger("providers");
+let cached = null;
+function getEmbedProvider() {
+  if (cached) return cached;
+  cached = import("../embedding/fastembed-provider.js").then(async (m) => {
+    const p = new m.FastembedEmbedProvider();
+    await p.warmup();
+    log.info("embed provider ready", { provider: "embed", impl: "fastembed", modelId: p.modelId, dim: p.dim });
+    return p;
+  }).catch((err) => {
+    cached = null;
+    throw err;
+  });
+  return cached;
+}
+function _resetEmbedProviderForTest() {
+  cached = null;
+}
+export {
+  _resetEmbedProviderForTest,
+  getEmbedProvider
+};
+//# sourceMappingURL=embed-provider.js.map

package/dist/providers/embed-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/embed-provider.ts"],"sourcesContent":["/**\n * Embed provider interface — Phase 1 Task 1.3 of v1 engine overhaul.\n *\n * Stable interface for embedding implementations. Phase 3 swapped the\n * sentence-transformers Python subprocess for fastembed (Rust ONNX via\n * Node bindings); the factory now returns FastembedEmbedProvider.\n */\nimport { createLogger } from '../logger.js';\n\nconst log = createLogger('providers');\n\nexport interface EmbedProvider {\n  /** Embed a batch of strings; returns one Float32Array per input. */\n  embed(texts: string[]): Promise<Float32Array[]>;\n  /** Dimensionality of embeddings produced by this provider. */\n  readonly dim: number;\n  /** Model identifier (for cache invalidation / provenance). */\n  readonly modelId: string;\n}\n\nlet cached: Promise<EmbedProvider> | null = null;\n\nexport function getEmbedProvider(): Promise<EmbedProvider> {\n  if (cached) return cached;\n  cached = import('../embedding/fastembed-provider.js')\n    .then(async m => {\n      const p = new m.FastembedEmbedProvider();\n      await p.warmup();\n      log.info('embed provider ready', { provider: 'embed', impl: 'fastembed', modelId: p.modelId, dim: p.dim });\n      return p;\n    })\n    .catch(err => {\n      // Clear cache on any failure (import or warmup) so the next call retries.\n      cached = null;\n      throw err;\n    });\n  return cached;\n}\n\nexport function _resetEmbedProviderForTest(): void {\n  cached = null;\n}\n"],"mappings":"AAOA,SAAS,oBAAoB;AAE7B,MAAM,MAAM,aAAa,WAAW;AAWpC,IAAI,SAAwC;AAErC,SAAS,mBAA2C;AACzD,MAAI,OAAQ,QAAO;AACnB,WAAS,OAAO,oCAAoC,EACjD,KAAK,OAAM,MAAK;AACf,UAAM,IAAI,IAAI,EAAE,uBAAuB;AACvC,UAAM,EAAE,OAAO;AACf,QAAI,KAAK,wBAAwB,EAAE,UAAU,SAAS,MAAM,aAAa,SAAS,EAAE,SAAS,KAAK,EAAE,IAAI,CAAC;AACzG,WAAO;AAAA,EACT,CAAC,EACA,MAAM,SAAO;AAEZ,aAAS;AACT,UAAM;AAAA,EACR,CAAC;AACH,SAAO;AACT;AAEO,SAAS,6BAAmC;AACjD,WAAS;AACX;","names":[]}

package/dist/providers/extract-provider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Extract provider interface — wraps the v1 extraction pipeline behind a
+ * stable interface.
+ *
+ * Note: named ExtractProvider (not Extractor) to avoid collision with the
+ * pre-existing `Extractor` interface in `src/types.ts`, which models a single
+ * site-specific extractor within the v1 pipeline.
+ */
+import type { ExtractionResult } from '../types.js';
+export interface ExtractProviderOptions {
+    maxChars?: number;
+    section?: string;
+    sectionIndex?: number;
+    contentType?: string;
+    pdfBuffer?: Buffer;
+}
+export interface ExtractProvider {
+    extract(html: string, url: string, options?: ExtractProviderOptions): Promise<ExtractionResult>;
+    readonly name: 'legacy' | 'v1';
+}
+export declare function getExtractProvider(): Promise<ExtractProvider>;
+export declare function _resetExtractProviderForTest(): void;
+//# sourceMappingURL=extract-provider.d.ts.map

package/dist/providers/extract-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-provider.d.ts","sourceRoot":"","sources":["../../src/providers/extract-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC;AAID,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAU7D;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}