@mcpmesh/core 0.8.0-beta.6

package/index.d.ts

@@ -0,0 +1,302 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/** Handle to a running agent runtime (TypeScript wrapper). */
+export declare class JsAgentHandle {
+  /**
+   * Wait for and return the next mesh event.
+   *
+   * This is an async method that blocks until an event is available.
+   * Returns a JsMeshEvent with eventType "shutdown" when the runtime has shut down.
+   */
+  nextEvent(): Promise<JsMeshEvent>
+  /**
+   * Get current dependency endpoints.
+   *
+   * Returns an object mapping capability names to endpoint URLs.
+   */
+  getDependencies(): Promise<Record<string, string>>
+  /** Get current agent health status. */
+  getStatus(): Promise<string>
+  /** Get the agent ID assigned by the registry. */
+  getAgentId(): Promise<string | null>
+  /** Check if shutdown has been requested. */
+  isShutdownRequested(): Promise<boolean>
+  /** Request graceful shutdown of the agent runtime. */
+  shutdown(): Promise<void>
+  /**
+   * Update the tools/routes registered with the registry.
+   *
+   * Uses smart diffing - only triggers a heartbeat if tools have changed.
+   * Call this after Express route introspection to update route names
+   * from placeholders (e.g., "route_0_UNKNOWN:UNKNOWN") to proper names
+   * (e.g., "GET:/time").
+   *
+   * @param tools - Array of tool specifications with updated function names
+   * @returns true if the update was sent successfully
+   */
+  updateTools(tools: Array<JsToolSpec>): Promise<boolean>
+  /**
+   * Update the HTTP port (e.g., after auto-detection from Express).
+   *
+   * @param port - The detected HTTP port
+   * @returns true if the update was sent successfully
+   */
+  updatePort(port: number): Promise<boolean>
+}
+
+/**
+ * Auto-detect external IP address.
+ *
+ * Uses UDP socket trick to find the IP that would route to external networks.
+ * Falls back to "localhost" if detection fails.
+ */
+export declare function autoDetectIp(): string
+
+/**
+ * Get the default value for a configuration key.
+ *
+ * This allows SDKs to retrieve default values without doing full resolution,
+ * useful for documentation, type hints, and avoiding duplicate default definitions.
+ *
+ * @param keyName - Config key (e.g., "registry_url", "namespace", "health_interval")
+ * @returns Default value if the key is known and has a default, null otherwise.
+ */
+export declare function getDefault(keyName: string): string | null
+
+/**
+ * Get the environment variable name for a configuration key.
+ *
+ * @param keyName - Config key (e.g., "registry_url", "namespace")
+ * @returns Environment variable name if the key is known, null otherwise.
+ */
+export declare function getEnvVar(keyName: string): string | null
+
+/** Get Redis URL with fallback to default (redis://localhost:6379). */
+export declare function getRedisUrl(): string
+
+/**
+ * Initialize the trace publisher.
+ *
+ * Must be called before publishing spans. Checks if tracing is enabled
+ * and initializes Redis connection.
+ *
+ * @returns true if tracing is enabled and Redis is available, false otherwise.
+ */
+export declare function initTracePublisher(): Promise<boolean>
+
+/**
+ * Check if trace publishing is available.
+ *
+ * @returns true if tracing is enabled and Redis is connected.
+ */
+export declare function isTracePublisherAvailable(): Promise<boolean>
+
+/**
+ * Check if distributed tracing is enabled.
+ *
+ * Checks MCP_MESH_DISTRIBUTED_TRACING_ENABLED environment variable.
+ */
+export declare function isTracingEnabled(): boolean
+
+/** Agent specification for TypeScript. */
+export interface JsAgentSpec {
+  /** Unique agent name/identifier */
+  name: string
+  /** Agent version (semver) */
+  version: string
+  /** Human-readable description */
+  description: string
+  /** Registry URL (e.g., "http://localhost:8100") */
+  registryUrl: string
+  /** HTTP port for this agent */
+  httpPort: number
+  /** HTTP host announced to registry */
+  httpHost: string
+  /** Namespace for isolation */
+  namespace: string
+  /**
+   * Agent type: "mcp_agent" (provides capabilities) or "api" (only consumes)
+   * Defaults to "mcp_agent" if not specified
+   */
+  agentType?: string
+  /**
+   * SDK runtime type: "python" or "typescript"
+   * Defaults to "typescript" for TypeScript SDK
+   */
+  runtime?: string
+  /** Tools/capabilities provided by this agent */
+  tools: Array<JsToolSpec>
+  /** LLM agent specifications for tools using mesh.llm() */
+  llmAgents?: Array<JsLlmAgentSpec>
+  /** Heartbeat interval in seconds */
+  heartbeatInterval: number
+}
+
+/** Dependency specification for TypeScript. */
+export interface JsDependencySpec {
+  /** Capability name to depend on */
+  capability: string
+  /** Tags for filtering (e.g., ["+fast", "-deprecated"]) */
+  tags: Array<string>
+  /** Version constraint (e.g., ">=2.0.0") */
+  version?: string
+}
+
+/**
+ * LLM agent specification for TypeScript.
+ * Used to register LLM-powered tools with the mesh.
+ */
+export interface JsLlmAgentSpec {
+  /** Unique identifier for this LLM function (matches the tool's function_name) */
+  functionId: string
+  /**
+   * Provider selector - serialized JSON string
+   * e.g., '{"capability": "llm", "tags": ["+claude"]}'
+   */
+  provider: string
+  /**
+   * Tool filter specification - serialized JSON string
+   * e.g., '[{"capability": "calculator"}, {"tags": ["tools"]}]'
+   */
+  filter?: string
+  /** Filter mode: "all", "best_match", or "*" */
+  filterMode: string
+  /** Maximum agentic loop iterations */
+  maxIterations: number
+}
+
+/** LLM provider information returned in llm_provider_available events. */
+export interface JsLlmProviderInfo {
+  /** Function ID of the LLM function that requested this provider */
+  functionId: string
+  /** Agent ID providing this capability */
+  agentId: string
+  /** Endpoint URL to call */
+  endpoint: string
+  /** Function name to call */
+  functionName: string
+  /** Model name (optional) */
+  model?: string
+}
+
+/**
+ * LLM tool information returned in llm_tools_updated events.
+ * Contains resolved tool metadata for LLM agents to use.
+ */
+export interface JsLlmToolInfo {
+  /** Function name of the tool */
+  functionName: string
+  /** Capability name */
+  capability: string
+  /** Endpoint URL to call */
+  endpoint: string
+  /** Agent ID providing this tool */
+  agentId: string
+  /** Input schema (serialized JSON string) */
+  inputSchema?: string
+}
+
+/** Mesh event for TypeScript. */
+export interface JsMeshEvent {
+  /** Event type (e.g., "dependency_available", "agent_registered", "llm_tools_updated") */
+  eventType: string
+  /** Capability name (for dependency events) */
+  capability?: string
+  /** Endpoint URL (for dependency_available) */
+  endpoint?: string
+  /** Function name to call (for dependency_available) */
+  functionName?: string
+  /** Agent ID (for dependency events) */
+  agentId?: string
+  /**
+   * Function that requested this dependency (for dependency events)
+   * This is the tool/function that declared the dependency.
+   */
+  requestingFunction?: string
+  /**
+   * Dependency index within the requesting function (for dependency events)
+   * This allows SDKs to inject the resolved dependency at the correct position.
+   */
+  depIndex?: number
+  /** Function ID of the LLM agent (for llm_tools_updated, llm_provider_available) */
+  functionId?: string
+  /** List of available tools (for llm_tools_updated event) */
+  tools?: Array<JsLlmToolInfo>
+  /** Provider info (for llm_provider_available event) */
+  providerInfo?: JsLlmProviderInfo
+  /** Error message (for error events) */
+  error?: string
+  /** Reason for event (for disconnect events) */
+  reason?: string
+}
+
+/** Tool specification for TypeScript. */
+export interface JsToolSpec {
+  /** Function name in the code */
+  functionName: string
+  /** Capability name for discovery */
+  capability: string
+  /** Version of this capability */
+  version: string
+  /** Tags for filtering */
+  tags: Array<string>
+  /** Human-readable description */
+  description: string
+  /** Dependencies required by this tool */
+  dependencies: Array<JsDependencySpec>
+  /** JSON Schema for input parameters (MCP format) - serialized JSON string */
+  inputSchema?: string
+  /** LLM filter specification (for @mesh.llm decorated functions) - serialized JSON string */
+  llmFilter?: string
+  /** LLM provider specification (for mesh delegation) - serialized JSON string */
+  llmProvider?: string
+}
+
+/**
+ * Publish a trace span to Redis.
+ *
+ * Publishes span data to the `mesh:trace` Redis stream.
+ * Non-blocking - silently handles failures to never break agent operations.
+ *
+ * @param spanData - Map of span data (all values must be strings)
+ * @returns true if published successfully, false otherwise.
+ */
+export declare function publishSpan(spanData: Record<string, string>): Promise<boolean>
+
+/**
+ * Resolve configuration value with priority: ENV > param > default.
+ *
+ * @param keyName - Config key (e.g., "registry_url", "http_host", "namespace")
+ * @param paramValue - Optional value from code/config
+ * @returns Resolved value or empty string if unknown key
+ */
+export declare function resolveConfig(keyName: string, paramValue?: string | undefined | null): string
+
+/**
+ * Resolve boolean configuration value with priority: ENV > param > default.
+ *
+ * @param keyName - Config key (e.g., "distributed_tracing_enabled")
+ * @param paramValue - Optional value from code/config
+ * @returns Resolved boolean value
+ */
+export declare function resolveConfigBool(keyName: string, paramValue?: boolean | undefined | null): boolean
+
+/**
+ * Resolve integer configuration value with priority: ENV > param > default.
+ *
+ * @param keyName - Config key (e.g., "http_port", "health_interval")
+ * @param paramValue - Optional value from code/config
+ * @returns Resolved integer value or null if unknown key
+ */
+export declare function resolveConfigInt(keyName: string, paramValue?: number | undefined | null): number | null
+
+/**
+ * Start an agent runtime with the given specification.
+ *
+ * This spawns a background Tokio runtime that handles:
+ * - Registration with the mesh registry
+ * - Periodic heartbeats
+ * - Topology change detection
+ * - Event streaming
+ */
+export declare function startAgent(spec: JsAgentSpec): JsAgentHandle

