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

package/examples/example-agent/abilities/echo-js/0.0.1/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-agent/abilities/echo-js/0.0.1/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"
-          }
-        }
-      }
-    }
-  ]
-}

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

@@ -1,93 +0,0 @@
-{
-  "name": "echo-js",
-  "version": "0.0.1",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "echo-js",
-      "version": "0.0.1",
-      "license": "MIT",
-      "dependencies": {
-        "@kadi.build/core": "file:kadi.build-core-0.0.1-alpha.2.tgz"
-      }
-    },
-    "node_modules/@kadi.build/core": {
-      "version": "0.0.1-alpha.2",
-      "resolved": "file:kadi.build-core-0.0.1-alpha.2.tgz",
-      "integrity": "sha512-2sOOpGC4+Ze3slPJOBU//d1F20svyjMjEYzGLG3P95oqab38fwm7nlu+7xv/UEhwWAkvVbkMw649lnvznSI4TQ==",
-      "license": "MIT",
-      "dependencies": {
-        "chalk": "^5.5.0",
-        "debug": "^4.4.1",
-        "events": "^3.3.0",
-        "ws": "^8.16.0"
-      }
-    },
-    "node_modules/chalk": {
-      "version": "5.6.0",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.0.tgz",
-      "integrity": "sha512-46QrSQFyVSEyYAgQ22hQ+zDa60YHA4fBstHmtSApj1Y5vKtG27fWowW03jCk5KcbXEWPZUIR894aARCA/G1kfQ==",
-      "license": "MIT",
-      "engines": {
-        "node": "^12.17.0 || ^14.13 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
-    "node_modules/debug": {
-      "version": "4.4.1",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz",
-      "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==",
-      "license": "MIT",
-      "dependencies": {
-        "ms": "^2.1.3"
-      },
-      "engines": {
-        "node": ">=6.0"
-      },
-      "peerDependenciesMeta": {
-        "supports-color": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/events": {
-      "version": "3.3.0",
-      "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
-      "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.8.x"
-      }
-    },
-    "node_modules/ms": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-      "license": "MIT"
-    },
-    "node_modules/ws": {
-      "version": "8.18.3",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.3.tgz",
-      "integrity": "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=10.0.0"
-      },
-      "peerDependencies": {
-        "bufferutil": "^4.0.1",
-        "utf-8-validate": ">=5.0.2"
-      },
-      "peerDependenciesMeta": {
-        "bufferutil": {
-          "optional": true
-        },
-        "utf-8-validate": {
-          "optional": true
-        }
-      }
-    }
-  }
-}

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

@@ -1,24 +0,0 @@
-{
-  "name": "echo-js",
-  "version": "0.0.1",
-  "description": "Simple echo ability demonstrating the new KadiAbility architecture",
-  "type": "module",
-  "main": "service.js",
-  "scripts": {
-    "preflight": "",
-    "setup": "npm install",
-    "start": "node service.js",
-    "test": "echo 'No tests yet'"
-  },
-  "keywords": [
-    "kadi",
-    "ability",
-    "echo",
-    "demo"
-  ],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "@kadi.build/core": "file:kadi.build-core-0.0.1-alpha.2.tgz"
-  }
-}

package/examples/example-agent/abilities/echo-js/0.0.1/service.js

@@ -1,41 +0,0 @@
-// echo-js/index.ts (or .js)
-import { KadiAbility } from '@kadi.build/core';
-
-const echoAbility = new KadiAbility({
-  name: 'echo-js',
-  version: '0.0.1',
-  description: 'Simple echo ability demonstrating the new KadiAbility architecture',
-  scope: process.env.KADI_AGENT_SCOPE,
-});
-
-async function echo(message) {
-  const timestamp = new Date().toISOString();
-  const messageText = message?.message ?? message ?? '';
-  const length = messageText.length;
-
-  echoAbility.publishEvent('echo:test-event', { from: 'message echo'});
-  echoAbility.publishEvent('echo:test-event', { from: 'message echo 2'});
-
-  return { echo: messageText, timestamp, length };
-}
-
-async function say_message(message) {
-  return { message };
-}
-
-// Register methods
-echoAbility.method('echo', echo);
-echoAbility.method('say_message', say_message, {
-  description: 'Say a message',
-  inputSchema: { type: 'object', properties: { message: { type: 'string' } } },
-  outputSchema: { type: 'object', properties: { message: { type: 'string' } } },
-});
-
-// For native/in-process you usually do NOT need serve().
-// If you keep it for other protocols, it won’t hurt, but isn’t required here.
-echoAbility.serve().catch((error) => {
-  console.error(`[echo-js] Fatal error: ${error.message}`);
-  process.exit(1);
-});
-
-export default echoAbility; 

package/examples/example-agent/abilities/hash-go/0.0.1/agent.json

@@ -1,53 +0,0 @@
-{
-  "name": "hash-go",
-  "kind": "ability",
-  "version": "0.0.1",
-  "license": "MIT",
-  "description": "Compute digests (sha256 default).",
-  "repo": "",
-  "brokers": {
-    "local": "ws://127.0.0.1:8080",
-    "remote": "ws://146.190.121.213:8080"
-  },
-  "abilities": {},
-  "scripts": {
-    "preflight": "",
-    "setup": "go mod tidy && mkdir -p bin && go build -o bin/hash_ability ./cmd/hash_ability",
-    "start": "./bin/hash_ability",
-    "stop": ""
-  },
-  "interfaces": {
-    "stdio": {
-      "discover": true,
-      "timeoutMs": 10000
-    }
-  },
-  "exports": [
-    {
-      "name": "digest",
-      "title": "Compute Digest",
-      "description": "Return a hex digest of the input text.",
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "text": { "type": "string", "description": "Input text" },
-          "algo": {
-            "type": "string",
-            "enum": ["sha256", "md5"],
-            "default": "sha256",
-            "description": "Hash algorithm"
-          }
-        },
-        "required": ["text"]
-      },
-      "outputSchema": {
-        "type": "object",
-        "properties": {
-          "algo": { "type": "string" },
-          "hex": { "type": "string" }
-        },
-        "required": ["algo", "hex"]
-      }
-    }
-  ]
-}