openbroker 1.0.88 → 1.1.0

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "openbroker",
-  "version": "1.0.88",
+  "version": "1.1.0",
   "description": "Hyperliquid trading CLI - execute orders, manage positions, and run trading strategies",
   "type": "module",
   "bin": {
     "openbroker": "./bin/openbroker.js"
   },
-  "openclaw": {
-    "extensions": ["./scripts/plugin/index.ts"]
+  "main": "./scripts/lib.ts",
+  "exports": {
+    ".": "./scripts/lib.ts",
+    "./package.json": "./package.json"
   },
   "files": [
     "bin/",
     "scripts/",
     "config/example.env",
-    "openclaw.plugin.json",
     "README.md",
-    "CHANGELOG.md",
-    "SKILL.md"
+    "CHANGELOG.md"
   ],
   "scripts": {
     "onboard": "tsx scripts/setup/onboard.ts",

package/scripts/auto/cli.ts

@@ -130,6 +130,10 @@ async function runCommand(args: Record<string, string | boolean>, positional: st
     process.exit(1);
   }
 
+  const envHooksToken = process.env.OPENCLAW_HOOKS_TOKEN;
+  const envGatewayPortStr = process.env.OPENCLAW_GATEWAY_PORT;
+  const envGatewayPort = envGatewayPortStr ? parseInt(envGatewayPortStr, 10) : undefined;
+
   const automation = await startAutomation({
     scriptPath,
     id,
@@ -138,6 +142,8 @@ async function runCommand(args: Record<string, string | boolean>, positional: st
     pollIntervalMs,
     useWebSocket,
     initialState: Object.keys(initialState).length > 0 ? initialState : undefined,
+    hooksToken: envHooksToken,
+    gatewayPort: envGatewayPort && !isNaN(envGatewayPort) ? envGatewayPort : undefined,
   });
 
   // Graceful shutdown on SIGINT/SIGTERM

package/scripts/auto/runtime.ts

@@ -15,9 +15,9 @@ import { AutomationEventBus } from './events.js';
 import { loadAutomation } from './loader.js';
 import { registerAutomation, unregisterAutomation, getRegisteredAutomations as getRegisteredFromFile } from './registry.js';
 import { createAutomationAudit, toSerializable, type AutomationAuditSink } from './audit.js';
-import { withDashboardForwarder, forwardAgentAction } from './dashboard-forwarder.js';
 import type {
   AutomationAPI,
+  AutomationAuditObserver,
   AutomationEventPayloads,
   AutomationEventType,
   AutomationLogger,
@@ -30,6 +30,70 @@ import type {
   RunningAutomation,
 } from './types.js';
 
+// ── Observer fan-out ────────────────────────────────────────────────
+//
+// External monitoring packages (e.g. `openbroker-monitoring`) plug into
+// the audit pipeline as observers. We auto-load them via convention
+// dynamic-import: any package whose default export is a factory returning
+// an `AutomationAuditObserver` (or null) and that resolves through Node's
+// module resolver gets wired in at startup.
+
+const CONVENTION_OBSERVER_PACKAGES = ['openbroker-monitoring'];
+
+type ObserverFactory =
+  | AutomationAuditObserver
+  | ((opts?: unknown) => AutomationAuditObserver | null | undefined);
+
+async function loadConventionObservers(log: AutomationLogger): Promise<AutomationAuditObserver[]> {
+  const observers: AutomationAuditObserver[] = [];
+  for (const name of CONVENTION_OBSERVER_PACKAGES) {
+    try {
+      const mod = await import(name);
+      const exported: ObserverFactory | undefined = mod.default ?? mod;
+      const observer = typeof exported === 'function' ? exported() : exported;
+      if (observer && typeof observer === 'object') {
+        observers.push(observer as AutomationAuditObserver);
+        log.debug(`Loaded audit observer: ${name}`);
+      }
+    } catch (err) {
+      const code = (err as NodeJS.ErrnoException | undefined)?.code;
+      if (code !== 'ERR_MODULE_NOT_FOUND' && code !== 'MODULE_NOT_FOUND') {
+        log.warn(`Failed to load audit observer "${name}": ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+  }
+  return observers;
+}
+
+function fanOutNote(observers: AutomationAuditObserver[], kind: string, payload?: unknown): void {
+  for (const o of observers) {
+    try { o.onNote?.(kind, payload); } catch { /* observer must not break runtime */ }
+  }
+}
+
+function fanOutMetric(
+  observers: AutomationAuditObserver[],
+  name: string,
+  value: number,
+  tags?: Record<string, unknown>,
+): void {
+  for (const o of observers) {
+    try { o.onMetric?.(name, value, tags); } catch { /* observer must not break runtime */ }
+  }
+}
+
+function fanOutAgentAction(
+  observers: AutomationAuditObserver[],
+  action: string,
+  status: 'success' | 'error',
+  details: Record<string, unknown>,
+  txHash?: string,
+): void {
+  for (const o of observers) {
+    try { o.onAgentAction?.(action, status, details, txHash); } catch { /* observer must not break runtime */ }
+  }
+}
+
 const STATE_DIR = path.join(os.homedir(), '.openbroker', 'state');
 const AUDITED_WRITE_METHODS = new Set([
   'order', 'marketOrder', 'limitOrder', 'triggerOrder',
@@ -155,6 +219,7 @@ function createAuditedClient(
   client: HyperliquidClient,
   audit: AutomationAuditSink,
   dryRun: boolean,
+  observers: AutomationAuditObserver[],
 ): HyperliquidClient {
   return new Proxy(client, {
     get(target, prop, receiver) {
@@ -179,7 +244,8 @@ function createAuditedClient(
               result,
               dryRun,
             });
-            forwardAgentAction(
+            fanOutAgentAction(
+              observers,
               prop,
               'success',
               { args: toSerializable(args), result: toSerializable(result), dryRun },
@@ -193,7 +259,8 @@ function createAuditedClient(
               error,
               dryRun,
             });
-            forwardAgentAction(
+            fanOutAgentAction(
+              observers,
               prop,
               'error',
               { args: toSerializable(args), error: String(error), dryRun },
@@ -282,11 +349,11 @@ function createPublish(
   hooksToken?: string,
 ): (message: string, options?: PublishOptions) => Promise<boolean> {
   return async (message: string, options?: PublishOptions): Promise<boolean> => {
-    const token = hooksToken || process.env.OPENCLAW_HOOKS_TOKEN;
-    const port = gatewayPort || parseInt(process.env.OPENCLAW_GATEWAY_PORT || '18789', 10);
+    const token = hooksToken;
+    const port = gatewayPort || 18789;
 
     if (!token) {
-      log.debug('publish() skipped — no hooks token configured (set OPENCLAW_HOOKS_TOKEN or pass hooksToken in plugin config)');
+      log.debug('publish() skipped — no hooks token configured (pass --hooks-token, set OPENCLAW_HOOKS_TOKEN before invoking the CLI, or configure plugin.hooksToken)');
       return false;
     }
 
@@ -425,8 +492,9 @@ export async function startAutomation(options: RuntimeOptions): Promise<RunningA
   stateController.attachAudit(audit);
 
   const log = createLogger(id, verbose, audit);
+  const observers = await loadConventionObservers(log);
   const baseClient = dryRun ? createDryClient(rawClient, log) : rawClient;
-  const client = createAuditedClient(baseClient, audit, dryRun);
+  const client = createAuditedClient(baseClient, audit, dryRun, observers);
 
   const startHooks: Array<() => void | Promise<void>> = [];
   const stopHooks: Array<() => void | Promise<void>> = [];
@@ -435,10 +503,16 @@ export async function startAutomation(options: RuntimeOptions): Promise<RunningA
 
   // Build the API object
   const publish = createAuditedPublish(createPublish(id, log, gatewayPort, hooksToken), audit);
-  const auditApi: AutomationAudit = withDashboardForwarder({
-    record: (kind: string, payload?: unknown) => audit.recordNote(kind, payload),
-    metric: (name: string, value: number, tags?: Record<string, unknown>) => audit.recordMetric(name, value, tags),
-  });
+  const auditApi: AutomationAudit = {
+    record: (kind: string, payload?: unknown) => {
+      audit.recordNote(kind, payload);
+      fanOutNote(observers, kind, payload);
+    },
+    metric: (name: string, value: number, tags?: Record<string, unknown>) => {
+      audit.recordMetric(name, value, tags);
+      fanOutMetric(observers, name, value, tags);
+    },
+  };
   const api: AutomationAPI = {
     client,
     utils: { roundPrice, roundSize, sleep, normalizeCoin, formatUsd, formatPercent, annualizeFundingRate },

package/scripts/auto/types.ts

@@ -116,6 +116,26 @@ export interface AutomationAudit {
   metric(name: string, value: number, tags?: Record<string, unknown>): void;
 }
 
+/**
+ * Hook for external monitoring packages (e.g. `openbroker-monitoring`) to
+ * receive audit events. The runtime fans out every note, metric, and
+ * audited write-method call to every observer it has loaded.
+ *
+ * Observers are auto-loaded via convention dynamic-import — the runtime
+ * tries `await import('openbroker-monitoring')` at startup and uses the
+ * default export (a factory returning an observer or null).
+ */
+export interface AutomationAuditObserver {
+  onNote?(kind: string, payload?: unknown): void;
+  onMetric?(name: string, value: number, tags?: Record<string, unknown>): void;
+  onAgentAction?(
+    action: string,
+    status: 'success' | 'error',
+    details: Record<string, unknown>,
+    txHash?: string,
+  ): void;
+}
+
 // ── Publish (webhook) ───────────────────────────────────────────────
 
 export interface PublishOptions {

package/scripts/core/client.ts

@@ -56,7 +56,7 @@ export class HyperliquidClient {
   constructor(config?: OpenBrokerConfig) {
     this.config = config ?? loadConfig();
     this.account = privateKeyToAccount(this.config.privateKey);
-    this.verbose = process.env.VERBOSE === '1' || process.env.VERBOSE === 'true';
+    this.verbose = this.config.verbose;
 
     // Initialize SDK clients
     this.transport = new HttpTransport({ isTestnet: !isMainnet() });

package/scripts/core/config.ts

@@ -142,6 +142,8 @@ export function loadConfig(): OpenBrokerConfig {
   // Standard API wallets (approved via approveAgent) do NOT need this.
   const vaultAddress = process.env.HYPERLIQUID_VAULT_ADDRESS?.toLowerCase();
 
+  const verbose = process.env.VERBOSE === '1' || process.env.VERBOSE === 'true';
+
   return {
     baseUrl,
     privateKey: privateKey as `0x${string}`,
@@ -153,6 +155,7 @@ export function loadConfig(): OpenBrokerConfig {
     builderFee,
     slippageBps,
     vaultAddress,
+    verbose,
   };
 }
 

package/scripts/core/types.ts

@@ -13,6 +13,7 @@ export interface OpenBrokerConfig {
   builderFee: number;         // tenths of bps (10 = 1 bps)
   slippageBps: number;
   vaultAddress?: string;      // Explicit vault address for vault trading (ERC4626 / native vaults via CoreWriter)
+  verbose: boolean;           // Debug logging — set from VERBOSE env var by loadConfig()
 }
 
 // ============ Builder ============

package/scripts/lib.ts

@@ -0,0 +1,80 @@
+// Public library API for `openbroker`.
+//
+// External packages — notably `openbroker-plugin` — import from here to
+// drive the CLI's functionality in-process (no `child_process` dispatch).
+//
+// Stability: every symbol re-exported here is a public API. Renames or
+// removals are breaking changes and require a major version bump.
+
+export {
+  HyperliquidClient,
+  getClient,
+} from './core/client.js';
+
+export {
+  loadConfig,
+  isConfigured,
+  getNetwork,
+  isMainnet,
+  ensureConfigDir,
+  getConfigPath,
+  GLOBAL_CONFIG_DIR,
+  GLOBAL_ENV_PATH,
+  OPEN_BROKER_BUILDER_ADDRESS,
+} from './core/config.js';
+
+export {
+  roundPrice,
+  roundSize,
+  sleep,
+  normalizeCoin,
+  formatUsd,
+  formatPercent,
+  annualizeFundingRate,
+  parseArgs,
+  getSlippagePrice,
+  getTimestampMs,
+  generateCloid,
+  orderToWire,
+  checkBuilderFeeApproval,
+} from './core/utils.js';
+
+export type * from './core/types.js';
+
+// ── Operations (in-process callable) ────────────────────────────────
+
+export { runBracket } from './operations/bracket.js';
+export type { BracketOptions, BracketResult } from './operations/bracket.js';
+
+export { runChase } from './operations/chase.js';
+export type { ChaseOptions, ChaseResult } from './operations/chase.js';
+
+// ── Automation runtime ──────────────────────────────────────────────
+
+export {
+  startAutomation,
+  getRunningAutomations,
+  getAutomation,
+  getRegisteredAutomations,
+} from './auto/runtime.js';
+export type { RuntimeOptions } from './auto/runtime.js';
+
+export {
+  resolveScriptPath,
+  resolveExamplePath,
+  listAutomations,
+  listExamples,
+  loadExampleConfigs,
+  ensureAutomationsDir,
+  loadAutomation,
+} from './auto/loader.js';
+
+export {
+  registerAutomation,
+  unregisterAutomation,
+  cleanRegistry,
+  getAutomationsToRestart,
+  markAutomationError,
+} from './auto/registry.js';
+
+export type * from './auto/types.js';