@totalreclaw/totalreclaw 1.3.0 → 1.4.0

package/README.md

@@ -79,9 +79,9 @@ Most of the time you won't use these directly -- the automatic hooks handle memo
 | Tier | Memories | Reads | Storage | Price |
 |------|----------|-------|---------|-------|
 | **Free** | 500/month | Unlimited | Testnet (trial) | $0 |
-| **Pro** | Unlimited | Unlimited | Permanent on-chain (Gnosis) | $5/month |
+| **Pro** | Unlimited | Unlimited | Permanent on-chain (Gnosis) | See `totalreclaw_status` |
 
-Pay with card via Stripe. Counter resets monthly.
+Pay with card via Stripe. Use `totalreclaw_status` to check current pricing. Counter resets monthly.
 
 ## Using with Other Agents
 

package/index.ts

@@ -9,6 +9,7 @@
  *   - totalreclaw_status       -- check billing/subscription status
  *   - totalreclaw_consolidate  -- scan and merge near-duplicate memories
  *   - totalreclaw_import_from  -- import memories from other tools (Mem0, MCP Memory, etc.)
+ *   - totalreclaw_upgrade      -- create Stripe checkout for Pro upgrade
  *
  * Also registers a `before_agent_start` hook that automatically injects
  * relevant memories into the agent's context.
@@ -134,6 +135,9 @@ const MAX_FACTS_PER_EXTRACTION = 15;
 // Store-time near-duplicate detection (consolidation module)
 const STORE_DEDUP_ENABLED = process.env.TOTALRECLAW_STORE_DEDUP !== 'false';
 
+// One-time welcome-back message for returning Pro users (set during init, consumed by first before_agent_start)
+let welcomeBackMessage: string | null = null;
+
 // B2: Minimum relevance threshold — cosine below this means no memory injection
 const RELEVANCE_THRESHOLD = parseFloat(process.env.TOTALRECLAW_RELEVANCE_THRESHOLD ?? '0.3');
 
@@ -421,6 +425,45 @@ async function initialize(logger: OpenClawPluginApi['logger']): Promise<void> {
       subgraphOwner = userId;
     }
   }
+
+  // One-time billing check for returning users (imported recovery phrase).
+  // If they already have an active Pro subscription, inform them on next conversation start.
+  if (existingUserId && authKeyHex) {
+    try {
+      const walletAddr = subgraphOwner || userId || '';
+      if (walletAddr) {
+        const billingUrl = (process.env.TOTALRECLAW_SERVER_URL || 'https://api.totalreclaw.xyz').replace(/\/+$/, '');
+        const resp = await fetch(`${billingUrl}/v1/billing/status?wallet_address=${encodeURIComponent(walletAddr)}`, {
+          method: 'GET',
+          headers: {
+            'Authorization': `Bearer ${authKeyHex}`,
+            'Accept': 'application/json',
+            'X-TotalReclaw-Client': 'openclaw-plugin',
+          },
+        });
+        if (resp.ok) {
+          const billingData = await resp.json() as Record<string, unknown>;
+          const tier = billingData.tier as string;
+          const expiresAt = billingData.expires_at as string | undefined;
+          // Populate billing cache for future use.
+          writeBillingCache({
+            tier: tier || 'free',
+            free_writes_used: (billingData.free_writes_used as number) ?? 0,
+            free_writes_limit: (billingData.free_writes_limit as number) ?? 0,
+            features: billingData.features as BillingCache['features'] | undefined,
+            checked_at: Date.now(),
+          });
+          if (tier === 'pro' && expiresAt) {
+            const expiryDate = new Date(expiresAt).toLocaleDateString();
+            welcomeBackMessage = `Welcome back! Your Pro subscription is active (expires: ${expiryDate}).`;
+            logger.info(`Returning Pro user detected — expires ${expiryDate}`);
+          }
+        }
+      }
+    } catch {
+      // Best-effort — don't block initialization on billing check failure.
+    }
+  }
 }
 
 function isDocker(): boolean {
@@ -2183,6 +2226,85 @@ const plugin = {
       { name: 'totalreclaw_import_from' },
     );
 
+    // ---------------------------------------------------------------
+    // Tool: totalreclaw_upgrade
+    // ---------------------------------------------------------------
+
+    api.registerTool(
+      {
+        name: 'totalreclaw_upgrade',
+        label: 'Upgrade to Pro',
+        description:
+          'Upgrade to TotalReclaw Pro for unlimited encrypted memories. ' +
+          'Returns a Stripe checkout URL for the user to complete payment via credit/debit card.',
+        parameters: {
+          type: 'object',
+          properties: {},
+          additionalProperties: false,
+        },
+        async execute() {
+          try {
+            await requireFullSetup(api.logger);
+
+            if (!authKeyHex) {
+              return {
+                content: [{ type: 'text', text: 'Auth credentials are not available. Please initialize first.' }],
+              };
+            }
+
+            const serverUrl = (process.env.TOTALRECLAW_SERVER_URL || 'https://api.totalreclaw.xyz').replace(/\/+$/, '');
+            const walletAddr = subgraphOwner || userId || '';
+
+            if (!walletAddr) {
+              return {
+                content: [{ type: 'text', text: 'Wallet address not available. Please ensure the plugin is fully initialized.' }],
+              };
+            }
+
+            const response = await fetch(`${serverUrl}/v1/billing/checkout`, {
+              method: 'POST',
+              headers: {
+                'Authorization': `Bearer ${authKeyHex}`,
+                'Content-Type': 'application/json',
+                'X-TotalReclaw-Client': 'openclaw-plugin',
+              },
+              body: JSON.stringify({
+                wallet_address: walletAddr,
+                tier: 'pro',
+              }),
+            });
+
+            if (!response.ok) {
+              const body = await response.text().catch(() => '');
+              return {
+                content: [{ type: 'text', text: `Failed to create checkout session (HTTP ${response.status}): ${body || response.statusText}` }],
+              };
+            }
+
+            const data = await response.json() as { checkout_url?: string };
+
+            if (!data.checkout_url) {
+              return {
+                content: [{ type: 'text', text: 'Failed to create checkout session: no checkout URL returned.' }],
+              };
+            }
+
+            return {
+              content: [{ type: 'text', text: `Open this URL to upgrade to Pro: ${data.checkout_url}` }],
+              details: { checkout_url: data.checkout_url },
+            };
+          } catch (err: unknown) {
+            const message = err instanceof Error ? err.message : String(err);
+            api.logger.error(`totalreclaw_upgrade failed: ${message}`);
+            return {
+              content: [{ type: 'text', text: `Failed to create checkout session: ${message}` }],
+            };
+          }
+        },
+      },
+      { name: 'totalreclaw_upgrade' },
+    );
+
     // ---------------------------------------------------------------
     // Hook: before_agent_start
     // ---------------------------------------------------------------
@@ -2213,6 +2335,13 @@ const plugin = {
             };
           }
 
