clawnexus 0.2.7 → 0.3.0

package/dist/adapter/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Framework adapter interface — pluggable probe logic for non-OpenClaw variants
+// that don't share port 18789 or serve /__openclaw/control-ui-config.json
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/server.d.ts

@@ -39,6 +39,7 @@ export interface DiagnosticsDeps {
     unreachable: UnreachableInstance[];
 }
 export declare function registerDiagnosticsRoutes(app: FastifyInstance, deps: DiagnosticsDeps): void;
+export declare function registerA2aRoutes(app: FastifyInstance, store: RegistryStore, daemonVersion: string): void;
 export interface DaemonOptions {
     port?: number;
     host?: string;

package/dist/api/server.js

@@ -10,6 +10,7 @@ exports.registerAgentRoutes = registerAgentRoutes;
 exports.registerRegistryRoutes = registerRegistryRoutes;
 exports.registerInstanceRoutes = registerInstanceRoutes;
 exports.registerDiagnosticsRoutes = registerDiagnosticsRoutes;
+exports.registerA2aRoutes = registerA2aRoutes;
 exports.startDaemon = startDaemon;
 const fastify_1 = __importDefault(require("fastify"));
 const store_js_1 = require("../registry/store.js");
@@ -27,6 +28,9 @@ const client_js_1 = require("../registry/client.js");
 const auto_register_js_1 = require("../registry/auto-register.js");
 const discovery_js_1 = require("../registry/discovery.js");
 const connector_js_1 = require("../relay/connector.js");
+const card_js_1 = require("../a2a/card.js");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
 const PORT = parseInt(process.env.CLAWNEXUS_PORT ?? "17890", 10);
 const HOST = process.env.CLAWNEXUS_HOST ?? "127.0.0.1";
 function registerRelayRoutes(app, getConnector) {
@@ -301,6 +305,30 @@ function registerDiagnosticsRoutes(app, deps) {
         };
     });
 }
+function registerA2aRoutes(app, store, daemonVersion) {
+    // A2A standard well-known endpoint — returns card for the local (is_self) instance
+    app.get("/.well-known/agent-card.json", async (_request, reply) => {
+        const self = store.getAll().find((i) => i.is_self);
+        if (!self) {
+            return reply.status(404).send({ error: "No local instance discovered" });
+        }
+        return (0, card_js_1.buildAgentCard)(self, daemonVersion);
+    });
+    // All instances as Agent Cards
+    app.get("/a2a/cards", async () => {
+        const instances = store.getAll();
+        const cards = instances.map((i) => (0, card_js_1.buildAgentCard)(i, daemonVersion));
+        return { count: cards.length, cards };
+    });
+    // Single instance Agent Card by name
+    app.get("/a2a/cards/:name", async (request, reply) => {
+        const inst = store.resolve(request.params.name);
+        if (!inst) {
+            return reply.status(404).send({ error: "Instance not found" });
+        }
+        return (0, card_js_1.buildAgentCard)(inst, daemonVersion);
+    });
+}
 async function startDaemon(options = {}) {
     const port = options.port ?? PORT;
     const host = options.host ?? HOST;
@@ -390,6 +418,9 @@ async function startDaemon(options = {}) {
         getAutoRegister: () => autoRegister,
         unreachable,
     });
+    // A2A Agent Card routes
+    const daemonPkg = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "../../package.json"), "utf-8"));
+    registerA2aRoutes(app, store, daemonPkg.version);
     // 9. Initialize Registry integration (non-fatal — LAN must work without it)
     let identityKeys = null;
     let registryClient = null;

package/dist/cli/index.js

