@dimcool/dimclaw 0.1.17 → 0.1.19

package/dim-client.ts

@@ -185,6 +185,29 @@ export class DimClient {
     return this.eventQueue.length;
   }
 
+  // ── Daily spend tracking ──────────────────────────────────────────────
+
+  private dailySpendMinor = 0;
+  private spendResetDate = '';
+
+  private resetDailySpendIfNeeded(): void {
+    const today = new Date().toISOString().slice(0, 10);
+    if (this.spendResetDate !== today) {
+      this.dailySpendMinor = 0;
+      this.spendResetDate = today;
+    }
+  }
+
+  recordSpend(amountMinor: number): void {
+    this.resetDailySpendIfNeeded();
+    this.dailySpendMinor += amountMinor;
+  }
+
+  get dailySpentDollars(): number {
+    this.resetDailySpendIfNeeded();
+    return this.dailySpendMinor / 1_000_000;
+  }
+
   getKeypair(): Keypair {
     return this.keypair;
   }

package/dist/index.js

@@ -57439,6 +57439,24 @@ var DimClient = class {
   get pendingEventCount() {
     return this.eventQueue.length;
   }
+  // ── Daily spend tracking ──────────────────────────────────────────────
+  dailySpendMinor = 0;
+  spendResetDate = "";
+  resetDailySpendIfNeeded() {
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    if (this.spendResetDate !== today) {
+      this.dailySpendMinor = 0;
+      this.spendResetDate = today;
+    }
+  }
+  recordSpend(amountMinor) {
+    this.resetDailySpendIfNeeded();
+    this.dailySpendMinor += amountMinor;
+  }
+  get dailySpentDollars() {
+    this.resetDailySpendIfNeeded();
+    return this.dailySpendMinor / 1e6;
+  }
   getKeypair() {
     return this.keypair;
   }
@@ -57501,6 +57519,194 @@ async function resolveWalletKey(config) {
   await writeWalletFile(storePath, record3);
   return record3.walletPrivateKey;
 }
+function generateOnboardingScript(platform, referrer) {
+  const templates = {
+    openclaw: `# Connect to DIM \u2014 OpenClaw Setup
+
+## Step 1: Install the DIM plugin
+\`\`\`bash
+openclaw plugins install @dimcool/dimclaw
+\`\`\`
+
+## Step 2: Configure
+Add to your OpenClaw config under \`plugins.entries.dimclaw.config\`:
+\`\`\`yaml
+plugins:
+  entries:
+    dimclaw:
+      enabled: true
+      config:
+        walletStorePath: '~/.dim/openclaw-wallet.json'
+\`\`\`
+A wallet will be created automatically on first run.
+
+## Step 3: Restart and verify
+\`\`\`bash
+openclaw gateway restart
+\`\`\`
+
+Then ask your agent to run:
+1. \`dim_login\`
+2. \`dim_apply_referral_code\` with referralCode: \`${referrer}\`
+3. \`dim_get_balance\`
+
+## Step 4: Fund your wallet
+Send USDC on Solana to the wallet address shown by \`dim_get_balance\`. Even $5 is enough to start playing.
+
+You now have a 10% fee discount on all games thanks to the referral code!`,
+    "claude-desktop": `# Connect to DIM \u2014 Claude Desktop Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+Copy the wallet store path from the output.
+
+## Step 2: Edit your Claude Desktop config
+Open \`~/Library/Application Support/Claude/claude_desktop_config.json\` (macOS) or \`%APPDATA%\\Claude\\claude_desktop_config.json\` (Windows).
+
+Add this to the \`mcpServers\` section:
+\`\`\`json
+{
+  "mcpServers": {
+    "dim": {
+      "command": "npx",
+      "args": ["@dimcool/mcp"],
+      "env": {
+        "DIM_WALLET_STORE_PATH": "/path/from/init-wallet/output",
+        "DIM_API_URL": "https://api.dim.cool",
+        "DIM_REFERRAL_CODE": "${referrer}"
+      }
+    }
+  }
+}
+\`\`\`
+Replace \`/path/from/init-wallet/output\` with the actual path from step 1.
+
+## Step 3: Restart Claude Desktop
+Quit and reopen Claude Desktop. The referral code \`${referrer}\` will be applied on first login automatically.
+
+## Step 4: Verify
+Ask Claude: "Log in to DIM and check my balance"
+Claude will call \`dim_login\` then \`dim_get_balance\`.
+
+## Step 5: Fund your wallet
+Send USDC on Solana to the wallet address shown. Even $5 is enough to start.
+
+You have a 10% fee discount on all games thanks to the referral code!`,
+    cursor: `# Connect to DIM \u2014 Cursor Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+Copy the wallet store path from the output.
+
+## Step 2: Edit your Cursor MCP config
+Create or edit \`.cursor/mcp.json\` in your project root:
+\`\`\`json
+{
+  "mcpServers": {
+    "dim": {
+      "command": "npx",
+      "args": ["@dimcool/mcp"],
+      "env": {
+        "DIM_WALLET_STORE_PATH": "/path/from/init-wallet/output",
+        "DIM_API_URL": "https://api.dim.cool",
+        "DIM_REFERRAL_CODE": "${referrer}"
+      }
+    }
+  }
+}
+\`\`\`
+Replace \`/path/from/init-wallet/output\` with the actual path from step 1.
+
+## Step 3: Restart Cursor
+The referral code \`${referrer}\` will be applied on first login automatically.
+
+## Step 4: Verify
+Ask: "Log in to DIM and check my balance"
+
+## Step 5: Fund your wallet
+Send USDC on Solana to the wallet address shown. Even $5 is enough to start.`,
+    hermes: `# Connect to DIM \u2014 Hermes Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+Copy the wallet store path.
+
+## Step 2: Add DIM as a Hermes skill
+In your Hermes config, add:
+\`\`\`yaml
+skills:
+  dim:
+    command: npx
+    args: ["@dimcool/mcp"]
+    env:
+      DIM_WALLET_STORE_PATH: "/path/from/init-wallet/output"
+      DIM_API_URL: "https://api.dim.cool"
+      DIM_REFERRAL_CODE: "${referrer}"
+\`\`\`
+
+## Step 3: Restart Hermes
+The referral code \`${referrer}\` will be applied on first login.
+
+## Step 4: Verify
+Call \`dim_login\` then \`dim_get_balance\`.
+
+## Step 5: Fund your wallet
+Send USDC on Solana to the wallet address shown.`,
+    "node-sdk": `# Connect to DIM \u2014 Node.js SDK Setup
+
+## Step 1: Install packages
+\`\`\`bash
+npm install @dimcool/sdk @dimcool/wallet
+\`\`\`
+
+## Step 2: Initialize and connect
+\`\`\`typescript
+import { SDK, NodeStorage } from '@dimcool/sdk';
+import { Wallet } from '@dimcool/wallet';
+
+const wallet = new Wallet({
+  enabledNetworks: ['solana'],
+  fromPrivateKey: process.env.DIM_WALLET_PRIVATE_KEY!,
+});
+
+const sdk = new SDK({
+  appId: 'dim-agents',
+  baseUrl: 'https://api.dim.cool',
+  storage: new NodeStorage(),
+  autoPay: { enabled: true, maxAmountMinor: 20_000 },
+});
+
+sdk.wallet.setSigner(wallet.getSigner());
+
+const { access_token, user } = await sdk.auth.loginWithWallet({
+  referralCode: '${referrer}',
+});
+
+sdk.wsTransport.setAccessToken(access_token);
+await sdk.ensureWebSocketConnected(10000);
+
+console.log('Connected as', user.username, '\u2014 wallet:', wallet.getAddresses().solana);
+\`\`\`
+
+## Step 3: Fund your wallet
+Send USDC on Solana to the wallet address. Even $5 is enough to start.
+
+The referral code \`${referrer}\` gives you a 10% fee discount on all games.
+
+Full docs: https://docs.dim.cool`
+  };
+  const script = templates[platform];
+  if (!script) {
+    return `Unknown platform "${platform}". Supported: openclaw, claude-desktop, cursor, hermes, node-sdk`;
+  }
+  return script;
+}
 function textResult(text, isError = false) {
   return {
     content: [{ type: "text", text }],
@@ -57509,15 +57715,32 @@ function textResult(text, isError = false) {
 }
 function register(api) {
   let client = null;
+  let pluginConfig = null;
+  function checkSpendLimit(c, amountDollars, isGameBet = false) {
+    if (!pluginConfig) return null;
+    if (isGameBet) {
+      const maxBet = pluginConfig.maxBetPerGame ?? 1;
+      if (amountDollars > maxBet) {
+        return `Bet $${amountDollars.toFixed(2)} exceeds maxBetPerGame limit of $${maxBet.toFixed(2)}. Ask your operator to increase maxBetPerGame in the plugin config if needed.`;
+      }
+    }
+    const limit = pluginConfig.dailySpendLimit ?? 20;
+    const projected = c.dailySpentDollars + amountDollars;
+    if (projected > limit) {
+      return `Daily spend limit reached ($${c.dailySpentDollars.toFixed(2)} spent of $${limit.toFixed(2)} limit). This action would cost $${amountDollars.toFixed(2)}. Ask your operator to increase dailySpendLimit in the plugin config if you need more.`;
+    }
+    return null;
+  }
   async function getClient() {
     if (client) return client;
-    const config = getPluginConfig(api);
-    if (!config) return null;
-    const walletPrivateKey = await resolveWalletKey(config);
+    pluginConfig = getPluginConfig(api);
+    if (!pluginConfig) return null;
+    const walletPrivateKey = await resolveWalletKey(pluginConfig);
     if (!walletPrivateKey) return null;
     client = new DimClient({
       walletPrivateKey,
-      apiUrl: config.apiUrl
+      apiUrl: pluginConfig.apiUrl,
+      heartbeatPath: pluginConfig.heartbeatPath
     });
     return client;
   }
@@ -57563,11 +57786,24 @@ function register(api) {
           }
         } catch {
         }
+        const booleanExists = (value2, defaultValue) => typeof value2 === "boolean" ? value2 : defaultValue;
         const response = {
           success: true,
           userId: result.userId,
           username: result.username ?? null,
           walletAddress: c.walletAddress,
+          agentConfig: {
+            autoAcceptFriendRequests: booleanExists(
+              pluginConfig?.autoAcceptFriendRequests,
+              true
+            ),
+            autoReplyDms: booleanExists(pluginConfig?.autoReplyDms, true),
+            autoPlayGames: booleanExists(pluginConfig?.autoPlayGames, true),
+            maxBetPerGame: pluginConfig?.maxBetPerGame ?? 1,
+            dailySpendLimit: pluginConfig?.dailySpendLimit ?? 20,
+            autoJoinGlobalChat: booleanExists(pluginConfig?.autoJoinGlobalChat, true),
+            autoPromoteReferrals: booleanExists(pluginConfig?.autoPromoteReferrals, true)
+          },
           nextSteps
         };
         return textResult(JSON.stringify(response, null, 2));
@@ -57780,6 +58016,14 @@ function register(api) {
     {
       name: "dim_check_notifications",
       description: "Check unread notifications, DMs, and friend requests in one call."
+    },
+    {
+      name: "dim_get_agent_config",
+      description: "Get autonomy scopes, spending limits, and current daily spend."
+    },
+    {
+      name: "dim_get_referral_onboarding",
+      description: "Get platform-specific setup instructions to share with another agent, with your referral code embedded."
     }
   ];
   api.registerTool({
@@ -57845,9 +58089,12 @@ function register(api) {
       if ("error" in c) return c.error;
       const recipient = String(params.recipient ?? "");
       const amount = Number(params.amount ?? 0);
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1e6);
         const result = await c.sdk.wallet.send(recipient, amountMinor);
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -57894,9 +58141,12 @@ function register(api) {
       if ("error" in c) return c.error;
       const recipientUsername = String(params.recipientUsername ?? "");
       const amount = Number(params.amount ?? 0);
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1e6);
         const result = await c.sdk.tips.send(recipientUsername, amountMinor);
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -58285,9 +58535,15 @@ function register(api) {
       const c = await requireClient();
       if ("error" in c) return c.error;
       const gameType = String(params.gameType ?? "");
-      const betAmount = typeof params.betAmount === "number" ? Math.round(params.betAmount * 1e6) : void 0;
+      const betDollars = typeof params.betAmount === "number" ? params.betAmount : 0;
+      const betAmount = betDollars > 0 ? Math.round(betDollars * 1e6) : void 0;
+      if (betDollars > 0) {
+        const limitErr = checkSpendLimit(c, betDollars, true);
+        if (limitErr) return textResult(limitErr, true);
+      }
       try {
         const lobby = await c.sdk.lobbies.createLobby(gameType, betAmount);
+        if (betAmount) c.recordSpend(betAmount);
         return textResult(
           JSON.stringify(
             {
@@ -58485,12 +58741,15 @@ function register(api) {
       const c = await requireClient();
       if ("error" in c) return c.error;
       const amount = Number(params.amount ?? 0);
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1e6);
         const result = await c.sdk.games.sendDonation(
           String(params.gameId ?? ""),
           amountMinor
         );
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -59071,6 +59330,8 @@ function register(api) {
       const amount = Number(params.amount ?? 0);
       const gameId = String(params.gameId ?? "");
       const outcomeId = String(params.outcomeId ?? "");
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1e6);
         const { transaction: txBase64 } = await c.sdk.markets.prepareBuyOrder(
@@ -59087,6 +59348,7 @@ function register(api) {
           outcomeId,
           amountMinor
         );
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -59274,6 +59536,71 @@ function register(api) {
       }
     }
   });
+  api.registerTool({
+    name: "dim_get_agent_config",
+    description: "Get the agent autonomy configuration: what actions are allowed (friends, DMs, games, chat, referral promotion), spending limits, and current daily spend.",
+    parameters: { type: "object", properties: {}, additionalProperties: false },
+    async execute() {
+      const c = await requireClient();
+      if ("error" in c) return c.error;
+      return textResult(
+        JSON.stringify(
+          {
+            autoAcceptFriendRequests: pluginConfig?.autoAcceptFriendRequests ?? false,
+            autoReplyDms: pluginConfig?.autoReplyDms ?? false,
+            autoPlayGames: pluginConfig?.autoPlayGames ?? false,
+            maxBetPerGame: pluginConfig?.maxBetPerGame ?? 1,
+            dailySpendLimit: pluginConfig?.dailySpendLimit ?? 20,
+            dailySpentSoFar: `$${c.dailySpentDollars.toFixed(2)}`,
+            dailyRemaining: `$${Math.max(0, (pluginConfig?.dailySpendLimit ?? 20) - c.dailySpentDollars).toFixed(2)}`,
+            autoJoinGlobalChat: pluginConfig?.autoJoinGlobalChat ?? false,
+            autoPromoteReferrals: pluginConfig?.autoPromoteReferrals ?? false,
+            hint: "These scopes are set by your operator in the plugin config. If you need higher limits, ask your operator to update dailySpendLimit or maxBetPerGame."
+          },
+          null,
+          2
+        )
+      );
+    }
+  });
+  api.registerTool({
+    name: "dim_get_referral_onboarding",
+    description: "Get platform-specific setup instructions to share with another agent or user to onboard them to DIM with your referral code. The instructions include your referral code so the new user is attributed to you.",
+    parameters: {
+      type: "object",
+      properties: {
+        platform: {
+          type: "string",
+          enum: ["openclaw", "claude-desktop", "cursor", "hermes", "node-sdk"],
+          description: "Target platform: openclaw, claude-desktop, cursor, hermes, or node-sdk"
+        }
+      },
+      required: ["platform"],
+      additionalProperties: false
+    },
+    async execute(_, params) {
+      const c = await requireClient();
+      if ("error" in c) return c.error;
+      try {
+        let username = "YOUR_USERNAME";
+        try {
+          if (c.currentUserId) {
+            const profile = await c.sdk.users.getUserById(c.currentUserId);
+            if (profile.username) username = profile.username;
+          }
+        } catch {
+        }
+        const platform = String(params.platform ?? "openclaw");
+        const script = generateOnboardingScript(platform, username);
+        return textResult(script);
+      } catch (err) {
+        return textResult(
+          `Failed to generate onboarding script: ${err instanceof Error ? err.message : String(err)}`,
+          true
+        );
+      }
+    }
+  });
   api.registerTool({
     name: "dim_get_pending_events",
     description: "Drain buffered real-time events (DMs, challenges, game turns, match notifications). Call this regularly during game loops or idle time to stay aware of incoming activity.",

package/index.ts

@@ -14,6 +14,15 @@ type PluginConfig = {
   walletPrivateKey?: string;
   walletStorePath?: string;
   apiUrl?: string;
+  heartbeatPath?: string;
+  // Autonomy scopes
+  autoAcceptFriendRequests?: boolean;
+  autoReplyDms?: boolean;
+  autoPlayGames?: boolean;
+  maxBetPerGame?: number;
+  dailySpendLimit?: number;
+  autoJoinGlobalChat?: boolean;
+  autoPromoteReferrals?: boolean;
 };
 
 function getPluginConfig(api: { config?: unknown }): PluginConfig | null {
@@ -93,6 +102,200 @@ async function resolveWalletKey(config: PluginConfig): Promise<string | null> {
   return record.walletPrivateKey;
 }
 
+function generateOnboardingScript(platform: string, referrer: string): string {
+  const templates: Record<string, string> = {
+    openclaw: `# Connect to DIM — OpenClaw Setup
+
+## Step 1: Install the DIM plugin
+\`\`\`bash
+openclaw plugins install @dimcool/dimclaw
+\`\`\`
+
+## Step 2: Configure
+Add to your OpenClaw config under \`plugins.entries.dimclaw.config\`:
+\`\`\`yaml
+plugins:
+  entries:
+    dimclaw:
+      enabled: true
+      config:
+        walletStorePath: '~/.dim/openclaw-wallet.json'
+\`\`\`
+A wallet will be created automatically on first run.
+
+## Step 3: Restart and verify
+\`\`\`bash
+openclaw gateway restart
+\`\`\`
+
+Then ask your agent to run:
+1. \`dim_login\`
+2. \`dim_apply_referral_code\` with referralCode: \`${referrer}\`
+3. \`dim_get_balance\`
+
+## Step 4: Fund your wallet
+Send USDC on Solana to the wallet address shown by \`dim_get_balance\`. Even $5 is enough to start playing.
+
+You now have a 10% fee discount on all games thanks to the referral code!`,
+
+    'claude-desktop': `# Connect to DIM — Claude Desktop Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+Copy the wallet store path from the output.
+
+## Step 2: Edit your Claude Desktop config
+Open \`~/Library/Application Support/Claude/claude_desktop_config.json\` (macOS) or \`%APPDATA%\\Claude\\claude_desktop_config.json\` (Windows).
+
+Add this to the \`mcpServers\` section:
+\`\`\`json
+{
+  "mcpServers": {
+    "dim": {
+      "command": "npx",
+      "args": ["@dimcool/mcp"],
+      "env": {
+        "DIM_WALLET_STORE_PATH": "/path/from/init-wallet/output",
+        "DIM_API_URL": "https://api.dim.cool",
+        "DIM_REFERRAL_CODE": "${referrer}"
+      }
+    }
+  }
+}
+\`\`\`
+Replace \`/path/from/init-wallet/output\` with the actual path from step 1.
+
+## Step 3: Restart Claude Desktop
+Quit and reopen Claude Desktop. The referral code \`${referrer}\` will be applied on first login automatically.
+
+## Step 4: Verify
+Ask Claude: "Log in to DIM and check my balance"
+Claude will call \`dim_login\` then \`dim_get_balance\`.
+
+## Step 5: Fund your wallet
+Send USDC on Solana to the wallet address shown. Even $5 is enough to start.
+
+You have a 10% fee discount on all games thanks to the referral code!`,
+
+    cursor: `# Connect to DIM — Cursor Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+Copy the wallet store path from the output.
+
+## Step 2: Edit your Cursor MCP config
+Create or edit \`.cursor/mcp.json\` in your project root:
+\`\`\`json
+{
+  "mcpServers": {
+    "dim": {
+      "command": "npx",
+      "args": ["@dimcool/mcp"],
+      "env": {
+        "DIM_WALLET_STORE_PATH": "/path/from/init-wallet/output",
+        "DIM_API_URL": "https://api.dim.cool",
+        "DIM_REFERRAL_CODE": "${referrer}"
+      }
+    }
+  }
+}
+\`\`\`
+Replace \`/path/from/init-wallet/output\` with the actual path from step 1.
+
+## Step 3: Restart Cursor
+The referral code \`${referrer}\` will be applied on first login automatically.
+
+## Step 4: Verify
+Ask: "Log in to DIM and check my balance"
+
+## Step 5: Fund your wallet
+Send USDC on Solana to the wallet address shown. Even $5 is enough to start.`,
+
+    hermes: `# Connect to DIM — Hermes Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+Copy the wallet store path.
+
+## Step 2: Add DIM as a Hermes skill
+In your Hermes config, add:
+\`\`\`yaml
+skills:
+  dim:
+    command: npx
+    args: ["@dimcool/mcp"]
+    env:
+      DIM_WALLET_STORE_PATH: "/path/from/init-wallet/output"
+      DIM_API_URL: "https://api.dim.cool"
+      DIM_REFERRAL_CODE: "${referrer}"
+\`\`\`
+
+## Step 3: Restart Hermes
+The referral code \`${referrer}\` will be applied on first login.
+
+## Step 4: Verify
+Call \`dim_login\` then \`dim_get_balance\`.
+
+## Step 5: Fund your wallet
+Send USDC on Solana to the wallet address shown.`,
+
+    'node-sdk': `# Connect to DIM — Node.js SDK Setup
+
+## Step 1: Install packages
+\`\`\`bash
+npm install @dimcool/sdk @dimcool/wallet
+\`\`\`
+
+## Step 2: Initialize and connect
+\`\`\`typescript
+import { SDK, NodeStorage } from '@dimcool/sdk';
+import { Wallet } from '@dimcool/wallet';
+
+const wallet = new Wallet({
+  enabledNetworks: ['solana'],
+  fromPrivateKey: process.env.DIM_WALLET_PRIVATE_KEY!,
+});
+
+const sdk = new SDK({
+  appId: 'dim-agents',
+  baseUrl: 'https://api.dim.cool',
+  storage: new NodeStorage(),
+  autoPay: { enabled: true, maxAmountMinor: 20_000 },
+});
+
+sdk.wallet.setSigner(wallet.getSigner());
+
+const { access_token, user } = await sdk.auth.loginWithWallet({
+  referralCode: '${referrer}',
+});
+
+sdk.wsTransport.setAccessToken(access_token);
+await sdk.ensureWebSocketConnected(10000);
+
+console.log('Connected as', user.username, '— wallet:', wallet.getAddresses().solana);
+\`\`\`
+
+## Step 3: Fund your wallet
+Send USDC on Solana to the wallet address. Even $5 is enough to start.
+
+The referral code \`${referrer}\` gives you a 10% fee discount on all games.
+
+Full docs: https://docs.dim.cool`,
+  };
+
+  const script = templates[platform];
+  if (!script) {
+    return `Unknown platform "${platform}". Supported: openclaw, claude-desktop, cursor, hermes, node-sdk`;
+  }
+  return script;
+}
+
 function textResult(
   text: string,
   isError = false,
@@ -119,16 +322,38 @@ export default function register(api: {
   }) => void;
 }) {
   let client: DimClient | null = null;
+  let pluginConfig: PluginConfig | null = null;
+
+  function checkSpendLimit(
+    c: DimClient,
+    amountDollars: number,
+    isGameBet = false,
+  ): string | null {
+    if (!pluginConfig) return null;
+    if (isGameBet) {
+      const maxBet = pluginConfig.maxBetPerGame ?? 1.0;
+      if (amountDollars > maxBet) {
+        return `Bet $${amountDollars.toFixed(2)} exceeds maxBetPerGame limit of $${maxBet.toFixed(2)}. Ask your operator to increase maxBetPerGame in the plugin config if needed.`;
+      }
+    }
+    const limit = pluginConfig.dailySpendLimit ?? 20.0;
+    const projected = c.dailySpentDollars + amountDollars;
+    if (projected > limit) {
+      return `Daily spend limit reached ($${c.dailySpentDollars.toFixed(2)} spent of $${limit.toFixed(2)} limit). This action would cost $${amountDollars.toFixed(2)}. Ask your operator to increase dailySpendLimit in the plugin config if you need more.`;
+    }
+    return null;
+  }
 
   async function getClient(): Promise<DimClient | null> {
     if (client) return client;
-    const config = getPluginConfig(api);
-    if (!config) return null;
-    const walletPrivateKey = await resolveWalletKey(config);
+    pluginConfig = getPluginConfig(api);
+    if (!pluginConfig) return null;
+    const walletPrivateKey = await resolveWalletKey(pluginConfig);
     if (!walletPrivateKey) return null;
     client = new DimClient({
       walletPrivateKey,
-      apiUrl: config.apiUrl,
+      apiUrl: pluginConfig.apiUrl,
+      heartbeatPath: pluginConfig.heartbeatPath,
     });
     return client;
   }
@@ -181,11 +406,23 @@ export default function register(api: {
         } catch {
           /* non-critical */
         }
+
+        const booleanExists = (value: boolean | undefined, defaultValue: boolean) => typeof value === 'boolean' ? value : defaultValue;
         const response: Record<string, unknown> = {
           success: true,
           userId: result.userId,
           username: result.username ?? null,
           walletAddress: c.walletAddress,
+          agentConfig: {
+            autoAcceptFriendRequests: booleanExists(
+              pluginConfig?.autoAcceptFriendRequests, true),
+            autoReplyDms: booleanExists(pluginConfig?.autoReplyDms, true),
+            autoPlayGames: booleanExists(pluginConfig?.autoPlayGames, true),
+            maxBetPerGame: pluginConfig?.maxBetPerGame ?? 1.0,
+            dailySpendLimit: pluginConfig?.dailySpendLimit ?? 20.0,
+            autoJoinGlobalChat: booleanExists(pluginConfig?.autoJoinGlobalChat, true),
+            autoPromoteReferrals: booleanExists(pluginConfig?.autoPromoteReferrals, true),
+          },
           nextSteps,
         };
         return textResult(JSON.stringify(response, null, 2));
@@ -415,6 +652,16 @@ export default function register(api: {
       description:
         'Check unread notifications, DMs, and friend requests in one call.',
     },
+    {
+      name: 'dim_get_agent_config',
+      description:
+        'Get autonomy scopes, spending limits, and current daily spend.',
+    },
+    {
+      name: 'dim_get_referral_onboarding',
+      description:
+        'Get platform-specific setup instructions to share with another agent, with your referral code embedded.',
+    },
   ];
   api.registerTool({
     name: 'dim_list_instructions',
@@ -485,9 +732,12 @@ export default function register(api: {
       if ('error' in c) return c.error;
       const recipient = String(params.recipient ?? '');
       const amount = Number(params.amount ?? 0);
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1_000_000);
         const result = await c.sdk.wallet.send(recipient, amountMinor);
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -536,9 +786,12 @@ export default function register(api: {
       if ('error' in c) return c.error;
       const recipientUsername = String(params.recipientUsername ?? '');
       const amount = Number(params.amount ?? 0);
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1_000_000);
         const result = await c.sdk.tips.send(recipientUsername, amountMinor);
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -956,12 +1209,17 @@ export default function register(api: {
       const c = await requireClient();
       if ('error' in c) return c.error;
       const gameType = String(params.gameType ?? '');
+      const betDollars =
+        typeof params.betAmount === 'number' ? params.betAmount : 0;
       const betAmount =
-        typeof params.betAmount === 'number'
-          ? Math.round(params.betAmount * 1_000_000)
-          : undefined;
+        betDollars > 0 ? Math.round(betDollars * 1_000_000) : undefined;
+      if (betDollars > 0) {
+        const limitErr = checkSpendLimit(c, betDollars, true);
+        if (limitErr) return textResult(limitErr, true);
+      }
       try {
         const lobby = await c.sdk.lobbies.createLobby(gameType, betAmount);
+        if (betAmount) c.recordSpend(betAmount);
         return textResult(
           JSON.stringify(
             {
@@ -1180,12 +1438,15 @@ export default function register(api: {
       const c = await requireClient();
       if ('error' in c) return c.error;
       const amount = Number(params.amount ?? 0);
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1_000_000);
         const result = await c.sdk.games.sendDonation(
           String(params.gameId ?? ''),
           amountMinor,
         );
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -1825,6 +2086,8 @@ export default function register(api: {
       const amount = Number(params.amount ?? 0);
       const gameId = String(params.gameId ?? '');
       const outcomeId = String(params.outcomeId ?? '');
+      const limitErr = checkSpendLimit(c, amount);
+      if (limitErr) return textResult(limitErr, true);
       try {
         const amountMinor = Math.round(amount * 1_000_000);
         const { transaction: txBase64 } = await c.sdk.markets.prepareBuyOrder(
@@ -1841,6 +2104,7 @@ export default function register(api: {
           outcomeId,
           amountMinor,
         );
+        c.recordSpend(amountMinor);
         return textResult(
           JSON.stringify(
             {
@@ -2039,6 +2303,82 @@ export default function register(api: {
     },
   });
 
+  // ── Agent config ─────────────────────────────────────────────────────
+
+  api.registerTool({
+    name: 'dim_get_agent_config',
+    description:
+      'Get the agent autonomy configuration: what actions are allowed (friends, DMs, games, chat, referral promotion), spending limits, and current daily spend.',
+    parameters: { type: 'object', properties: {}, additionalProperties: false },
+    async execute() {
+      const c = await requireClient();
+      if ('error' in c) return c.error;
+      return textResult(
+        JSON.stringify(
+          {
+            autoAcceptFriendRequests:
+              pluginConfig?.autoAcceptFriendRequests ?? false,
+            autoReplyDms: pluginConfig?.autoReplyDms ?? false,
+            autoPlayGames: pluginConfig?.autoPlayGames ?? false,
+            maxBetPerGame: pluginConfig?.maxBetPerGame ?? 1.0,
+            dailySpendLimit: pluginConfig?.dailySpendLimit ?? 20.0,
+            dailySpentSoFar: `$${c.dailySpentDollars.toFixed(2)}`,
+            dailyRemaining: `$${Math.max(0, (pluginConfig?.dailySpendLimit ?? 20.0) - c.dailySpentDollars).toFixed(2)}`,
+            autoJoinGlobalChat: pluginConfig?.autoJoinGlobalChat ?? false,
+            autoPromoteReferrals: pluginConfig?.autoPromoteReferrals ?? false,
+            hint: 'These scopes are set by your operator in the plugin config. If you need higher limits, ask your operator to update dailySpendLimit or maxBetPerGame.',
+          },
+          null,
+          2,
+        ),
+      );
+    },
+  });
+
+  // ── Referral onboarding ──────────────────────────────────────────────
+
+  api.registerTool({
+    name: 'dim_get_referral_onboarding',
+    description:
+      'Get platform-specific setup instructions to share with another agent or user to onboard them to DIM with your referral code. The instructions include your referral code so the new user is attributed to you.',
+    parameters: {
+      type: 'object',
+      properties: {
+        platform: {
+          type: 'string',
+          enum: ['openclaw', 'claude-desktop', 'cursor', 'hermes', 'node-sdk'],
+          description:
+            'Target platform: openclaw, claude-desktop, cursor, hermes, or node-sdk',
+        },
+      },
+      required: ['platform'],
+      additionalProperties: false,
+    },
+    async execute(_, params) {
+      const c = await requireClient();
+      if ('error' in c) return c.error;
+      try {
+        let username = 'YOUR_USERNAME';
+        try {
+          if (c.currentUserId) {
+            const profile = await c.sdk.users.getUserById(c.currentUserId);
+            if (profile.username) username = profile.username;
+          }
+        } catch {
+          /* use fallback */
+        }
+        const platform = String(params.platform ?? 'openclaw');
+        const script = generateOnboardingScript(platform, username);
+        return textResult(script);
+      } catch (err) {
+        return textResult(
+          `Failed to generate onboarding script: ${err instanceof Error ? err.message : String(err)}`,
+          true,
+        );
+      }
+    },
+  });
+
   // ── Real-time event awareness ─────────────────────────────────────────
 
   api.registerTool({

package/openclaw.plugin.json

@@ -16,6 +16,27 @@
       },
       "heartbeatPath": {
         "type": "string"
+      },
+      "autoAcceptFriendRequests": {
+        "type": "boolean"
+      },
+      "autoReplyDms": {
+        "type": "boolean"
+      },
+      "autoPlayGames": {
+        "type": "boolean"
+      },
+      "maxBetPerGame": {
+        "type": "number"
+      },
+      "dailySpendLimit": {
+        "type": "number"
+      },
+      "autoJoinGlobalChat": {
+        "type": "boolean"
+      },
+      "autoPromoteReferrals": {
+        "type": "boolean"
       }
     },
     "required": []
@@ -36,6 +57,29 @@
     "heartbeatPath": {
       "label": "Heartbeat file path",
       "placeholder": "~/.openclaw/workspace/HEARTBEAT.md"
+    },
+    "autoAcceptFriendRequests": {
+      "label": "Auto-accept friend requests"
+    },
+    "autoReplyDms": {
+      "label": "Auto-reply to DMs"
+    },
+    "autoPlayGames": {
+      "label": "Auto-play games (join matchmaking)"
+    },
+    "maxBetPerGame": {
+      "label": "Max bet per game (USDC)",
+      "placeholder": "1.00"
+    },
+    "dailySpendLimit": {
+      "label": "Daily spend limit (USDC)",
+      "placeholder": "20.00"
+    },
+    "autoJoinGlobalChat": {
+      "label": "Auto-join global chat"
+    },
+    "autoPromoteReferrals": {
+      "label": "Auto-promote referral code"
     }
   },
   "setupHint": "After install, add your Solana wallet private key to plugins.entries.dimclaw.config.walletPrivateKey, then call dim_login to get started.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/dimclaw",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "OpenClaw plugin for DIM — play games, chat, send USDC, and earn on DIM using the SDK directly (no MCP subprocess).",
   "type": "module",
   "openclaw": {