openclaw-adspirer 0.2.1 → 0.3.0

package/README.md

@@ -13,7 +13,7 @@ OpenClaw plugin for [Adspirer](https://adspirer.com) — manage Google, Meta, Ti
 ## Installation
 
 ```bash
-openclaw plugin install openclaw-adspirer
+openclaw plugins install openclaw-adspirer
 ```
 
 ## Setup
@@ -48,6 +48,7 @@ openclaw adspirer status
 | `openclaw adspirer status` | Show auth status, connections, tool count |
 | `openclaw adspirer accounts` | List connected ad accounts |
 | `openclaw adspirer tools` | List registered tools by platform |
+| `openclaw adspirer connect` | Open Adspirer to connect ad platforms |
 
 ## Tool Groups
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-adspirer",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "OpenClaw plugin for Adspirer — manage Google, Meta, TikTok & LinkedIn ads via natural language",
   "license": "SEE LICENSE IN LICENSE",
@@ -14,7 +14,7 @@
   ],
   "scripts": {
     "check-types": "tsc --noEmit",
-    "test": "ESBUILD_BINARY_PATH=./node_modules/@esbuild/linux-x64/bin/esbuild tsx --test tests/*.test.ts",
+    "test": "tsx --test tests/*.test.ts",
     "build": "tsc"
   },
   "peerDependencies": {
@@ -26,10 +26,8 @@
     ]
   },
   "devDependencies": {
-    "@esbuild/linux-x64": "^0.27.2",
     "@types/node": "^22.0.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^3.0.0"
+    "typescript": "^5.9.3"
   }
 }

package/src/commands/cli.ts

@@ -16,6 +16,7 @@ import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
 const PLUGIN_ID = "openclaw-adspirer";
+const PLUGIN_VERSION = "0.3.0";
 
 function getConfigPath(): string {
   return join(process.env.HOME || process.env.USERPROFILE || ".", ".openclaw", "openclaw.json");
@@ -85,6 +86,13 @@ export function registerCommands(
         .action(async () => {
           await handleTools(config);
         });
+
+      cmd
+        .command("connect")
+        .description("Open Adspirer to connect ad platforms")
+        .action(async () => {
+          await handleConnect();
+        });
     },
     { commands: ["adspirer"] },
   );
@@ -121,6 +129,7 @@ async function handleLogin(api: OpenClawPluginApi, config: AdspirerConfig): Prom
 
         // Persist client_id so we don't re-register every login
         patchPluginConfig({ oauthClientId: clientId });
+        config.oauthClientId = clientId;
       } catch (regErr: any) {
         callbackServer.close();
         throw new Error(`Client registration failed: ${regErr.message}`);
@@ -159,7 +168,7 @@ async function handleLogin(api: OpenClawPluginApi, config: AdspirerConfig): Prom
       // Browser open failed, user can use the URL
     }
 
-    console.log("⏳ Waiting for authentication (30s timeout)...\n");
+    console.log("⏳ Waiting for authentication (120s timeout)...\n");
 
     const { code, state: returnedState } = await callbackServer.waitForCallback();
     callbackServer.close();
@@ -185,6 +194,7 @@ async function handleLogin(api: OpenClawPluginApi, config: AdspirerConfig): Prom
     });
 
     console.log(`✅ Connected to Adspirer! Restart the gateway to load all tools.`);
+    console.log(`\n   📌 Connect your ad platforms at https://www.adspirer.com`);
   } catch (err: any) {
     console.log(`❌ Login failed: ${err.message}`);
   }
