@kadi.build/core 0.0.1-alpha.3 → 0.0.1-alpha.4

package/dist/utils/logger.d.ts

@@ -0,0 +1,59 @@
+import { Debugger } from 'debug';
+export interface KadiLogger extends Debugger {
+    trace: Debugger;
+    error: Debugger;
+    lifecycle: Debugger;
+    protocol: Debugger;
+    transport: Debugger;
+    info: Debugger;
+    warn: Debugger;
+    debug: Debugger;
+}
+export declare const loggers: {
+    main: KadiLogger | null;
+    ability: KadiLogger | null;
+    broker: KadiLogger | null;
+    ipc: KadiLogger | null;
+    transport: KadiLogger | null;
+    rpc: KadiLogger | null;
+};
+/**
+ * Creates a namespaced logger with sub-loggers for different concerns
+ * @param namespace - The logger namespace (e.g., 'ability', 'broker')
+ * @returns A logger instance with specialized sub-loggers
+ */
+export declare function createLogger(namespace: string): KadiLogger;
+/**
+ * Creates a logger for a specific component within a namespace
+ */
+export declare function createComponentLogger(component: string): KadiLogger;
+/**
+ * Checks if debug is enabled for a namespace
+ */
+export declare function isDebugEnabled(namespace: string): boolean;
+/**
+ * Format an object for logging
+ */
+export declare function formatObject(obj: any, label?: string): string;
+/**
+ * Create a child logger with additional context
+ */
+export declare function createChildLogger(parentLogger: KadiLogger, context: string): KadiLogger;
+export declare function isKadiLogger(obj: unknown): obj is KadiLogger;
+declare const _default: {
+    loggers: {
+        main: KadiLogger | null;
+        ability: KadiLogger | null;
+        broker: KadiLogger | null;
+        ipc: KadiLogger | null;
+        transport: KadiLogger | null;
+        rpc: KadiLogger | null;
+    };
+    createLogger: typeof createLogger;
+    createComponentLogger: typeof createComponentLogger;
+    isDebugEnabled: typeof isDebugEnabled;
+    formatObject: typeof formatObject;
+    createChildLogger: typeof createChildLogger;
+};
+export default _default;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAA0B,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIpD,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,QAAQ,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;CACjB;AAMD,eAAO,MAAM,OAAO;UACJ,UAAU,GAAG,IAAI;aACd,UAAU,GAAG,IAAI;YAClB,UAAU,GAAG,IAAI;SACpB,UAAU,GAAG,IAAI;eACX,UAAU,GAAG,IAAI;SACvB,UAAU,GAAG,IAAI;CAC/B,CAAC;AAYF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAwC1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAEnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAazD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM,CAKjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE,MAAM,GACd,UAAU,CAGZ;AAGD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAQ5D;;;cAxHe,UAAU,GAAG,IAAI;iBACd,UAAU,GAAG,IAAI;gBAClB,UAAU,GAAG,IAAI;aACpB,UAAU,GAAG,IAAI;mBACX,UAAU,GAAG,IAAI;aACvB,UAAU,GAAG,IAAI;;;;;;;;AAyHhC,wBAOE"}

package/dist/utils/logger.js

