mcard-js 2.1.49 → 2.1.51

package/dist/chunk-R3XRBAM7.js

@@ -0,0 +1,253 @@
+// ../config/app_config.json
+var app_config_default = {
+  network: {
+    default_ws_host: "127.0.0.1",
+    default_ws_port: 5321,
+    default_api_port: 5320,
+    default_python_api_port: 28302,
+    default_js_api_port: 28303,
+    default_server_host: "0.0.0.0",
+    cors_origins: [
+      "http://localhost:3000",
+      "http://localhost:8000",
+      "https://localhost:3000",
+      "https://localhost:8000",
+      "http://localhost:8080",
+      "https://example.com"
+    ]
+  },
+  web: {
+    api_key_header_name: "X-API-Key"
+  },
+  identity: {
+    provider: "sqlite",
+    space_path: "./data/agent_identities.db",
+    api_endpoint: null,
+    default_vapid_contact: "mailto:developer@example.com"
+  },
+  storage: {
+    default_db_path: "./data/content_memory.db",
+    test_db_path: "./tests/data/test_mcard.db",
+    default_data_root_dirname: "data",
+    default_data_user: "guest",
+    default_seed_dirname: "seed",
+    default_artifacts_dirname: "artifacts",
+    default_server_memory_db: "servermemory.db",
+    default_mcard_db: "mcard.db",
+    default_server_log_db: "server_log.db",
+    default_push_subscriptions_file: "subscriptions.json",
+    default_execution_log_path: "./data/execution_log.db"
+  },
+  services: {
+    default_ollama_base_url: "http://localhost:11434",
+    default_fallback_model: "qwen3:0.6b",
+    default_otlp_endpoint: "http://localhost:4317",
+    default_vllm_base_url: "http://localhost:8000",
+    default_lmstudio_base_url: "http://localhost:1234"
+  },
+  env: {
+    api_port: "MCARD_API_PORT",
+    ws_port: "MCARD_WS_PORT",
+    ws_host: "VITE_WS_HOST",
+    vite_ws_port: "VITE_WS_PORT",
+    identity_provider: "MCARD_IDENTITY_PROVIDER",
+    identity_space_path: "IDENTITY_SPACE_PATH",
+    identity_api_endpoint: "MCARD_IDENTITY_API_ENDPOINT",
+    data_root: "DATA_ROOT",
+    data_user: "DATA_USER",
+    artifacts_dir: "ARTIFACTS_DIR",
+    mcard_db_path: "MCARD_DB_PATH",
+    mcard_storage_path: "MCARD_STORAGE_PATH",
+    execution_logs_db_path: "EXECUTION_LOGS_DB_PATH",
+    server_log_db_path: "SERVER_LOG_DB_PATH",
+    server_memory_db_path: "SERVER_MEMORY_DB_PATH",
+    servermemory_db_path: "SERVERMEMORY_DB_PATH",
+    seeding_memory_db_path: "SEEDING_MEMORY_DB_PATH",
+    push_subscriptions_path: "PUSH_SUBSCRIPTIONS_PATH",
+    vapid_contact_email: "VAPID_CONTACT_EMAIL",
+    vapid_contact: "VAPID_CONTACT",
+    ollama_base_url: "OLLAMA_BASE_URL",
+    fallback_model: "FALLBACK_MODEL",
+    otlp_endpoint: "OTLP_ENDPOINT",
+    vllm_base_url: "VLLM_BASE_URL",
+    lmstudio_base_url: "LMSTUDIO_BASE_URL",
+    api_key_header_name: "X-API-Key"
+  }
+};
+
+// src/config/constants.ts
+var network = app_config_default.network ?? {};
+var identity = app_config_default.identity ?? {};
+var services = app_config_default.services ?? {};
+var web = app_config_default.web ?? {};
+var DEFAULT_PAGE_SIZE = 10;
+var MAX_PAGE_SIZE = 1e3;
+var MIN_PAGE_SIZE = 1;
+var DETECTION_SAMPLE_CAP = 8192;
+var MAX_FILE_SIZE = typeof process !== "undefined" && process.env.MCARD_MAX_SIZE_BYTES ? parseInt(process.env.MCARD_MAX_SIZE_BYTES, 10) : 150 * 1024 * 1024;
+var READ_TIMEOUT_MS = 5e3;
+var READ_CHUNK_SIZE = 8192;
+var KNOWN_TYPE_SIZE_LIMIT = 1024 * 1024;
+var BINARY_CHECK_SAMPLE_SIZE = 32 * 1024;
+var CONTENT_DETECTION_SAMPLE_SIZE = 1024 * 1024;
+var MAX_VECTOR_CONTENT_CHARS = 1e4;
+var DEFAULT_MAX_PROBLEM_BYTES = 2 * 1024 * 1024;
+var WRAP_WIDTH_KNOWN = 1e3;
+var INDEXEDDB_DEFAULT_DB_NAME = "mcard-db";
+var INDEXEDDB_DEFAULT_DB_VERSION = 1;
+var SQLITE_BUSY_TIMEOUT_MS = 5e3;
+var DEFAULT_IDENTITY_PROVIDER = String(identity.provider ?? "sqlite");
+var DEFAULT_IDENTITY_SPACE_PATH = String(identity.space_path ?? "./data/agent_identities.db");
+var DEFAULT_EXECUTION_LOG_PATH = String(app_config_default.storage?.default_execution_log_path ?? "./data/execution_log.db");
+var DEFAULT_API_PORT = Number(network.default_api_port ?? 5320);
+var DEFAULT_PYTHON_API_PORT = Number(network.default_python_api_port ?? 28302);
+var DEFAULT_JS_API_PORT = Number(network.default_js_api_port ?? 28303);
+var ENV_API_PORT = "MCARD_API_PORT";
+var DEFAULT_WS_PORT = Number(network.default_ws_port ?? 5321);
+var DEFAULT_WS_HOST = String(network.default_ws_host ?? "127.0.0.1");
+var DEFAULT_SERVER_HOST = String(network.default_server_host ?? "0.0.0.0");
+var CORS_ORIGINS = Array.isArray(network.cors_origins) ? network.cors_origins : [];
+var ENV_WS_PORT = "MCARD_WS_PORT";
+var getEnvUrl = (key, fallback) => {
+  try {
+    if (typeof process !== "undefined" && process.env && process.env[key]) {
+      return process.env[key];
+    }
+  } catch (e) {
+  }
+  return fallback;
+};
+var API_KEY_HEADER_NAME = String(web.api_key_header_name ?? "X-API-Key");
+var DEFAULT_OLLAMA_BASE_URL = getEnvUrl(
+  "OLLAMA_BASE_URL",
+  String(services.default_ollama_base_url ?? "http://localhost:11434")
+);
+var DEFAULT_OTLP_ENDPOINT = getEnvUrl(
+  "OTLP_ENDPOINT",
+  String(services.default_otlp_endpoint ?? "http://localhost:4317")
+);
+var DEFAULT_VLLM_BASE_URL = getEnvUrl(
+  "VLLM_BASE_URL",
+  String(services.default_vllm_base_url ?? "http://localhost:8000")
+);
+var DEFAULT_LMSTUDIO_BASE_URL = getEnvUrl(
+  "LMSTUDIO_BASE_URL",
+  String(services.default_lmstudio_base_url ?? "http://localhost:1234")
+);
+var DEFAULT_FALLBACK_MODEL = getEnvUrl(
+  "FALLBACK_MODEL",
+  String(services.default_fallback_model ?? "qwen3:0.6b")
+);
+var DEFAULT_SQLJS_WASM_URL = "https://sql.js.org/dist/";
+var EMBEDDING_MODELS = {
+  "nomic-embed-text": {
+    dimensions: 768,
+    provider: "ollama",
+    max_tokens: 8192,
+    description: "High quality, general purpose embeddings"
+  },
+  "bge-m3": {
+    dimensions: 1024,
+    provider: "ollama",
+    max_tokens: 8192,
+    description: "Multi-lingual, multi-granularity embeddings"
+  },
+  "mxbai-embed-large": {
+    dimensions: 1024,
+    provider: "ollama",
+    max_tokens: 512,
+    description: "High quality embeddings for retrieval"
+  },
+  "all-minilm": {
+    dimensions: 384,
+    provider: "ollama",
+    max_tokens: 256,
+    description: "Fast, lightweight embeddings"
+  }
+};
+var DEFAULT_EMBEDDING_MODEL = "nomic-embed-text";
+var VISION_MODELS = {
+  "moondream": {
+    size: "1.7GB",
+    description: "Moondream - Tiny, high-performance vision language model",
+    capabilities: ["image_description", "visual_qa"]
+  },
+  "llama3.2-vision": {
+    size: "7.9GB",
+    description: "Llama 3.2 Vision - 11B multimodal model with strong OCR",
+    capabilities: ["image_description", "ocr", "visual_qa"]
+  },
+  "llava": {
+    size: "4.7GB",
+    description: "LLaVA - Large Language and Vision Assistant",
+    capabilities: ["image_description", "visual_qa"]
+  },
+  "minicpm-v": {
+    size: "5.6GB",
+    description: "MiniCPM-V - Efficient vision-language model",
+    capabilities: ["image_description", "ocr", "multi_image"]
+  }
+};
+var DEFAULT_VISION_MODEL = "moondream";
+var DEFAULT_SANDBOX_TIMEOUT_MS = 5e3;
+var DEFAULT_CLM_TIMEOUT_MS = 5e3;
+var DEFAULT_VM_EXECUTION_TIMEOUT_MS = 5e3;
+var LLM_DEFAULT_TIMEOUT_SECS = 120;
+var LLM_DEFAULT_RETRY_COUNT = 3;
+var LLM_DEFAULT_RETRY_DELAY_SECS = 1;
+var DEFAULT_WS_RECONNECT_MS = 3e3;
+var DEFAULT_MAX_REDUCTION_STEPS = 1e3;
+var DEFAULT_MAX_ETA_STEPS = 100;
+var DEFAULT_MAX_INTROSPECTION_DEPTH = 100;
+
+export {
+  DEFAULT_PAGE_SIZE,
+  MAX_PAGE_SIZE,
+  MIN_PAGE_SIZE,
+  DETECTION_SAMPLE_CAP,
+  MAX_FILE_SIZE,
+  READ_TIMEOUT_MS,
+  READ_CHUNK_SIZE,
+  KNOWN_TYPE_SIZE_LIMIT,
+  BINARY_CHECK_SAMPLE_SIZE,
+  CONTENT_DETECTION_SAMPLE_SIZE,
+  MAX_VECTOR_CONTENT_CHARS,
+  DEFAULT_MAX_PROBLEM_BYTES,
+  WRAP_WIDTH_KNOWN,
+  INDEXEDDB_DEFAULT_DB_NAME,
+  INDEXEDDB_DEFAULT_DB_VERSION,
+  SQLITE_BUSY_TIMEOUT_MS,
+  DEFAULT_IDENTITY_PROVIDER,
+  DEFAULT_IDENTITY_SPACE_PATH,
+  DEFAULT_EXECUTION_LOG_PATH,
+  DEFAULT_API_PORT,
+  DEFAULT_PYTHON_API_PORT,
+  DEFAULT_JS_API_PORT,
+  ENV_API_PORT,
+  DEFAULT_WS_PORT,
+  DEFAULT_WS_HOST,
+  DEFAULT_SERVER_HOST,
+  CORS_ORIGINS,
+  ENV_WS_PORT,
+  API_KEY_HEADER_NAME,
+  DEFAULT_OLLAMA_BASE_URL,
+  DEFAULT_OTLP_ENDPOINT,
+  DEFAULT_VLLM_BASE_URL,
+  DEFAULT_LMSTUDIO_BASE_URL,
+  DEFAULT_FALLBACK_MODEL,
+  DEFAULT_SQLJS_WASM_URL,
+  EMBEDDING_MODELS,
+  DEFAULT_EMBEDDING_MODEL,
+  VISION_MODELS,
+  DEFAULT_VISION_MODEL,
+  DEFAULT_SANDBOX_TIMEOUT_MS,
+  DEFAULT_CLM_TIMEOUT_MS,
+  DEFAULT_VM_EXECUTION_TIMEOUT_MS,
+  LLM_DEFAULT_TIMEOUT_SECS,
+  LLM_DEFAULT_RETRY_COUNT,
+  LLM_DEFAULT_RETRY_DELAY_SECS,
+  DEFAULT_WS_RECONNECT_MS,
+  DEFAULT_MAX_REDUCTION_STEPS,
+  DEFAULT_MAX_ETA_STEPS,
+  DEFAULT_MAX_INTROSPECTION_DEPTH
+};

