@openenthrium/oe-runtime-sdk 1.8.4 → 1.8.7

package/README.md

@@ -1,7 +1,12 @@
-# OE Runtime SDK
+# OE Runtime SDK · `@openenthrium/oe-runtime-sdk`
 
 Embed AI agent execution directly in your Node.js application. Same engine as [OE Runtime CLI](https://www.openenthrium.com/runtime.html) — no subprocess, no HTTP overhead, just a function call.
 
+[![npm](https://img.shields.io/npm/v/@openenthrium/oe-runtime-sdk?color=4f46e5)](https://www.npmjs.com/package/@openenthrium/oe-runtime-sdk)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-4f46e5.svg)](https://github.com/enthrium/open-enthrium-ai-agent-runtime/blob/main/LICENSE)
+
+---
+
 ## Install
 
 ```bash
@@ -11,56 +16,58 @@ npm install @openenthrium/oe-runtime-sdk
 Install only the connector dependencies your agents actually use:
 
 ```bash
-# PostgreSQL / MySQL / SQLite
-npm install pg          # PostgreSQL
-npm install mysql2      # MySQL / MariaDB
-npm install better-sqlite3  # SQLite
+npm install pg           # PostgreSQL
+npm install mysql2       # MySQL / MariaDB
+npm install mongodb      # MongoDB
+npm install ioredis      # Redis
+npm install ssh2         # SSH / SFTP
+npm install kafkajs      # Kafka
+npm install @aws-sdk/client-s3  # S3 / object storage
+npm install googleapis   # Gmail, Google Drive
+```
 
-# MongoDB
-npm install mongodb
+---
 
-# Redis
-npm install ioredis
+## Usage
 
-# Kafka / RabbitMQ
-npm install kafkajs
+### Run a SKILL.md skill (recommended)
 
-# S3 / object storage
-npm install @aws-sdk/client-s3
+Pass the skill folder — the SDK resolves `agent.yaml` + `SKILL.md` inside it automatically.
 
-# SSH
-npm install ssh2
+```js
+const { runAgent } = require("@openenthrium/oe-runtime-sdk");
 
-# Gmail / Google Drive
-npm install googleapis
-```
+const result = await runAgent(
+  "./skills/sql-databases",  // folder containing SKILL.md + agent.yaml
+  "./oe-config.json",
+  { topic: "Q3 sales" }      // optional params
+);
 
-## Usage
+console.log(result.output);
+console.log(result.toolCalls); // connector tools called
+```
 
-### From file paths
+### Run from an agent.yaml file path
 
 ```js
 const { runAgent } = require("@openenthrium/oe-runtime-sdk");
 
 const result = await runAgent(
-  "./agent.yaml",       // path to your agent
-  "./oe-config.json",   // path to your config
-  { topic: "Q3 sales" } // optional params
+  "./my-agent/agent.yaml",
+  "./oe-config.json"
 );
 
 console.log(result.output);
-console.log(result.toolCalls); // list of connector tools called
 ```
 
-### From objects (no file I/O)
+### Run from inline objects (no file I/O)
 
 ```js
 const { runAgentFromObject } = require("@openenthrium/oe-runtime-sdk");
 
 const agent = {
   name: "Database Analyst",
-  instructions: "You are a SQL analyst.",
-  steps: [{ name: "Query", content: "List all tables and their row counts." }],
+  skills: [{ path: "./SKILL.md", trigger_type: "auto" }],
   connectors: [{ connection_name: "My Database", connection_type: "postgresql" }],
 };
 
@@ -81,9 +88,7 @@ console.log(result.output);
 ### With hooks (streaming tool calls)
 
 ```js
-const { runAgent } = require("@openenthrium/oe-runtime-sdk");
-
-const result = await runAgent("./agent.yaml", "./oe-config.json", {}, {
+const result = await runAgent("./my-agent/agent.yaml", "./oe-config.json", {}, {
   onToolCall:   (name)         => console.log(`→ ${name}`),
   onToolResult: (name, result) => console.log(`↳ ${result}`),
   onDone:       (output)       => console.log("Done:", output),
@@ -91,22 +96,15 @@ const result = await runAgent("./agent.yaml", "./oe-config.json", {}, {
 });
 ```
 
-## Config file format
+---
+
+## oe-config.json
 
-Same `oe-config.json` used by OE Runtime CLI — no changes needed:
+Same config used by OE Runtime CLI — no changes needed:
 
 ```json
 {
-  "llm": {
-    "provider": "openai",
-    "model": "gpt-4o",
-    "apiKey": "YOUR_OPENAI_API_KEY"
-  },
-  "server": {
-    "enabled": false,
-    "port": 3333,
-    "apiKey": "your-secret-api-key"
-  },
+  "llm": { "provider": "openai", "model": "gpt-4o", "apiKey": "sk-..." },
   "connectors": [
     {
       "connection_name": "My Database",
@@ -121,19 +119,25 @@ Same `oe-config.json` used by OE Runtime CLI — no changes needed:
 }
 ```
 
-## Supported LLM providers
+---
+
+## Supported LLM Providers
+
+`openai` · `anthropic` · `azure` · `groq` · `gemini` · `ollama` · `mistral` · `deepseek` · `together` · `fireworks` · `bedrock` · and more
 
-OpenAI, Anthropic, Azure OpenAI, Groq, Mistral, Ollama, Google Gemini, AWS Bedrock, and any OpenAI-compatible endpoint.
+---
 
-## Supported connectors
+## Part of Open Enthrium
 
-30+ connector types — PostgreSQL, MySQL, MongoDB, Redis, Elasticsearch, S3, GitHub, Slack, Gmail, Jira, Confluence, Notion, HubSpot, Kafka, MQTT, LDAP, GraphQL, Web3/Blockchain, SSH, shell, SFTP, and more.
+| | |
+|---|---|
+| ⚡ **Runtime CLI** | [@openenthrium/oe-runtime](https://www.npmjs.com/package/@openenthrium/oe-runtime) — standalone binary / npx |
+| 🖥️ **Platform** | [open-enthrium-ai-platform](https://github.com/enthrium/open-enthrium-ai-platform) — full web app with workspaces, RAG, Agent Builder |
+| 🔌 **MCP Server** | [open-enthrium-ai-mcp-server](https://github.com/enthrium/open-enthrium-ai-mcp-server) — connect Claude Code, Cursor, Windsurf to enterprise data |
+| 🌐 **Website** | [openenthrium.com](https://www.openenthrium.com) |
 
-See [OE Runtime Connector Catalog](https://www.openenthrium.com/runtime.html) for the full list.
+---
 
-## Links
+## License
 
-- [OE Runtime CLI](https://www.openenthrium.com/runtime.html)
-- [Sample library](https://github.com/enthrium/open-enthrium-ai-agent-runtime/releases/latest/download/oe-runtime-samples.zip)
-- [GitHub](https://github.com/enthrium/open-enthrium-ai-agent-runtime)
-- [Open Enthrium](https://www.openenthrium.com)
+[Apache-2.0](https://github.com/enthrium/open-enthrium-ai-agent-runtime/blob/main/LICENSE) — free to use, modify, and deploy for any purpose, including commercial use.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openenthrium/oe-runtime-sdk",
-  "version": "1.8.4",
-  "description": "OE Runtime SDK — embed AI agent execution directly in your Node.js application. Same engine as OE Runtime CLI, importable as a library.",
+  "version": "1.8.7",
+  "description": "OE Runtime SDK — embed AI agent execution directly in your Node.js application. Same engine as OE Runtime CLI, importable as a library.",
   "main": "index.js",
   "homepage": "https://www.openenthrium.com/runtime.html",
   "repository": {

package/src/index.js

@@ -152,5 +152,4 @@ if (process.env.NODE_ENV === "production") {
 app.listen(PORT, async () => {
   console.log(`Open Enthrium server running on port ${PORT}`);
   await recoverPendingJobs();
-  try { await require("./telemetry/bootstrap")(prisma); } catch {}
 });

package/src/routes/marketplace.js

@@ -3,15 +3,15 @@ const { authenticate } = require("../middleware/auth");
 const path = require("path");
 const fs   = require("fs");
 
-const SAMPLES_DIR = path.resolve(__dirname, "../../cli/samples");
+const SKILLS_DIR = path.resolve(__dirname, "../../cli/skills");
 
-function readSamples() {
-  if (!fs.existsSync(SAMPLES_DIR)) return [];
-  return fs.readdirSync(SAMPLES_DIR)
-    .filter(f => fs.statSync(path.join(SAMPLES_DIR, f)).isDirectory())
+function readSkills() {
+  if (!fs.existsSync(SKILLS_DIR)) return [];
+  return fs.readdirSync(SKILLS_DIR)
+    .filter(f => fs.statSync(path.join(SKILLS_DIR, f)).isDirectory())
     .map(folder => {
-      const yamlPath   = path.join(SAMPLES_DIR, folder, "agent.yaml");
-      const configPath = path.join(SAMPLES_DIR, folder, "oe-config.json");
+      const yamlPath   = path.join(SKILLS_DIR, folder, "agent.yaml");
+      const configPath = path.join(SKILLS_DIR, folder, "oe-config.json");
       const yaml   = fs.existsSync(yamlPath)   ? fs.readFileSync(yamlPath,   "utf8") : null;
       const config = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf8") : null;
       return { folder, yaml, config };
@@ -19,27 +19,27 @@ function readSamples() {
     .filter(s => s.yaml);
 }
 
-// GET /api/marketplace/samples
-router.get("/samples", authenticate, (req, res) => {
+// GET /api/marketplace/skills
+router.get("/skills", authenticate, (req, res) => {
   try {
-    res.json({ samples: readSamples() });
+    res.json({ skills: readSkills() });
   } catch (e) {
     res.status(500).json({ error: e.message });
   }
 });
 
-// GET /api/marketplace/samples/:folder/yaml
-router.get("/samples/:folder/yaml", authenticate, (req, res) => {
-  const file = path.join(SAMPLES_DIR, req.params.folder, "agent.yaml");
+// GET /api/marketplace/skills/:folder/yaml
+router.get("/skills/:folder/yaml", authenticate, (req, res) => {
+  const file = path.join(SKILLS_DIR, req.params.folder, "agent.yaml");
   if (!fs.existsSync(file)) return res.status(404).json({ error: "Not found" });
   res.setHeader("Content-Type", "text/yaml");
   res.setHeader("Content-Disposition", `attachment; filename="${req.params.folder}.yaml"`);
   res.send(fs.readFileSync(file, "utf8"));
 });
 
-// GET /api/marketplace/samples/:folder/config
-router.get("/samples/:folder/config", authenticate, (req, res) => {
-  const file = path.join(SAMPLES_DIR, req.params.folder, "oe-config.json");
+// GET /api/marketplace/skills/:folder/config
+router.get("/skills/:folder/config", authenticate, (req, res) => {
+  const file = path.join(SKILLS_DIR, req.params.folder, "oe-config.json");
   if (!fs.existsSync(file)) return res.status(404).json({ error: "Not found" });
   res.setHeader("Content-Type", "application/json");
   res.setHeader("Content-Disposition", `attachment; filename="${req.params.folder}.oe-config.json"`);

package/src/routes/templates.js

@@ -6,7 +6,7 @@ const yaml = require("js-yaml");
 
 router.use(authenticate, requireManagerOrAdmin);
 
-const SAMPLES_DIR = path.resolve(__dirname, "../../cli/samples");
+const SAMPLES_DIR = path.resolve(__dirname, "../../cli/skills");
 
 // ── List templates ─────────────────────────────────────────────────────────────
 router.get("/", (req, res) => {

package/src/utils/tools/registry.js

@@ -54,6 +54,7 @@ const filesystem     = tryRequire("./adapters/filesystem");
 const ADAPTERS = {
   // SQL databases
   postgresql:    database,
+  postgres:      database,
   mysql:         database,
   mssql:         database,
   oracle:        database,

package/src/telemetry/bootstrap.js

@@ -1,39 +0,0 @@
-const fs   = require("fs");
-const path = require("path");
-const { v4: uuidv4 } = require("uuid");
-const { sendRegistration } = require("./registration");
-
-const { version } = JSON.parse(fs.readFileSync(path.resolve(__dirname, "../../../package.json"), "utf8"));
-
-module.exports = async function bootstrap(prisma) {
-  try {
-    if (process.env.LICENSE_TYPE === "enterprise") return;
-
-    const upsert = (key, value) => prisma.setting.upsert({
-      where:  { key },
-      create: { key, value },
-      update: { value },
-    });
-
-    const getSetting = (key) => prisma.setting.findUnique({ where: { key } }).then(r => r?.value ?? null);
-
-    // Generate instance ID once
-    let instanceId = await getSetting("telemetry.instanceId");
-    if (!instanceId) {
-      instanceId = uuidv4();
-      await upsert("telemetry.instanceId", instanceId);
-    }
-
-    const lastVersion = await getSetting("telemetry.lastVersion");
-
-    // Send on first boot or version upgrade
-    if (lastVersion !== version) {
-      const email = process.env.SUPER_ADMIN_EMAIL || "";
-      await sendRegistration({ email, company: "", instanceId, version, event: lastVersion ? "upgrade" : "first_boot" });
-      await upsert("telemetry.lastVersion", version);
-      console.log(`[Telemetry] Registered instance ${instanceId} v${version}`);
-    }
-  } catch (err) {
-    // never crash the server
-  }
-};

package/src/telemetry/registration.js

@@ -1,16 +0,0 @@
-const TELEMETRY_URL   = "https://script.google.com/macros/s/AKfycbxzUHUVoXFQW9Hh2cUMKeIhmNWNLPHU2nSKS_yDO3CLYNpfmvGMuyeH8Y8jypvbdAQ/exec";
-const TELEMETRY_TOKEN = "oe-reg-2026-openenthrium";
-
-async function sendRegistration({ email, company, instanceId, version, event = "first_boot" }) {
-  try {
-    await fetch(TELEMETRY_URL, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ token: TELEMETRY_TOKEN, email, company, instanceId, version, event }),
-    });
-  } catch {
-    // silent fail — never block the user
-  }
-}
-
-module.exports = { sendRegistration };