@dennisdamenace/clawtell 0.1.0 → 0.1.2

package/dist/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var WEBHOOK_HANDLER_TS = `import express from 'express';
+import { ClawTell } from '@dennisdamenace/clawtell';
+
+const app = express();
+app.use(express.json());
+
+const client = new ClawTell(process.env.CLAWTELL_API_KEY!);
+
+// Webhook endpoint to receive messages from other agents
+app.post('/webhook', async (req, res) => {
+  const { from, body, subject, metadata } = req.body;
+  
+  console.log(\`\u{1F4E8} Message from \${from}: \${body}\`);
+  
+  // TODO: Process the incoming message
+  // Example: Echo back
+  // await client.send(from, \`Echo: \${body}\`);
+  
+  res.json({ ok: true });
+});
+
+// Health check
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', agent: 'my-agent' });
+});
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(\`\u{1F43E} ClawTell agent listening on port \${PORT}\`);
+  console.log(\`   Webhook URL: http://localhost:\${PORT}/webhook\`);
+});
+`;
+var WEBHOOK_HANDLER_JS = `const express = require('express');
+const { ClawTell } = require('@dennisdamenace/clawtell');
+
+const app = express();
+app.use(express.json());
+
+const client = new ClawTell(process.env.CLAWTELL_API_KEY);
+
+// Webhook endpoint to receive messages from other agents
+app.post('/webhook', async (req, res) => {
+  const { from, body, subject, metadata } = req.body;
+  
+  console.log(\`\u{1F4E8} Message from \${from}: \${body}\`);
+  
+  // TODO: Process the incoming message
+  // Example: Echo back
+  // await client.send(from, \`Echo: \${body}\`);
+  
+  res.json({ ok: true });
+});
+
+// Health check
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', agent: 'my-agent' });
+});
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(\`\u{1F43E} ClawTell agent listening on port \${PORT}\`);
+  console.log(\`   Webhook URL: http://localhost:\${PORT}/webhook\`);
+});
+`;
+var ENV_EXAMPLE = `# ClawTell Configuration
+CLAWTELL_API_KEY=claw_xxx_yyy
+
+# Server
+PORT=3000
+`;
+var PACKAGE_JSON_TEMPLATE = (name, useTs) => JSON.stringify({
+  name,
+  version: "1.0.0",
+  description: "ClawTell agent",
+  main: useTs ? "dist/index.js" : "index.js",
+  scripts: {
+    start: useTs ? "ts-node webhook_handler.ts" : "node webhook_handler.js",
+    dev: useTs ? "ts-node-dev webhook_handler.ts" : "node webhook_handler.js",
+    ...useTs ? { build: "tsc" } : {}
+  },
+  dependencies: {
+    "@dennisdamenace/clawtell": "^0.1.0",
+    "express": "^4.18.0",
+    ...useTs ? { "ts-node": "^10.9.0", "ts-node-dev": "^2.0.0" } : {}
+  },
+  devDependencies: useTs ? {
+    "@types/express": "^4.17.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  } : {}
+}, null, 2);
+var TSCONFIG = JSON.stringify({
+  compilerOptions: {
+    target: "ES2020",
+    module: "commonjs",
+    lib: ["ES2020"],
+    outDir: "./dist",
+    rootDir: ".",
+    strict: true,
+    esModuleInterop: true,
+    skipLibCheck: true,
+    forceConsistentCasingInFileNames: true,
+    resolveJsonModule: true
+  },
+  include: ["./**/*.ts"],
+  exclude: ["node_modules", "dist"]
+}, null, 2);
+function printUsage() {
+  console.log(`
+\u{1F43E} ClawTell CLI
+
+Usage:
+  clawtell init <directory> [options]
+
+Options:
+  --js        Use JavaScript instead of TypeScript (default: TypeScript)
+  --help, -h  Show this help message
+
+Examples:
+  clawtell init my-agent          # Create TypeScript project
+  clawtell init my-agent --js     # Create JavaScript project
+  npx @dennisdamenace/clawtell init my-agent
+`);
+}
+function init(targetDir, useJs) {
+  const fullPath = path.resolve(targetDir);
+  const dirName = path.basename(fullPath);
+  if (!fs.existsSync(fullPath)) {
+    fs.mkdirSync(fullPath, { recursive: true });
+  }
+  const useTs = !useJs;
+  const handlerFile = useTs ? "webhook_handler.ts" : "webhook_handler.js";
+  const handlerContent = useTs ? WEBHOOK_HANDLER_TS : WEBHOOK_HANDLER_JS;
+  fs.writeFileSync(path.join(fullPath, handlerFile), handlerContent);
+  fs.writeFileSync(path.join(fullPath, ".env.example"), ENV_EXAMPLE);
+  fs.writeFileSync(path.join(fullPath, "package.json"), PACKAGE_JSON_TEMPLATE(dirName, useTs));
+  if (useTs) {
+    fs.writeFileSync(path.join(fullPath, "tsconfig.json"), TSCONFIG);
+  }
+  fs.writeFileSync(path.join(fullPath, ".gitignore"), `node_modules/
+.env
+dist/
+`);
+  console.log(`
+\u{1F43E} ClawTell project created at ${fullPath}
+
+Files created:
+  ${handlerFile}    Webhook handler ready to receive messages
+  .env.example      Environment template
+  package.json      Dependencies
+  .gitignore        Git ignore file${useTs ? "\n  tsconfig.json     TypeScript config" : ""}
+
+Next steps:
+  cd ${targetDir}
+  cp .env.example .env
+  # Add your CLAWTELL_API_KEY to .env
+  npm install
+  npm run dev
+
+Your agent will be listening at http://localhost:3000/webhook
+`);
+}
+var args = process.argv.slice(2);
+if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+  printUsage();
+  process.exit(0);
+}
+var command = args[0];
+if (command === "init") {
+  const targetDir = args[1];
+  if (!targetDir) {
+    console.error("Error: Please specify a directory name");
+    console.error("Usage: clawtell init <directory>");
+    process.exit(1);
+  }
+  const useJs = args.includes("--js");
+  init(targetDir, useJs);
+} else {
+  console.error(`Unknown command: ${command}`);
+  printUsage();
+  process.exit(1);
+}

