@kadi.build/core 0.0.1-alpha.1 → 0.0.1-alpha.11

package/package.json

@@ -1,12 +1,59 @@
 {
   "name": "@kadi.build/core",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.11",
   "description": "A module that is a comprehensive toolkit for developers integrating with the KADI infrastructure.",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./types/protocol": {
+      "import": "./dist/types/protocol.js",
+      "types": "./dist/types/protocol.d.ts"
+    },
+    "./messages": {
+      "import": "./dist/messages/index.js",
+      "types": "./dist/messages/index.d.ts"
+    },
+    "./schemas": {
+      "import": "./dist/schemas/index.js",
+      "types": "./dist/schemas/index.d.ts"
+    },
+    "./schemas/mcp": {
+      "import": "./dist/schemas/mcp/schema.js",
+      "types": "./dist/schemas/mcp/schema.d.ts"
+    },
+    "./validation": {
+      "import": "./dist/validation/index.js",
+      "types": "./dist/validation/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "build:watch": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint 'src/**/*.{js,ts}'",
+    "lint:fix": "eslint 'src/**/*.{js,ts}' --fix",
     "format": "prettier --write .",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run build"
   },
   "author": "Corey Clark",
   "contributors": [
@@ -17,10 +64,28 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.5.0",
+    "debug": "^4.4.1",
     "events": "^3.3.0",
-    "ws": "^8.16.0"
+    "ws": "^8.16.0",
+    "zod": "^4.1.5"
   },
   "devDependencies": {
-    "prettier": "^3.6.2"
+    "@types/debug": "^4.1.12",
+    "@types/node": "^20.19.11",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.6.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
   }
 }

package/agent.json

@@ -1,18 +0,0 @@
-{
-  "name": "kadi-core",
-  "version": "0.0.1",
-  "license": "MIT",
-  "description": "base install ability for kadi",
-  "repo": "https://gitlab.com/humin-game-lab/agent-abilities/kadi-core.git",
-  "lib": "https://gitlab.com/humin-game-lab/agent-abilities/kadi-core/-/archive/v0.0.1/kadi-core-v0.0.1.zip",
-  "abilities": {},
-
-  "scripts": {
-    "preflight": "echo 'kadi-core v0.0.1 is starting...'",
-    "setup": "echo 'kadi-core v0.0.1 is ready...'",
-    "start": "npm install",
-    "stop": "echo 'kadi-core v0.0.1 is ready...'",
-    "python": "python3 ./node_modules/kadi-core/ipcInterfaces/pythonAbilityIPC.py",
-    "rust": "cargo run --bin path/to/rustAbilityIPC"
-  }
-}

package/broker.js

