gopher-orch 0.1.0-20260131-081911

package/dist/result.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentResultBuilder = exports.AgentResult = exports.AgentResultStatus = void 0;
+/**
+ * Status of agent query execution.
+ */
+var AgentResultStatus;
+(function (AgentResultStatus) {
+    AgentResultStatus["SUCCESS"] = "success";
+    AgentResultStatus["ERROR"] = "error";
+    AgentResultStatus["TIMEOUT"] = "timeout";
+})(AgentResultStatus || (exports.AgentResultStatus = AgentResultStatus = {}));
+/**
+ * Result from agent query execution.
+ */
+class AgentResult {
+    response;
+    status;
+    iterationCount;
+    tokensUsed;
+    constructor(options) {
+        this.response = options.response;
+        this.status = options.status;
+        this.iterationCount = options.iterationCount;
+        this.tokensUsed = options.tokensUsed;
+    }
+    /**
+     * Check if the result is a success.
+     */
+    isSuccess() {
+        return this.status === AgentResultStatus.SUCCESS;
+    }
+    /**
+     * Create a new builder for AgentResult.
+     */
+    static builder() {
+        return new AgentResultBuilder();
+    }
+    /**
+     * Create a success result.
+     */
+    static success(response) {
+        return AgentResult.builder()
+            .response(response)
+            .status(AgentResultStatus.SUCCESS)
+            .build();
+    }
+    /**
+     * Create an error result.
+     */
+    static error(message) {
+        return AgentResult.builder()
+            .response(message)
+            .status(AgentResultStatus.ERROR)
+            .build();
+    }
+    /**
+     * Create a timeout result.
+     */
+    static timeout(message) {
+        return AgentResult.builder()
+            .response(message)
+            .status(AgentResultStatus.TIMEOUT)
+            .build();
+    }
+    /**
+     * String representation of the result.
+     */
+    toString() {
+        return `AgentResult{response='${this.response}', status=${this.status}, iterationCount=${this.iterationCount}, tokensUsed=${this.tokensUsed}}`;
+    }
+}
+exports.AgentResult = AgentResult;
+/**
+ * Builder for AgentResult.
+ */
+class AgentResultBuilder {
+    _response;
+    _status;
+    _iterationCount;
+    _tokensUsed;
+    /**
+     * Set the response.
+     */
+    response(response) {
+        this._response = response;
+        return this;
+    }
+    /**
+     * Set the status.
+     */
+    status(status) {
+        this._status = status;
+        return this;
+    }
+    /**
+     * Set the iteration count.
+     */
+    iterationCount(iterationCount) {
+        this._iterationCount = iterationCount;
+        return this;
+    }
+    /**
+     * Set the tokens used.
+     */
+    tokensUsed(tokensUsed) {
+        this._tokensUsed = tokensUsed;
+        return this;
+    }
+    /**
+     * Build the AgentResult.
+     */
+    build() {
+        if (this._response === undefined) {
+            throw new Error('Response is required');
+        }
+        if (this._status === undefined) {
+            throw new Error('Status is required');
+        }
+        return new AgentResult({
+            response: this._response,
+            status: this._status,
+            iterationCount: this._iterationCount,
+            tokensUsed: this._tokensUsed,
+        });
+    }
+}
+exports.AgentResultBuilder = AgentResultBuilder;
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"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"}

package/dist/serverConfig.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Utility class for fetching server configurations.
+ */
+/**
+ * Utility functions for fetching server configurations.
+ */
+export declare const ServerConfig: {
+    /**
+     * Fetch MCP server configurations from remote API.
+     *
+     * @param apiKey API key for authentication
+     * @returns Server configuration JSON string
+     * @throws {ApiKeyError} if API key is invalid or missing
+     * @throws {AgentError} if fetch fails
+     */
+    fetch(apiKey: string): string;
+};
+//# sourceMappingURL=serverConfig.d.ts.map

package/dist/serverConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverConfig.d.ts","sourceRoot":"","sources":["../src/serverConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;;;;;;OAOG;kBACW,MAAM,GAAG,MAAM;CA2B9B,CAAC"}