@@ -200,6 +210,8 @@ async function handleLogout(api: OpenClawPluginApi): Promise<void> {
 }
 
 async function handleStatus(client: AdspirerMCPClient, config: AdspirerConfig): Promise<void> {
+  console.log(`\n📦 openclaw-adspirer v${PLUGIN_VERSION}\n`);
+
   if (config.testMode) {
     console.log("🧪 Test Mode Active");
     console.log(`   Server: ${config.serverUrl}`);
@@ -230,6 +242,16 @@ async function handleStatus(client: AdspirerMCPClient, config: AdspirerConfig):
     console.log("\n⚠️  Could not fetch connection status.");
   }
 
+  // Try to get usage/quota status
+  try {
+    const result = await client.callTool("get_usage_status", {});
+    if (result.content?.[0]?.text) {
+      console.log(`\n📊 Plan & Usage:\n${result.content[0].text}`);
+    }
+  } catch {
+    // Quota info not available
+  }
+
   // Show tool count
   const tools = config.enabledTools.length > 0
     ? config.enabledTools
@@ -276,3 +298,22 @@ async function handleTools(config: AdspirerConfig): Promise<void> {
 
   console.log(`\nTotal enabled: ${total}`);
 }
+
+async function handleConnect(): Promise<void> {
+  const url = "https://www.adspirer.com";
+  console.log("🔗 Connect your ad platforms at Adspirer:\n");
+  console.log(`   ${url}\n`);
+  console.log("   Supported platforms:");
+  console.log("   • Google Ads");
+  console.log("   • Meta Ads");
+  console.log("   • LinkedIn Ads");
+  console.log("   • TikTok Ads");
+
+  try {
+    const { execFile } = await import("node:child_process");
+    const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    execFile(openCmd, [url], (err) => { /* ignore browser open failures */ });
+  } catch {
+    // Browser open failed, user can visit the URL manually
+  }
+}

package/src/config.ts

@@ -41,7 +41,8 @@ export function parseConfig(raw: unknown): AdspirerConfig {
 export function isAuthenticated(config: AdspirerConfig): boolean {
   if (config.testMode) return true;
   if (!config.accessToken) return false;
-  if (config.tokenExpiresAt && config.tokenExpiresAt < Date.now()) return false;
+  // Allow expired tokens through if we have a refresh token — getToken() will refresh
+  if (config.tokenExpiresAt && config.tokenExpiresAt < Date.now() && !config.refreshToken) return false;
   return true;
 }
 

package/src/index.ts

@@ -71,6 +71,18 @@ export default {
       api.logger,
     );
 
+    // If token is expired but we have a refresh token, refresh before registering tools
+    if (isAuthenticated(config) && config.tokenExpiresAt && config.tokenExpiresAt < Date.now()) {
+      try {
+        api.logger.info("adspirer: token expired, refreshing...");
+        const tokens = await doRefresh();
+        saveTokens(api, config, tokens);
+        api.logger.info("adspirer: token refreshed successfully");
+      } catch (err) {
+        api.logger.warn(`adspirer: token refresh failed: ${err}`);
+      }
+    }
+
     // Register tools
     if (isAuthenticated(config)) {
       try {
@@ -100,13 +112,15 @@ function saveTokens(api: OpenClawPluginApi, config: AdspirerConfig, tokens: Toke
     const path = require("node:path");
     const configPath = path.join(process.env.HOME || ".", ".openclaw", "openclaw.json");
     const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-    const entry = raw?.plugins?.entries?.["openclaw-adspirer"];
-    if (entry?.config) {
-      entry.config.accessToken = tokens.accessToken;
-      entry.config.refreshToken = tokens.refreshToken;
-      entry.config.tokenExpiresAt = tokens.expiresAt;
-      fs.writeFileSync(configPath, JSON.stringify(raw, null, 2) + "\n");
-    }
+    if (!raw.plugins) raw.plugins = {};
+    if (!raw.plugins.entries) raw.plugins.entries = {};
+    if (!raw.plugins.entries["openclaw-adspirer"]) raw.plugins.entries["openclaw-adspirer"] = { enabled: true, config: {} };
+    if (!raw.plugins.entries["openclaw-adspirer"].config) raw.plugins.entries["openclaw-adspirer"].config = {};
+    const entry = raw.plugins.entries["openclaw-adspirer"];
+    entry.config.accessToken = tokens.accessToken;
+    entry.config.refreshToken = tokens.refreshToken;
+    entry.config.tokenExpiresAt = tokens.expiresAt;
+    fs.writeFileSync(configPath, JSON.stringify(raw, null, 2) + "\n");
   } catch {
     api.logger.warn("Could not persist tokens to config file");
   }

package/src/tool-registry.ts

@@ -101,7 +101,7 @@ export function registerConnectTool(api: OpenClawPluginApi): void {
       execute: async () => ({
         content: [{
           type: "text" as const,
-          text: "🔑 You're not connected to Adspirer yet.\n\nRun `openclaw adspirer login` in your terminal to authenticate.\n\nOnce connected, you'll have access to 103 ad management tools across Google, Meta, TikTok, and LinkedIn.",
+          text: "🔑 You're not connected to Adspirer yet.\n\nRun `openclaw adspirer login` in your terminal to authenticate.\n\nThen connect your ad platforms at https://www.adspirer.com\n\nOnce connected, you'll have access to 103 ad management tools across Google, Meta, TikTok, and LinkedIn.",
         }],
       }),
     },