@moltbankhq/openclaw 0.1.13 → 0.1.15

package/README.md

@@ -1,6 +1,6 @@
 # @moltbankhq/openclaw
 
-Standalone CLI and optional OpenClaw plugin for [MoltBank](https://moltbank.bot) — stablecoin treasury controls, approvals, and audit trails for agent fleets.
+Standalone CLI for [MoltBank](https://moltbank.bot) — stablecoin treasury controls, approvals, and audit trails for agent fleets.
 
 ## Install
 
@@ -22,25 +22,19 @@ Or from a local install:
 npm exec --package @moltbankhq/openclaw -- moltbank setup
 ```
 
-OpenClaw plugin mode still exists in this pass for compatibility:
-
-```bash
-openclaw plugins install @moltbankhq/openclaw
-```
-
 ## What it does
 
 This package connects your OpenClaw agent to MoltBank's stablecoin treasury infrastructure. During setup, it:
 
-- Downloads and configures the MoltBank skill (`skill.md` + scripts)
+- Downloads and configures the MoltBank skill (`SKILL.md` + scripts)
 - Installs and registers [mcporter](https://www.npmjs.com/package/mcporter) for MCP server connectivity
 - Handles OAuth device-code authentication to link your agent to your MoltBank account
 - Configures sandbox (Docker) or host mode automatically based on your OpenClaw setup
-- Injects required environment variables (`MOLTBANK`, `SIGNER`, `ACTIVE_ORG_OVERRIDE`)
+- Injects the sandbox auth path (`MOLTBANK_CREDENTIALS_PATH`) plus `ACTIVE_ORG_OVERRIDE`, while keeping tokens and signer keys in a skill-local credentials file
 
 Once set up, your agent can manage treasury operations, set per-agent spending limits, handle x402 payments, and interact with MoltBank's MCP server — all within OpenClaw.
 
-The standalone `moltbank` CLI is for install, setup, auth status, and repair flows. Actual treasury operations should run through the installed skill wrapper scripts inside the skill directory.
+The standalone `moltbank` CLI is the supported path for install, setup, auth status, and repair flows. Actual treasury operations should run through the installed skill wrapper scripts inside the skill directory.
 
 ## Setup
 
@@ -73,25 +67,6 @@ CLI flags:
 moltbank setup --app-base-url https://app.moltbank.bot --skill-name MoltBank
 ```
 
-Plugin mode can still read optional config from your `openclaw.json`:
-
-Optional config in your `openclaw.json`:
-
-```json
-{
-  "plugins": {
-    "entries": {
-      "moltbank": {
-        "config": {
-          "appBaseUrl": "https://app.moltbank.bot",
-          "skillName": "MoltBank"
-        }
-      }
-    }
-  }
-}
-```
-
 ## Environment Variables
 
 | Variable | Description |

package/index.ts

@@ -7,7 +7,7 @@ const IS_WIN = process.platform === 'win32';
 type OpenclawConfig = Record<string, unknown>;
 type ParsedJsonObject = Record<string, unknown>;
 
-export interface MoltbankPluginConfig {
+export interface MoltbankConfig {
   skillName?: string;
   appBaseUrl?: string;
 }
@@ -53,36 +53,6 @@ export interface SetupCommandLoggerOptions {
   statusCommand?: string;
 }
 
-interface ServiceDefinition {
-  id: string;
-  start: () => void | Promise<void>;
-  stop: () => void | Promise<void>;
-}
-
-interface CliCommandLike {
-  command(name: string): CliCommandLike;
-  createCommand(name: string): CliCommandLike;
-  description(text: string): CliCommandLike;
-  addCommand(command: CliCommandLike): CliCommandLike;
-  action(handler: () => void | Promise<void>): CliCommandLike;
-}
-
-interface PluginApiConfig {
-  plugins?: {
-    entries?: {
-      moltbank?: {
-        config?: MoltbankPluginConfig;
-      };
-    };
-  };
-}
-
-interface PluginApi extends LoggerApi {
-  config?: PluginApiConfig;
-  registerService(service: ServiceDefinition): void;
-  registerCli(handler: (args: { program: CliCommandLike }) => void, options: { commands: string[] }): void;
-}
-
 export type AuthWaitMode = 'blocking' | 'nonblocking';
 const oauthPollers = new Map<string, ReturnType<typeof spawn>>();
 const backgroundFinalizers = new Map<string, ReturnType<typeof spawn>>();
@@ -920,15 +890,15 @@ function getWorkspace(): string {
   return process.env.OPENCLAW_WORKSPACE || join(homedir(), '.openclaw', 'workspace');
 }
 
-export function getSkillName(cfg: MoltbankPluginConfig): string {
+export function getSkillName(cfg: MoltbankConfig): string {
   return cfg?.skillName || process.env.MOLTBANK_SKILL_NAME || 'MoltBank';
 }
 
-export function getAppBaseUrl(cfg: MoltbankPluginConfig): string {
+export function getAppBaseUrl(cfg: MoltbankConfig): string {
   return (cfg?.appBaseUrl || process.env.APP_BASE_URL || 'https://app.moltbank.bot').trim();
 }
 
-export function getSkillBundleBaseUrl(cfg: MoltbankPluginConfig): string {
+export function getSkillBundleBaseUrl(cfg: MoltbankConfig): string {
   const base = getAppBaseUrl(cfg).replace(/\/$/, '');
   return base.endsWith('/skill') ? base : `${base}/skill`;
 }
@@ -944,7 +914,7 @@ function isSandboxEnabled(): boolean {
   }
 }
 
-export function getSkillDir(cfg: MoltbankPluginConfig): string {
+export function getSkillDir(cfg: MoltbankConfig): string {
   const skillName = getSkillName(cfg);
   return join(getWorkspace(), 'skills', skillName);
 }
@@ -1065,47 +1035,6 @@ function setNestedValue(obj: Record<string, unknown>, path: string[], value: unk
   current[path[path.length - 1]] = value;
 }
 
-function cleanupStaleMoltbankPluginLoadPaths(api: LoggerApi): boolean {
-  try {
-    const config = readOpenclawConfig();
-    const loadPathsPath = ['plugins', 'load', 'paths'];
-    const current = getNestedValue(config, loadPathsPath);
-    if (!Array.isArray(current)) return false;
-
-    const removed: string[] = [];
-    const next: unknown[] = [];
-
-    for (const entry of current) {
-      if (typeof entry !== 'string') {
-        next.push(entry);
-        continue;
-      }
-
-      const normalized = entry.replace(/\\/g, '/').toLowerCase();
-      const looksLikeMoltbankPath = normalized.includes('moltbank');
-      if (looksLikeMoltbankPath && !existsSync(entry)) {
-        removed.push(entry);
-        continue;
-      }
-
-      next.push(entry);
-    }
-
-    if (removed.length === 0) {
-      api.logger.info('[moltbank] ✓ no stale MoltBank plugin load paths found');
-      return false;
-    }
-
-    setNestedValue(config, loadPathsPath, next);
-    writeOpenclawConfig(config);
-    api.logger.info(`[moltbank] ✓ removed stale MoltBank plugin load path(s): ${removed.join(', ')}`);
-    return true;
-  } catch (e) {
-    api.logger.warn('[moltbank] could not clean stale MoltBank plugin load paths: ' + String(e));
-    return false;
-  }
-}
-
 // ─── mcporter ────────────────────────────────────────────────────────────────
 
 function ensureMcporter(api: LoggerApi) {
@@ -1692,7 +1621,7 @@ function startBackgroundFinalizeAfterAuth(skillDir: string, appBaseUrl: string,
   }
   if (existing) backgroundFinalizers.delete(skillDir);
 
-  const child = spawn('openclaw', ['moltbank', 'setup-blocking'], {
+  const child = spawn('moltbank', ['setup-blocking'], {
     cwd: skillDir,
     env: {
       ...process.env,
@@ -1849,7 +1778,7 @@ function ensureMoltbankAuth(skillDir: string, appBaseUrl: string, api: LoggerApi
     const backgroundTimeoutSeconds = Math.max(30, expiresAt - now - 5);
     startBackgroundOauthPoll(skillDir, appBaseUrl, credsPath, deviceCode, backgroundTimeoutSeconds, api);
     api.logger.info('[moltbank] once approved in browser, setup finalization will continue automatically');
-    api.logger.info('[moltbank] optional immediate check: `openclaw moltbank auth-status`');
+    api.logger.info('[moltbank] optional immediate check: `moltbank status`');
     return false;
   }
 
@@ -1974,6 +1903,42 @@ export function ensureMcporterConfig(skillDir: string, appBaseUrl: string, api:
   api.logger.info('[moltbank] ✓ MoltBank will use skill-local mcporter config only');
 }
 
+function runHostReadinessCheck(skillDir: string, api: LoggerApi): boolean {
+  const active = parseActiveTokenFromCredentials();
+  if (!active.ok || !active.activeOrg) {
+    api.logger.warn('[moltbank] host setup incomplete: active organization could not be resolved for readiness verification');
+    return false;
+  }
+
+  const wrapperPath = IS_WIN ? join(skillDir, 'scripts', 'moltbank.ps1') : join(skillDir, 'scripts', 'moltbank.sh');
+  const readinessArgs = ['call', 'MoltBank.get_balance', `organizationName=${active.activeOrg}`, 'date=today'];
+  const readinessTimeoutMs = IS_WIN ? 30000 : 25000;
+
+  api.logger.info(`[moltbank] verifying readiness with authenticated balance read (org: ${active.activeOrg})...`);
+
+  const readiness = runCommand(wrapperPath, readinessArgs, {
+    cwd: skillDir,
+    silent: true,
+    timeoutMs: readinessTimeoutMs,
+    env: {
+      ACTIVE_ORG_OVERRIDE: active.activeOrg
+    }
+  });
+
+  if (!readiness.ok) {
+    const combined = `${readiness.stderr}\n${readiness.stdout}`.trim();
+    const detail = lastNonEmptyLine(combined);
+    if (detail) {
+      api.logger.warn(`[moltbank] readiness detail: ${detail}`);
+    }
+    api.logger.warn('[moltbank] host setup incomplete: authenticated balance-read verification failed');
+    return false;
+  }
+
+  api.logger.info('[moltbank] host readiness verified (`MoltBank.get_balance`)');
+  return true;
+}
+
 // ─── sandbox env vars ────────────────────────────────────────────────────────
 
 export function injectSandboxEnv(skillDir: string, api: LoggerApi): boolean {
@@ -2213,7 +2178,7 @@ function restartGatewayAfterHostSetup(api: LoggerApi): boolean {
 // ─── main setup ───────────────────────────────────────────────────────────────
 
 export async function runSetup(
-  cfg: MoltbankPluginConfig,
+  cfg: MoltbankConfig,
   api: LoggerApi,
   options: { authWaitMode?: AuthWaitMode; restartGatewayOnSuccess?: boolean } = {}
 ) {
@@ -2232,9 +2197,6 @@ export async function runSetup(
   api.logger.info(`[moltbank] skill dir: ${skillDir}`);
   api.logger.info(`[moltbank] base url:  ${appBaseUrl}`);
   api.logger.info(`[moltbank] ══════════════════════════════════════`);
-  api.logger.info('[moltbank] preflight: cleaning stale MoltBank plugin load paths...');
-  cleanupStaleMoltbankPluginLoadPaths(api);
-
   if (sandbox) {
     api.logger.info('[moltbank] configuring sandbox mode...');
 
@@ -2262,10 +2224,10 @@ export async function runSetup(
         if (pending) {
           api.logger.warn('[moltbank] sandbox auth pending — startup continues without blocking channel startup');
           api.logger.info('[moltbank] setup will finalize automatically after browser approval');
-          api.logger.info('[moltbank] optional immediate check: `openclaw moltbank auth-status`');
+          api.logger.info('[moltbank] optional immediate check: `moltbank status`');
         } else {
           api.logger.warn('[moltbank] sandbox auth setup failed before issuing a valid device code');
-          api.logger.warn('[moltbank] review the previous error and rerun `openclaw moltbank setup`');
+          api.logger.warn('[moltbank] review the previous error and rerun `moltbank setup`');
         }
         return;
       }
@@ -2321,10 +2283,10 @@ export async function runSetup(
         if (pending) {
           api.logger.warn('[moltbank] host auth pending — startup continues without blocking channel startup');
           api.logger.info('[moltbank] setup will finalize automatically after browser approval');
-          api.logger.info('[moltbank] optional immediate check: `openclaw moltbank auth-status`');
+          api.logger.info('[moltbank] optional immediate check: `moltbank status`');
         } else {
           api.logger.warn('[moltbank] host auth setup failed before issuing a valid device code');
-          api.logger.warn('[moltbank] review the previous error and rerun `openclaw moltbank setup`');
+          api.logger.warn('[moltbank] review the previous error and rerun `moltbank setup`');
         }
         return;
       }
@@ -2338,98 +2300,8 @@ export async function runSetup(
     api.logger.info('[moltbank] [host 7/8] writing/registering mcporter config...');
     ensureMcporterConfig(skillDir, appBaseUrl, api);
 
-    api.logger.info('[moltbank] [host 8/8] running wrapper smoke test...');
-    const smokeTimeoutMs = IS_WIN ? 15000 : 20000;
-    let smokeOk = false;
-
-    if (IS_WIN) {
-      const mcporterConfigPath = join(skillDir, 'assets', 'mcporter.json');
-      const active = parseActiveTokenFromCredentials();
-      const mcpSmoke = runCommand('mcporter', ['--config', mcporterConfigPath, 'list', 'MoltBank'], {
-        cwd: skillDir,
-        silent: true,
-        timeoutMs: smokeTimeoutMs,
-        env: {
-          MOLTBANK: active.token ?? '__MOLTBANK_PLACEHOLDER__'
-        }
-      });
-
-      if (mcpSmoke.ok) {
-        api.logger.info('[moltbank] host smoke test passed (`mcporter list MoltBank`)');
-        smokeOk = true;
-      } else {
-        const mcpCombined = `${mcpSmoke.stderr}\n${mcpSmoke.stdout}`.trim();
-        const mcpCombinedLower = mcpCombined.toLowerCase();
-        const mcpDetail = lastNonEmptyLine(mcpCombined);
-        if (mcpDetail) {
-          api.logger.warn(`[moltbank] smoke detail: ${mcpDetail}`);
-        }
-
-        const timedOut = mcpSmoke.stderr.includes('ETIMEDOUT') || mcpCombinedLower.includes('timed out');
-        if (timedOut) {
-          api.logger.warn(
-            `[moltbank] host MCP smoke timed out after ${Math.floor(smokeTimeoutMs / 1000)}s; running local fallback checks`
-          );
-
-          const ps1Path = join(skillDir, 'scripts', 'moltbank.ps1');
-          const fallback = runCommand(
-            'powershell',
-            [
-              '-NoProfile',
-              '-NonInteractive',
-              '-ExecutionPolicy',
-              'Bypass',
-              '-Command',
-              "$ErrorActionPreference = 'Stop'; if (-not (Test-Path -LiteralPath $env:MOLTBANK_WRAPPER_PATH)) { throw 'moltbank.ps1 not found' }; if (-not (Get-Command bash -ErrorAction SilentlyContinue)) { throw 'bash is not installed or not on PATH' }; if (-not (Get-Command mcporter -ErrorAction SilentlyContinue)) { throw 'mcporter is not installed or not on PATH' }; Write-Output 'ok'"
-            ],
-            {
-              cwd: skillDir,
-              silent: true,
-              timeoutMs: 10000,
-              env: { MOLTBANK_WRAPPER_PATH: ps1Path }
-            }
-          );
-
-          if (fallback.ok) {
-            api.logger.warn('[moltbank] host smoke fallback passed (wrapper prerequisites available), but MCP endpoint was not verified');
-            smokeOk = true;
-          } else {
-            const fallbackCombined = `${fallback.stderr}\n${fallback.stdout}`.trim();
-            const fallbackDetail = lastNonEmptyLine(fallbackCombined);
-            if (fallbackDetail) {
-              api.logger.warn(`[moltbank] fallback detail: ${fallbackDetail}`);
-            }
-            api.logger.warn('[moltbank] host setup incomplete: MCP smoke timed out and fallback checks failed');
-          }
-        } else if (
-          mcpCombinedLower.includes('mcporter') &&
-          (mcpCombinedLower.includes('not recognized') || mcpCombinedLower.includes('not found'))
-        ) {
-          api.logger.warn('[moltbank] mcporter binary not found in PATH during smoke test');
-        } else {
-          api.logger.warn('[moltbank] host setup incomplete: smoke test failed (`mcporter list MoltBank`)');
-        }
-      }
-    } else {
-      const smoke = runCommand(join(skillDir, 'scripts', 'moltbank.sh'), ['list', 'MoltBank'], {
-        cwd: skillDir,
-        silent: true,
-        timeoutMs: smokeTimeoutMs
-      });
-      if (!smoke.ok) {
-        const smokeCombined = `${smoke.stderr}\n${smoke.stdout}`.trim();
-        const smokeDetail = lastNonEmptyLine(smokeCombined);
-        if (smokeDetail) {
-          api.logger.warn(`[moltbank] smoke detail: ${smokeDetail}`);
-        }
-        api.logger.warn('[moltbank] host setup incomplete: smoke test failed (`moltbank list MoltBank` via platform script)');
-      } else {
-        api.logger.info('[moltbank] host smoke test passed (`moltbank list MoltBank`)');
-        smokeOk = true;
-      }
-    }
-
-    hostReady = smokeOk;
+    api.logger.info('[moltbank] [host 8/8] running readiness balance check...');
+    hostReady = runHostReadinessCheck(skillDir, api);
 
     api.logger.info('[moltbank] host mode — setup completed with onboarding flow');
 
@@ -2489,116 +2361,3 @@ export async function runSetup(
   api.logger.info(`[moltbank] ══════════════════════════════════════`);
 }
 
-// ─── plugin register ──────────────────────────────────────────────────────────
-
-export default function register(api: PluginApi) {
-  const cfg: MoltbankPluginConfig = api.config?.plugins?.entries?.moltbank?.config ?? {};
-
-  api.registerService({
-    id: 'moltbank-setup',
-    start: async () => {
-      await runSetup(cfg, api, { authWaitMode: 'nonblocking' });
-    },
-    stop: async () => {
-      stopBackgroundOauthPoll(getSkillDir(cfg));
-      stopBackgroundFinalize(getSkillDir(cfg));
-      api.logger.info('[moltbank] plugin stopped');
-    }
-  });
-
-  api.registerCli(
-    ({ program }: { program: CliCommandLike }) => {
-      program
-        .command('moltbank')
-        .description('MoltBank plugin commands')
-        .addCommand(
-          program
-            .createCommand('setup')
-            .description('Re-run MoltBank setup')
-            .action(async () => {
-              const verbose = process.argv.includes('--verbose');
-              const restartGatewayOnSuccess = getSetupGatewayRestartEnabled(IS_WIN);
-              const logger = createSetupCommandLogger({ verbose, statusCommand: 'openclaw moltbank status' });
-              try {
-                await runSetup(cfg, logger, { authWaitMode: 'blocking', restartGatewayOnSuccess });
-              } finally {
-                logger.finish();
-              }
-            })
-        )
-        .addCommand(
-          program
-            .createCommand('setup-blocking')
-            .description('Re-run full MoltBank setup and wait for OAuth approval')
-            .action(async () => {
-              const verbose = process.argv.includes('--verbose');
-              const restartGatewayOnSuccess = getSetupGatewayRestartEnabled(IS_WIN);
-              const logger = createSetupCommandLogger({ verbose, statusCommand: 'openclaw moltbank status' });
-              try {
-                await runSetup(cfg, logger, { authWaitMode: 'blocking', restartGatewayOnSuccess });
-              } finally {
-                logger.finish();
-              }
-            })
-        )
-        .addCommand(
-          program
-            .createCommand('sandbox-setup')
-            .description('Reconfigure sandbox docker in openclaw.json')
-            .action(() => {
-              const changed = configureSandbox({ logger: console });
-              if (changed) {
-                recreateSandboxAndRestart({ logger: console });
-              } else {
-                console.log('[moltbank] No sandbox docker changes — not scheduling teardown');
-              }
-            })
-        )
-        .addCommand(
-          program
-            .createCommand('inject-key')
-            .description('Re-inject sandbox env vars from credentials.json')
-            .action(() => {
-              const skillDir = getSkillDir(cfg);
-              const changed = injectSandboxEnv(skillDir, { logger: console });
-              if (changed) {
-                recreateSandboxAndRestart({ logger: console });
-              } else {
-                console.log('[moltbank] No env changes — not scheduling teardown');
-              }
-            })
-        )
-        .addCommand(
-          program
-            .createCommand('status')
-            .description('Show current MoltBank auth state')
-            .action(() => {
-              const appBaseUrl = getAppBaseUrl(cfg);
-              const skillDir = getSkillDir(cfg);
-              printAuthStatus(skillDir, appBaseUrl, { logger: console });
-            })
-        )
-        .addCommand(
-          program
-            .createCommand('auth-status')
-            .description('Show current MoltBank auth state (credentials, pending code, background poll)')
-            .action(() => {
-              const appBaseUrl = getAppBaseUrl(cfg);
-              const skillDir = getSkillDir(cfg);
-              printAuthStatus(skillDir, appBaseUrl, { logger: console });
-            })
-        )
-        .addCommand(
-          program
-            .createCommand('register')
-            .description('Re-register mcporter server')
-            .action(() => {
-              const appBaseUrl = getAppBaseUrl(cfg);
-              const skillDir = getSkillDir(cfg);
-              ensureMcporterConfig(skillDir, appBaseUrl, { logger: console });
-            })
-        );
-    },
-    { commands: ['moltbank'] }
-  );
-}

package/package.json

@@ -1,20 +1,49 @@
 {
     "name": "@moltbankhq/openclaw",
-    "version": "0.1.13",
-    "description": "MoltBank stablecoin treasury CLI and OpenClaw plugin",
+    "version": "0.1.15",
+    "description": "MoltBank stablecoin treasury CLI and OpenClaw skill installer",
+    "homepage": "https://github.com/moltbankhq/openclaw-plugin#readme",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/moltbankhq/openclaw-plugin.git"
+    },
+    "bugs": {
+        "url": "https://github.com/moltbankhq/openclaw-plugin/issues"
+    },
     "main": "index.ts",
+    "types": "index.ts",
+    "exports": {
+        ".": "./index.ts",
+        "./cli": "./cli.ts",
+        "./package.json": "./package.json"
+    },
     "bin": {
         "moltbank": "./bin/moltbank.mjs"
     },
-    "openclaw": {
-        "extensions": [
-            "./index.ts"
-        ]
-    },
-    "keywords": [],
+    "files": [
+        "README.md",
+        "bin/",
+        "cli.ts",
+        "index.ts"
+    ],
+    "keywords": [
+        "moltbank",
+        "openclaw",
+        "treasury",
+        "mcp",
+        "cli",
+        "stablecoin",
+        "x402"
+    ],
     "author": "",
     "license": "ISC",
     "type": "module",
+    "engines": {
+        "node": ">=22"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
     "dependencies": {
         "tsx": "^4.20.6"
     },

package/openclaw.plugin.json

@@ -1,29 +0,0 @@
-{
-    "id": "moltbank",
-    "name": "MoltBank",
-    "description": "MoltBank stablecoin treasury plugin for OpenClaw — installs mcporter, npm dependencies, sandbox setup, and the MoltBank skill",
-    "configSchema": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-            "appBaseUrl": {
-                "type": "string",
-                "description": "MoltBank deployment URL"
-            },
-            "skillName": {
-                "type": "string",
-                "description": "Override skill folder name (default: MoltBank)"
-            }
-        }
-    },
-    "uiHints": {
-        "appBaseUrl": {
-            "label": "App Base URL",
-            "placeholder": "https://app.moltbank.bot"
-        },
-        "skillName": {
-            "label": "Skill Name",
-            "placeholder": "MoltBank"
-        }
-    }
-}