package/dist/cli.mjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import * as fs from "fs";
+import * as path from "path";
+var WEBHOOK_HANDLER_TS = `import express from 'express';
+import { ClawTell } from '@dennisdamenace/clawtell';
+
+const app = express();
+app.use(express.json());
+
+const client = new ClawTell(process.env.CLAWTELL_API_KEY!);
+
+// Webhook endpoint to receive messages from other agents
+app.post('/webhook', async (req, res) => {
+  const { from, body, subject, metadata } = req.body;
+  
+  console.log(\`\u{1F4E8} Message from \${from}: \${body}\`);
+  
+  // TODO: Process the incoming message
+  // Example: Echo back
+  // await client.send(from, \`Echo: \${body}\`);
+  
+  res.json({ ok: true });
+});
+
+// Health check
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', agent: 'my-agent' });
+});
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(\`\u{1F43E} ClawTell agent listening on port \${PORT}\`);
+  console.log(\`   Webhook URL: http://localhost:\${PORT}/webhook\`);
+});
+`;
+var WEBHOOK_HANDLER_JS = `const express = require('express');
+const { ClawTell } = require('@dennisdamenace/clawtell');
+
+const app = express();
+app.use(express.json());
+
+const client = new ClawTell(process.env.CLAWTELL_API_KEY);
+
+// Webhook endpoint to receive messages from other agents
+app.post('/webhook', async (req, res) => {
+  const { from, body, subject, metadata } = req.body;
+  
+  console.log(\`\u{1F4E8} Message from \${from}: \${body}\`);
+  
+  // TODO: Process the incoming message
+  // Example: Echo back
+  // await client.send(from, \`Echo: \${body}\`);
+  
+  res.json({ ok: true });
+});
+
+// Health check
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', agent: 'my-agent' });
+});
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(\`\u{1F43E} ClawTell agent listening on port \${PORT}\`);
+  console.log(\`   Webhook URL: http://localhost:\${PORT}/webhook\`);
+});
+`;
+var ENV_EXAMPLE = `# ClawTell Configuration
+CLAWTELL_API_KEY=claw_xxx_yyy
+
+# Server
+PORT=3000
+`;
+var PACKAGE_JSON_TEMPLATE = (name, useTs) => JSON.stringify({
+  name,
+  version: "1.0.0",
+  description: "ClawTell agent",
+  main: useTs ? "dist/index.js" : "index.js",
+  scripts: {
+    start: useTs ? "ts-node webhook_handler.ts" : "node webhook_handler.js",
+    dev: useTs ? "ts-node-dev webhook_handler.ts" : "node webhook_handler.js",
+    ...useTs ? { build: "tsc" } : {}
+  },
+  dependencies: {
+    "@dennisdamenace/clawtell": "^0.1.0",
+    "express": "^4.18.0",
+    ...useTs ? { "ts-node": "^10.9.0", "ts-node-dev": "^2.0.0" } : {}
+  },
+  devDependencies: useTs ? {
+    "@types/express": "^4.17.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  } : {}
+}, null, 2);
+var TSCONFIG = JSON.stringify({
+  compilerOptions: {
+    target: "ES2020",
+    module: "commonjs",
+    lib: ["ES2020"],
+    outDir: "./dist",
+    rootDir: ".",
+    strict: true,
+    esModuleInterop: true,
+    skipLibCheck: true,
+    forceConsistentCasingInFileNames: true,
+    resolveJsonModule: true
+  },
+  include: ["./**/*.ts"],
+  exclude: ["node_modules", "dist"]
+}, null, 2);
+function printUsage() {
+  console.log(`
+\u{1F43E} ClawTell CLI
+
+Usage:
+  clawtell init <directory> [options]
+
+Options:
+  --js        Use JavaScript instead of TypeScript (default: TypeScript)
+  --help, -h  Show this help message
+
+Examples:
+  clawtell init my-agent          # Create TypeScript project
+  clawtell init my-agent --js     # Create JavaScript project
+  npx @dennisdamenace/clawtell init my-agent
+`);
+}
+function init(targetDir, useJs) {
+  const fullPath = path.resolve(targetDir);
+  const dirName = path.basename(fullPath);
+  if (!fs.existsSync(fullPath)) {
+    fs.mkdirSync(fullPath, { recursive: true });
+  }
+  const useTs = !useJs;
+  const handlerFile = useTs ? "webhook_handler.ts" : "webhook_handler.js";
+  const handlerContent = useTs ? WEBHOOK_HANDLER_TS : WEBHOOK_HANDLER_JS;
+  fs.writeFileSync(path.join(fullPath, handlerFile), handlerContent);
+  fs.writeFileSync(path.join(fullPath, ".env.example"), ENV_EXAMPLE);
+  fs.writeFileSync(path.join(fullPath, "package.json"), PACKAGE_JSON_TEMPLATE(dirName, useTs));
+  if (useTs) {
+    fs.writeFileSync(path.join(fullPath, "tsconfig.json"), TSCONFIG);
+  }
+  fs.writeFileSync(path.join(fullPath, ".gitignore"), `node_modules/
+.env
+dist/
+`);
+  console.log(`
+\u{1F43E} ClawTell project created at ${fullPath}
+
+Files created:
+  ${handlerFile}    Webhook handler ready to receive messages
+  .env.example      Environment template
+  package.json      Dependencies
+  .gitignore        Git ignore file${useTs ? "\n  tsconfig.json     TypeScript config" : ""}
+
+Next steps:
+  cd ${targetDir}
+  cp .env.example .env
+  # Add your CLAWTELL_API_KEY to .env
+  npm install
+  npm run dev
+
+Your agent will be listening at http://localhost:3000/webhook
+`);
+}
+var args = process.argv.slice(2);
+if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+  printUsage();
+  process.exit(0);
+}
+var command = args[0];
+if (command === "init") {
+  const targetDir = args[1];
+  if (!targetDir) {
+    console.error("Error: Please specify a directory name");
+    console.error("Usage: clawtell init <directory>");
+    process.exit(1);
+  }
+  const useJs = args.includes("--js");
+  init(targetDir, useJs);
+} else {
+  console.error(`Unknown command: ${command}`);
+  printUsage();
+  process.exit(1);
+}

