@contractspec/example.integration-hub 2.6.0 → 2.7.0

package/README.md

@@ -15,6 +15,7 @@ A comprehensive integration hub example demonstrating ContractSpec principles fo
 - **Scheduled Sync**: Cron-based scheduled synchronization
 - **Feature Flag Integration**: Control integration availability
 - **Full Audit Trail**: Track all sync operations
+- **MCP-Ready Providers**: Supports provider configs that call remote MCP tools
 
 ## Entities
 
@@ -137,6 +138,45 @@ const run = await executeContract(TriggerSyncContract, {
 });
 ```
 
+## MCP Provider Wiring
+
+Provider adapters in this workspace can be configured to call MCP endpoints
+(for example `mcpUrl` + headers/tokens on analytics providers, or transport
+selection for meeting recorder providers). This example remains provider-agnostic,
+so MCP transport details stay in provider config rather than contract logic.
+
+## Run MCP Example
+
+This package now includes a runnable MCP connectivity example:
+`src/run-mcp.ts`.
+
+List MCP tools from a local stdio server (default):
+
+```bash
+export CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT="stdio"
+export CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND="npx"
+export CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON='["-y","@modelcontextprotocol/server-filesystem","."]'
+
+bun run --filter @contractspec/example.integration-hub run:mcp
+```
+
+Call a specific MCP tool:
+
+```bash
+export CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE="call"
+export CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME="read_file"
+export CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON='{"path":"README.md"}'
+
+bun run --filter @contractspec/example.integration-hub run:mcp
+```
+
+Remote MCP transport is also supported via:
+
+- `CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT=http|sse`
+- `CONTRACTSPEC_INTEGRATION_HUB_MCP_URL`
+- `CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON` (optional)
+- `CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN` or `..._ACCESS_TOKEN_ENV` (optional)
+
 ## Dependencies
 
 - `@contractspec/lib.identity-rbac` - User identity and roles

package/dist/docs/index.js

@@ -68,6 +68,7 @@ var integrationHubDocBlocks = [
     body: `## Setup
 1) Seed integrations/connections (if available) or create connector definitions.
 2) Configure sync jobs with Jobs module; store payload archives via Files.
+3) Use \`src/run-mcp.ts\` to validate MCP connectivity for provider adapters.
 
 ## Extend & regenerate
 1) Add mapping fields or provider configs in the spec; include validation and PII paths.
@@ -95,6 +96,7 @@ var integrationHubDocBlocks = [
 ## PII & Payloads
 - Treat payload archives as potentially sensitive; mark policy.pii paths.
 - For MCP/web, avoid exposing raw credentials/tokens; store via provider adapters only.
+- Keep MCP endpoint URLs, headers, and tokens in provider connection config, never in mappings.
 
 ## Verification
 - Include fixtures for mapping changes and sync retries.

package/dist/docs/integration-hub.docblock.js

@@ -68,6 +68,7 @@ var integrationHubDocBlocks = [
     body: `## Setup
 1) Seed integrations/connections (if available) or create connector definitions.
 2) Configure sync jobs with Jobs module; store payload archives via Files.