@@ -0,0 +1,122 @@
+import createDebugLogger from 'debug';
+import chalk from 'chalk';
+// Typed logger storage
+const loggerCache = new Map();
+// Pre-configured loggers for backward compatibility
+export const loggers = {
+    main: null,
+    ability: null,
+    broker: null,
+    ipc: null,
+    transport: null,
+    rpc: null
+};
+// Initialize default loggers
+function initializeDefaultLoggers() {
+    loggers.main = createLogger('main');
+    loggers.ability = createLogger('ability');
+    loggers.broker = createLogger('broker');
+    loggers.ipc = createLogger('ipc');
+    loggers.transport = createLogger('transport');
+    loggers.rpc = createLogger('rpc');
+}
+/**
+ * Creates a namespaced logger with sub-loggers for different concerns
+ * @param namespace - The logger namespace (e.g., 'ability', 'broker')
+ * @returns A logger instance with specialized sub-loggers
+ */
+export function createLogger(namespace) {
+    // Check cache first
+    if (loggerCache.has(namespace)) {
+        return loggerCache.get(namespace);
+    }
+    const baseNamespace = `kadi:${namespace}`;
+    const logger = createDebugLogger(baseNamespace);
+    // Create typed sub-loggers
+    logger.trace = createDebugLogger(`${baseNamespace}:trace`);
+    logger.error = createDebugLogger(`${baseNamespace}:error`);
+    logger.lifecycle = createDebugLogger(`${baseNamespace}:lifecycle`);
+    logger.protocol = createDebugLogger(`${baseNamespace}:protocol`);
+    logger.transport = createDebugLogger(`${baseNamespace}:transport`);
+    logger.info = createDebugLogger(`${baseNamespace}:info`);
+    logger.warn = createDebugLogger(`${baseNamespace}:warn`);
+    logger.debug = createDebugLogger(`${baseNamespace}:debug`);
+    // Add colored output for different log levels
+    const originalError = logger.error;
+    logger.error = ((message, ...args) => {
+        if (process.stdout.isTTY) {
+            originalError(chalk.red(message), ...args);
+        }
+        else {
+            originalError(message, ...args);
+        }
+    });
+    const originalWarn = logger.warn;
+    logger.warn = ((message, ...args) => {
+        if (process.stdout.isTTY) {
+            originalWarn(chalk.yellow(message), ...args);
+        }
+        else {
+            originalWarn(message, ...args);
+        }
+    });
+    loggerCache.set(namespace, logger);
+    return logger;
+}
+/**
+ * Creates a logger for a specific component within a namespace
+ */
+export function createComponentLogger(component) {
+    return createLogger(component);
+}
+/**
+ * Checks if debug is enabled for a namespace
+ */
+export function isDebugEnabled(namespace) {
+    const debug = process.env.DEBUG || '';
+    // Handle wildcard patterns
+    if (debug.includes('*')) {
+        const patterns = debug.split(',').map((p) => p.trim());
+        return patterns.some((pattern) => {
+            const regex = pattern.replace(/\*/g, '.*');
+            return new RegExp(`^${regex}$`).test(namespace);
+        });
+    }
+    return debug.includes(namespace);
+}
+/**
+ * Format an object for logging
+ */
+export function formatObject(obj, label = '') {
+    if (label) {
+        return `${label}: ${JSON.stringify(obj, null, 2)}`;
+    }
+    return JSON.stringify(obj, null, 2);
+}
+/**
+ * Create a child logger with additional context
+ */
+export function createChildLogger(parentLogger, context) {
+    const namespace = parentLogger.namespace.replace('kadi:', '');
+    return createLogger(`${namespace}:${context}`);
+}
+// Type guard for checking if something is a logger
+export function isKadiLogger(obj) {
+    return (obj !== null &&
+        typeof obj === 'function' &&
+        'trace' in obj &&
+        'error' in obj &&
+        'lifecycle' in obj);
+}
+// Initialize default loggers on module load
+initializeDefaultLoggers();
+// Default export for backward compatibility
+export default {
+    loggers,
+    createLogger,
+    createComponentLogger,
+    isDebugEnabled,
+    formatObject,
+    createChildLogger
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/pathUtils.d.ts

@@ -0,0 +1,48 @@
+export type ValidatedPath = string & {
+    __brand: 'ValidatedPath';
+};
+/**
+ * Resolves the Kadi executable directory path
+ * @returns The directory containing the Kadi executable
+ */
+export declare function resolveKadiExecPath(): string;
+/**
+ * Safely resolves Kadi installation path
+ * @throws {Error} If Kadi installation cannot be found
+ */
+export declare function resolveKadiInstallPath(): string;
+export declare const kadiExecDir: string;
+export declare const kadiRootDir: string;
+export declare const kadiAgentPath: string;
+export declare const rootDir: string;
+export declare const abilitiesDir: string;
+export declare const projectAgentPath: string;
+export declare const kadiCoreAgentPath: string;
+export declare const pathUtils: {
+    /**
+     * Normalizes path for current platform
+     */
+    readonly normalize: (inputPath: string) => string;
+    /**
+     * Checks if path is absolute
+     */
+    readonly isAbsolute: (inputPath: string) => boolean;
+    /**
+     * Safely joins paths
+     */
+    readonly join: (...paths: string[]) => string;
+    /**
+     * Gets directory name from path
+     */
+    readonly dirname: (inputPath: string) => string;
+    /**
+     * Gets base name from path
+     */
+    readonly basename: (inputPath: string, ext?: string) => string;
+    /**
+     * Resolve a path relative to the project root
+     */
+    readonly resolveFromRoot: (...segments: string[]) => string;
+};
+export default pathUtils;
+//# sourceMappingURL=pathUtils.d.ts.map

package/dist/utils/pathUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../src/utils/pathUtils.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAElE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAa5C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CA4C/C;AAaD,eAAO,MAAM,WAAW,QAAwB,CAAC;AACjD,eAAO,MAAM,WAAW,QAA2B,CAAC;AACpD,eAAO,MAAM,aAAa,QAAuC,CAAC;AAElE,eAAO,MAAM,OAAO,QAAgB,CAAC;AACrC,eAAO,MAAM,YAAY,QAAkC,CAAC;AAC5D,eAAO,MAAM,gBAAgB,QAAmC,CAAC;AACjE,eAAO,MAAM,iBAAiB,QAA2C,CAAC;AAG1E,eAAO,MAAM,SAAS;IACpB;;OAEG;oCACkB,MAAM,KAAG,MAAM;IAIpC;;OAEG;qCACmB,MAAM,KAAG,OAAO;IAItC;;OAEG;8BACY,MAAM,EAAE,KAAG,MAAM;IAIhC;;OAEG;kCACgB,MAAM,KAAG,MAAM;IAIlC;;OAEG;mCACiB,MAAM,QAAQ,MAAM,KAAG,MAAM;IAIjD;;OAEG;4CAC0B,MAAM,EAAE,KAAG,MAAM;CAGtC,CAAC;AAEX,eAAe,SAAS,CAAC"}

package/dist/utils/pathUtils.js

@@ -0,0 +1,128 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { execSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Resolves the Kadi executable directory path
+ * @returns The directory containing the Kadi executable
+ */
+export function resolveKadiExecPath() {
+    // Try to find kadi using which command
+    try {
+        const kadiPath = execSync('which kadi', { encoding: 'utf8' }).trim();
+        if (kadiPath) {
+            return path.dirname(kadiPath);
+        }
+    }
+    catch {
+        // which command failed, continue with other methods
+    }
+    // Fallback to process.execPath
+    return path.dirname(process.execPath);
+}
+/**
+ * Safely resolves Kadi installation path
+ * @throws {Error} If Kadi installation cannot be found
+ */
+export function resolveKadiInstallPath() {
+    // Try using npm to find the global kadi installation
+    try {
+        const npmGlobalPath = execSync('npm root -g', { encoding: 'utf8' }).trim();
+        const kadiPath = path.join(npmGlobalPath, 'kadi');
+        if (fs.existsSync(kadiPath)) {
+            return kadiPath;
+        }
+    }
+    catch {
+        // npm command failed, continue with other methods
+    }
+    // Try to find kadi in the path
+    try {
+        const kadiExecutable = execSync('which kadi', { encoding: 'utf8' }).trim();
+        if (kadiExecutable) {
+            // Follow symlinks to get real path
+            const realPath = fs.realpathSync(kadiExecutable);
+            // Go up from bin to find the kadi root
+            let currentPath = path.dirname(realPath);
+            while (currentPath !== path.dirname(currentPath)) {
+                if (fs.existsSync(path.join(currentPath, 'package.json'))) {
+                    try {
+                        const pkg = JSON.parse(fs.readFileSync(path.join(currentPath, 'package.json'), 'utf8'));
+                        if (pkg.name === 'kadi' || pkg.name === '@kadi.build/core') {
+                            return currentPath;
+                        }
+                    }
+                    catch {
+                        // Not a valid package.json, continue searching
+                    }
+                }
+                currentPath = path.dirname(currentPath);
+            }
+        }
+    }
+    catch {
+        // which command failed
+    }
+    // Fallback to current working directory
+    return process.cwd();
+}
+/**
+ * Type guard to validate a path exists
+ */
+function validatePath(pathStr) {
+    if (!fs.existsSync(pathStr)) {
+        throw new Error(`Path does not exist: ${pathStr}`);
+    }
+    return pathStr;
+}
+// Export path constants
+export const kadiExecDir = resolveKadiExecPath();
+export const kadiRootDir = resolveKadiInstallPath();
+export const kadiAgentPath = path.join(kadiRootDir, 'agent.json');
+export const rootDir = process.cwd();
+export const abilitiesDir = path.join(rootDir, 'abilities');
+export const projectAgentPath = path.join(rootDir, 'agent.json');
+export const kadiCoreAgentPath = path.join(__dirname, '..', 'agent.json');
+// Platform-specific path utilities
+export const pathUtils = {
+    /**
+     * Normalizes path for current platform
+     */
+    normalize(inputPath) {
+        return path.normalize(inputPath);
+    },
+    /**
+     * Checks if path is absolute
+     */
+    isAbsolute(inputPath) {
+        return path.isAbsolute(inputPath);
+    },
+    /**
+     * Safely joins paths
+     */
+    join(...paths) {
+        return path.join(...paths);
+    },
+    /**
+     * Gets directory name from path
+     */
+    dirname(inputPath) {
+        return path.dirname(inputPath);
+    },
+    /**
+     * Gets base name from path
+     */
+    basename(inputPath, ext) {
+        return path.basename(inputPath, ext);
+    },
+    /**
+     * Resolve a path relative to the project root
+     */
+    resolveFromRoot(...segments) {
+        return path.resolve(rootDir, ...segments);
+    }
+};
+export default pathUtils;
+//# sourceMappingURL=pathUtils.js.map

package/dist/utils/pathUtils.js.map

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

package/package.json

@@ -1,12 +1,52 @@
 {
   "name": "@kadi.build/core",
-  "version": "0.0.1-alpha.3",
+  "version": "0.0.1-alpha.4",
   "description": "A module that is a comprehensive toolkit for developers integrating with the KADI infrastructure.",
-  "main": "src/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"
+    },
+    "./types/events": {
+      "import": "./dist/types/events.js",
+      "types": "./dist/types/events.d.ts"
+    },
+    "./schemas": {
+      "import": "./dist/schemas/index.js",
+      "types": "./dist/schemas/index.d.ts"
+    },
+    "./messages": {
+      "import": "./dist/messages/BrokerMessages.js",
+      "types": "./dist/messages/BrokerMessages.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
+    "clean": "rimraf dist",
+    "build": "npm run clean && tsc",
+    "build:watch": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "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",
+    "prepare": "npm run build"
   },
   "author": "Corey Clark",
   "contributors": [
@@ -20,9 +60,20 @@
     "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",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.6.2",
+    "rimraf": "^5.0.10",
+    "typescript": "^5.9.2"
   }
 }

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/examples/example-abilities/echo-js/README.md

@@ -1,131 +0,0 @@
-# Echo-JS Ability
-
-A simple echo ability that demonstrates the new **improved KadiAbility architecture**. This ability showcases how easy it is to create powerful abilities with minimal code.
-
-## What This Demonstrates
-
-### 🏗️ **New Architecture Benefits**
-
-1. **Cleaner Code**: The entire ability is ~100 lines vs ~600+ lines with the old architecture
-2. **Transport Abstraction**: Automatically works with stdio and broker modes
-3. **Built-in Discovery**: `__kadi_init` and `__kadi_discover` methods are automatic
-4. **Better Error Handling**: Protocol errors are handled gracefully
-5. **Metadata Support**: Easy to add schemas and descriptions to methods
-
-### 🚀 **Simple API**
-
-```javascript
-const ability = new KadiAbility({ name: 'echo-js' });
-
-ability
-  .method('echo', async ({ message }) => {
-    return { echo: message, timestamp: new Date().toISOString() };
-  })
-  .serve();
-```
-
-That's it! The new architecture handles:
-
-- LSP framing for stdio communication
-- Request/response correlation
-- Error handling
-- Discovery methods
-- Transport selection
-
-## Available Methods
-
-### `echo`
-
-Returns your message with metadata:
-
-```json
-{
-  "method": "echo",
-  "params": { "message": "Hello!" }
-}
-// Returns: { "echo": "Hello!", "timestamp": "2024-...", "length": 6 }
-```
-
-### `mirror`
-
-Returns your entire input object:
-
-```json
-{
-  "method": "mirror",
-  "params": { "foo": "bar", "numbers": [1, 2, 3] }
-}
-// Returns: { "mirrored": {...}, "metadata": {...} }
-```
-
-### `health`
-
-Returns service health status:
-
-```json
-{
-  "method": "health",
-  "params": {}
-}
-// Returns: { "status": "healthy", "uptime": 12345, "version": "0.0.1" }
-```
-
-## Running
-
-### Stdio Mode (default)
-
-```bash
-node service.js
-# Then send JSON-RPC messages via stdin
-```
-
-### Broker Mode
-
-```bash
-KADI_MODE=broker KADI_BROKER_URL=ws://localhost:8080 node service.js
-```
-
-### Testing
-
-```bash
-node test-manual.js
-```
-
-## Architecture Comparison
-
-### Before (Old KadiAbility)
-
-```javascript
-// Had to implement:
-// - LSP frame reading/writing (~200 lines)
-// - Request/response loop (~100 lines)
-// - Error handling (~100 lines)
-// - Discovery methods (~50 lines)
-// - Transport management (~50 lines)
-// Total: ~500+ lines before any business logic!
-```
-
-### After (New Architecture)
-
-```javascript
-import { KadiAbility } from '@kadi/core';
-
-const ability = new KadiAbility({ name: 'my-ability' });
-ability.method('myMethod', handler);
-ability.serve();
-
-// Everything else is handled automatically!
-// Focus on business logic, not plumbing.
-```
-
-## Key Features Demonstrated
-
-- ✅ **Multiple Methods**: echo, mirror, health
-- ✅ **Method Metadata**: Descriptions and schemas
-- ✅ **Error Handling**: Graceful error responses
-- ✅ **Event Monitoring**: Request/response logging
-- ✅ **Discovery**: Built-in `__kadi_init` and `__kadi_discover`
-- ✅ **Transport Agnostic**: Works with stdio and broker modes
-- ✅ **Clean Shutdown**: Handles SIGINT/SIGTERM
-
-This is what ability development should feel like! 🎉

package/examples/example-abilities/echo-js/agent.json

@@ -1,63 +0,0 @@
-{
-  "name": "echo-js",
-  "kind": "ability",
-  "version": "0.0.1",
-  "license": "MIT",
-  "description": "Simple echo ability that returns whatever you send to it - demonstrates the new KadiAbility architecture.",
-  "repo": "",
-  "brokers": {
-    "local": "ws://127.0.0.1:8080",
-    "remote": "ws://kadi.build:8080"
-  },
-  "abilities": {},
-  "scripts": {
-    "preflight": "npm uninstall @kadi.build/core && npm cache clean --force && npm pack ../../../../../ && npm install kadi.build-core-0.0.1-alpha.2.tgz && rm kadi.build-core-0.0.1-alpha.2.tgz",
-    "setup": "npm install",
-    "start": "node service.js",
-    "stop": ""
-  },
-  "interfaces": {
-    "native": {
-      "entry": "service.js"
-    },
-    "stdio": {
-      "discover": true,
-      "timeoutMs": 10000
-    },
-    "broker": {
-      "discover": true,
-      "timeoutMs": 15000
-    }
-  },
-  "exports": [
-    {
-      "name": "echo",
-      "title": "Echo",
-      "description": "Returns the exact input you provide - useful for testing.",
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "message": {
-            "type": "string",
-            "description": "Message to echo back"
-          }
-        },
-        "required": ["message"]
-      },
-      "outputSchema": {
-        "type": "object",
-        "properties": {
-          "echo": {
-            "type": "string"
-          },
-          "timestamp": {
-            "type": "string"
-          },
-          "length": {
-            "type": "number"
-          }
-        }
-      }
-    }
-  ]
-}