package/dist/chunk-RYP66UMH.js

@@ -0,0 +1,74 @@
+// src/storage/EngineRegistry.ts
+var EngineType = /* @__PURE__ */ ((EngineType2) => {
+  EngineType2["INDEXED_DB"] = "indexeddb";
+  EngineType2["SQLITE_NODE"] = "sqlite-node";
+  EngineType2["SQLITE_WASM"] = "sqlite-wasm";
+  return EngineType2;
+})(EngineType || {});
+var ENGINE_INFO = {
+  ["indexeddb" /* INDEXED_DB */]: {
+    type: "indexeddb" /* INDEXED_DB */,
+    displayName: "IndexedDB",
+    environment: "browser",
+    package: null,
+    description: "Browser-native IndexedDB key-value store"
+  },
+  ["sqlite-node" /* SQLITE_NODE */]: {
+    type: "sqlite-node" /* SQLITE_NODE */,
+    displayName: "SQLite (Node.js)",
+    environment: "node",
+    package: "better-sqlite3",
+    description: "SQLite via native better-sqlite3 bindings"
+  },
+  ["sqlite-wasm" /* SQLITE_WASM */]: {
+    type: "sqlite-wasm" /* SQLITE_WASM */,
+    displayName: "SQLite (WASM)",
+    environment: "browser",
+    package: "sql.js",
+    description: "SQLite via sql.js WebAssembly"
+  }
+};
+async function createEngine(type, options = {}) {
+  switch (type) {
+    case "indexeddb" /* INDEXED_DB */: {
+      const { IndexedDBEngine } = await import("./IndexedDBEngine-FXAD42F3.js");
+      const engine = new IndexedDBEngine();
+      await engine.init();
+      return engine;
+    }
+    case "sqlite-node" /* SQLITE_NODE */: {
+      const { SqliteNodeEngine } = await import("./storage/SqliteNodeEngine.js");
+      return SqliteNodeEngine.create(options.dbPath || ":memory:");
+    }
+    case "sqlite-wasm" /* SQLITE_WASM */: {
+      const { SqliteWasmEngine } = await import("./storage/SqliteWasmEngine.js");
+      const engine = new SqliteWasmEngine();
+      await engine.init(options.wasmUrl, options.existingData);
+      return engine;
+    }
+    default: {
+      const validTypes = Object.values(EngineType).join(", ");
+      throw new Error(
+        `Unknown engine type: "${type}". Valid types: ${validTypes}`
+      );
+    }
+  }
+}
+function getAvailableEngines() {
+  return Object.values(EngineType);
+}
+function getEngineInfo(type) {
+  return ENGINE_INFO[type];
+}
+function getEnginesByEnvironment(env) {
+  return Object.values(ENGINE_INFO).filter((info) => info.environment === env);
+}
+
+export {
+  EngineType,
+  ENGINE_INFO,
+  createEngine,
+  getAvailableEngines,
+  getEngineInfo,
+  getEnginesByEnvironment
+};