package/dist/serverConfig.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Utility class for fetching server configurations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerConfig = void 0;
+const agent_1 = require("./agent");
+const errors_1 = require("./errors");
+const ffi_1 = require("./ffi");
+/**
+ * Utility functions for fetching server configurations.
+ */
+exports.ServerConfig = {
+    /**
+     * Fetch MCP server configurations from remote API.
+     *
+     * @param apiKey API key for authentication
+     * @returns Server configuration JSON string
+     * @throws {ApiKeyError} if API key is invalid or missing
+     * @throws {AgentError} if fetch fails
+     */
+    fetch(apiKey) {
+        if (!agent_1.GopherAgent.isInitialized()) {
+            agent_1.GopherAgent.init();
+        }
+        if (!apiKey || apiKey.trim() === '') {
+            throw new errors_1.ApiKeyError('Invalid or missing API key');
+        }
+        const lib = ffi_1.GopherOrchLibrary.getInstance();
+        if (lib === null) {
+            throw new errors_1.AgentError('Native library not available');
+        }
+        try {
+            const result = lib.apiFetchServers(apiKey);
+            if (result === null) {
+                throw new errors_1.AgentError('Failed to fetch servers: no response');
+            }
+            return result;
+        }
+        catch (e) {
+            if (e instanceof errors_1.ApiKeyError) {
+                throw e;
+            }
+            throw new errors_1.AgentError(`Failed to fetch servers: ${e.message}`);
+        }
+    },
+};
+//# sourceMappingURL=serverConfig.js.map

package/dist/serverConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverConfig.js","sourceRoot":"","sources":["../src/serverConfig.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAAsC;AACtC,qCAAmD;AACnD,+BAA0C;AAE1C;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B;;;;;;;OAOG;IACH,KAAK,CAAC,MAAc;QAClB,IAAI,CAAC,mBAAW,CAAC,aAAa,EAAE,EAAE,CAAC;YACjC,mBAAW,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,oBAAW,CAAC,4BAA4B,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,GAAG,GAAG,uBAAiB,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,mBAAU,CAAC,8BAA8B,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,IAAI,mBAAU,CAAC,sCAAsC,CAAC,CAAC;YAC/D,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,oBAAW,EAAE,CAAC;gBAC7B,MAAM,CAAC,CAAC;YACV,CAAC;YACD,MAAM,IAAI,mBAAU,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "gopher-orch",
+  "version": "0.1.0-20260131-081911",
+  "description": "TypeScript SDK for Gopher Orch - AI Agent orchestration framework with native performance",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "author": "Gopher Security <dev@gophersecurity.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GopherSecurity/gopher-mcp-js.git"
+  },
+  "keywords": [
+    "gopher",
+    "mcp",
+    "ai",
+    "agent",
+    "orchestration",
+    "llm",
+    "ffi"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "example": "tsx examples/client_example_json.ts",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write 'src/**/*.ts' 'tests/**/*.ts' 'examples/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.ts' 'examples/**/*.ts'",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/download-native.js || true"
+  },
+  "dependencies": {
+    "koffi": "^2.9.0"
+  },
+  "optionalDependencies": {
+    "@gopher-test/gopher-orch-darwin-arm64": "0.1.0",
+    "@gopher-test/gopher-orch-darwin-x64": "0.1.0",
+    "@gopher-test/gopher-orch-linux-arm64": "0.1.0",
+    "@gopher-test/gopher-orch-linux-x64": "0.1.0",
+    "@gopher-test/gopher-orch-win32-arm64": "0.1.0",
+    "@gopher-test/gopher-orch-win32-x64": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.6",
+    "@typescript-eslint/eslint-plugin": "^6.16.0",
+    "@typescript-eslint/parser": "^6.16.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.1.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist",
+    "native/lib",
+    "scripts"
+  ]
+}

package/scripts/download-native.js