@@ -1,214 +0,0 @@
-import { EventEmitter } from 'events';
-import { WebSocket } from 'ws';
-import { randomUUID } from 'crypto';
-
-function formatJSON(jsonString) {
-  try {
-    const jsonObj = JSON.parse(jsonString);
-    return JSON.stringify(jsonObj, null, 2);
-  } catch (error) {
-    return `Error parsing JSON: ${error}`;
-  }
-}
-
-//List Message
-// {
-//     "type": "list",
-//     "data": {
-//       "clients": [
-//         {
-//           "id": "9143a10c-5b4f-11ef-bb3a-2250bcde1118",
-//           "name": "TestAgent",
-//           "description": "A Broker Testing Agent"
-//         }
-//       ]
-//     }
-//   }
-
-class IBroker extends EventEmitter {
-  constructor(url, name) {
-    super();
-    this.url = url;
-    this.name = name;
-    this.uuid = null; //public id for the broker
-    this.key = null; //private id for the broker
-    this.queryPending = null; //used for Syncronous queries, disables forwarding to onMessage
-    this.ws = new WebSocket(url);
-
-    this.ws.on('open', () => {
-      this.emit('open');
-      console.log(`Connected to ${this.url}`);
-    });
-
-    this.ws.on('message', (data) => {
-      let msg = JSON.parse(data);
-
-      //Emit messages to listeners
-      if (msg.type != this.queryPending) {
-        //A syncronous query is pending
-        this.emit('message', data);
-      } else {
-        // Emit synQuery to listener, to proces event
-        this.queryPending = null;
-        this.emit('syncQuery', data);
-      }
-
-      // console.log('Received:', data);
-    });
-
-    this.ws.on('error', (error) => {
-      this.emit('error', error);
-      console.error('WebSocket error:', error);
-    });
-
-    this.ws.on('close', () => {
-      this.emit('close');
-      console.log('Disconnected from the server');
-    });
-  }
-
-  getConnectedAgents() {
-    return new Promise((resolve, reject) => {
-      // Set the query pending to list
-      this.queryPending = 'list';
-
-      // Set up a timeout to reject if no response is received in 10 seconds
-      const timeout = setTimeout(() => {
-        reject(new Error('Get Connected Agents timed out after 10 seconds'));
-      }, 10000);
-
-      const handleListRequest = (data) => {
-        const msg = JSON.parse(data);
-
-        if (msg.type === 'list') {
-          clearTimeout(timeout);
-          this.off('syncQuery', handleListRequest);
-          resolve(msg.data.clients);
-        }
-      };
-
-      const jsonObject = BrokerMessageBuilder.list();
-      this.send(jsonObject);
-      // console.log("Requested List of Agents");
-      this.on('syncQuery', handleListRequest);
-    });
-  }
-
-  send(message) {
-    // console.log("WS Ready State: ", this.ws.readyState)
-    // console.log("WS OPEN: ", WebSocket.OPEN)
-    if (this.ws.readyState === WebSocket.OPEN) {
-      // console.log("Sending: ", JSON.stringify(message, null, 2));
-      this.ws.send(message);
-      // console.log(`Sending message to ${this.url}: ${message}`);
-    } else {
-      // console.log('WebSocket is not open.');
-    }
-  }
-}
-
-let brokers = new Map();
-
-export const Broker = {
-  addBroker: function (url, name = 'default') {
-    if (!brokers.has(name)) {
-      let broker = new IBroker(url, name);
-      brokers.set(name, broker);
-    } else {
-      console.log(`Broker ${name} already exists.`);
-    }
-  },
-
-  disconnect: function (name = 'default') {
-    let broker = brokers.get(name);
-    if (broker) {
-      broker.ws.close();
-    } else {
-      console.error(`Broker ${name} not found`);
-    }
-  },
-
-  deleteBroker: function (name = 'default') {
-    let broker = brokers.get(name);
-    if (broker) {
-      broker.ws.close();
-      brokers.delete(name);
-    } else {
-      console.error(`Broker ${name} not found`);
-    }
-  },
-
-  send: function (message, brokerName = 'default') {
-    let broker = brokers.get(brokerName);
-    if (broker) {
-      broker.send(message);
-    } else {
-      console.error(`Broker ${brokerName} not found`);
-    }
-  },
-
-  addEventListener: function (event, listener, brokerName = 'default') {
-    let broker = brokers.get(brokerName);
-    if (broker) {
-      broker.on(event, listener);
-    } else {
-      console.error(`Broker ${brokerName} not found`);
-    }
-  },
-
-  removeEventListener: function (event, listener, brokerName = 'default') {
-    let broker = brokers.get(brokerName);
-    if (broker) {
-      broker.off(event, listener);
-    } else {
-      console.error(`Broker ${brokerName} not found`);
-    }
-  },
-
-  removeAllListeners: function (brokerName = 'default') {
-    let broker = brokers.get(brokerName);
-    if (broker) {
-      broker.removeAllListeners();
-    } else {
-      console.error(`Broker ${brokerName} not found`);
-    }
-  },
-
-  getBroker: function (brokerName = 'default') {
-    return brokers.get(brokerName);
-  }
-};
-
-//Need to add a message that will return a list of agents connected
-//  for a specific name/type
-export const BrokerMessageBuilder = {
-  create_message: function (type, data) {
-    return JSON.stringify({
-      type: type,
-      data: data
-    });
-  },
-  message: function (to, data) {
-    return BrokerMessageBuilder.create_message('sendmessage', {
-      peer: to,
-      data: data
-    });
-  },
-  setup: function (name, description, limit, uuid) {
-    return BrokerMessageBuilder.create_message('setup', {
-      name: name,
-      description: description,
-      limit: limit,
-      key: uuid
-    });
-  },
-  suspend: function () {
-    return BrokerMessageBuilder.create_message('suspend', {});
-  },
-  finish: function () {
-    return BrokerMessageBuilder.create_message('finish', {});
-  },
-  list: function () {
-    return BrokerMessageBuilder.create_message('list', {});
-  }
-};

