clawnexus-skill 0.1.0

package/README.md

@@ -0,0 +1,71 @@
+# clawnexus-skill
+
+ClawNexus Skill for OpenClaw — query and manage AI instances from within an OpenClaw conversation.
+
+## Installation
+
+```bash
+npm install clawnexus-skill
+```
+
+## Prerequisites
+
+The `clawnexus` daemon must be running:
+
+```bash
+npm install -g clawnexus
+clawnexus start
+```
+
+## Actions
+
+| Action | Description | Parameters |
+|--------|-------------|------------|
+| `list` | List all known instances | — |
+| `info` | Get details for a specific instance | `name` |
+| `scan` | Scan the local network for instances | — |
+| `alias` | Set a friendly alias for an instance | `id`, `alias` |
+| `connect` | Get WebSocket URL for an instance | `name` |
+| `health` | Check daemon status | — |
+
+## Usage
+
+```typescript
+import { handleSkillRequest } from "clawnexus-skill";
+
+// List all instances
+const result = await handleSkillRequest({ action: "list" });
+// { success: true, data: { count: 2, instances: [...] } }
+
+// Get instance info
+const info = await handleSkillRequest({
+  action: "info",
+  params: { name: "home" },
+});
+
+// Scan the network
+const scan = await handleSkillRequest({ action: "scan" });
+
+// Set an alias
+const alias = await handleSkillRequest({
+  action: "alias",
+  params: { id: "my-agent-id", alias: "home" },
+});
+
+// Get connection URL
+const conn = await handleSkillRequest({
+  action: "connect",
+  params: { name: "home" },
+});
+// { success: true, data: { url: "ws://192.168.1.10:18789" } }
+```
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `CLAWNEXUS_API` | Daemon API URL | `http://localhost:17890` |
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,32 @@
+# ClawNexus Skill
+
+Query and manage OpenClaw instances discovered by the ClawNexus daemon.
+
+## Prerequisites
+
+The `clawnexus` daemon must be running on `localhost:17890`.
+
+```bash
+clawnexus start
+```
+
+## Actions
+
+| Action | Description | Parameters |
+|--------|-------------|------------|
+| `list` | List all known instances | — |
+| `info` | Get instance details | `name` |
+| `scan` | Scan local network | — |
+| `alias` | Set instance alias | `id`, `alias` |
+| `connect` | Get WebSocket URL | `name` |
+| `health` | Check daemon status | — |
+
+## Example Usage
+
+```json
+{ "action": "list" }
+{ "action": "info", "params": { "name": "home" } }
+{ "action": "scan" }
+{ "action": "alias", "params": { "id": "my-agent", "alias": "home" } }
+{ "action": "connect", "params": { "name": "home" } }
+```

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+interface SkillRequest {
+    action: string;
+    params?: Record<string, string>;
+}
+interface SkillResponse {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export declare function handleSkillRequest(request: SkillRequest): Promise<SkillResponse>;
+export {};

package/dist/index.js

@@ -0,0 +1,84 @@
+"use strict";
+// ClawNexus Skill — OpenClaw Skill entry point
+// Queries clawnexus daemon HTTP API at localhost:17890
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillRequest = handleSkillRequest;
+const API_URL = process.env.CLAWNEXUS_API ?? "http://localhost:17890";
+async function callDaemon(method, path, body) {
+    try {
+        const res = await fetch(`${API_URL}${path}`, {
+            method,
+            headers: body ? { "Content-Type": "application/json" } : undefined,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: AbortSignal.timeout(5000),
+        });
+        const data = await res.json();
+        return { ok: res.ok, data };
+    }
+    catch {
+        return { ok: false, data: { error: "Cannot connect to ClawNexus daemon" } };
+    }
+}
+async function handleSkillRequest(request) {
+    switch (request.action) {
+        case "list": {
+            const { ok, data } = await callDaemon("GET", "/instances");
+            return ok
+                ? { success: true, data }
+                : { success: false, error: data.error };
+        }
+        case "info": {
+            const name = request.params?.name;
+            if (!name)
+                return { success: false, error: "Missing instance name" };
+            const { ok, data } = await callDaemon("GET", `/instances/${encodeURIComponent(name)}`);
+            return ok
+                ? { success: true, data }
+                : { success: false, error: "Instance not found" };
+        }
+        case "scan": {
+            const { ok, data } = await callDaemon("POST", "/scan");
+            return ok
+                ? { success: true, data }
+                : { success: false, error: data.error };
+        }
+        case "alias": {
+            const id = request.params?.id;
+            const alias = request.params?.alias;
+            if (!id || !alias)
+                return { success: false, error: "Missing id or alias" };
+            const { ok, data } = await callDaemon("PUT", `/instances/${encodeURIComponent(id)}/alias`, { alias });
+            return ok
+                ? { success: true, data }
+                : { success: false, error: data.error };
+        }
+        case "connect": {
+            const name = request.params?.name;
+            if (!name)
+                return { success: false, error: "Missing instance name" };
+            const { ok, data } = await callDaemon("GET", `/instances/${encodeURIComponent(name)}`);
+            if (!ok)
+                return { success: false, error: "Instance not found" };
+            const inst = data;
+            const protocol = inst.tls ? "wss" : "ws";
+            return { success: true, data: { url: `${protocol}://${inst.address}:${inst.gateway_port}` } };
+        }
+        case "health": {
+            const { ok, data } = await callDaemon("GET", "/health");
+            return ok
+                ? { success: true, data }
+                : { success: false, error: "Daemon not available" };
+        }
+        case "resolve": {
+            const name = request.params?.name;
+            if (!name)
+                return { success: false, error: "Missing .claw name" };
+            const { ok, data } = await callDaemon("GET", `/resolve/${encodeURIComponent(name)}`);
+            return ok
+                ? { success: true, data }
+                : { success: false, error: "Name not found" };
+        }
+        default:
+            return { success: false, error: `Unknown action: ${request.action}` };
+    }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "clawnexus-skill",
+  "version": "0.1.0",
+  "description": "ClawNexus OpenClaw Skill — query and manage instances from within OpenClaw",
+  "license": "MIT",
+  "author": "alan-silverstreams <alan@silverstream.tech>",
+  "homepage": "https://github.com/alan-silverstreams/ClawNexus",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alan-silverstreams/ClawNexus.git",
+    "directory": "packages/skill"
+  },
+  "bugs": "https://github.com/alan-silverstreams/ClawNexus/issues",
+  "keywords": [
+    "openclaw",
+    "ai",
+    "agent",
+    "skill",
+    "clawnexus",
+    "instance",
+    "management"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "SKILL.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm build"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}