+3) Use \`src/run-mcp.ts\` to validate MCP connectivity for provider adapters.
 
 ## Extend & regenerate
 1) Add mapping fields or provider configs in the spec; include validation and PII paths.
@@ -95,6 +96,7 @@ var integrationHubDocBlocks = [
 ## PII & Payloads
 - Treat payload archives as potentially sensitive; mark policy.pii paths.
 - For MCP/web, avoid exposing raw credentials/tokens; store via provider adapters only.
+- Keep MCP endpoint URLs, headers, and tokens in provider connection config, never in mappings.
 
 ## Verification
 - Include fixtures for mapping changes and sync retries.

package/dist/index.d.ts

@@ -9,3 +9,4 @@ export * from './sync';
 export { createIntegrationHandlers, type IntegrationHandlers, } from './handlers/integration.handlers';
 export * from './ui';
 export * from './sync-engine';
+export * from './mcp-example';

package/dist/index.js

@@ -1558,9 +1558,158 @@ function hasChanges(sourceChecksum, targetChecksum) {
   }
   return sourceChecksum !== targetChecksum;
 }
+
+// src/mcp-example.ts
+import { randomUUID } from "crypto";
+import {
+  createMcpToolsets
+} from "@contractspec/lib.ai-agent/tools/mcp-client";
+var DEFAULT_STDIO_ARGS = [
+  "-y",
+  "@modelcontextprotocol/server-filesystem",
+  "."
+];
+async function runIntegrationHubMcpExampleFromEnv() {
+  const mode = resolveMode();
+  const config = buildMcpConfigFromEnv();
+  const toolset = await createMcpToolsets([config], {
+    onNameCollision: "error"
+  });
+  try {
+    const toolNames = Object.keys(toolset.tools).sort();
+    const output = {
+      mode,
+      server: {
+        name: config.name,
+        transport: config.transport ?? "stdio"
+      },
+      tools: toolNames
+    };
+    if (mode === "call") {
+      const toolName = requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME");
+      const toolArgs = parseRecordEnvOrDefault("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON", {});
+      const tool = toolset.tools[toolName];
+      if (!tool?.execute) {
+        throw new Error(`Tool "${toolName}" was not found. Available tools: ${toolNames.join(", ")}`);
+      }
+      const toolOutput = await tool.execute(toolArgs, {
+        toolCallId: `integration-hub-${randomUUID()}`,
+        messages: []
+      });
+      output.toolCall = {
+        name: toolName,
+        args: toolArgs,
+        output: toolOutput
+      };
+    }
+    return output;
+  } finally {
+    await toolset.cleanup().catch(() => {
+      return;
+    });
+  }
+}
+function buildMcpConfigFromEnv() {
+  const name = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_NAME ?? "filesystem";
+  const transport = resolveTransport();
+  const toolPrefix = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_PREFIX;
+  if (transport === "stdio") {
+    return {
+      name,
+      transport,
+      command: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND ?? "npx",
+      args: parseStringArrayEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON", DEFAULT_STDIO_ARGS),
+      toolPrefix
+    };
+  }
+  const accessToken = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN;
+  const accessTokenEnvVar = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;
+  return {
+    name,
+    transport,
+    url: requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),
+    headers: parseStringRecordEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),
+    accessToken,
+    accessTokenEnvVar,
+    toolPrefix
+  };
+}
+function resolveMode() {
+  const rawMode = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE?.toLowerCase() ?? "list";
+  if (rawMode === "list" || rawMode === "call") {
+    return rawMode;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE: ${rawMode}. Use "list" or "call".`);
+}
+function resolveTransport() {
+  const rawTransport = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase() ?? "stdio";
+  if (rawTransport === "stdio" || rawTransport === "http" || rawTransport === "sse") {
+    return rawTransport;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${rawTransport}. Use "stdio", "http", or "sse".`);
+}
+function parseStringArrayEnv(key, fallback) {
+  const raw = process.env[key];
+  if (!raw) {
+    return fallback;
+  }
+  const parsed = parseJsonEnv(key);
+  if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "string")) {
+    throw new Error(`${key} must be a JSON string array.`);
+  }
+  return parsed;
+}
+function parseRecordEnv(key) {
+  const raw = process.env[key];
+  if (!raw) {
+    return;
+  }
+  const parsed = parseJsonEnv(key);
+  if (!isRecord(parsed)) {
+    throw new Error(`${key} must be a JSON object.`);
+  }
+  return parsed;
+}
+function parseRecordEnvOrDefault(key, fallback) {
+  return parseRecordEnv(key) ?? fallback;
+}
+function parseStringRecordEnv(key) {
+  const parsed = parseRecordEnv(key);
+  if (!parsed) {
+    return;
+  }
+  const entries = Object.entries(parsed);
+  const invalidEntry = entries.find(([, value]) => typeof value !== "string");
+  if (invalidEntry) {
+    throw new Error(`${key} must contain only string values.`);
+  }
+  return Object.fromEntries(entries);
+}
+function parseJsonEnv(key) {
+  const raw = process.env[key];
+  if (!raw) {
+    return;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`${key} contains invalid JSON.`);
+  }
+}
+function requireEnv(key) {
+  const value = process.env[key];
+  if (!value) {
+    throw new Error(`Missing required env var: ${key}`);
+  }
+  return value;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 export {
   useIntegrationData,
   syncConfigMarkdownRenderer,
+  runIntegrationHubMcpExampleFromEnv,
   integrationDashboardMarkdownRenderer,
   hasChanges,
   createSyncEngine,

package/dist/mcp-example.d.ts

@@ -0,0 +1,16 @@
+type IntegrationHubMcpMode = 'list' | 'call';
+interface IntegrationHubMcpOutput {
+    mode: IntegrationHubMcpMode;
+    server: {
+        name: string;
+        transport: 'stdio' | 'http' | 'sse';
+    };
+    tools: string[];
+    toolCall?: {
+        name: string;
+        args: Record<string, unknown>;
+        output: unknown;
+    };
+}
+export declare function runIntegrationHubMcpExampleFromEnv(): Promise<IntegrationHubMcpOutput>;
+export {};

package/dist/mcp-example.js

@@ -0,0 +1,151 @@
+// @bun
+// src/mcp-example.ts
+import { randomUUID } from "crypto";
+import {
+  createMcpToolsets
+} from "@contractspec/lib.ai-agent/tools/mcp-client";
+var DEFAULT_STDIO_ARGS = [
+  "-y",
+  "@modelcontextprotocol/server-filesystem",
+  "."
+];
+async function runIntegrationHubMcpExampleFromEnv() {
+  const mode = resolveMode();
+  const config = buildMcpConfigFromEnv();
+  const toolset = await createMcpToolsets([config], {
+    onNameCollision: "error"
+  });
+  try {
+    const toolNames = Object.keys(toolset.tools).sort();
+    const output = {
+      mode,
+      server: {
+        name: config.name,
+        transport: config.transport ?? "stdio"
+      },
+      tools: toolNames
+    };
+    if (mode === "call") {
+      const toolName = requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME");
+      const toolArgs = parseRecordEnvOrDefault("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON", {});
+      const tool = toolset.tools[toolName];
+      if (!tool?.execute) {
+        throw new Error(`Tool "${toolName}" was not found. Available tools: ${toolNames.join(", ")}`);
+      }
+      const toolOutput = await tool.execute(toolArgs, {
+        toolCallId: `integration-hub-${randomUUID()}`,
+        messages: []
+      });
+      output.toolCall = {
+        name: toolName,
+        args: toolArgs,
+        output: toolOutput
+      };
+    }
+    return output;
+  } finally {
+    await toolset.cleanup().catch(() => {
+      return;
+    });
+  }
+}
+function buildMcpConfigFromEnv() {
+  const name = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_NAME ?? "filesystem";
+  const transport = resolveTransport();
+  const toolPrefix = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_PREFIX;
+  if (transport === "stdio") {
+    return {
+      name,
+      transport,
+      command: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND ?? "npx",
+      args: parseStringArrayEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON", DEFAULT_STDIO_ARGS),
+      toolPrefix
+    };
+  }
+  const accessToken = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN;
+  const accessTokenEnvVar = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;
+  return {
+    name,
+    transport,
+    url: requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),
+    headers: parseStringRecordEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),
+    accessToken,
+    accessTokenEnvVar,
+    toolPrefix
+  };
+}
+function resolveMode() {
+  const rawMode = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE?.toLowerCase() ?? "list";
+  if (rawMode === "list" || rawMode === "call") {
+    return rawMode;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE: ${rawMode}. Use "list" or "call".`);
+}
+function resolveTransport() {
+  const rawTransport = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase() ?? "stdio";
+  if (rawTransport === "stdio" || rawTransport === "http" || rawTransport === "sse") {
+    return rawTransport;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${rawTransport}. Use "stdio", "http", or "sse".`);
+}
+function parseStringArrayEnv(key, fallback) {
+  const raw = process.env[key];
+  if (!raw) {
+    return fallback;
+  }
+  const parsed = parseJsonEnv(key);
+  if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "string")) {
+    throw new Error(`${key} must be a JSON string array.`);
+  }
+  return parsed;
+}
+function parseRecordEnv(key) {
+  const raw = process.env[key];
+  if (!raw) {
+    return;
+  }
+  const parsed = parseJsonEnv(key);
+  if (!isRecord(parsed)) {
+    throw new Error(`${key} must be a JSON object.`);
+  }
+  return parsed;
+}
+function parseRecordEnvOrDefault(key, fallback) {
+  return parseRecordEnv(key) ?? fallback;
+}
+function parseStringRecordEnv(key) {
+  const parsed = parseRecordEnv(key);
+  if (!parsed) {
+    return;
+  }
+  const entries = Object.entries(parsed);
+  const invalidEntry = entries.find(([, value]) => typeof value !== "string");
+  if (invalidEntry) {
+    throw new Error(`${key} must contain only string values.`);
+  }
+  return Object.fromEntries(entries);
+}
+function parseJsonEnv(key) {
+  const raw = process.env[key];
+  if (!raw) {
+    return;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`${key} contains invalid JSON.`);
+  }
+}
+function requireEnv(key) {
+  const value = process.env[key];
+  if (!value) {
+    throw new Error(`Missing required env var: ${key}`);
+  }
+  return value;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export {
+  runIntegrationHubMcpExampleFromEnv
+};

package/dist/node/docs/index.js

@@ -67,6 +67,7 @@ var integrationHubDocBlocks = [
     body: `## Setup
 1) Seed integrations/connections (if available) or create connector definitions.
 2) Configure sync jobs with Jobs module; store payload archives via Files.
