@openenthrium/oe-runtime-sdk 1.7.5

package/README.md

@@ -0,0 +1,139 @@
+# 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.
+
+## Install
+
+```bash
+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
+
+# MongoDB
+npm install mongodb
+
+# Redis
+npm install ioredis
+
+# Kafka / RabbitMQ
+npm install kafkajs
+
+# S3 / object storage
+npm install @aws-sdk/client-s3
+
+# SSH
+npm install ssh2
+
+# Gmail / Google Drive
+npm install googleapis
+```
+
+## Usage
+
+### From file paths
+
+```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
+);
+
+console.log(result.output);
+console.log(result.toolCalls); // list of connector tools called
+```
+
+### From 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." }],
+  connectors: [{ connection_name: "My Database", connection_type: "postgresql" }],
+};
+
+const config = {
+  llm: { provider: "openai", model: "gpt-4o", apiKey: "sk-..." },
+  connectors: [{
+    connection_name: "My Database",
+    connection_type: "postgresql",
+    host: "localhost", port: 5432,
+    database: "mydb", user: "postgres", password: "secret"
+  }]
+};
+
+const result = await runAgentFromObject(agent, config, {});
+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", {}, {
+  onToolCall:   (name)         => console.log(`→ ${name}`),
+  onToolResult: (name, result) => console.log(`↳ ${result}`),
+  onDone:       (output)       => console.log("Done:", output),
+  onError:      (err)          => console.error("Error:", err),
+});
+```
+
+## Config file format
+
+Same `oe-config.json` 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"
+  },
+  "connectors": [
+    {
+      "connection_name": "My Database",
+      "connection_type": "postgresql",
+      "host": "localhost",
+      "port": 5432,
+      "database": "mydb",
+      "user": "postgres",
+      "password": "YOUR_DB_PASSWORD"
+    }
+  ]
+}
+```
+
+## Supported LLM providers
+
+OpenAI, Anthropic, Azure OpenAI, Groq, Mistral, Ollama, Google Gemini, AWS Bedrock, and any OpenAI-compatible endpoint.
+
+## Supported connectors
+
+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.
+
+See [OE Runtime Connector Catalog](https://www.openenthrium.com/runtime.html) for the full list.
+
+## Links
+
+- [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)

package/index.js

@@ -0,0 +1,58 @@
+"use strict";
+
+const fs   = require("fs");
+const path = require("path");
+const yaml = require("js-yaml");
+
+// Works in both monorepo context (../src/) and npm-installed context (./src/)
+const srcDir = fs.existsSync(path.join(__dirname, "src", "engine"))
+  ? path.join(__dirname, "src")
+  : path.join(__dirname, "..", "src");
+
+const engine                = require(path.join(srcDir, "engine"));
+const { prepareConnectors } = require(path.join(srcDir, "utils", "prepareConnectors"));
+
+/**
+ * Run an agent from file paths.
+ *
+ * @param {string} agentPath   - Path to agent.yaml
+ * @param {string} configPath  - Path to oe-config.json
+ * @param {object} params      - Optional key/value params (replaces {{param}} in prompts)
+ * @param {object} hooks       - Optional hooks: { onToolCall, onToolResult, onDone, onError }
+ * @returns {Promise<{ output: string, toolCalls: string[] }>}
+ */
+async function runAgent(agentPath, configPath, params = {}, hooks = {}) {
+  const agentYaml = yaml.load(fs.readFileSync(path.resolve(agentPath), "utf8"));
+  const config    = JSON.parse(fs.readFileSync(path.resolve(configPath), "utf8"));
+  return _run(agentYaml, config, params, hooks);
+}
+
+/**
+ * Run an agent from already-parsed objects.
+ *
+ * @param {object} agentYaml  - Parsed agent YAML object
+ * @param {object} config     - Parsed oe-config.json object { llm, connectors, server }
+ * @param {object} params     - Optional key/value params
+ * @param {object} hooks      - Optional hooks: { onToolCall, onToolResult, onDone, onError }
+ * @returns {Promise<{ output: string, toolCalls: string[] }>}
+ */
+async function runAgentFromObject(agentYaml, config, params = {}, hooks = {}) {
+  return _run(agentYaml, config, params, hooks);
+}
+
+function _run(agentYaml, config, params, hooks) {
+  const connectors = prepareConnectors(agentYaml.connectors, config.connectors);
+
+  const agentSpec = {
+    systemPrompt: agentYaml.systemPrompt || agentYaml.system_prompt || agentYaml.instructions || "",
+    workflow:     agentYaml.steps        || agentYaml.workflow       || [],
+    params:       agentYaml.params       || [],
+    paramValues:  params || {},
+    maxRounds:    agentYaml.maxRounds    || 25,
+    input:        null,
+  };
+
+  return engine.run(agentSpec, config.llm, connectors, hooks);
+}
+
+module.exports = { runAgent, runAgentFromObject };

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@openenthrium/oe-runtime-sdk",
+  "version": "1.7.5",
+  "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": {
+    "type": "git",
+    "url": "https://github.com/enthrium/open-enthrium-ai-agent-runtime"
+  },
+  "keywords": [
+    "ai-agent", "llm", "openai", "anthropic", "enterprise",
+    "oe-runtime", "agent-sdk", "postgresql", "mongodb", "kafka",
+    "open-enthrium", "automation"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.27.0",
+    "axios": "^1.7.7",
+    "js-yaml": "^4.1.0",
+    "openai": "^4.67.3"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "optional",
+    "@elastic/elasticsearch": "optional",
+    "better-sqlite3": "optional",
+    "googleapis": "optional",
+    "imapflow": "optional",
+    "ioredis": "optional",
+    "kafkajs": "optional",
+    "ldapts": "optional",
+    "mongodb": "optional",
+    "mqtt": "optional",
+    "mssql": "optional",
+    "mysql2": "optional",
+    "nodemailer": "optional",
+    "oracledb": "optional",
+    "pg": "optional",
+    "snowflake-sdk": "optional",
+    "ssh2": "optional"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-s3":    { "optional": true },
+    "@elastic/elasticsearch": { "optional": true },
+    "better-sqlite3":        { "optional": true },
+    "googleapis":            { "optional": true },
+    "imapflow":              { "optional": true },
+    "ioredis":               { "optional": true },
+    "kafkajs":               { "optional": true },
+    "ldapts":                { "optional": true },
+    "mongodb":               { "optional": true },
+    "mqtt":                  { "optional": true },
+    "mssql":                 { "optional": true },
+    "mysql2":                { "optional": true },
+    "nodemailer":            { "optional": true },
+    "oracledb":              { "optional": true },
+    "pg":                    { "optional": true },
+    "snowflake-sdk":         { "optional": true },
+    "ssh2":                  { "optional": true }
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}