routstrd 0.2.2 → 0.2.4

package/SKILL.md

@@ -113,11 +113,36 @@ List all registered clients with their ID, name, API key, and creation date.
 
 #### `routstrd clients add`
 
-Add a new client.
+Add a new client or set up a client integration.
 
 | Option | Description |
 |--------|-------------|
-| `-n, --name <name>` | **Required.** Client name |
+| `-n, --name <name>` | Client name (required when not using integration flags) |
+| `--opencode` | Set up OpenCode integration |
+| `--openclaw` | Set up OpenClaw integration |
+| `--pi-agent` | Set up Pi Agent integration |
+| `--claude-code` | Set up Claude Code integration |
+
+Set up a specific client integration (creates API key and writes config to the client's config file):
+
+```sh
+routstrd clients add --opencode
+routstrd clients add --claude-code
+routstrd clients add --pi-agent
+routstrd clients add --openclaw
+```
+
+You can also set up multiple integrations at once:
+
+```sh
+routstrd clients add --opencode --pi-agent --claude-code
+```
+
+Add a generic client manually:
+
+```sh
+routstrd clients add -n "My App"
+```
 
 Returns the client ID and API key for use with the OpenAI-compatible API.
 

package/dist/daemon/index.js

@@ -30266,6 +30266,8 @@ var import_rxjs24, InsufficientBalanceError, ProviderError, MintUnreachableError
     const msg = error.message.toLowerCase();
     if (msg.includes("fetch failed"))
       return true;
+    if (msg.includes("429"))
+      return true;
     if (msg.includes("502"))
       return true;
     if (msg.includes("503"))
@@ -30474,6 +30476,8 @@ var import_rxjs24, InsufficientBalanceError, ProviderError, MintUnreachableError
     const msg = error.message.toLowerCase();
     if (msg.includes("fetch failed"))
       return true;
+    if (msg.includes("429"))
+      return true;
     if (msg.includes("502"))
       return true;
     if (msg.includes("503"))
@@ -33881,9 +33885,10 @@ var import_rxjs24, InsufficientBalanceError, ProviderError, MintUnreachableError
       try {
         const currentBalanceInfo = await this.balanceManager.getTokenBalance(params.token, baseUrl);
         const currentBalance = currentBalanceInfo.unit === "msat" ? currentBalanceInfo.amount / 1000 : currentBalanceInfo.amount;
-        const shortfall = Math.max(0, params.requiredSats - currentBalance);
+        const reservedBalance = currentBalanceInfo.unit === "msat" ? (currentBalanceInfo.reserved ?? 0) / 1000 : currentBalanceInfo.reserved ?? 0;
+        const shortfall = Math.max(0, params.requiredSats - currentBalance + reservedBalance);
         topupAmount = shortfall > 0.21 * params.requiredSats ? shortfall : 0.21 * params.requiredSats;
-        this._log("DEBUG", `The shortfall is: ${shortfall}. requiredSats: ${params.requiredSats}. Current Balance: ${currentBalance} `);
+        this._log("DEBUG", `The shortfall is: ${shortfall}. requiredSats: ${params.requiredSats}. Current Balance: ${currentBalance}. Reserved Balance: ${reservedBalance}. Available Balance: ${currentBalance - reservedBalance}`);
       } catch (e) {
         this._log("WARN", "Could not get current token balance for topup calculation:", e);
       }
@@ -33974,8 +33979,8 @@ var import_rxjs24, InsufficientBalanceError, ProviderError, MintUnreachableError
         tryNextProvider = true;
       }
     }