@@ -0,0 +1,328 @@
+#!/usr/bin/env node
+
+/**
+ * Download native gopher-orch library as a fallback when optional
+ * dependency packages aren't available.
+ *
+ * This script is run during postinstall to ensure the native library
+ * is available even if:
+ * - The user's platform package wasn't installed
+ * - The user ran npm install with --ignore-scripts initially
+ * - The optional dependencies failed to install
+ *
+ * Usage:
+ *   node scripts/download-native.js [--version <version>] [--force]
+ */
+
+const https = require('https');
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// Configuration
+const GITHUB_REPO = 'GopherSecurity/gopher-orch';
+const DEFAULT_VERSION = 'latest';
+
+// Platform mappings
+const PLATFORM_MAP = {
+  darwin: { name: 'macos', ext: 'tar.gz', lib: 'libgopher-orch.dylib' },
+  linux: { name: 'linux', ext: 'tar.gz', lib: 'libgopher-orch.so' },
+  win32: { name: 'windows', ext: 'zip', lib: 'gopher-orch.dll' },
+};
+
+const ARCH_MAP = {
+  arm64: 'arm64',
+  x64: 'x64',
+  x86_64: 'x64',
+};
+
+/**
+ * Get the platform-specific package name
+ */
+function getPlatformPackageName() {
+  const platform = os.platform();
+  const arch = os.arch();
+  const archName = ARCH_MAP[arch] || arch;
+
+  const platformName =
+    platform === 'darwin' ? 'darwin' : platform === 'win32' ? 'win32' : 'linux';
+
+  return `gopher-orch-${platformName}-${archName}`;
+}
+
+/**
+ * Check if the platform package is already installed
+ */
+function isPlatformPackageInstalled() {
+  const packageName = getPlatformPackageName();
+  try {
+    require.resolve(`${packageName}/package.json`);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if the native library already exists locally
+ */
+function isLibraryInstalled() {
+  const platform = os.platform();
+  const platformInfo = PLATFORM_MAP[platform];
+  if (!platformInfo) return false;
+
+  const libPath = path.join(__dirname, '..', 'native', 'lib', platformInfo.lib);
+  return fs.existsSync(libPath);
+}
+
+/**
+ * Get the download URL for the current platform
+ */
+function getDownloadUrl(version) {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const platformInfo = PLATFORM_MAP[platform];
+  const archName = ARCH_MAP[arch] || arch;
+
+  if (!platformInfo) {
+    throw new Error(`Unsupported platform: ${platform}`);
+  }
+
+  const filename = `libgopher-orch-${platformInfo.name}-${archName}.${platformInfo.ext}`;
+
+  if (version === 'latest') {
+    return `https://github.com/${GITHUB_REPO}/releases/latest/download/${filename}`;
+  }
+  return `https://github.com/${GITHUB_REPO}/releases/download/${version}/${filename}`;
+}
+
+/**
+ * Follow redirects and download a file
+ */
+function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(destPath);
+    const protocol = url.startsWith('https') ? https : http;
+
+    const request = protocol.get(url, (response) => {
+      // Handle redirects
+      if (response.statusCode === 301 || response.statusCode === 302) {
+        file.close();
+        fs.unlinkSync(destPath);
+        return downloadFile(response.headers.location, destPath)
+          .then(resolve)
+          .catch(reject);
+      }
+
+      if (response.statusCode !== 200) {
+        file.close();
+        fs.unlinkSync(destPath);
+        reject(new Error(`Download failed with status ${response.statusCode}`));
+        return;
+      }
+
+      response.pipe(file);
+
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    });
+
+    request.on('error', (err) => {
+      file.close();
+      fs.unlink(destPath, () => {});
+      reject(err);
+    });
+
+    file.on('error', (err) => {
+      file.close();
+      fs.unlink(destPath, () => {});
+      reject(err);
+    });
+  });
+}
+
+/**
+ * Extract the archive based on extension
+ */
+function extractArchive(archivePath, destDir) {
+  const ext = path.extname(archivePath);
+
+  if (ext === '.gz' && archivePath.endsWith('.tar.gz')) {
+    // tar.gz
+    execSync(`tar -xzf "${archivePath}" -C "${destDir}"`, { stdio: 'inherit' });
+  } else if (ext === '.zip') {
+    // zip
+    execSync(`unzip -o "${archivePath}" -d "${destDir}"`, { stdio: 'inherit' });
+  } else {
+    throw new Error(`Unknown archive format: ${ext}`);
+  }
+}
+
+/**
+ * Main download function
+ */
+async function downloadNative(options = {}) {
+  const { version = DEFAULT_VERSION, force = false } = options;
+
+  console.log('gopher-orch native library installer');
+  console.log('====================================');
+  console.log(`Platform: ${os.platform()} ${os.arch()}`);
+  console.log(`Version: ${version}`);
+  console.log();
+
+  // Check if platform package is already installed
+  if (!force && isPlatformPackageInstalled()) {
+    console.log(
+      '✓ Platform-specific package is already installed via npm optional dependencies'
+    );
+    console.log('  No download needed.');
+    return;
+  }
+
+  // Check if library already exists
+  if (!force && isLibraryInstalled()) {
+    console.log('✓ Native library already exists in native/lib/');
+    console.log('  Use --force to re-download.');
+    return;
+  }
+
+  const platform = os.platform();
+  const platformInfo = PLATFORM_MAP[platform];
+
+  if (!platformInfo) {
+    console.error(`✗ Unsupported platform: ${platform}`);
+    console.error(
+      '  Supported platforms: darwin (macOS), linux, win32 (Windows)'
+    );
+    process.exit(1);
+  }
+
+  // Create directories
+  const nativeLibDir = path.join(__dirname, '..', 'native', 'lib');
+  const tempDir = path.join(os.tmpdir(), 'gopher-orch-download');
+
+  fs.mkdirSync(nativeLibDir, { recursive: true });
+  fs.mkdirSync(tempDir, { recursive: true });
+
+  try {
+    // Download
+    const url = getDownloadUrl(version);
+    const archiveName = `gopher-orch.${platformInfo.ext}`;
+    const archivePath = path.join(tempDir, archiveName);
+
+    console.log(`Downloading from: ${url}`);
+    await downloadFile(url, archivePath);
+    console.log('✓ Download complete');
+
+    // Extract
+    console.log('Extracting archive...');
+    const extractDir = path.join(tempDir, 'extracted');
+    fs.mkdirSync(extractDir, { recursive: true });
+    extractArchive(archivePath, extractDir);
+    console.log('✓ Extraction complete');
+
+    // Find and copy library file
+    const libName = platformInfo.lib;
+    let libFound = false;
+
+    // Look for the library in various locations
+    const searchPaths = [
+      path.join(extractDir, libName),
+      path.join(extractDir, 'lib', libName),
+    ];
+
+    // Also search for versioned libraries (e.g., libgopher-orch.so.0.1.0)
+    const files = fs.readdirSync(extractDir);
+    for (const file of files) {
+      if (file.startsWith(libName.replace(/\.[^.]+$/, ''))) {
+        searchPaths.push(path.join(extractDir, file));
+      }
+    }
+
+    // Check lib subdirectory too
+    const libDir = path.join(extractDir, 'lib');
+    if (fs.existsSync(libDir)) {
+      const libFiles = fs.readdirSync(libDir);
+      for (const file of libFiles) {
+        if (file.startsWith(libName.replace(/\.[^.]+$/, ''))) {
+          searchPaths.push(path.join(libDir, file));
+        }
+      }
+    }
+
+    for (const srcPath of searchPaths) {
+      if (fs.existsSync(srcPath) && fs.statSync(srcPath).isFile()) {
+        const destPath = path.join(nativeLibDir, path.basename(srcPath));
+        fs.copyFileSync(srcPath, destPath);
+        console.log(`✓ Installed: ${path.basename(srcPath)}`);
+        libFound = true;
+
+        // Create symlink for versioned libraries
+        if (platform !== 'win32' && srcPath !== path.join(extractDir, libName)) {
+          const symlinkPath = path.join(nativeLibDir, libName);
+          if (fs.existsSync(symlinkPath)) {
+            fs.unlinkSync(symlinkPath);
+          }
+          fs.symlinkSync(path.basename(srcPath), symlinkPath);
+          console.log(`✓ Created symlink: ${libName}`);
+        }
+      }
+    }
+
+    if (!libFound) {
+      throw new Error(`Library file not found in archive: ${libName}`);
+    }
+
+    console.log();
+    console.log('✓ Installation complete!');
+    console.log(`  Library installed to: ${nativeLibDir}`);
+  } finally {
+    // Cleanup temp directory
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+
+// Parse command line arguments
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const options = {
+    version: DEFAULT_VERSION,
+    force: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--version' || args[i] === '-v') {
+      options.version = args[++i];
+    } else if (args[i] === '--force' || args[i] === '-f') {
+      options.force = true;
+    } else if (args[i] === '--help' || args[i] === '-h') {
+      console.log('Usage: download-native.js [options]');
+      console.log();
+      console.log('Options:');
+      console.log(
+        '  --version, -v <version>  gopher-orch version (default: latest)'
+      );
+      console.log('  --force, -f              Force re-download');
+      console.log('  --help, -h               Show this help');
+      process.exit(0);
+    }
+  }
+
+  return options;
+}
+
+// Run if called directly
+if (require.main === module) {
+  const options = parseArgs();
+  downloadNative(options).catch((err) => {
+    console.error('Error:', err.message);
+    process.exit(1);
+  });
+}
+
+module.exports = { downloadNative };