ring-a-ding-cli 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,74 @@
+# Ring-a-Ding CLI
+
+`ring-a-ding-cli` installs the `rad` command used by the public `ring-a-ding`
+OpenClaw skill.
+
+## What You Need
+
+Before you can make calls, you need:
+
+1. A Ring-a-Ding API key from [ringading.ai/account](https://ringading.ai/account)
+2. Your own OpenAI API key from [platform.openai.com/api-keys](https://platform.openai.com/api-keys)
+
+Ring-a-Ding is the telephony service. Your OpenAI key powers the voice agent.
+
+## OpenClaw Install
+
+1. Install the CLI:
+
+```bash
+npm install -g ring-a-ding-cli
+```
+
+2. Install the OpenClaw skill:
+
+```bash
+openclaw skills install ring-a-ding
+```
+
+3. Check what is still missing:
+
+```bash
+openclaw skills check
+```
+
+4. Add your keys to `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "skills": {
+    "entries": {
+      "ring-a-ding": {
+        "enabled": true,
+        "apiKey": "rad_live_...",
+        "env": {
+          "OPENAI_API_KEY": "sk-..."
+        }
+      }
+    }
+  }
+}
+```
+
+5. Start a fresh OpenClaw session.
+
+6. Test with this prompt:
+
+```text
+Use the ring-a-ding skill to call +16143970634 and ask the callee to say ready.
+```
+
+## Optional CLI Setup
+
+If you want to use `rad` directly outside OpenClaw, save your keys locally:
+
+```bash
+rad init
+```
+
+That stores config in `~/.config/ring-a-ding/config.json`.
+
+## Docs
+
+- Public setup guide: [ringading.ai/openclaw](https://ringading.ai/openclaw)
+- Account and billing: [ringading.ai/account](https://ringading.ai/account)

package/dist/index.js

@@ -14017,7 +14017,7 @@ function loadConfig() {
   if (envApiKey && envOpenaiKey) {
     return {
       apiKey: envApiKey,
-      apiUrl: envApiUrl ?? "https://ringading.fly.dev",
+      apiUrl: envApiUrl ?? "https://api.ringading.ai",
       openaiKey: envOpenaiKey
     };
   }
@@ -14029,7 +14029,7 @@ function loadConfig() {
     const parsed = JSON.parse(raw);
     return {
       apiKey: envApiKey ?? parsed.apiKey,
-      apiUrl: envApiUrl ?? parsed.apiUrl ?? "https://ringading.fly.dev",
+      apiUrl: envApiUrl ?? parsed.apiUrl ?? "https://api.ringading.ai",
       openaiKey: envOpenaiKey ?? parsed.openaiKey
     };
   } catch {
@@ -14043,7 +14043,7 @@ function requireConfig() {
       `${JSON.stringify({
         error: true,
         errorCode: "NOT_CONFIGURED",
-        message: "Ring-a-Ding is not configured. Run: rad init"
+        message: "Ring-a-Ding is not configured. Get your API key at https://ringading.ai/account, then run: rad init"
       })}
 `
     );
@@ -14054,7 +14054,7 @@ function requireConfig() {
       `${JSON.stringify({
         error: true,
         errorCode: "MISSING_API_KEY",
-        message: "API key not found. Run: rad init"
+        message: "API key not found. Get your API key at https://ringading.ai/account, then run: rad init"
       })}
 `
     );
@@ -14231,12 +14231,30 @@ function registerEndCommand(program2) {
 }
 
 // src/commands/init.ts
-import { copyFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2 } from "node:fs";
+import { copyFileSync, existsSync as existsSync3, mkdirSync as mkdirSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { dirname, join as join2 } from "node:path";
+import { dirname as dirname2, join as join3 } from "node:path";
 import { createInterface } from "node:readline/promises";
+
+// src/skill-file.ts
+import { existsSync as existsSync2 } from "node:fs";
+import { dirname, join as join2 } from "node:path";
 import { fileURLToPath } from "node:url";
 var __dirname = dirname(fileURLToPath(import.meta.url));
+function getBundledSkillPath() {
+  const candidates = [
+    join2(__dirname, "skills", "ring-a-ding", "SKILL.md"),
+    join2(__dirname, "..", "skills", "ring-a-ding", "SKILL.md")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync2(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error("Skill file not found. Reinstall ring-a-ding-cli.");
+}
+
+// src/commands/init.ts
 async function prompt(rl, message) {
   const answer = await rl.question(message);
   return answer.trim();
@@ -14249,11 +14267,24 @@ function getValidationFailureMessage(err) {
   return "FAILED (key may be invalid, but config saved)";
 }
 function registerInitCommand(program2) {
-  program2.command("init").description("Configure Ring-a-Ding (API key, OpenAI key)").option("--api-key <key>", "Ring-a-Ding API key").option("--openai-key <key>", "OpenAI API key").option("--api-url <url>", "API URL (default: https://ringading.fly.dev)").action(async (opts) => {
+  program2.command("init").description("Save your Ring-a-Ding API key and OpenAI API key for local use").option("--api-key <key>", "Ring-a-Ding API key").option("--openai-key <key>", "OpenAI API key").option("--api-url <url>", "API URL (default: https://api.ringading.ai)").addHelpText(
+    "after",
+    [
+      "",
+      "You need:",
+      "  - A Ring-a-Ding API key from https://ringading.ai/account",
+      "  - An OpenAI API key from https://platform.openai.com/api-keys",
+      "",
+      "OpenClaw setup guide: https://ringading.ai/openclaw"
+    ].join("\n")
+  ).action(async (opts) => {
     const rl = createInterface({ input: process.stdin, output: process.stderr });
+    const isInteractive = Boolean(process.stdin.isTTY && process.stderr.isTTY);
     try {
       process.stderr.write("\nRing-a-Ding CLI Setup\n");
       process.stderr.write("=====================\n\n");
+      process.stderr.write("Need a Ring-a-Ding API key? Visit https://ringading.ai/account\n");
+      process.stderr.write("OpenClaw setup guide: https://ringading.ai/openclaw\n\n");
       if (configExists()) {
         const existing = loadConfig();
         if (existing) {
@@ -14286,7 +14317,7 @@ function registerInitCommand(program2) {
         rl.close();
         process.exit(1);
       }
-      const apiUrl = opts.apiUrl ?? (await prompt(rl, "API URL [https://ringading.fly.dev]: ") || "https://ringading.fly.dev");
+      const apiUrl = opts.apiUrl ?? (await prompt(rl, "API URL [https://api.ringading.ai]: ") || "https://api.ringading.ai");
       saveConfig({ apiKey, apiUrl, openaiKey });
       process.stderr.write(`
 Config saved to ${getConfigPath()}
@@ -14301,28 +14332,52 @@ Config saved to ${getConfigPath()}
         process.stderr.write(`${getValidationFailureMessage(err)}
 `);
       }
-      const openclawDir = join2(homedir2(), ".openclaw");
-      if (existsSync2(openclawDir)) {
-        process.stderr.write("\nOpenClaw detected!\n");
-        const defaultPath = join2(openclawDir, "workspace", "skills", "ring-a-ding", "SKILL.md");
-        const skillPath = await prompt(rl, `Copy OpenClaw skill to [${defaultPath}]: `) || defaultPath;
-        try {
-          const skillSource = join2(__dirname, "..", "skills", "ring-a-ding", "SKILL.md");
-          mkdirSync2(dirname(skillPath), { recursive: true });
-          copyFileSync(skillSource, skillPath);
-          process.stderr.write(`Skill file copied to ${skillPath}
+      const openclawDir = join3(homedir2(), ".openclaw");
+      if (existsSync3(openclawDir)) {
+        process.stderr.write("\nOpenClaw detected.\n");
+        process.stderr.write("Recommended public setup:\n");
+        process.stderr.write("  openclaw skills install ring-a-ding\n");
+        process.stderr.write("  openclaw skills check\n");
+        process.stderr.write("  Start a fresh OpenClaw session\n");
+        if (isInteractive) {
+          const defaultPath = join3(openclawDir, "workspace", "skills", "ring-a-ding", "SKILL.md");
+          const skillPath = await prompt(
+            rl,
+            `
+Optional local-dev shortcut: copy a local skill file to [${defaultPath}] (press Enter to skip): `
+          );
+          if (skillPath) {
+            try {
+              const skillSource = getBundledSkillPath();
+              mkdirSync2(dirname2(skillPath), { recursive: true });
+              copyFileSync(skillSource, skillPath);
+              process.stderr.write(`Local skill file copied to ${skillPath}
 `);
-        } catch (err) {
-          process.stderr.write(`Could not copy skill file: ${err.message}
+            } catch (err) {
+              process.stderr.write(`Could not copy skill file: ${err.message}
 `);
-          process.stderr.write('Run "rad skill" to print the skill file for manual copy.\n');
+              process.stderr.write('Run "rad skill" to print the skill file for manual copy.\n');
+            }
+          } else {
+            process.stderr.write("Skipped local skill copy.\n");
+          }
+        } else {
+          process.stderr.write("Skipping optional local skill copy in non-interactive mode.\n");
         }
-        process.stderr.write('\nAdd "rad" to your OpenClaw shell tool allowlist.\n');
+        process.stderr.write('\nIf OpenClaw uses a shell allowlist, add "rad".\n');
       } else {
-        process.stderr.write('\nRun "rad skill" to see the skill file for your AI agent.\n');
-      }
-      process.stderr.write("\nSetup complete! Ask your AI agent to make a phone call.\n");
-      process.stderr.write("\nQuick test:\n");
+        process.stderr.write(
+          "\nIf OpenClaw is on another machine, install the skill there with:\n"
+        );
+        process.stderr.write("  openclaw skills install ring-a-ding\n");
+      }
+      process.stderr.write("\nNext steps for OpenClaw:\n");
+      process.stderr.write("  1. Install the skill: openclaw skills install ring-a-ding\n");
+      process.stderr.write("  2. Check readiness: openclaw skills check\n");
+      process.stderr.write("  3. Start a fresh OpenClaw session\n");
+      process.stderr.write("  4. Ask OpenClaw to make the call\n");
+      process.stderr.write("Docs: https://ringading.ai/openclaw\n");
+      process.stderr.write("\nOptional CLI-only test:\n");
       process.stderr.write('  rad call "+15551234567" "Test call -- say hello and hang up"\n\n');
     } catch (err) {
       process.stderr.write(`Error: ${err.message}
@@ -14336,13 +14391,10 @@ Config saved to ${getConfigPath()}
 
 // src/commands/skill.ts
 import { readFileSync as readFileSync3 } from "node:fs";
-import { dirname as dirname2, join as join3 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
 function registerSkillCommand(program2) {
-  program2.command("skill").description("Print the OpenClaw skill file for AI agents").action(() => {
+  program2.command("skill").description("Print the bundled OpenClaw skill file for AI agents").action(() => {
     try {
-      const skillPath = join3(__dirname2, "..", "skills", "ring-a-ding", "SKILL.md");
+      const skillPath = getBundledSkillPath();
       const content = readFileSync3(skillPath, "utf-8");
       process.stdout.write(content);
     } catch {
@@ -14398,7 +14450,17 @@ function registerWaitCommand(program2) {
 
 // src/index.ts
 var program = new Command();
-program.name("rad").description("Ring-a-Ding CLI -- give AI agents the ability to make phone calls").version("0.1.0").option("--pretty", "Human-readable output instead of JSON");
+program.name("rad").description("Ring-a-Ding CLI for outbound AI phone calls in OpenClaw and other agents").version("0.1.1").option("--pretty", "Human-readable output instead of JSON");
+program.addHelpText(
+  "after",
+  [
+    "",
+    "Setup:",
+    "  Get your Ring-a-Ding API key: https://ringading.ai/account",
+    "  Get your OpenAI API key: https://platform.openai.com/api-keys",
+    "  Public OpenClaw guide: https://ringading.ai/openclaw"
+  ].join("\n")
+);
 registerCallCommand(program);
 registerStatusCommand(program);
 registerWaitCommand(program);

package/dist/skills/ring-a-ding/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ring-a-ding
-description: Use the rad CLI to place outbound phone calls with an AI voice agent, then check status, wait for completion, or end calls.
-metadata: {"openclaw":{"requires":{"bins":["rad"],"env":["RAD_API_KEY","OPENAI_API_KEY"]},"primaryEnv":"RAD_API_KEY","install":[{"id":"node","kind":"node","package":"ring-a-ding-cli","bins":["rad"],"label":"Install Ring-a-Ding CLI (npm)"}]}}
+description: Use the rad CLI to place outbound AI phone calls. Requires a Ring-a-Ding API key and an OpenAI API key.
+metadata: {"openclaw":{"homepage":"https://ringading.ai/openclaw","requires":{"bins":["rad"],"env":["RAD_API_KEY","OPENAI_API_KEY"]},"primaryEnv":"RAD_API_KEY","install":[{"id":"node","kind":"node","package":"ring-a-ding-cli","bins":["rad"],"label":"Install Ring-a-Ding CLI (npm)"}]}}
 ---
 
 # Ring-a-Ding
@@ -13,6 +13,7 @@ voice conversation, and report back with the outcome.
 
 - The shell tool must be allowed to run `rad`.
 - `RAD_API_KEY` and `OPENAI_API_KEY` must be available for the agent run.
+- Public setup guide: `https://ringading.ai/openclaw`
 
 OpenClaw config example:
 

package/package.json

@@ -1,7 +1,17 @@
 {
 	"name": "ring-a-ding-cli",
-	"version": "0.1.0",
-	"description": "CLI for Ring-a-Ding — give AI agents the ability to make phone calls",
+	"version": "0.1.1",
+	"description": "OpenClaw-ready CLI for Ring-a-Ding AI phone calls",
+	"homepage": "https://ringading.ai/openclaw",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/vlbeta/telephone-mcp.git",
+		"directory": "packages/cli"
+	},
+	"bugs": {
+		"url": "https://github.com/vlbeta/telephone-mcp/issues"
+	},
+	"keywords": ["openclaw", "openclaw-skill", "ai-phone-calls", "voice-agent", "openai", "cli"],
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {
@@ -11,9 +21,13 @@
 	"scripts": {
 		"build": "rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --banner:js='#!/usr/bin/env node' --external:commander && mkdir -p dist/skills && cp -r skills/. dist/skills",
 		"dev": "tsx src/index.ts",
+		"postinstall": "node -e \"if (!process.env.CI && !process.env.npm_config_user_agent?.includes('pnpm')) console.error(['Ring-a-Ding CLI installed.','Get your API key at https://ringading.ai/account','Install the OpenClaw skill with: openclaw skills install ring-a-ding','Docs: https://ringading.ai/openclaw'].join('\\n'))\"",
 		"typecheck": "tsc --noEmit",
 		"test": "vitest run"
 	},
+	"engines": {
+		"node": ">=20.0.0"
+	},
 	"dependencies": {
 		"commander": "^13.0.0"
 	},