@@ -156,6 +156,7 @@ function printTable(instances) {
     }
     const header = {
         name: "NAME",
+        impl: "IMPL",
         address: "ADDRESS",
         status: "STATUS",
         channel: "CHANNEL",
@@ -166,6 +167,7 @@ function printTable(instances) {
         const baseName = i.alias ?? i.auto_name;
         return {
             name: i.is_self ? `${baseName} (self)` : baseName,
+            impl: i.implementation ?? "-",
             address: `${i.address}:${i.gateway_port}`,
             status: i.status,
             channel: getChannel(i),
@@ -175,15 +177,16 @@ function printTable(instances) {
     });
     const colWidths = {
         name: Math.max(header.name.length, ...rows.map((r) => r.name.length)),
+        impl: Math.max(header.impl.length, ...rows.map((r) => r.impl.length)),
         address: Math.max(header.address.length, ...rows.map((r) => r.address.length)),
         status: Math.max(header.status.length, ...rows.map((r) => r.status.length)),
         channel: Math.max(header.channel.length, ...rows.map((r) => r.channel.length)),
         source: Math.max(header.source.length, ...rows.map((r) => r.source.length)),
         lastSeen: Math.max(header.lastSeen.length, ...rows.map((r) => r.lastSeen.length)),
     };
-    const line = (r) => `${r.name.padEnd(colWidths.name)}  ${r.address.padEnd(colWidths.address)}  ${r.status.padEnd(colWidths.status)}  ${r.channel.padEnd(colWidths.channel)}  ${r.source.padEnd(colWidths.source)}  ${r.lastSeen}`;
+    const line = (r) => `${r.name.padEnd(colWidths.name)}  ${r.impl.padEnd(colWidths.impl)}  ${r.address.padEnd(colWidths.address)}  ${r.status.padEnd(colWidths.status)}  ${r.channel.padEnd(colWidths.channel)}  ${r.source.padEnd(colWidths.source)}  ${r.lastSeen}`;
     console.log(line(header));
-    console.log("-".repeat(colWidths.name + colWidths.address + colWidths.status + colWidths.channel + colWidths.source + colWidths.lastSeen + 10));
+    console.log("-".repeat(colWidths.name + colWidths.impl + colWidths.address + colWidths.status + colWidths.channel + colWidths.source + colWidths.lastSeen + 12));
     for (const row of rows) {
         console.log(line(row));
     }
@@ -404,6 +407,8 @@ async function cmdInfo(args) {
         const inst = data;
         console.log(`Auto Name:     ${inst.auto_name}${inst.is_self ? " (self)" : ""}`);
         console.log(`Agent ID:      ${inst.agent_id}`);
+        if (inst.implementation)
+            console.log(`Implementation: ${inst.implementation}`);
         console.log(`Display Name:  ${inst.display_name}`);
         console.log(`Assistant:     ${inst.assistant_name}`);
         if (inst.alias)

package/dist/discovery/broadcast.js

@@ -46,7 +46,6 @@ const CDP_PORT = 17891;
 const TCP_PROBE_TIMEOUT = 2_000;
 const ANNOUNCE_INTERVAL_BASE = 60_000;
 const ANNOUNCE_JITTER = 10_000;
-const CONFIG_PATH = "/__openclaw/control-ui-config.json";
 class BroadcastDiscovery extends node_events_1.EventEmitter {
     store;
     getLocalInstance;
@@ -274,12 +273,14 @@ class BroadcastDiscovery extends node_events_1.EventEmitter {
         });
     }
     async _tcpProbe(address, port) {
-        const url = `http://${address}:${port}${CONFIG_PATH}`;
+        // Quick HTTP liveness check — just confirm the port is alive.
+        // Framework identification is left to HealthChecker / subsequent scans.
         try {
-            const res = await fetch(url, {
+            const res = await fetch(`http://${address}:${port}/`, {
                 signal: AbortSignal.timeout(TCP_PROBE_TIMEOUT),
             });
-            return res.ok;
+            // Any HTTP response (including 404, 500) means the port is alive
+            return res.status > 0;
         }
         catch {
             return false;

package/dist/health/checker.d.ts

@@ -11,4 +11,8 @@ export declare class HealthChecker extends EventEmitter {
     stop(): void;
     checkAll(): Promise<void>;
     private checkOne;
+    /** OpenClaw-specific health check with name updates */
+    private checkOpenClaw;
+    /** Fallback health check for instances without a known adapter */
+    private genericHttpCheck;
 }

package/dist/health/checker.js

@@ -1,9 +1,11 @@
 "use strict";
 // Health Checker — periodically pings known instances and updates status
 // Enhanced with dual-channel connectivity detection
+// Adapter-aware: uses framework-specific health checks for non-OpenClaw instances
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HealthChecker = void 0;
 const node_events_1 = require("node:events");
+const index_js_1 = require("../adapter/index.js");
 const CHECK_INTERVAL = 30_000;
 const PING_TIMEOUT = 5_000;
 const CONFIG_PATH = "/__openclaw/control-ui-config.json";
@@ -41,36 +43,51 @@ class HealthChecker extends node_events_1.EventEmitter {
         if (inst.is_self)
             return;
         const networkKey = this.store.networkKey(inst.address, inst.gateway_port);
-        const protocol = inst.tls ? "https" : "http";
-        const url = `${protocol}://${inst.address}:${inst.gateway_port}${CONFIG_PATH}`;
+        const impl = inst.implementation ?? "openclaw";
         const now = new Date().toISOString();
         let lanOk = false;
         let lanLatency;
         let unreachableReason;
-        try {
-            const start = performance.now();
-            const res = await fetch(url, {
-                signal: AbortSignal.timeout(PING_TIMEOUT),
-            });
-            lanLatency = Math.round(performance.now() - start);
-            if (res.ok) {
-                lanOk = true;
-                const config = (await res.json());
-                inst.last_seen = now;
-                if (config.assistantName) {
-                    inst.assistant_name = config.assistantName;
+        if (impl === "openclaw" || impl === "goclaw") {
+            // OpenClaw path: detailed check with name updates (original behavior)
+            const result = await this.checkOpenClaw(inst, now);
+            lanOk = result.ok;
+            lanLatency = result.latency;
+            unreachableReason = result.reason;
+        }
+        else {
+            // Non-OpenClaw: use adapter healthCheck
+            const adapter = (0, index_js_1.getAdapter)(impl);
+            if (adapter) {
+                try {
+                    const start = performance.now();
+                    // Use healthCheckLocal for port-0 instances (no HTTP server)
+                    if (inst.gateway_port === 0 && adapter.healthCheckLocal) {
+                        lanOk = await adapter.healthCheckLocal();
+                    }
+                    else {
+                        lanOk = await adapter.healthCheck(inst.address, inst.gateway_port);
+                    }
+                    lanLatency = Math.round(performance.now() - start);
+                    if (lanOk) {
+                        inst.last_seen = now;
+                    }
+                    else {
+                        unreachableReason = "Health check failed";
+                    }
                 }
-                if (config.displayName) {
-                    inst.display_name = config.displayName;
+                catch (err) {
+                    unreachableReason = err instanceof Error ? err.message : "Connection failed";
                 }
             }
             else {
-                unreachableReason = `HTTP ${res.status}`;
+                // Unknown implementation: generic HTTP check
+                const result = await this.genericHttpCheck(inst, now);
+                lanOk = result.ok;
+                lanLatency = result.latency;
+                unreachableReason = result.reason;
             }
         }
-        catch (err) {
-            unreachableReason = err instanceof Error ? err.message : "Connection failed";
-        }
         // Check relay availability
         const relayAvailable = this.relayChecker?.(inst.agent_id) ?? false;
         // Update connectivity
@@ -104,5 +121,52 @@ class HealthChecker extends node_events_1.EventEmitter {
             });
         }
     }
+    /** OpenClaw-specific health check with name updates */
+    async checkOpenClaw(inst, now) {
+        const protocol = inst.tls ? "https" : "http";
+        const url = `${protocol}://${inst.address}:${inst.gateway_port}${CONFIG_PATH}`;
+        try {
+            const start = performance.now();
+            const res = await fetch(url, {
+                signal: AbortSignal.timeout(PING_TIMEOUT),
+            });
+            const latency = Math.round(performance.now() - start);
+            if (res.ok) {
+                const config = (await res.json());
+                inst.last_seen = now;
+                if (config.assistantName) {
+                    inst.assistant_name = config.assistantName;
+                }
+                if (config.displayName) {
+                    inst.display_name = config.displayName;
+                }
+                return { ok: true, latency };
+            }
+            return { ok: false, latency, reason: `HTTP ${res.status}` };
+        }
+        catch (err) {
+            return { ok: false, reason: err instanceof Error ? err.message : "Connection failed" };
+        }
+    }
+    /** Fallback health check for instances without a known adapter */
+    async genericHttpCheck(inst, now) {
+        const protocol = inst.tls ? "https" : "http";
+        const url = `${protocol}://${inst.address}:${inst.gateway_port}/`;
+        try {
+            const start = performance.now();
+            const res = await fetch(url, {
+                signal: AbortSignal.timeout(PING_TIMEOUT),
+            });
+            const latency = Math.round(performance.now() - start);
+            if (res.ok) {
+                inst.last_seen = now;
+                return { ok: true, latency };
+            }
+            return { ok: false, latency, reason: `HTTP ${res.status}` };
+        }
+        catch (err) {
+            return { ok: false, reason: err instanceof Error ? err.message : "Connection failed" };
+        }
+    }
 }
 exports.HealthChecker = HealthChecker;

package/dist/index.d.ts

@@ -6,6 +6,10 @@ export { HealthChecker } from './health/checker.js';
 export { LocalProbe } from './local/probe.js';
 export { ActiveScanner } from './scanner/active.js';
 export type { ScanOptions } from './scanner/active.js';
+export { ADAPTERS, getAdapter, getAllAdapterPorts } from './adapter/index.js';
+export { NanoClawAdapter } from './adapter/nanoclaw.js';
+export { NanoBotAdapter } from './adapter/nanobot.js';
+export type { FrameworkAdapter, ProbeResult } from './adapter/types.js';
 export { BroadcastDiscovery } from './discovery/broadcast.js';
 export { registerRelayRoutes, registerInstanceRoutes, registerAgentRoutes, registerDiagnosticsRoutes, registerRegistryRoutes, startDaemon } from './api/server.js';
 export type { DaemonOptions, DaemonHandle, AgentDeps, DiagnosticsDeps, RegistryDeps } from './api/server.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProtocolError = exports.isExpired = exports.validatePayload = exports.parseEnvelope = exports.createEnvelope = exports.AgentRouter = exports.TaskManager = exports.PolicyEngine = exports.RelayConnector = exports.RemoteDiscovery = exports.AutoRegister = exports.RegistryError = exports.RegistryClient = exports.getPublicKeyString = exports.sign = exports.loadOrCreateKeys = exports.startDaemon = exports.registerRegistryRoutes = exports.registerDiagnosticsRoutes = exports.registerAgentRoutes = exports.registerInstanceRoutes = exports.registerRelayRoutes = exports.BroadcastDiscovery = exports.ActiveScanner = exports.LocalProbe = exports.HealthChecker = exports.MdnsListener = exports.NotFoundError = exports.AliasConflictError = exports.AliasError = exports.RegistryStore = void 0;
+exports.ProtocolError = exports.isExpired = exports.validatePayload = exports.parseEnvelope = exports.createEnvelope = exports.AgentRouter = exports.TaskManager = exports.PolicyEngine = exports.RelayConnector = exports.RemoteDiscovery = exports.AutoRegister = exports.RegistryError = exports.RegistryClient = exports.getPublicKeyString = exports.sign = exports.loadOrCreateKeys = exports.startDaemon = exports.registerRegistryRoutes = exports.registerDiagnosticsRoutes = exports.registerAgentRoutes = exports.registerInstanceRoutes = exports.registerRelayRoutes = exports.BroadcastDiscovery = exports.NanoBotAdapter = exports.NanoClawAdapter = exports.getAllAdapterPorts = exports.getAdapter = exports.ADAPTERS = exports.ActiveScanner = exports.LocalProbe = exports.HealthChecker = exports.MdnsListener = exports.NotFoundError = exports.AliasConflictError = exports.AliasError = exports.RegistryStore = void 0;
 var store_js_1 = require("./registry/store.js");
 Object.defineProperty(exports, "RegistryStore", { enumerable: true, get: function () { return store_js_1.RegistryStore; } });
 Object.defineProperty(exports, "AliasError", { enumerable: true, get: function () { return store_js_1.AliasError; } });
@@ -14,6 +14,14 @@ var probe_js_1 = require("./local/probe.js");
 Object.defineProperty(exports, "LocalProbe", { enumerable: true, get: function () { return probe_js_1.LocalProbe; } });
 var active_js_1 = require("./scanner/active.js");
 Object.defineProperty(exports, "ActiveScanner", { enumerable: true, get: function () { return active_js_1.ActiveScanner; } });
+var index_js_1 = require("./adapter/index.js");
+Object.defineProperty(exports, "ADAPTERS", { enumerable: true, get: function () { return index_js_1.ADAPTERS; } });
+Object.defineProperty(exports, "getAdapter", { enumerable: true, get: function () { return index_js_1.getAdapter; } });
+Object.defineProperty(exports, "getAllAdapterPorts", { enumerable: true, get: function () { return index_js_1.getAllAdapterPorts; } });
+var nanoclaw_js_1 = require("./adapter/nanoclaw.js");
+Object.defineProperty(exports, "NanoClawAdapter", { enumerable: true, get: function () { return nanoclaw_js_1.NanoClawAdapter; } });
+var nanobot_js_1 = require("./adapter/nanobot.js");
+Object.defineProperty(exports, "NanoBotAdapter", { enumerable: true, get: function () { return nanobot_js_1.NanoBotAdapter; } });
 var broadcast_js_1 = require("./discovery/broadcast.js");
 Object.defineProperty(exports, "BroadcastDiscovery", { enumerable: true, get: function () { return broadcast_js_1.BroadcastDiscovery; } });
 var server_js_1 = require("./api/server.js");

package/dist/local/probe.d.ts

@@ -11,5 +11,9 @@ export declare class LocalProbe extends EventEmitter {
     start(): Promise<void>;
     stop(): void;
     private _markOffline;
+    /** Mark offline any previously-known self instances that were not rediscovered this cycle */
+    private _markOfflineStaleSelf;
     probe(): Promise<ClawInstance | null>;
+    /** Original OpenClaw probe logic (kept as primary path for backward compatibility) */
+    private probeOpenClaw;
 }

package/dist/local/probe.js

@@ -1,6 +1,7 @@
 "use strict";
-// LocalProbe — detects OpenClaw instance on localhost and registers it
+// LocalProbe — detects AI instances on localhost and registers them
 // Runs on daemon startup, then periodically re-checks
+// Adapter-aware: tries all registered adapters on their default ports
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -38,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocalProbe = void 0;
 const node_events_1 = require("node:events");
 const os = __importStar(require("node:os"));
+const index_js_1 = require("../adapter/index.js");
 const LOCAL_HOST = "127.0.0.1";
 const DEFAULT_PORT = 18789;
 const CONFIG_PATH = "/__openclaw/control-ui-config.json";
@@ -71,8 +73,8 @@ class LocalProbe extends node_events_1.EventEmitter {
             this.timer = null;
         }
     }
-    _markOffline() {
-        const existing = this.store.getByNetworkKey(LOCAL_HOST, this.port);
+    _markOffline(port) {
+        const existing = this.store.getByNetworkKey(LOCAL_HOST, port);
         if (existing && existing.status !== "offline") {
             this.store.upsert({
                 ...existing,
@@ -81,21 +83,135 @@ class LocalProbe extends node_events_1.EventEmitter {
             });
         }
     }
+    /** Mark offline any previously-known self instances that were not rediscovered this cycle */
+    _markOfflineStaleSelf(staleKeys) {
+        for (const key of staleKeys) {
+            const [address, portStr] = key.split(":");
+            this._markOffline(Number(portStr));
+        }
+    }
     async probe() {
-        const url = `http://${LOCAL_HOST}:${this.port}${CONFIG_PATH}`;
+        // Snapshot all current is_self instances so we can mark stale ones offline later
+        const previousSelfKeys = new Set(this.store
+            .getAll()
+            .filter((inst) => inst.is_self)
+            .map((inst) => `${inst.address}:${inst.gateway_port}`));
+        // 1. Try OpenClaw on the configured port (backward-compatible primary path)
+        const openClawResult = await this.probeOpenClaw(this.port);
+        if (openClawResult) {
+            previousSelfKeys.delete(`${LOCAL_HOST}:${this.port}`);
+            this._markOfflineStaleSelf(previousSelfKeys);
+            return openClawResult;
+        }
+        // 2. Try all adapters on their default ports (skip OpenClaw on this.port, already tried)
+        let found = null;
+        for (const adapter of index_js_1.ADAPTERS) {
+            if (adapter.name === "openclaw")
+                continue; // already tried above
+            // Try probeLocal first (for frameworks without HTTP servers, e.g. NanoClaw)
+            if (adapter.probeLocal) {
+                const probeResult = await adapter.probeLocal();
+                if (probeResult) {
+                    const now = new Date().toISOString();
+                    const partial = adapter.toClawInstance(LOCAL_HOST, 0, probeResult);
+                    const instance = {
+                        agent_id: partial.agent_id ?? `${adapter.name}@localhost`,
+                        auto_name: "",
+                        assistant_name: partial.assistant_name ?? "",
+                        display_name: partial.display_name ?? adapter.name,
+                        lan_host: os.hostname(),
+                        address: LOCAL_HOST,
+                        gateway_port: partial.gateway_port ?? 0,
+                        tls: false,
+                        discovery_source: "local",
+                        network_scope: "local",
+                        status: "online",
+                        last_seen: now,
+                        discovered_at: now,
+                        implementation: partial.implementation,
+                        connectivity: {
+                            lan_reachable: false,
+                            relay_available: false,
+                            preferred_channel: "local",
+                            last_lan_check: now,
+                        },
+                        is_self: true,
+                        labels: partial.labels,
+                    };
+                    this.store.upsert(instance);
+                    this.emit("local:discovered", instance);
+                    previousSelfKeys.delete(`${LOCAL_HOST}:${instance.gateway_port}`);
+                    found = instance;
+                    break;
+                }
+            }
+            // Then try HTTP probe on default ports
+            if (!found) {
+                for (const port of adapter.defaultPorts) {
+                    const probeResult = await adapter.probe(LOCAL_HOST, port);
+                    if (probeResult) {
+                        const now = new Date().toISOString();
+                        const partial = adapter.toClawInstance(LOCAL_HOST, port, probeResult);
+                        const instance = {
+                            agent_id: partial.agent_id ?? `${adapter.name}@localhost`,
+                            auto_name: "",
+                            assistant_name: partial.assistant_name ?? "",
+                            display_name: partial.display_name ?? adapter.name,
+                            lan_host: os.hostname(),
+                            address: LOCAL_HOST,
+                            gateway_port: port,
+                            tls: false,
+                            discovery_source: "local",
+                            network_scope: "local",
+                            status: "online",
+                            last_seen: now,
+                            discovered_at: now,
+                            implementation: partial.implementation,
+                            connectivity: {
+                                lan_reachable: true,
+                                relay_available: false,
+                                preferred_channel: "local",
+                                last_lan_check: now,
+                            },
+                            is_self: true,
+                        };
+                        this.store.upsert(instance);
+                        this.emit("local:discovered", instance);
+                        previousSelfKeys.delete(`${LOCAL_HOST}:${port}`);
+                        found = instance;
+                        break;
+                    }
+                }
+            }
+            if (found)
+                break;
+        }
+        if (found) {
+            this._markOfflineStaleSelf(previousSelfKeys);
+            return found;
+        }
+        // Nothing found
+        this.localAgentId = null;
+        this._markOfflineStaleSelf(previousSelfKeys);
+        this.emit("local:unavailable");
+        return null;
+    }
+    /** Original OpenClaw probe logic (kept as primary path for backward compatibility) */
+    async probeOpenClaw(port) {
+        const url = `http://${LOCAL_HOST}:${port}${CONFIG_PATH}`;
         try {
             const res = await fetch(url, {
                 signal: AbortSignal.timeout(PROBE_TIMEOUT),
             });
             if (!res.ok) {
-                this._markOffline();
-                this.emit("local:unreachable", { reason: `HTTP ${res.status}` });
+                // Port responded but not valid OpenClaw — don't mark offline or emit unreachable,
+                // because another adapter may be occupying this port. Let the adapter loop try.
                 return null;
             }
             const config = (await res.json());
             if (!config.assistantAgentId) {
-                this._markOffline();
-                this.emit("local:unreachable", { reason: "missing assistantAgentId" });
+                // Has an HTTP server but no assistantAgentId — not a valid OpenClaw instance.
+                // Don't mark offline; another adapter may match this endpoint.
                 return null;
             }
             this.localAgentId = config.assistantAgentId;
@@ -107,13 +223,14 @@ class LocalProbe extends node_events_1.EventEmitter {
                 display_name: config.displayName ?? config.assistantName ?? "",
                 lan_host: os.hostname(),
                 address: LOCAL_HOST,
-                gateway_port: this.port,
+                gateway_port: port,
                 tls: false,
                 discovery_source: "local",
                 network_scope: "local",
                 status: "online",
                 last_seen: now,
                 discovered_at: now,
+                implementation: "openclaw",
                 connectivity: {
                     lan_reachable: true,
                     relay_available: false,
@@ -127,9 +244,7 @@ class LocalProbe extends node_events_1.EventEmitter {
             return instance;
         }
         catch {
-            this.localAgentId = null;
-            this._markOffline();
-            this.emit("local:unavailable");
+            // OpenClaw not running on this port — don't emit yet, try adapters first
             return null;
         }
     }

package/dist/registry/store.js

@@ -201,6 +201,8 @@ class RegistryStore extends node_events_1.EventEmitter {
             // Preserve registry fields
             instance.claw_name = instance.claw_name ?? existing.claw_name;
             instance.owner_pubkey = instance.owner_pubkey ?? existing.owner_pubkey;
+            // Preserve implementation (prefer new value if provided)
+            instance.implementation = instance.implementation ?? existing.implementation;
             this.instances.set(key, instance);
             this.scheduleDirtyFlush();
             this.emit("upsert", instance);
@@ -315,6 +317,7 @@ class RegistryStore extends node_events_1.EventEmitter {
             labels: existing.labels ?? incoming.labels,
             connectivity: incoming.connectivity ?? existing.connectivity,
             is_self: existing.is_self || incoming.is_self,
+            implementation: incoming.implementation ?? existing.implementation,
         };
     }
     /** Numeric priority for network scope: local > vpn > public */

package/dist/scanner/active.d.ts

@@ -18,6 +18,7 @@ export declare class ActiveScanner extends EventEmitter {
     private generateIPs;
     private probeAll;
     private probeHost;
+    private probeConfigEndpoint;
     /**
      * Resolve a stable lan_host for scanned instances to enable multi-NIC dedup.
      *