arkitek-relay-skill 1.0.0 → 1.0.1

package/.env.example

@@ -0,0 +1,2 @@
+ARKITEK_API_KEY=ak_your_api_key_here
+ARKITEK_AUTO_RECONNECT=true

package/README.md

@@ -22,77 +22,67 @@ The agent initiates all connections. Nothing is exposed on your network.
 - An **OpenClaw agent** (or any agent framework — the handler interface is generic)
 - An **ArkiTek account** at [arkitek.dev](https://arkitek.dev)
 
-## Installation
+## Quick Start
 
 ```bash
 npm install arkitek-relay-skill
+npx arkitek-relay-skill
 ```
 
-Or clone and build from source:
+That's it. The skill will ask for your API key, save it, and connect your agent to ArkiTek automatically.
 
-```bash
-git clone https://github.com/raleighgardner16-source/arkitek-relay-skill.git
-cd arkitek-relay-skill
-npm install
-npm run build
-```
+> **First time?** Get your API key at [arkitek.dev](https://arkitek.dev) — go to **Agents** → **Add Agent** → **Create** and copy the `ak_...` key.
 
-## Getting Your API Key
+## What Happens When You Run It
 
-1. Log in to [arkitek.dev](https://arkitek.dev)
-2. Navigate to **Agents** → **Add Agent**
-3. Give your agent a name and description
-4. Click **Create** — you'll receive a private API key (starts with `ak_`)
-5. Copy the key immediately — it won't be shown again
+1. If no API key is saved, the skill prompts you to paste one
+2. The key is validated and saved to a local `.env` file (so you never have to enter it again)
+3. The skill connects to ArkiTek over HTTPS
+4. Your agent is live — send it a message from the ArkiTek UI
 
-> **Security**: Your API key is a secret. Never commit it to version control, share it publicly, or log it. Use environment variables.
+On subsequent runs, the saved key is loaded automatically and the agent reconnects.
 
-## Configuration
+## Changing or Rotating Your API Key
 
-Set your API key as an environment variable:
+1. Stop the agent (Ctrl+C)
+2. Delete or edit the `ARKITEK_API_KEY` line in your `.env` file
+3. Run `npx arkitek-relay-skill` again — it will prompt for the new key
 
-```bash
-export ARKITEK_API_KEY=ak_your_api_key_here
-```
+If you deleted your agent in ArkiTek and want to reconnect, create a new agent in the dashboard, copy the new key, and follow the steps above.
 
-Or use a `.env` file (see `.env.example`):
+## Disconnecting Your Agent
 
-```
-ARKITEK_API_KEY=ak_your_api_key_here
-ARKITEK_AUTO_RECONNECT=true
-```
+1. Stop the agent process — this closes the connection to ArkiTek
+2. Optionally delete the agent in ArkiTek's dashboard (**Agents** → select your agent → **Delete**)
 
-### Configuration Options
+The skill files remain installed locally. To fully remove: `npm uninstall arkitek-relay-skill`
+
+## Configuration Options
+
+The skill reads these from your `.env` file or environment variables:
 
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
 | `ARKITEK_API_KEY` | Yes | — | Your agent's private API key from ArkiTek |
 | `ARKITEK_AUTO_RECONNECT` | No | `true` | Auto-reconnect on network errors |
 
-## Usage
+> **Security**: Your API key is a secret. The `.env` file is local only — never commit it to version control or share it publicly.
 
-### As an imported module
+## Advanced: Using as a Library
+
+If you're building your own agent and want to integrate the relay programmatically:
 
 ```typescript
 import { createArkitekRelay } from "arkitek-relay-skill";
 import type { IncomingMessage } from "arkitek-relay-skill";
 
-// Define your message handler
 async function handleMessage(message: IncomingMessage): Promise<string> {
-  console.log(`User said: ${message.content}`);
-
-  // Pass to your OpenClaw agent, LLM, or any processing logic
   const response = await yourAgent.process(message.content, message.images);
-
   return response;
 }
 
-// Create and connect the relay
 const relay = createArkitekRelay(
-  {
-    apiKey: process.env.ARKITEK_API_KEY!,
-    autoReconnect: true,
-  },
+  { apiKey: process.env.ARKITEK_API_KEY! },
   handleMessage,
   {
     onConnect: (agentId) => console.log(`Connected as agent ${agentId}`),
@@ -104,33 +94,6 @@ const relay = createArkitekRelay(
 await relay.connect();
 ```
 
-### As a standalone script (echo mode)
-
-```bash
-ARKITEK_API_KEY=ak_your_key node dist/index.js
-```
-
-This starts the skill with a built-in echo handler — useful for testing that your connection works.
-
-### With the RelayClient class directly
-
-```typescript
-import { RelayClient } from "arkitek-relay-skill";
-
-const client = new RelayClient(
-  { apiKey: process.env.ARKITEK_API_KEY! },
-  async (message) => {
-    // Your logic here
-    return `Processed: ${message.content}`;
-  }
-);
-
-await client.connect();
-
-// Later...
-client.disconnect();
-```
-
 ## Council of LLMs (Optional)
 
 ArkiTek's Council feature lets you query multiple LLMs simultaneously and get aggregated responses. This requires an active ArkiTek subscription.

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 export { type ArkitekConfig, type ArkitekRelayEvents, type IncomingMessage, type MessageHandler, type ConnectionState, type ConnectedEvent, type PingEvent, type RespondPayload, type RespondResponse, type CouncilRequest, type CouncilResponse, type CouncilModelResponse, } from "./types.js";
 export { RelayClient } from "./relay.js";
 export { maskKey, validateApiKey, checkTlsSafety, warnIfNotHttps } from "./validation.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAc,MAAM,YAAY,CAAC;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,WAAW,CAEb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAIpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMzC,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,WAAW,CAEb"}

package/dist/index.js

@@ -1,33 +1,103 @@
+#!/usr/bin/env node
 export { RelayClient } from "./relay.js";
 export { maskKey, validateApiKey, checkTlsSafety, warnIfNotHttps } from "./validation.js";
 export { queryCouncil } from "./council.js";
-import { LOG_PREFIX } from "./types.js";
+import { LOG_PREFIX, API_KEY_PATTERN, } from "./types.js";
 import { RelayClient } from "./relay.js";
 import { fileURLToPath } from "node:url";
 import { resolve } from "node:path";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { createInterface } from "node:readline";
 export function createArkitekRelay(config, handler, events) {
     return new RelayClient(config, handler, events);
 }
+function loadEnvFile() {
+    const envPath = resolve(process.cwd(), ".env");
+    if (!existsSync(envPath))
+        return;
+    const content = readFileSync(envPath, "utf-8");
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const value = trimmed.slice(eqIdx + 1).trim();
+        if (!process.env[key]) {
+            process.env[key] = value;
+        }
+    }
+}
+function promptForKey() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((res) => {
+        rl.question("  Paste your API key here: ", (answer) => {
+            rl.close();
+            res(answer.trim());
+        });
+    });
+}
+function saveKeyToEnv(apiKey) {
+    const envPath = resolve(process.cwd(), ".env");
+    if (existsSync(envPath)) {
+        let content = readFileSync(envPath, "utf-8");
+        if (content.includes("ARKITEK_API_KEY=")) {
+            content = content.replace(/ARKITEK_API_KEY=.*/, `ARKITEK_API_KEY=${apiKey}`);
+        }
+        else {
+            content = content.trimEnd() + `\nARKITEK_API_KEY=${apiKey}\n`;
+        }
+        writeFileSync(envPath, content);
+    }
+    else {
+        writeFileSync(envPath, `ARKITEK_API_KEY=${apiKey}\nARKITEK_AUTO_RECONNECT=true\n`);
+    }
+}
 const isMainModule = typeof process !== "undefined" &&
     process.argv[1] &&
     fileURLToPath(import.meta.url) === resolve(process.argv[1]);
 if (isMainModule) {
-    const apiKey = process.env.ARKITEK_API_KEY;
-    if (!apiKey) {
-        console.error(`${LOG_PREFIX} ARKITEK_API_KEY environment variable is required`);
-        process.exit(1);
-    }
-    const autoReconnect = process.env.ARKITEK_AUTO_RECONNECT !== "false";
-    const echoHandler = async (message) => {
-        console.log(`${LOG_PREFIX} [Echo] Received: ${message.content.slice(0, 100)}`);
-        return `Echo: ${message.content}`;
-    };
-    const relay = createArkitekRelay({ apiKey, autoReconnect }, echoHandler, {
-        onConnect: (agentId) => console.log(`${LOG_PREFIX} Agent ${agentId} connected`),
-        onDisconnect: (reason) => console.log(`${LOG_PREFIX} Disconnected: ${reason}`),
-        onError: (err) => console.error(`${LOG_PREFIX} Error: ${err.message}`),
-    });
-    relay.connect().catch((err) => {
+    (async () => {
+        loadEnvFile();
+        let apiKey = process.env.ARKITEK_API_KEY;
+        if (!apiKey) {
+            if (!process.stdin.isTTY) {
+                console.error(`${LOG_PREFIX} ARKITEK_API_KEY environment variable is required`);
+                process.exit(1);
+            }
+            console.log(`\n${LOG_PREFIX} Welcome! Let's connect your agent to ArkiTek.\n`);
+            console.log("  1. Go to https://arkitek.dev");
+            console.log("  2. Navigate to Agents → Add Agent → Create");
+            console.log("  3. Copy the API key (starts with ak_)\n");
+            apiKey = await promptForKey();
+            if (!apiKey) {
+                console.error(`\n${LOG_PREFIX} No key provided. Exiting.`);
+                process.exit(1);
+            }
+            if (!API_KEY_PATTERN.test(apiKey)) {
+                console.error(`\n${LOG_PREFIX} Invalid key format. Keys start with ak_ and are 67 characters.`);
+                process.exit(1);
+            }
+            saveKeyToEnv(apiKey);
+            process.env.ARKITEK_API_KEY = apiKey;
+            console.log(`\n${LOG_PREFIX} API key saved to .env — you won't need to enter it again.`);
+        }
+        const autoReconnect = process.env.ARKITEK_AUTO_RECONNECT !== "false";
+        const echoHandler = async (message) => {
+            console.log(`${LOG_PREFIX} [Echo] Received: ${message.content.slice(0, 100)}`);
+            return `Echo: ${message.content}`;
+        };
+        const relay = createArkitekRelay({ apiKey, autoReconnect }, echoHandler, {
+            onConnect: (agentId) => console.log(`${LOG_PREFIX} Connected! Agent ${agentId} is live and listening for messages.`),
+            onDisconnect: (reason) => console.log(`${LOG_PREFIX} Disconnected: ${reason}`),
+            onError: (err) => console.error(`${LOG_PREFIX} Error: ${err.message}`),
+        });
+        console.log(`${LOG_PREFIX} Connecting to ArkiTek...`);
+        await relay.connect();
+        console.log(`${LOG_PREFIX} Ready. Send a message from the ArkiTek UI to test.`);
+    })().catch((err) => {
         console.error(`${LOG_PREFIX} Fatal:`, err);
         process.exit(1);
     });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAoE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,OAAuB,EACvB,MAA2B;IAE3B,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,YAAY,GAChB,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,IAAI,YAAY,EAAE,CAAC;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,mDAAmD,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,OAAO,CAAC;IAErE,MAAM,WAAW,GAAmB,KAAK,EAAE,OAAO,EAAE,EAAE;QACpD,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,qBAAqB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,SAAS,OAAO,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,kBAAkB,CAC9B,EAAE,MAAM,EAAE,aAAa,EAAE,EACzB,WAAW,EACX;QACE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,UAAU,OAAO,YAAY,CAAC;QAC/E,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,kBAAkB,MAAM,EAAE,CAAC;QAC9E,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,WAAW,GAAG,CAAC,OAAO,EAAE,CAAC;KACvE,CACF,CAAC;IAEF,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiBA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAKL,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,OAAuB,EACvB,MAA2B;IAE3B,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACjC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACzB,EAAE,CAAC,QAAQ,CAAC,6BAA6B,EAAE,CAAC,MAAM,EAAE,EAAE;YACpD,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,qBAAqB,MAAM,IAAI,CAAC;QAChE,CAAC;QACD,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,aAAa,CACX,OAAO,EACP,mBAAmB,MAAM,iCAAiC,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,YAAY,GAChB,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,IAAI,YAAY,EAAE,CAAC;IACjB,CAAC,KAAK,IAAI,EAAE;QACV,WAAW,EAAE,CAAC;QAEd,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,mDAAmD,CAAC,CAAC;gBAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,kDAAkD,CAAC,CAAC;YAC/E,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;YAEzD,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;YAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,KAAK,UAAU,4BAA4B,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,KAAK,UAAU,iEAAiE,CAAC,CAAC;gBAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,4DAA4D,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,OAAO,CAAC;QAErE,MAAM,WAAW,GAAmB,KAAK,EAAE,OAAO,EAAE,EAAE;YACpD,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,qBAAqB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/E,OAAO,SAAS,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,kBAAkB,CAC9B,EAAE,MAAM,EAAE,aAAa,EAAE,EACzB,WAAW,EACX;YACE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,qBAAqB,OAAO,sCAAsC,CAAC;YAC9F,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CACvB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,kBAAkB,MAAM,EAAE,CAAC;YACtD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACf,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,WAAW,GAAG,CAAC,OAAO,EAAE,CAAC;SACvD,CACF,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,2BAA2B,CAAC,CAAC;QACtD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,qDAAqD,CAAC,CAAC;IAClF,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkitek-relay-skill",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Connect your OpenClaw agent to ArkiTek via secure outbound SSE relay",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,13 +11,17 @@
     }
   },
   "type": "module",
+  "bin": {
+    "arkitek-relay-skill": "dist/index.js"
+  },
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "postinstall": "node scripts/postinstall.js"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -33,6 +37,8 @@
   "author": "",
   "files": [
     "dist",
+    "scripts/postinstall.js",
+    ".env.example",
     "README.md",
     "LICENSE"
   ],

package/scripts/postinstall.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+const BOLD = "\x1b[1m";
+const CYAN = "\x1b[36m";
+const YELLOW = "\x1b[33m";
+const DIM = "\x1b[2m";
+const RESET = "\x1b[0m";
+
+console.log(`
+  ${BOLD}${CYAN}arkitek-relay-skill${RESET} installed!
+
+  Run this to set up and connect your agent:
+
+    ${YELLOW}npx arkitek-relay-skill${RESET}
+
+  ${DIM}You'll be asked for your API key from https://arkitek.dev${RESET}
+`);