openbroker 1.0.59 → 1.0.60

package/SKILL.md

@@ -4,7 +4,7 @@ description: Hyperliquid trading plugin with background position monitoring. Exe
 license: MIT
 compatibility: Requires Node.js 22+, network access to api.hyperliquid.xyz
 homepage: https://www.npmjs.com/package/openbroker
-metadata: {"author": "monemetrics", "version": "1.0.59", "openclaw": {"requires": {"bins": ["openbroker"], "env": ["HYPERLIQUID_PRIVATE_KEY"]}, "primaryEnv": "HYPERLIQUID_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "openbroker", "bins": ["openbroker"], "label": "Install openbroker (npm)"}]}}
+metadata: {"author": "monemetrics", "version": "1.0.60", "openclaw": {"requires": {"bins": ["openbroker"], "env": ["HYPERLIQUID_PRIVATE_KEY"]}, "primaryEnv": "HYPERLIQUID_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "openbroker", "bins": ["openbroker"], "label": "Install openbroker (npm)"}]}}
 allowed-tools: ob_account ob_positions ob_funding ob_markets ob_search ob_spot ob_fills ob_orders ob_order_status ob_fees ob_candles ob_funding_history ob_trades ob_rate_limit ob_funding_scan ob_buy ob_sell ob_limit ob_trigger ob_tpsl ob_cancel ob_twap ob_bracket ob_chase ob_watcher_status Bash(openbroker:*)
 ---
 

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openbroker",
   "name": "OpenBroker — Hyperliquid Trading",
-  "version": "1.0.59",
+  "version": "1.0.60",
   "description": "Trade on Hyperliquid DEX with background position monitoring",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbroker",
-  "version": "1.0.59",
+  "version": "1.0.60",
   "description": "Hyperliquid trading CLI - execute orders, manage positions, and run trading strategies",
   "type": "module",
   "bin": {

package/scripts/plugin/watcher.ts

@@ -284,6 +284,35 @@ export class PositionWatcher implements PluginService {
     return events;
   }
 
+  private buildHookMessage(event: PositionEvent): string {
+    const lines: string[] = [
+      `[OpenBroker Alert] ${this.formatEventHeadline(event)}`,
+      '',
+      'Details:',
+      ...Object.entries(event.details ?? {}).map(([k, v]) => `  ${k}: ${v}`),
+      '',
+      `Notify the user of this trading alert via their preferred channel.`,
+    ];
+    return lines.join('\n');
+  }
+
+  private formatEventHeadline(event: PositionEvent): string {
+    switch (event.type) {
+      case 'position_opened':
+        return `New ${event.details?.side ?? ''} position opened on ${event.coin}: ${Math.abs(parseFloat(String(event.details?.size ?? '0')))} ${event.coin} at $${event.details?.entryPrice}`;
+      case 'position_closed':
+        return `Position on ${event.coin} has been closed (was ${event.details?.previousSize} at $${event.details?.entryPrice}, last unrealized PnL: $${event.details?.lastPnl})`;
+      case 'position_size_changed':
+        return `Position on ${event.coin} size changed from ${event.details?.previousSize} to ${event.details?.newSize}`;
+      case 'pnl_threshold':
+        return `Significant PnL movement on ${event.coin}: $${Number(event.details?.previousPnl ?? 0).toFixed(2)} → $${Number(event.details?.currentPnl ?? 0).toFixed(2)} (${Number(event.details?.changePct ?? 0).toFixed(1)}% of position value)`;
+      case 'margin_warning':
+        return `Margin usage at ${Number(event.details?.marginUsedPct ?? 0).toFixed(1)}% — approaching risk threshold (equity: $${event.details?.equity}, margin used: $${event.details?.marginUsed})`;
+      default:
+        return event.message;
+    }
+  }
+
   private async sendHook(event: PositionEvent): Promise<void> {
     const port = this.gatewayPort || 18789;
 
@@ -302,7 +331,7 @@ export class PositionWatcher implements PluginService {
           'Authorization': `Bearer ${this.hooksToken}`,
         },
         body: JSON.stringify({
-          message: event.message,
+          message: this.buildHookMessage(event),
           name: `ob-${event.type}`,
           wakeMode: 'now',
         }),