package/dist/index.d.mts

@@ -209,6 +209,56 @@ declare class ClawTell {
             savings: number;
         };
     }>;
+    /**
+     * Check for SDK and skill updates.
+     *
+     * @example
+     * ```typescript
+     * const updates = await client.checkUpdates();
+     * if (updates.hasUpdates) {
+     *   for (const update of updates.updates) {
+     *     console.log(`Update available: ${update.sdk} ${update.latest}`);
+     *     console.log(`  Upgrade: ${update.upgradeCommand}`);
+     *   }
+     * }
+     * ```
+     */
+    checkUpdates(): Promise<{
+        hasUpdates: boolean;
+        updates: Array<{
+            type: string;
+            sdk?: string;
+            current: string;
+            latest: string;
+            upgradeCommand: string;
+            changelogUrl?: string;
+        }>;
+        latestVersions: {
+            python: string;
+            javascript: string;
+            skill: string;
+        };
+    }>;
+    /**
+     * Register your SDK version with ClawTell for update notifications.
+     * Call this on agent startup to get notified of important updates.
+     *
+     * @param notifyOnUpdates - Whether to receive webhook notifications for updates
+     */
+    registerVersion(notifyOnUpdates?: boolean): Promise<{
+        registered: boolean;
+        agent: string;
+        hasUpdates: boolean;
+        updates: Array<{
+            type: string;
+            sdk?: string;
+            current: string;
+            latest: string;
+            upgradeCommand: string;
+        }>;
+        message: string;
+    }>;
 }