package/index.js

@@ -1,370 +0,0 @@
-import path from 'path';
-import fs from 'fs';
-// import { promises as fsPromises } from 'fs';
-import { fileURLToPath } from 'url';
-import { exec, execSync, spawn } from 'child_process';
-import { Broker, BrokerMessageBuilder } from './broker.js';
-import { IPCManager, IPCMessageBuilder } from './ipc.js';
-import { createRequire } from 'module'; // Import createRequire to use require in ES Modules
-
-// Create a require function scoped to the current module
-const require = createRequire(import.meta.url);
-
-function resolveKadiExecPath() {
-  const command = process.platform === 'win32' ? 'where kadi' : 'which kadi';
-
-  try {
-    const kadiPath = execSync(command, { encoding: 'utf8' }).trim();
-    if (kadiPath) {
-      return kadiPath;
-    } else {
-      throw new Error('Kadi CLI tool not found in the system PATH');
-    }
-  } catch (error) {
-    console.error('Error resolving Kadi path:', error);
-    return null;
-  }
-}
-
-function resolveKadiInstallPath() {
-  try {
-    // Step 1: Get the path to the kadi binary
-    const command = process.platform === 'win32' ? 'where kadi' : 'which kadi';
-    const kadiBinaryPath = execSync(command, { encoding: 'utf8' }).trim();
-
-    if (!kadiBinaryPath) {
-      throw new Error('Kadi CLI tool not found in the system PATH');
-    }
-    // console.log('Resolved Kadi binary path:', kadiBinaryPath);
-
-    // Step 2: Resolve the symlink to find the actual location of the binary
-    const resolvedBinaryPath = fs.realpathSync(kadiBinaryPath);
-    // console.log('Resolved binary real path:', resolvedBinaryPath);
-
-    // Step 3: Correctly determine the root directory of the kadi package
-    const kadiDir = path.dirname(resolvedBinaryPath); // Move up one level to get the kadi directory
-    // console.log('Kadi directory:', kadiDir);
-
-    // Step 4: Verify if this directory contains the kadi package.json
-    const packageJsonPath = path.join(kadiDir, 'package.json');
-    // console.log('Checking for package.json at:', packageJsonPath);
-
-    if (fs.existsSync(packageJsonPath)) {
-      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-
-      if (packageJson.name === 'kadi') {
-        // console.log('Kadi package.json found:', packageJsonPath);
-        return kadiDir;
-      } else {
-        throw new Error('Package.json found, but it is not for kadi.');
-      }
-    } else {
-      throw new Error('Kadi package.json not found in the resolved path.');
-    }
-  } catch (error) {
-    console.error('Error resolving Kadi CLI install path:', error);
-    return null;
-  }
-}
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const kadiExecDir = resolveKadiExecPath();
-const kadiRootDir = resolveKadiInstallPath(); //path.join(kadiCLIInstallPath);
-const kadiAgentPath = path.join(kadiRootDir, 'agent.json');
-
-const rootDir = process.cwd();
-const abilitiesDir = path.join(rootDir, 'abilities');
-const projectAgentPath = path.join(rootDir, 'agent.json');
-const kadiCoreAgentPath = path.join(__dirname, 'agent.json');
-
-//Gets the agent.json for the ability, so dependencies can be installed
-export function getAbilityJSON(abilityName, abilityVersion) {
-  //Get the agent.json for the ability
-  let abilityPath = path.join(
-    rootDir,
-    'abilities',
-    abilityName,
-    abilityVersion,
-    'agent.json'
-  );
-  let abilityJSON = fs.readFileSync(abilityPath, 'utf8');
-  abilityJSON = JSON.parse(abilityJSON);
-  return abilityJSON;
-}
-
-//Gets the file path for the ability agent.json
-export function getAbilityJSONPath(abilityName, abilityVersion) {
-  return path.join(
-    rootDir,
-    'abilities',
-    abilityName,
-    abilityVersion,
-    'agent.json'
-  );
-}
-
-//Gets the abilities directory
-export function getAbilitiesDir() {
-  return abilitiesDir;
-}
-
-//Gets the agent.json for the ability, so dependencies can be installed
-export function getProjectJSON() {
-  //Get the agent.json for kadi
-  let projectJSON = fs.readFileSync(projectAgentPath, 'utf8');
-  projectJSON = JSON.parse(projectJSON);
-  return projectJSON;
-}
-
-//Get the file path for the project agent.json
-export function getProjectJSONPath() {
-  return projectAgentPath;
-}
-
-//Get Kadi Core agent.json
-export function getKadiCoreJSON() {
-  //Get the agent.json for kadi
-  let kadiCoreJSON = fs.readFileSync(kadiCoreAgentPath, 'utf8');
-  kadiCoreJSON = JSON.parse(kadiCoreJSON);
-  return kadiCoreJSON;
-}
-
-//Get the file path for the KADI Core Agent.json
-export function getKadiCoreJSONPath() {
-  return kadiCoreAgentPath;
-}
-
-//Gets the agent.json for KADI system
-export function getKadiJSON() {
-  //Get the agent.json for kadi
-  let kadiJSON = fs.readFileSync(kadiAgentPath, 'utf8');
-  kadiJSON = JSON.parse(kadiJSON);
-  return kadiJSON;
-}
-
-//Gets the file path for the KADI Agent.json
-export function getKadiJSONPath() {
-  return kadiAgentPath;
-}
-
-//Get the exec path of the KADI system
-export function getKadiExecPath() {
-  return kadiExecDir;
-}
-
-//Get the Install directory of KADI system
-export function getKadiInstallPath() {
-  return kadiRootDir;
-}
-
-//Save agent.json file
-export async function saveAgentJSON(agentJSON, agentJSONPath) {
-  // Convert the JSON object to a string with pretty-print formatting
-  const jsonString = JSON.stringify(agentJSON, null, 2);
-
-  // Write the JSON string to the specified file
-  fs.writeFile(agentJSONPath, jsonString, 'utf8', (err) => {
-    if (err) {
-      console.error('Error saving JSON to file:', err);
-    }
-    // else {
-    //     console.log('JSON saved successfully to', filePath);
-    // }
-  });
-}
-
-export function getAbilityVersionFromArray(abilities, name) {
-  const ability = abilities.find((ability) => ability.name === name);
-  if (ability) {
-    return ability.version;
-  } else {
-    return null;
-  }
-}
-
-// Get the API URL from the agent.json
-let kadijson = getKadiJSON();
-
-// Define the API URL (Adjust according to your API)
-export const KADI_API_URL = kadijson.api;
-export const SEARCH_API_URL = kadijson.api + '/search';
-export const GET_API_URL = kadijson.api + '/get';
-
-// Export all broker URLs
-const brokers = {};
-for (const [name, url] of Object.entries(kadijson.brokers)) {
-  const brokerUrl = new URL(url);
-  brokers[name] =
-    `${brokerUrl.hostname}:${brokerUrl.port}${brokerUrl.pathname}`;
-}
-
-export const KADI_BROKERS = brokers;
-
-// Get default broker (first one defined)
-const defaultBrokerName = Object.keys(kadijson.brokers)[0];
-export const KADI_BROKER_URL = brokers[defaultBrokerName]; // Backward compatibility
-
-// Utility functions
-export function getBrokerUrl(brokerName) {
-  return brokers[brokerName] || null;
-}
-
-export function getBrokerNames() {
-  return Object.keys(brokers);
-}
-
-export function getDefaultBrokerName() {
-  return defaultBrokerName;
-}
-
-// Active broker selection
-let activeBrokerName = defaultBrokerName;
-
-export function setActiveBroker(brokerName) {
-  if (brokers[brokerName]) {
-    activeBrokerName = brokerName;
-    return true;
-  }
-  return false;
-}
-
-export function getActiveBrokerName() {
-  return activeBrokerName;
-}
-
-export function getActiveBrokerUrl() {
-  return brokers[activeBrokerName];
-}
-
-//Runs a command line string, used for abilities init functions
-export async function runExecCommand(name, version, command) {
-  let execDirectory;
-  if (name === '' || version === '') {
-    execDirectory = path.join(rootDir);
-  } else {
-    execDirectory = path.join(rootDir, 'abilities', name, version);
-  }
-  console.log('execDirectory: ', execDirectory);
-  return new Promise((resolve, reject) => {
-    exec(
-      command,
-      { cwd: execDirectory, maxBuffer: 1024 * 1024 },
-      (error, stdout, stderr) => {
-        if (error) {
-          console.error(`exec error: ${error}`);
-          reject(error); // Reject the promise on error
-          return;
-        }
-        if (stderr.trim()) {
-          console.error(stderr);
-        }
-        resolve(stdout.trim()); // Resolve the promise when exec completes successfully
-      }
-    );
-  });
-}
-
-export async function runSpawnCommand(name, version, command) {
-  let execDirectory;
-  if (name === '' || version === '') {
-    execDirectory = path.join(rootDir);
-  } else {
-    execDirectory = path.join(rootDir, 'abilities', name, version);
-  }
-  console.log('execDirectory: ', execDirectory);
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, {
-      cwd: execDirectory,
-      stdio: 'inherit', // This pipes the child process's stdio to the parent
-      shell: true // This ensures that the command is run within a shell
-    });
-
-    child.on('error', (error) => {
-      console.error(`Error: ${error}`);
-      reject(error);
-    });
-
-    child.on('close', (code) => {
-      if (code !== 0) {
-        console.error(`Process exited with code: ${code}`);
-        reject(new Error(`Process exited with code: ${code}`));
-      } else {
-        resolve();
-      }
-    });
-  });
-}
-
-// Function to find the version of an ability by name
-export function findAbilityVersionByName(abilities, name) {
-  const ability = abilities.find((ability) => ability.name === name);
-  if (ability) {
-    return ability.version;
-  } else {
-    return 'No ability found with the specified name.';
-  }
-}
-
-export async function loadAbility(abilityName) {
-  let agentJSON = await getProjectJSON();
-  let abilityConfig = agentJSON.abilities.find(
-    (ability) => ability.name === abilityName
-  );
-  if (!abilityConfig) {
-    //   throw new Error(`Ability ${abilityName} not found in configuration`);
-    console.error(`Ability ${abilityName} not found in Project configuration`);
-    const filePath = __filename;
-    console.log('filePath:', filePath);
-    // Extract the directory path of the file
-    const dirPath = path.dirname(filePath);
-    console.log(' dirPath:', dirPath);
-
-    // Split the directory path into an array of directories
-    const pathParts = dirPath.split(path.sep);
-
-    // Find the index of the "abilities" folder
-    const abilitiesIndex = pathParts.indexOf('abilities');
-
-    // Ensure that the folder above 'phone-ability' is 'abilities'
-    if (abilitiesIndex !== -1 && pathParts.length > abilitiesIndex + 2) {
-      const ability = pathParts[abilitiesIndex + 1]; // Extract 'phone-ability'
-      const version = pathParts[abilitiesIndex + 2]; // Extract '0.0.1'
-
-      console.log('Loading ability dependency from an ability');
-      agentJSON = await getAbilityJSON(ability, version);
-      abilityConfig = agentJSON.abilities.find(
-        (ability) => ability.name === abilityName
-      );
-      if (!abilityConfig) {
-        throw new Error(
-          `Ability ${abilityName} not found in ${ability} : ${version} configuration`
-        );
-      }
-    } else {
-      throw new Error('Ability not found in Project agent.json');
-    }
-  }
-  const moduleJSON = getAbilityJSON(abilityName, abilityConfig.version);
-  const modulePath = path.join(
-    rootDir,
-    `abilities/${abilityName}/${abilityConfig.version}/${moduleJSON.entry}`
-  );
-  const module = await import(modulePath);
-  return module.default || module; // Return the default export directly
-}
-
-export async function launchAbility(language, path = '') {}
-
-export { Broker };
-
-export { BrokerMessageBuilder };
-
-export { IPCManager };
-
-export { IPCMessageBuilder };
-
-//Load the IPC interfaces
-let kadiCoreJSON = getKadiCoreJSON();
-IPCManager.setIPCInterfaces(kadiCoreJSON.IPCInterfaces);