+3) Use \`src/run-mcp.ts\` to validate MCP connectivity for provider adapters.
 
 ## Extend & regenerate
 1) Add mapping fields or provider configs in the spec; include validation and PII paths.
@@ -94,6 +95,7 @@ var integrationHubDocBlocks = [
 ## PII & Payloads
 - Treat payload archives as potentially sensitive; mark policy.pii paths.
 - For MCP/web, avoid exposing raw credentials/tokens; store via provider adapters only.
+- Keep MCP endpoint URLs, headers, and tokens in provider connection config, never in mappings.
 
 ## Verification
 - Include fixtures for mapping changes and sync retries.

package/dist/node/docs/integration-hub.docblock.js

@@ -67,6 +67,7 @@ var integrationHubDocBlocks = [
     body: `## Setup
 1) Seed integrations/connections (if available) or create connector definitions.
 2) Configure sync jobs with Jobs module; store payload archives via Files.
+3) Use \`src/run-mcp.ts\` to validate MCP connectivity for provider adapters.
 
 ## Extend & regenerate
 1) Add mapping fields or provider configs in the spec; include validation and PII paths.
@@ -94,6 +95,7 @@ var integrationHubDocBlocks = [
 ## PII & Payloads
 - Treat payload archives as potentially sensitive; mark policy.pii paths.
 - For MCP/web, avoid exposing raw credentials/tokens; store via provider adapters only.
+- Keep MCP endpoint URLs, headers, and tokens in provider connection config, never in mappings.
 
 ## Verification
 - Include fixtures for mapping changes and sync retries.

package/dist/node/index.js

@@ -1557,9 +1557,158 @@ function hasChanges(sourceChecksum, targetChecksum) {
   }
   return sourceChecksum !== targetChecksum;
 }
+
+// src/mcp-example.ts
+import { randomUUID } from "node:crypto";
+import {
+  createMcpToolsets
+} from "@contractspec/lib.ai-agent/tools/mcp-client";
+var DEFAULT_STDIO_ARGS = [
+  "-y",
+  "@modelcontextprotocol/server-filesystem",
+  "."
+];
+async function runIntegrationHubMcpExampleFromEnv() {
+  const mode = resolveMode();
+  const config = buildMcpConfigFromEnv();
+  const toolset = await createMcpToolsets([config], {
+    onNameCollision: "error"
+  });
+  try {
+    const toolNames = Object.keys(toolset.tools).sort();
+    const output = {
+      mode,
+      server: {
+        name: config.name,
+        transport: config.transport ?? "stdio"
+      },
+      tools: toolNames
+    };
+    if (mode === "call") {
+      const toolName = requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME");
+      const toolArgs = parseRecordEnvOrDefault("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON", {});
+      const tool = toolset.tools[toolName];
+      if (!tool?.execute) {
+        throw new Error(`Tool "${toolName}" was not found. Available tools: ${toolNames.join(", ")}`);
+      }
+      const toolOutput = await tool.execute(toolArgs, {
+        toolCallId: `integration-hub-${randomUUID()}`,
+        messages: []
+      });
+      output.toolCall = {
+        name: toolName,
+        args: toolArgs,
+        output: toolOutput
+      };
+    }
+    return output;
+  } finally {
+    await toolset.cleanup().catch(() => {
+      return;
+    });
+  }
+}
+function buildMcpConfigFromEnv() {
+  const name = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_NAME ?? "filesystem";
+  const transport = resolveTransport();
+  const toolPrefix = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_PREFIX;
+  if (transport === "stdio") {
+    return {
+      name,
+      transport,
+      command: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND ?? "npx",
+      args: parseStringArrayEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON", DEFAULT_STDIO_ARGS),
+      toolPrefix
+    };
+  }
+  const accessToken = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN;
+  const accessTokenEnvVar = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;
+  return {
+    name,
+    transport,
+    url: requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),
+    headers: parseStringRecordEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),
+    accessToken,
+    accessTokenEnvVar,
+    toolPrefix
+  };
+}
+function resolveMode() {
+  const rawMode = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE?.toLowerCase() ?? "list";
+  if (rawMode === "list" || rawMode === "call") {
+    return rawMode;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE: ${rawMode}. Use "list" or "call".`);
+}
+function resolveTransport() {
+  const rawTransport = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase() ?? "stdio";
+  if (rawTransport === "stdio" || rawTransport === "http" || rawTransport === "sse") {
+    return rawTransport;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${rawTransport}. Use "stdio", "http", or "sse".`);
+}
+function parseStringArrayEnv(key, fallback) {
+  const raw = process.env[key];
+  if (!raw) {
+    return fallback;
+  }
+  const parsed = parseJsonEnv(key);
+  if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "string")) {
+    throw new Error(`${key} must be a JSON string array.`);
+  }
+  return parsed;
+}
+function parseRecordEnv(key) {
+  const raw = process.env[key];
+  if (!raw) {
+    return;
+  }
+  const parsed = parseJsonEnv(key);
+  if (!isRecord(parsed)) {
+    throw new Error(`${key} must be a JSON object.`);
+  }
+  return parsed;
+}
+function parseRecordEnvOrDefault(key, fallback) {
+  return parseRecordEnv(key) ?? fallback;
+}
+function parseStringRecordEnv(key) {
+  const parsed = parseRecordEnv(key);
+  if (!parsed) {
+    return;
+  }
+  const entries = Object.entries(parsed);
+  const invalidEntry = entries.find(([, value]) => typeof value !== "string");
+  if (invalidEntry) {
+    throw new Error(`${key} must contain only string values.`);
+  }
+  return Object.fromEntries(entries);
+}
+function parseJsonEnv(key) {
+  const raw = process.env[key];
+  if (!raw) {
+    return;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`${key} contains invalid JSON.`);
+  }
+}
+function requireEnv(key) {
+  const value = process.env[key];
+  if (!value) {
+    throw new Error(`Missing required env var: ${key}`);
+  }
+  return value;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 export {
   useIntegrationData,
   syncConfigMarkdownRenderer,
+  runIntegrationHubMcpExampleFromEnv,
   integrationDashboardMarkdownRenderer,
   hasChanges,
   createSyncEngine,