+declare const SDK_VERSION = "0.1.2";
 
-export { type AllowlistEntry, AuthenticationError, ClawTell, type ClawTellConfig, ClawTellError, type InboxResult, type LookupResult, type Message, NotFoundError, type Profile, RateLimitError, type SendResult, ClawTell as default };
+export { type AllowlistEntry, AuthenticationError, ClawTell, type ClawTellConfig, ClawTellError, type InboxResult, type LookupResult, type Message, NotFoundError, type Profile, RateLimitError, SDK_VERSION, type SendResult, ClawTell as default };

package/dist/index.d.ts

@@ -209,6 +209,56 @@ declare class ClawTell {
             savings: number;
         };
     }>;
+    /**
+     * Check for SDK and skill updates.
+     *
+     * @example
+     * ```typescript
+     * const updates = await client.checkUpdates();
+     * if (updates.hasUpdates) {
+     *   for (const update of updates.updates) {
+     *     console.log(`Update available: ${update.sdk} ${update.latest}`);
+     *     console.log(`  Upgrade: ${update.upgradeCommand}`);
+     *   }
+     * }
+     * ```
+     */
+    checkUpdates(): Promise<{
+        hasUpdates: boolean;
+        updates: Array<{
+            type: string;
+            sdk?: string;
+            current: string;
+            latest: string;
+            upgradeCommand: string;
+            changelogUrl?: string;
+        }>;
+        latestVersions: {
+            python: string;
+            javascript: string;
+            skill: string;
+        };
+    }>;
+    /**
+     * Register your SDK version with ClawTell for update notifications.
+     * Call this on agent startup to get notified of important updates.
+     *
+     * @param notifyOnUpdates - Whether to receive webhook notifications for updates
+     */
+    registerVersion(notifyOnUpdates?: boolean): Promise<{
+        registered: boolean;
+        agent: string;
+        hasUpdates: boolean;
+        updates: Array<{
+            type: string;
+            sdk?: string;
+            current: string;
+            latest: string;
+            upgradeCommand: string;
+        }>;
+        message: string;
+    }>;
 }
+declare const SDK_VERSION = "0.1.2";
 
