@reefclaw/connect 0.1.3 → 0.1.4

package/assets/plugin/connector-supervisor.d.ts

@@ -1,4 +1,20 @@
 import { spawn } from 'node:child_process';
+/** Bridge bundled INSIDE the plugin package (the npm-channel distribution
+ *  `@reefclaw/openclaw-plugin` ships the connector at <pluginRoot>/bridge).
+ *  Compiled connector-supervisor.js sits at the plugin dist root, so the
+ *  bundled bridge is a sibling directory. */
+export declare function bundledBridgeDir(): string;
+/** Where the connector lives, in preference order: bundled-in-package first
+ *  (npm-channel install — self-contained), then the npx installer's
+ *  placement. Returns null when neither exists. */
+export declare function resolveBridgeDir(): string | null;
+/** True when the plugin should supervise the connector even WITHOUT an
+ *  explicit connectorSupervisor='on' in plugin-config: the connector is
+ *  bundled inside this plugin package, which only the npm-channel
+ *  distribution does. Prod's linked plugin dir and the npx installer's
+ *  ~/.reefclaw/plugin have no bridge/ subdir, so they stay opt-in — prod
+ *  keeps running the bridge under systemd and must never double-connect. */
+export declare function hasBundledBridge(): boolean;
 export interface ConnectorSupervisorOptions {
     /** Directory holding the placed bridge (default ~/.reefclaw/bridge). */
     bridgeDir?: string;

package/assets/plugin/connector-supervisor.js

@@ -16,9 +16,36 @@
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { logger } from './logger.js';
 const TAG = 'connector-supervisor';
+/** Bridge bundled INSIDE the plugin package (the npm-channel distribution
+ *  `@reefclaw/openclaw-plugin` ships the connector at <pluginRoot>/bridge).
+ *  Compiled connector-supervisor.js sits at the plugin dist root, so the
+ *  bundled bridge is a sibling directory. */
+export function bundledBridgeDir() {
+    return join(dirname(fileURLToPath(import.meta.url)), 'bridge');
+}
+/** Where the connector lives, in preference order: bundled-in-package first
+ *  (npm-channel install — self-contained), then the npx installer's
+ *  placement. Returns null when neither exists. */
+export function resolveBridgeDir() {
+    for (const dir of [bundledBridgeDir(), join(homedir(), '.reefclaw', 'bridge')]) {
+        if (existsSync(join(dir, 'index.js')))
+            return dir;
+    }
+    return null;
+}
+/** True when the plugin should supervise the connector even WITHOUT an
+ *  explicit connectorSupervisor='on' in plugin-config: the connector is
+ *  bundled inside this plugin package, which only the npm-channel
+ *  distribution does. Prod's linked plugin dir and the npx installer's
+ *  ~/.reefclaw/plugin have no bridge/ subdir, so they stay opt-in — prod
+ *  keeps running the bridge under systemd and must never double-connect. */
+export function hasBundledBridge() {
+    return existsSync(join(bundledBridgeDir(), 'index.js'));
+}
 const MIN_BACKOFF_MS = 5_000;
 const MAX_BACKOFF_MS = 60_000;
 /** A child that survives this long resets the backoff (it was healthy). */
@@ -32,10 +59,14 @@ let singleton = null;
 export function startConnectorSupervisor(opts = {}) {
     if (singleton)
         return singleton;
-    const bridgeDir = opts.bridgeDir ?? join(homedir(), '.reefclaw', 'bridge');
+    const bridgeDir = opts.bridgeDir ?? resolveBridgeDir();
+    if (!bridgeDir) {
+        logger.warn(TAG, 'connector not found (no bundled bridge/ and no ~/.reefclaw/bridge) — supervisor idle');
+        return null;
+    }
     const indexJs = join(bridgeDir, 'index.js');
     if (!existsSync(indexJs)) {
-        logger.warn(TAG, `connector not found at ${indexJs} — supervisor idle (run the installer first)`);
+        logger.warn(TAG, `connector not found at ${indexJs} — supervisor idle`);
         return null;
     }
     const spawnFn = opts.spawnFn ?? spawn;

package/assets/plugin/index.js

@@ -40,7 +40,7 @@ import { queryReviewOutcomesTool } from './tools/query-review-outcomes.js';
 import { loadPositionReviewMode } from './config/position-review-config.js';
 import { installSignalHandlers } from './lifecycle/install-signal-handlers.js';
 import { readPluginConfig } from './config/plugin-config-io.js';
-import { startConnectorSupervisor } from './connector-supervisor.js';
+import { startConnectorSupervisor, hasBundledBridge } from './connector-supervisor.js';
 import { ToolGate } from './config/tool-gate.js';
 import { gateStore } from './config/gate-store.js';
 import { startAgentConfigPoller } from './config/agent-config-poller.js';
@@ -2010,8 +2010,16 @@ function maybeStartConnectorSupervisor() {
         if (process.env.RC_CONNECTOR_SUPERVISOR === 'off') {
             if (supervisorMode === 'on')
                 logger.warn(TAG, 'connector supervisor disabled by RC_CONNECTOR_SUPERVISOR=off');
+            return;
         }
-        else if (supervisorMode === 'on') {
+        if (supervisorMode === 'off')
+            return;
+        // 'on' → explicit opt-in (the npx installer writes this).
+        // undefined → auto-start ONLY when the connector is bundled inside this
+        // plugin package (the npm-channel @reefclaw/openclaw-plugin distribution
+        // is self-contained by design). Prod's linked plugin dir has no bundled
+        // bridge and no flag → stays off; systemd keeps owning prod's bridge.
+        if (supervisorMode === 'on' || hasBundledBridge()) {
             startConnectorSupervisor();
         }
     }

package/assets/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: reefclaw
-version: 0.0.2
+version: 0.0.3
 description: ReefClaw trading control room — bootstrap (connects your agent; full trading instructions arrive automatically after first connect)
 author: ReefClaw
 homepage: https://reefclaw.com
@@ -66,6 +66,16 @@ When a user gives you this message (or just a bare `Here's my ReefClaw token: rc
 - After saving, the connector picks the config up within seconds (it restarts until a token appears). The user does not need to run any command.
 - If you cannot write the config yourself (e.g. exec or file access is restricted in this session), show the user this exact JSON snippet and where it goes, and offer to verify it after they save it.
 
+## Installing without any terminal (preferred)
+
+OpenClaw can install the ReefClaw plugin through its own owner chat command — no exec, no terminal:
+
+1. In `~/.openclaw/openclaw.json` set `commands.plugins: true` and add the user's **sender id** (visible in this session) to `commands.ownerAllowFrom`.
+2. Tell the user to type `/restart` in this chat.
+3. Then the user types: `/plugins install npm:@reefclaw/openclaw-plugin` — the install restarts OpenClaw automatically; the bundled connector starts by itself and the dashboard flips to Connected.
+
+Only fall back to `npx @reefclaw/connect` (below) when the chat install is unavailable.
+
 ## If you cannot run the installer (elevated exec disabled)
 
 Fresh OpenClaw installs deny elevated (host) exec from chat sessions. If `npx @reefclaw/connect` is blocked, do NOT dead-end — offer the user this choice:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reefclaw/connect",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "One-command installer that connects your OpenClaw agent to ReefClaw (paper trading, no exchange keys).",
   "type": "module",
   "bin": {