package/dist/chunk-RZIZYRLF.js

@@ -0,0 +1,112 @@
+import {
+  AbstractSqlEngine,
+  CORE_SCHEMAS
+} from "./chunk-4DFTWDRB.js";
+import {
+  MCard
+} from "./chunk-GGQCF7ZK.js";
+import {
+  DEFAULT_SQLJS_WASM_URL
+} from "./chunk-PKLONZCF.js";
+
+// src/storage/engines/SqliteWasmEngine.ts
+var SqliteWasmEngine = class extends AbstractSqlEngine {
+  db = null;
+  SQL = null;
+  /**
+   * Initialize the database
+   * @param wasmUrl URL to sql-wasm.wasm file (optional, defaults to CDN)
+   * @param existingData Optional existing database as Uint8Array
+   */
+  async init(wasmUrl, existingData) {
+    const initSqlJs = (await import("sql.js")).default;
+    const SQL = await initSqlJs({
+      locateFile: (file) => wasmUrl || `${DEFAULT_SQLJS_WASM_URL}${file}`
+    });
+    this.SQL = SQL;
+    this.db = existingData ? new SQL.Database(existingData) : new SQL.Database();
+    this.db.run(CORE_SCHEMAS.card);
+    this.db.run(CORE_SCHEMAS.handleRegistry);
+    this.db.run(CORE_SCHEMAS.handleHistory);
+    this.db.run(CORE_SCHEMAS.handleIndex);
+  }
+  ensureDb() {
+    if (!this.db) throw new Error("Database not initialized. Call init() first.");
+    return this.db;
+  }
+  // ======================================================================
+  // AbstractSqlEngine primitives
+  // ======================================================================
+  async queryRows(sql, ...params) {
+    const db = this.ensureDb();
+    const stmt = db.prepare(sql);
+    if (params.length > 0) stmt.bind(params);
+    const results = [];
+    while (stmt.step()) {
+      const row = stmt.getAsObject();
+      results.push(row);
+    }
+    stmt.free();
+    return results;
+  }
+  async execSql(sql, ...params) {
+    const db = this.ensureDb();
+    if (params.length === 0) {
+      db.run(sql);
+    } else {
+      db.run(sql, params);
+    }
+    return 0;
+  }
+  // ======================================================================
+  // Row → MCard conversion (sql.js returns Uint8Array for BLOBs)
+  // ======================================================================
+  rowToCard(row) {
+    const rawContent = row.content;
+    const content = rawContent instanceof Uint8Array ? rawContent : typeof rawContent === "string" ? new TextEncoder().encode(rawContent) : new Uint8Array(0);
+    return MCard.fromData(content, String(row.hash), String(row.g_time));
+  }
+  // ======================================================================
+  // sql.js-specific helpers
+  // ======================================================================
+  /**
+   * Export database as Uint8Array (for persistence)
+   */
+  export() {
+    return this.ensureDb().export();
+  }
+  /**
+   * Get raw sql.js Database for use with VectorStore adapter.
+   */
+  getRawDb() {
+    return this.ensureDb();
+  }
+  // =========== pruneHandleHistory override (needs count before delete) ===========
+  async pruneHandleHistory(handle, options = {}) {
+    const { validateHandle } = await import("./Handle-3N4QOA3U.js");
+    const db = this.ensureDb();
+    const normalized = validateHandle(handle);
+    if (options.deleteAll) {
+      const stmt = db.prepare("SELECT COUNT(*) FROM handle_history WHERE handle = ?");
+      stmt.bind([normalized]);
+      stmt.step();
+      const count = stmt.get()[0];
+      stmt.free();
+      db.run("DELETE FROM handle_history WHERE handle = ?", [normalized]);
+      return count;
+    } else if (options.olderThan) {
+      const stmt = db.prepare("SELECT COUNT(*) FROM handle_history WHERE handle = ? AND changed_at < ?");
+      stmt.bind([normalized, options.olderThan]);
+      stmt.step();
+      const count = stmt.get()[0];
+      stmt.free();
+      db.run("DELETE FROM handle_history WHERE handle = ? AND changed_at < ?", [normalized, options.olderThan]);
+      return count;
+    }
+    return 0;
+  }
+};
+
+export {
+  SqliteWasmEngine
+};