+          // One-time welcome-back message for returning Pro users.
+          let welcomeBack = '';
+          if (welcomeBackMessage) {
+            welcomeBack = `\n\n${welcomeBackMessage}`;
+            welcomeBackMessage = null; // Consume — only show once
+          }
+
           // Billing cache check — warn if quota is approaching limit.
           let billingWarning = '';
           try {
@@ -2286,7 +2415,7 @@ const plugin = {
                 const lines = cachedFacts.slice(0, 8).map((f, i) =>
                   `${i + 1}. ${f.text} (importance: ${f.importance}/10, cached)`,
                 );
-                return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + billingWarning };
+                return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + welcomeBack + billingWarning };
               }
             }
 
@@ -2299,7 +2428,7 @@ const plugin = {
               const lines = cachedFacts.slice(0, 8).map((f, i) =>
                 `${i + 1}. ${f.text} (importance: ${f.importance}/10, cached)`,
               );
-              return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + billingWarning };
+              return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + welcomeBack + billingWarning };
             }
 
             if (allTrapdoors.length === 0) return undefined;
@@ -2316,7 +2445,7 @@ const plugin = {
                 const lines = cachedFacts.slice(0, 8).map((f, i) =>
                   `${i + 1}. ${f.text} (importance: ${f.importance}/10, cached)`,
                 );
-                return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + billingWarning };
+                return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + welcomeBack + billingWarning };
               }
               return undefined;
             }
@@ -2328,7 +2457,7 @@ const plugin = {
               const lines = cachedFacts.slice(0, 8).map((f, i) =>
                 `${i + 1}. ${f.text} (importance: ${f.importance}/10, cached)`,
               );
-              return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + billingWarning };
+              return { prependContext: `## Relevant Memories\n\n${lines.join('\n')}` + welcomeBack + billingWarning };
             }
 
             // 5. Decrypt subgraph results and build reranker input.
@@ -2434,7 +2563,7 @@ const plugin = {
             });
             const contextString = `## Relevant Memories\n\n${lines.join('\n')}`;
 
-            return { prependContext: contextString + billingWarning };
+            return { prependContext: contextString + welcomeBack + billingWarning };
           }
 
           // --- Server mode (existing behavior) ---
@@ -2546,7 +2675,7 @@ const plugin = {
           });
           const contextString = `## Relevant Memories\n\n${lines.join('\n')}`;
 
-          return { prependContext: contextString + billingWarning };
+          return { prependContext: contextString + welcomeBack + billingWarning };
         } catch (err: unknown) {
           // The hook must NEVER throw -- log and return undefined.
           const message = err instanceof Error ? err.message : String(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totalreclaw/totalreclaw",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "End-to-end encrypted memory for AI agents — portable, yours forever. Automatic extraction, semantic search, and on-chain storage",
   "type": "module",
   "keywords": [