package/index.js

@@ -0,0 +1,591 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./mcp-mesh-core.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-android-arm64')
+        const bindingPackageVersion = require('@mcpmesh/core-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./mcp-mesh-core.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-android-arm-eabi')
+        const bindingPackageVersion = require('@mcpmesh/core-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./mcp-mesh-core.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-win32-x64-gnu')
+        const bindingPackageVersion = require('@mcpmesh/core-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./mcp-mesh-core.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-win32-x64-msvc')
+        const bindingPackageVersion = require('@mcpmesh/core-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./mcp-mesh-core.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-win32-ia32-msvc')
+        const bindingPackageVersion = require('@mcpmesh/core-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./mcp-mesh-core.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-win32-arm64-msvc')
+        const bindingPackageVersion = require('@mcpmesh/core-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./mcp-mesh-core.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@mcpmesh/core-darwin-universal')
+      const bindingPackageVersion = require('@mcpmesh/core-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./mcp-mesh-core.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-darwin-x64')
+        const bindingPackageVersion = require('@mcpmesh/core-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./mcp-mesh-core.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-darwin-arm64')
+        const bindingPackageVersion = require('@mcpmesh/core-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./mcp-mesh-core.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-freebsd-x64')
+        const bindingPackageVersion = require('@mcpmesh/core-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./mcp-mesh-core.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-freebsd-arm64')
+        const bindingPackageVersion = require('@mcpmesh/core-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./mcp-mesh-core.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-x64-musl')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./mcp-mesh-core.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-x64-gnu')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./mcp-mesh-core.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-arm64-musl')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./mcp-mesh-core.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-arm64-gnu')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./mcp-mesh-core.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./mcp-mesh-core.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./mcp-mesh-core.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-loong64-musl')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./mcp-mesh-core.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-loong64-gnu')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./mcp-mesh-core.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-riscv64-musl')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./mcp-mesh-core.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@mcpmesh/core-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@mcpmesh/core-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./mcp-mesh-core.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@mcpmesh/core-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./mcp-mesh-core.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-linux-s390x-gnu')
+        const bindingPackageVersion = require('@mcpmesh/core-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./mcp-mesh-core.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-openharmony-arm64')
+        const bindingPackageVersion = require('@mcpmesh/core-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./mcp-mesh-core.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-openharmony-x64')
+        const bindingPackageVersion = require('@mcpmesh/core-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./mcp-mesh-core.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@mcpmesh/core-openharmony-arm')
+        const bindingPackageVersion = require('@mcpmesh/core-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.8.0-beta.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.8.0-beta.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./mcp-mesh-core.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('@mcpmesh/core-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.JsAgentHandle = nativeBinding.JsAgentHandle
+module.exports.autoDetectIp = nativeBinding.autoDetectIp
+module.exports.getDefault = nativeBinding.getDefault
+module.exports.getEnvVar = nativeBinding.getEnvVar
+module.exports.getRedisUrl = nativeBinding.getRedisUrl
+module.exports.initTracePublisher = nativeBinding.initTracePublisher
+module.exports.isTracePublisherAvailable = nativeBinding.isTracePublisherAvailable
+module.exports.isTracingEnabled = nativeBinding.isTracingEnabled
+module.exports.publishSpan = nativeBinding.publishSpan
+module.exports.resolveConfig = nativeBinding.resolveConfig
+module.exports.resolveConfigBool = nativeBinding.resolveConfigBool
+module.exports.resolveConfigInt = nativeBinding.resolveConfigInt
+module.exports.startAgent = nativeBinding.startAgent

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@mcpmesh/core",
+  "version": "0.8.0-beta.6",
+  "description": "MCP Mesh Rust core bindings for Node.js",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "napi": {
+    "binaryName": "mcp-mesh-core",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-pc-windows-msvc"
+    ]
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@napi-rs/cli": "^3.5.1"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release --manifest-path ../Cargo.toml --features typescript --no-default-features -o .",
+    "build:debug": "napi build --platform --manifest-path ../Cargo.toml --features typescript --no-default-features -o .",
+    "prepublishOnly": "napi prepublish -t npm",
+    "universal": "napi universal",
+    "version": "napi version"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcp-mesh/mcp-mesh"
+  },
+  "keywords": [
+    "mcp",
+    "mesh",
+    "agent",
+    "napi",
+    "rust"
+  ]
+}