-    if ((status === 401 || status === 403 || status === 413 || status === 400 || status === 500 || status === 502 || status === 503 || status === 504 || status === 521) && !tryNextProvider) {
-      this._log("DEBUG", `[RoutstrClient] _handleErrorResponse: Status ${status} (auth/server error), attempting refund for ${baseUrl}, mode=${this.mode}`);
+    if ((status === 401 || status === 403 || status === 413 || status === 400 || status === 429 || status === 500 || status === 502 || status === 503 || status === 504 || status === 521) && !tryNextProvider) {
+      this._log("DEBUG", `[RoutstrClient] _handleErrorResponse: Status ${status} (${status === 429 ? "rate limited" : "auth/server error"}), attempting refund for ${baseUrl}, mode=${this.mode}`);
       if (this.mode === "apikeys") {
         this._log("DEBUG", `[RoutstrClient] _handleErrorResponse: Attempting API key refund for ${baseUrl}, key preview=${token}`);
         const latestBalanceInfo = await this.balanceManager.getTokenBalance(token, baseUrl);

package/dist/index.js

@@ -29058,6 +29058,12 @@ var CLIENT_CONFIGS = {
     configPath: join2(process.env.HOME || "", ".claude/settings.json")
   }
 };
+var CLIENT_INTEGRATIONS = {
+  opencode: installOpencodeIntegration,
+  "pi-agent": installPiIntegration,
+  openclaw: installOpenClawIntegration,
+  "claude-code": installClaudeCodeIntegration
+};
 
 // src/integrations/opencode.ts
 var OPENCODE_SMALL_MODEL = "routstr/minimax-m2.5";
@@ -37300,9 +37306,49 @@ clientsCmd.command("list").description("List all clients").action(async () => {
     console.log("");
   }
 });
-clientsCmd.command("add").description("Add a new client").requiredOption("-n, --name <name>", "Client name").action(async (options) => {
+clientsCmd.command("add").description("Add a new client or set up client integrations").option("-n, --name <name>", "Client name").option("--opencode", "Set up OpenCode integration").option("--openclaw", "Set up OpenClaw integration").option("--pi-agent", "Set up Pi Agent integration").option("--claude-code", "Set up Claude Code integration").action(async (options) => {
   await ensureDaemonRunning();
   const config = await loadConfig();
+  const integrationKeys = [];
+  if (options.opencode)
+    integrationKeys.push("opencode");
+  if (options.openclaw)
+    integrationKeys.push("openclaw");
+  if (options.piAgent)
+    integrationKeys.push("pi-agent");
+  if (options.claudeCode)
+    integrationKeys.push("claude-code");
+  if (integrationKeys.length > 0) {
+    const sqliteDriver = await createBunSqliteDriver(DB_PATH);
+    const { store } = await createSdkStore({ driver: sqliteDriver });
+    for (const key of integrationKeys) {
+      const integrationFn = CLIENT_INTEGRATIONS[key];
+      const integrationConfig = CLIENT_CONFIGS[key];
+      if (!integrationFn || !integrationConfig)
+        continue;
+      try {
+        await integrationFn(config, store, integrationConfig);
+      } catch (error) {
+        logger.error(`Failed to set up ${integrationConfig.name} integration:`, error);
+        continue;
+      }
+      const state = store.getState();
+      const client2 = (state.clientIds || []).find((c) => c.clientId === key);
+      if (client2) {
+        console.log(`
+  ${integrationConfig.name}:`);
+        console.log(`    Client ID: ${client2.clientId}`);
+        console.log(`    API Key:   ${client2.apiKey}`);
+      }
+    }
+    console.log(`
+  Access Routstr at: http://localhost:${config.port || 8008}`);
+    return;
+  }
+  if (!options.name) {
+    console.error("error: required option '-n, --name <name>' not specified");
+    process.exit(1);
+  }
   const result = await callDaemon("/clients/add", {
     method: "POST",
     body: { name: options.name }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "routstrd",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "module": "src/index.ts",
   "type": "module",
   "private": false,
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@cashu/cashu-ts": "^3.1.1",
-    "@routstr/sdk": "^0.3.0",
+    "@routstr/sdk": "^0.3.1",
     "applesauce-core": "^5.1.0",
     "applesauce-relay": "^5.1.0",
     "commander": "^14.0.2",

package/src/cli.ts

@@ -18,7 +18,11 @@ import {
   type RoutstrdConfig,
 } from "./utils/config";
 import { logger } from "./utils/logger";
-import { setupIntegration } from "./integrations";
+import {
+  setupIntegration,
+  CLIENT_CONFIGS,
+  CLIENT_INTEGRATIONS,
+} from "./integrations";
 import { createSdkStore } from "@routstr/sdk";
 import { createBunSqliteDriver } from "@routstr/sdk/storage";
 import * as QRCode from "qrcode";
@@ -657,12 +661,71 @@ clientsCmd
 
 clientsCmd
   .command("add")
-  .description("Add a new client")
-  .requiredOption("-n, --name <name>", "Client name")
-  .action(async (options: { name: string }) => {
+  .description("Add a new client or set up client integrations")
+  .option("-n, --name <name>", "Client name")
+  .option("--opencode", "Set up OpenCode integration")
+  .option("--openclaw", "Set up OpenClaw integration")
+  .option("--pi-agent", "Set up Pi Agent integration")
+  .option("--claude-code", "Set up Claude Code integration")
+  .action(async (options: {
+    name?: string;
+    opencode?: boolean;
+    openclaw?: boolean;
+    piAgent?: boolean;
+    claudeCode?: boolean;
+  }) => {
     await ensureDaemonRunning();
     const config = await loadConfig();
 
+    const integrationKeys: string[] = [];
+    if (options.opencode) integrationKeys.push("opencode");
+    if (options.openclaw) integrationKeys.push("openclaw");
+    if (options.piAgent) integrationKeys.push("pi-agent");
+    if (options.claudeCode) integrationKeys.push("claude-code");
+
+    if (integrationKeys.length > 0) {
+      const sqliteDriver = await createBunSqliteDriver(DB_PATH);
+      const { store } = await createSdkStore({ driver: sqliteDriver });
+
+      for (const key of integrationKeys) {
+        const integrationFn = CLIENT_INTEGRATIONS[key];
+        const integrationConfig = CLIENT_CONFIGS[key];
+        if (!integrationFn || !integrationConfig) continue;
+
+        try {
+          await integrationFn(config, store, integrationConfig);
+        } catch (error) {
+          logger.error(
+            `Failed to set up ${integrationConfig.name} integration:`,
+            error,
+          );
+          continue;
+        }
+
+        const state = store.getState();
+        const client = (state.clientIds || []).find(
+          (c: { clientId: string }) => c.clientId === key,
+        );
+        if (client) {
+          console.log(`\n  ${integrationConfig.name}:`);
+          console.log(`    Client ID: ${client.clientId}`);
+          console.log(`    API Key:   ${client.apiKey}`);
+        }
+      }
+
+      console.log(
+        `\n  Access Routstr at: http://localhost:${config.port || 8008}`,
+      );
+      return;
+    }
+
+    if (!options.name) {
+      console.error(
+        "error: required option '-n, --name <name>' not specified",
+      );
+      process.exit(1);
+    }
+
     const result = await callDaemon("/clients/add", {
       method: "POST",
       body: { name: options.name },