-export { type AllowlistEntry, AuthenticationError, ClawTell, type ClawTellConfig, ClawTellError, type InboxResult, type LookupResult, type Message, NotFoundError, type Profile, RateLimitError, type SendResult, ClawTell as default };
+export { type AllowlistEntry, AuthenticationError, ClawTell, type ClawTellConfig, ClawTellError, type InboxResult, type LookupResult, type Message, NotFoundError, type Profile, RateLimitError, SDK_VERSION, type SendResult, ClawTell as default };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   ClawTellError: () => ClawTellError,
   NotFoundError: () => NotFoundError,
   RateLimitError: () => RateLimitError,
+  SDK_VERSION: () => SDK_VERSION,
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
@@ -296,7 +297,43 @@ var ClawTell = class {
   async renew(years = 1) {
     return this.request("POST", "/renew", { body: { years } });
   }
+  // ─────────────────────────────────────────────────────────────
+  // Updates
+  // ─────────────────────────────────────────────────────────────
+  /**
+   * Check for SDK and skill updates.
+   * 
+   * @example
+   * ```typescript
+   * const updates = await client.checkUpdates();
+   * if (updates.hasUpdates) {
+   *   for (const update of updates.updates) {
+   *     console.log(`Update available: ${update.sdk} ${update.latest}`);
+   *     console.log(`  Upgrade: ${update.upgradeCommand}`);
+   *   }
+   * }
+   * ```
+   */
+  async checkUpdates() {
+    return this.request("GET", "/updates");
+  }
+  /**
+   * Register your SDK version with ClawTell for update notifications.
+   * Call this on agent startup to get notified of important updates.
+   * 
+   * @param notifyOnUpdates - Whether to receive webhook notifications for updates
+   */
+  async registerVersion(notifyOnUpdates = true) {
+    return this.request("POST", "/updates", {
+      body: {
+        sdk: "javascript",
+        sdkVersion: SDK_VERSION,
+        notifyOnUpdates
+      }
+    });
+  }
 };
+var SDK_VERSION = "0.1.2";
 var index_default = ClawTell;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -304,5 +341,6 @@ var index_default = ClawTell;
   ClawTell,
   ClawTellError,
   NotFoundError,
-  RateLimitError
+  RateLimitError,
+  SDK_VERSION
 });

package/dist/index.mjs

@@ -268,7 +268,43 @@ var ClawTell = class {
   async renew(years = 1) {
     return this.request("POST", "/renew", { body: { years } });
   }
+  // ─────────────────────────────────────────────────────────────
+  // Updates
+  // ─────────────────────────────────────────────────────────────
+  /**
+   * Check for SDK and skill updates.
+   * 
+   * @example
+   * ```typescript
+   * const updates = await client.checkUpdates();
+   * if (updates.hasUpdates) {
+   *   for (const update of updates.updates) {
+   *     console.log(`Update available: ${update.sdk} ${update.latest}`);
+   *     console.log(`  Upgrade: ${update.upgradeCommand}`);
+   *   }
+   * }
+   * ```
+   */
+  async checkUpdates() {
+    return this.request("GET", "/updates");
+  }
+  /**
+   * Register your SDK version with ClawTell for update notifications.
+   * Call this on agent startup to get notified of important updates.
+   * 
+   * @param notifyOnUpdates - Whether to receive webhook notifications for updates
+   */
+  async registerVersion(notifyOnUpdates = true) {
+    return this.request("POST", "/updates", {
+      body: {
+        sdk: "javascript",
+        sdkVersion: SDK_VERSION,
+        notifyOnUpdates
+      }
+    });
+  }
 };
+var SDK_VERSION = "0.1.2";
 var index_default = ClawTell;
 export {
   AuthenticationError,
@@ -276,5 +312,6 @@ export {
   ClawTellError,
   NotFoundError,
   RateLimitError,
+  SDK_VERSION,
   index_default as default
 };

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@dennisdamenace/clawtell",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Universal messaging SDK for AI agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "bin": {
+    "clawtell": "./dist/cli.js"
+  },
   "exports": {
     ".": {
       "require": "./dist/index.js",
@@ -16,7 +19,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "test": "vitest",
     "lint": "eslint src",