@botcord/daemon 0.2.5 → 0.2.8

package/dist/provision.js

@@ -9,10 +9,11 @@ import { homedir } from "node:os";
 import path from "node:path";
 import { BotCordClient, CONTROL_FRAME_TYPES, defaultCredentialsFile, derivePublicKey, loadStoredCredentials, writeCredentialsFile, } from "@botcord/protocol-core";
 import { loadConfig, resolveConfiguredAgentIds, saveConfig, } from "./config.js";
-import { BOTCORD_CHANNEL_TYPE, buildManagedRoutes } from "./daemon-config-map.js";
-import { agentHomeDir, agentStateDir, agentWorkspaceDir, ensureAgentWorkspace, } from "./agent-workspace.js";
+import { BOTCORD_CHANNEL_TYPE, buildManagedRoutes, prepareGatewayProfile, } from "./daemon-config-map.js";
+import { agentHomeDir, agentStateDir, agentWorkspaceDir, applyAgentIdentity, ensureAgentWorkspace, } from "./agent-workspace.js";
 import { detectRuntimes, getAdapterModule } from "./adapters/runtimes.js";
 import { log as daemonLog } from "./log.js";
+import { discoverAgentCredentials } from "./agent-discovery.js";
 /**
  * Build a dispatcher function that routes a `ControlFrame` to the right
  * handler. Returned function signature matches
@@ -21,11 +22,42 @@ import { log as daemonLog } from "./log.js";
 export function createProvisioner(opts) {
     const gateway = opts.gateway;
     const register = opts.register ?? BotCordClient.register;
+    const policyResolver = opts.policyResolver;
     return async (frame) => {
         daemonLog.debug("provision.dispatch", { type: frame.type, id: frame.id });
         switch (frame.type) {
             case CONTROL_FRAME_TYPES.PING:
                 return { ok: true, result: { pong: true, ts: Date.now() } };
+            case CONTROL_FRAME_TYPES.HELLO: {
+                const params = (frame.params ?? {});
+                const result = applyHelloIdentitySnapshot(params.agents);
+                daemonLog.debug("hello: identity snapshot applied", {
+                    frameId: frame.id,
+                    received: params.agents?.length ?? 0,
+                    updated: result.updated,
+                    skipped: result.skipped,
+                });
+                return { ok: true, result };
+            }
+            case CONTROL_FRAME_TYPES.UPDATE_AGENT: {
+                const params = (frame.params ?? {});
+                if (!params.agentId) {
+                    return {
+                        ok: false,
+                        error: { code: "bad_params", message: "update_agent requires params.agentId" },
+                    };
+                }
+                const result = applyAgentIdentity(params.agentId, {
+                    displayName: params.displayName,
+                    bio: params.bio,
+                });
+                daemonLog.info("update_agent applied", {
+                    agentId: params.agentId,
+                    changed: result.changed,
+                    skipped: result.skipped ?? null,
+                });
+                return { ok: true, result };
+            }
             case CONTROL_FRAME_TYPES.PROVISION_AGENT: {
                 const params = (frame.params ?? {});
                 daemonLog.info("provision_agent: start", {
@@ -35,6 +67,18 @@ export function createProvisioner(opts) {
                     name: params.name ?? null,
                 });
                 const agent = await provisionAgent(params, { gateway, register });
+                // Seed the policy resolver from the optional `defaultAttention` /
+                // `attentionKeywords` fields (PR3, control-frame.ts). Hub builds that
+                // don't yet emit these stay backwards-compatible — the resolver just
+                // falls back to `mode=always` until a `policy_updated` frame arrives.
+                if (policyResolver && params.defaultAttention) {
+                    policyResolver.put(agent.agentId, null, {
+                        mode: params.defaultAttention,
+                        keywords: Array.isArray(params.attentionKeywords)
+                            ? params.attentionKeywords.slice()
+                            : [],
+                    });
+                }
                 return {
                     ok: true,
                     result: {
@@ -69,8 +113,58 @@ export function createProvisioner(opts) {
                 const res = setRoute(frame.params ?? {});
                 return { ok: true, result: res };
             }
+            case CONTROL_FRAME_TYPES.POLICY_UPDATED: {
+                const params = (frame.params ?? {});
+                const agentId = params.agent_id;
+                if (typeof agentId !== "string" || !agentId) {
+                    return {
+                        ok: false,
+                        error: { code: "bad_params", message: "policy_updated requires agent_id" },
+                    };
+                }
+                if (!policyResolver) {
+                    // No resolver wired — quietly succeed; the daemon may be running
+                    // without the gateway-level attention gate (e.g. legacy boot path).
+                    daemonLog.debug("policy_updated: no resolver — noop", { agentId });
+                    return { ok: true, result: { agent_id: agentId, applied: false } };
+                }
+                const roomId = typeof params.room_id === "string" ? params.room_id : undefined;
+                if (params.policy) {
+                    // Embedded policy payload — install directly to avoid a refetch.
+                    policyResolver.put(agentId, roomId ?? null, {
+                        mode: params.policy.mode,
+                        keywords: Array.isArray(params.policy.keywords)
+                            ? params.policy.keywords.slice()
+                            : [],
+                        ...(typeof params.policy.muted_until === "number"
+                            ? { muted_until: params.policy.muted_until }
+                            : {}),
+                    });
+                }
+                else {
+                    policyResolver.invalidate(agentId, roomId);
+                }
+                daemonLog.info("policy_updated: applied", {
+                    agentId,
+                    roomId: roomId ?? null,
+                    embedded: !!params.policy,
+                });
+                return {
+                    ok: true,
+                    result: { agent_id: agentId, applied: true, embedded: !!params.policy },
+                };
+            }
             case CONTROL_FRAME_TYPES.LIST_RUNTIMES: {
-                const snapshot = collectRuntimeSnapshot();
+                // Async path so the openclaw-acp endpoints get probed inline; gateway
+                // / WS errors are swallowed inside `collectRuntimeSnapshotAsync`.
+                let cfgForProbe;
+                try {
+                    cfgForProbe = loadConfig();
+                }
+                catch {
+                    cfgForProbe = undefined;
+                }
+                const snapshot = await collectRuntimeSnapshotAsync({ cfg: cfgForProbe });
                 daemonLog.debug("list_runtimes", { count: snapshot.runtimes.length });
                 return { ok: true, result: snapshot };
             }
@@ -86,6 +180,7 @@ export function createProvisioner(opts) {
         }
     };
 }
+const openclawProvisionLocks = new Map();
 async function provisionAgent(params, ctx) {
     // Validate both caller-supplied cwd sources up front. Previously only
     // `params.cwd` was checked, so `params.credentials.cwd` could smuggle an
@@ -93,13 +188,44 @@ async function provisionAgent(params, ctx) {
     // that hole by moving the check to the union of both.
     const explicitCwd = params.credentials?.cwd ?? params.cwd;
     assertSafeCwd(explicitCwd);
+    const openclawSel = pickOpenclawSelection(params);
+    if (openclawSel.gateway && openclawSel.agent) {
+        return withOpenclawProvisionLock(openclawSel.gateway, openclawSel.agent, async () => {
+            const existing = findCredentialsByOpenclaw(openclawSel.gateway, openclawSel.agent);
+            if (existing) {
+                daemonLog.info("provision_agent: openclaw binding already exists", {
+                    gateway: openclawSel.gateway,
+                    openclawAgent: openclawSel.agent,
+                    agentId: existing.agentId,
+                });
+                return installExistingOpenclawBinding(existing.agentId, ctx);
+            }
+            const cfg = loadConfig();
+            const credentials = await materializeCredentials(params, cfg, ctx, explicitCwd);
+            return installLocalAgent(credentials, {
+                ...ctx,
+                cfg,
+                bio: params.bio,
+                source: params.credentials ? "hub-supplied" : "registered",
+            });
+        });
+    }
     const cfg = loadConfig();
     const credentials = await materializeCredentials(params, cfg, ctx, explicitCwd);
+    return installLocalAgent(credentials, {
+        ...ctx,
+        cfg,
+        bio: params.bio,
+        source: params.credentials ? "hub-supplied" : "registered",
+    });
+}
+async function installLocalAgent(credentials, ctx) {
+    const cfg = ctx.cfg;
     daemonLog.debug("provision: credentials materialized", {
         agentId: credentials.agentId,
         hubUrl: credentials.hubUrl,
         runtime: credentials.runtime ?? null,
-        source: params.credentials ? "hub-supplied" : "registered",
+        source: ctx.source,
     });
     const credentialsFile = writeCredentialsFile(defaultCredentialsFile(credentials.agentId), credentials);
     // Seed the per-agent workspace directory. On failure, unlink the fresh
@@ -108,7 +234,7 @@ async function provisionAgent(params, ctx) {
     try {
         ensureAgentWorkspace(credentials.agentId, {
             displayName: credentials.displayName,
-            bio: params.bio,
+            bio: ctx.bio,
             runtime: credentials.runtime,
             keyId: credentials.keyId,
             savedAt: credentials.savedAt,
@@ -174,11 +300,7 @@ async function provisionAgent(params, ctx) {
     // Hot-add the synthesized per-agent managed route so the next turn picks
     // the agent's runtime + workspace cwd without waiting for reload_config.
     try {
-        ctx.gateway.upsertManagedRoute(credentials.agentId, {
-            match: { accountId: credentials.agentId },
-            runtime: credentials.runtime ?? cfg.defaultRoute.adapter,
-            cwd: credentials.cwd ?? agentWorkspaceDir(credentials.agentId),
-        });
+        upsertManagedRouteForCredentials(credentials, cfg, ctx.gateway);
     }
     catch (err) {
         // Rollback the channel + config + credentials on managed-route failure
@@ -219,6 +341,53 @@ async function provisionAgent(params, ctx) {
         credentialsFile,
     };
 }
+function upsertManagedRouteForCredentials(credentials, cfg, gateway) {
+    const synthRoute = {
+        match: { accountId: credentials.agentId },
+        runtime: credentials.runtime ?? cfg.defaultRoute.adapter,
+        cwd: credentials.cwd ?? agentWorkspaceDir(credentials.agentId),
+    };
+    if (synthRoute.runtime === "openclaw-acp") {
+        const profile = (cfg.openclawGateways ?? []).find((g) => g.name === credentials.openclawGateway);
+        if (profile) {
+            const prepared = prepareGatewayProfile(profile);
+            synthRoute.gateway = {
+                name: prepared.name,
+                url: prepared.url,
+                ...(prepared.resolvedToken ? { token: prepared.resolvedToken } : {}),
+                ...(credentials.openclawAgent
+                    ? { openclawAgent: credentials.openclawAgent }
+                    : prepared.defaultAgent
+                        ? { openclawAgent: prepared.defaultAgent }
+                        : {}),
+            };
+        }
+    }
+    gateway.upsertManagedRoute(credentials.agentId, synthRoute);
+}
+async function installExistingOpenclawBinding(agentId, ctx) {
+    const credentialsFile = defaultCredentialsFile(agentId);
+    const credentials = loadStoredCredentials(credentialsFile);
+    const cfg = loadConfig();
+    const updated = addAgentToConfig(cfg, credentials.agentId);
+    if (updated)
+        saveConfig(updated);
+    const snap = ctx.gateway.snapshot();
+    if (!snap.channels[credentials.agentId]) {
+        await ctx.gateway.addChannel({
+            id: credentials.agentId,
+            type: BOTCORD_CHANNEL_TYPE,
+            accountId: credentials.agentId,
+            agentId: credentials.agentId,
+        });
+    }
+    upsertManagedRouteForCredentials(credentials, cfg, ctx.gateway);
+    return {
+        agentId: credentials.agentId,
+        hubUrl: credentials.hubUrl,
+        credentialsFile,
+    };
+}
 async function materializeCredentials(params, cfg, ctx, explicitCwd) {
     // Runtime is an agent property. Hub is authoritative; top-level `runtime`
     // wins, `adapter` is a one-release alias, and `credentials.runtime` is the
@@ -259,6 +428,11 @@ async function materializeCredentials(params, cfg, ctx, explicitCwd) {
         if (runtime)
             record.runtime = runtime;
         record.cwd = cwd;
+        const openclawSel = pickOpenclawSelection(params);
+        if (openclawSel.gateway)
+            record.openclawGateway = openclawSel.gateway;
+        if (openclawSel.agent)
+            record.openclawAgent = openclawSel.agent;
         return record;
     }
     // Slow path: daemon registers a fresh identity against Hub. We need a
@@ -286,8 +460,155 @@ async function materializeCredentials(params, cfg, ctx, explicitCwd) {
     if (runtime)
         record.runtime = runtime;
     record.cwd = cwd;
+    const openclawSel = pickOpenclawSelection(params);
+    if (openclawSel.gateway)
+        record.openclawGateway = openclawSel.gateway;
+    if (openclawSel.agent)
+        record.openclawAgent = openclawSel.agent;
     return record;
 }
+/**
+ * Resolve OpenClaw routing selection from a `provision_agent` frame. Top-level
+ * `params.openclaw` (nested) wins over the flat `credentials.openclaw*` mirror.
+ * Returning `{}` is fine — only meaningful when the agent's runtime is
+ * `openclaw-acp`, and `buildManagedRoutes` falls back to defaultRoute.gateway
+ * when both are missing.
+ */
+function pickOpenclawSelection(params) {
+    const out = {};
+    const top = params.openclaw;
+    if (top && typeof top.gateway === "string" && top.gateway.length > 0) {
+        out.gateway = top.gateway;
+        if (typeof top.agent === "string" && top.agent.length > 0)
+            out.agent = top.agent;
+        return out;
+    }
+    const flat = params.credentials;
+    if (flat) {
+        if (typeof flat.openclawGateway === "string" && flat.openclawGateway.length > 0) {
+            out.gateway = flat.openclawGateway;
+        }
+        if (typeof flat.openclawAgent === "string" && flat.openclawAgent.length > 0) {
+            out.agent = flat.openclawAgent;
+        }
+    }
+    return out;
+}
+async function withOpenclawProvisionLock(gateway, agent, fn) {
+    const key = `${gateway}\0${agent}`;
+    const prev = openclawProvisionLocks.get(key) ?? Promise.resolve();
+    let release;
+    const current = new Promise((resolve) => {
+        release = resolve;
+    });
+    const chain = prev.then(() => current);
+    openclawProvisionLocks.set(key, chain);
+    await prev.catch(() => undefined);
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+        if (openclawProvisionLocks.get(key) === chain) {
+            openclawProvisionLocks.delete(key);
+        }
+    }
+}
+function findCredentialsByOpenclaw(gateway, openclawAgent) {
+    const discovered = discoverAgentCredentials({
+        credentialsDir: path.join(homedir(), ".botcord", "credentials"),
+    });
+    for (const a of discovered.agents) {
+        if (a.openclawGateway === gateway && a.openclawAgent === openclawAgent) {
+            return { agentId: a.agentId, credentialsFile: a.credentialsFile };
+        }
+    }
+    return null;
+}
+export async function adoptDiscoveredOpenclawAgents(ctx) {
+    const register = ctx.register ?? BotCordClient.register;
+    const cfg = ctx.cfg ?? loadConfig();
+    const result = {
+        adopted: [],
+        skipped: [],
+        failed: [],
+    };
+    for (const gw of cfg.openclawGateways ?? []) {
+        let probeResult;
+        try {
+            probeResult = await probeOpenclawAgents(gw, {
+                timeoutMs: ctx.timeoutMs,
+                probe: ctx.probe,
+            });
+        }
+        catch (err) {
+            result.failed.push({
+                gateway: gw.name,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        if (!probeResult.ok) {
+            result.skipped.push({
+                gateway: gw.name,
+                reason: probeResult.error ?? "gateway_unreachable",
+            });
+            continue;
+        }
+        for (const oc of probeResult.agents ?? []) {
+            await withOpenclawProvisionLock(gw.name, oc.id, async () => {
+                const existing = findCredentialsByOpenclaw(gw.name, oc.id);
+                if (existing) {
+                    result.skipped.push({
+                        gateway: gw.name,
+                        openclawAgent: oc.id,
+                        reason: "already_bound",
+                    });
+                    return;
+                }
+                const freshCfg = loadConfig();
+                if (!inferHubUrl(freshCfg)) {
+                    result.skipped.push({
+                        gateway: gw.name,
+                        openclawAgent: oc.id,
+                        reason: "missing_hub_url",
+                    });
+                    daemonLog.warn("openclaw adopt skipped: no known hubUrl", {
+                        gateway: gw.name,
+                        openclawAgent: oc.id,
+                    });
+                    return;
+                }
+                try {
+                    const params = {
+                        runtime: "openclaw-acp",
+                        name: oc.name ?? `openclaw-${oc.id}`,
+                        openclaw: { gateway: gw.name, agent: oc.id },
+                    };
+                    const credentials = await materializeCredentials(params, freshCfg, {
+                        gateway: ctx.gateway,
+                        register,
+                    }, undefined);
+                    const installed = await installLocalAgent(credentials, {
+                        gateway: ctx.gateway,
+                        register,
+                        cfg: freshCfg,
+                        source: "adopted-openclaw",
+                    });
+                    result.adopted.push(installed.agentId);
+                }
+                catch (err) {
+                    result.failed.push({
+                        gateway: gw.name,
+                        openclawAgent: oc.id,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            });
+        }
+    }
+    return result;
+}
 async function revokeAgent(params, ctx) {
     if (!params.agentId) {
         throw new Error("revoke_agent requires params.agentId");
@@ -477,6 +798,214 @@ export function collectRuntimeSnapshot() {
     });
     return { runtimes, probedAt: Date.now() };
 }
+/** Maximum number of `endpoints[]` entries persisted per runtime (RFC §3.8.2). */
+export const RUNTIME_ENDPOINTS_CAP = 32;
+/**
+ * Default L2 + L3 probe — opens a WS handshake against the OpenClaw gateway
+ * and, when the connection is up, issues a JSON-RPC `agents.list` request to
+ * enumerate configured agent profiles. Best-effort: a successful WS open with
+ * a failed `agents.list` still reports `ok: true` (just without `agents`),
+ * matching the RFC's "agents populated only when listing succeeded" rule.
+ *
+ * Method name and result shape follow OpenClaw:
+ *   `~/claws/openclaw/src/gateway/server-methods/agents.ts:416` and
+ *   `~/claws/openclaw/src/gateway/session-utils.ts:783` —
+ *   `{ defaultId, mainKey, scope, agents: [{ id, name?, identity?, workspace, model? }] }`.
+ */
+async function defaultWsProbe(args) {
+    const { default: WebSocket } = await import("ws");
+    return new Promise((resolve) => {
+        let settled = false;
+        let ws;
+        let timer;
+        const settle = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            try {
+                ws?.terminate();
+            }
+            catch {
+                // ignore
+            }
+            resolve(v);
+        };
+        try {
+            const headers = {};
+            if (args.token)
+                headers["Authorization"] = `Bearer ${args.token}`;
+            ws = new WebSocket(args.url, { headers });
+        }
+        catch (err) {
+            resolve({ ok: false, error: err.message });
+            return;
+        }
+        timer = setTimeout(() => settle({ ok: false, error: "timeout" }), args.timeoutMs);
+        const requestId = "probe-agents-list";
+        ws.on("open", () => {
+            // L3: enumerate agent profiles. We don't fail the L2 result if this
+            // call fails — the gateway is reachable either way.
+            try {
+                ws.send(JSON.stringify({
+                    jsonrpc: "2.0",
+                    id: requestId,
+                    method: "agents.list",
+                    params: {},
+                }));
+            }
+            catch (err) {
+                settle({ ok: true, error: `agents.list send failed: ${err.message}` });
+            }
+        });
+        ws.on("message", (raw) => {
+            try {
+                const msg = JSON.parse(typeof raw === "string" ? raw : raw.toString("utf8"));
+                if (msg?.id !== requestId)
+                    return; // ignore unrelated frames
+                if (msg.error) {
+                    settle({ ok: true, error: String(msg.error?.message ?? "agents.list error") });
+                    return;
+                }
+                const list = Array.isArray(msg.result?.agents) ? msg.result.agents : [];
+                const agents = [];
+                for (const a of list) {
+                    if (!a || typeof a.id !== "string" || a.id.length === 0)
+                        continue;
+                    const row = { id: a.id };
+                    if (typeof a.name === "string")
+                        row.name = a.name;
+                    if (typeof a.workspace === "string")
+                        row.workspace = a.workspace;
+                    if (a.model && typeof a.model === "object") {
+                        const model = {};
+                        if (typeof a.model.name === "string")
+                            model.name = a.model.name;
+                        if (typeof a.model.provider === "string")
+                            model.provider = a.model.provider;
+                        if (model.name || model.provider)
+                            row.model = model;
+                    }
+                    agents.push(row);
+                }
+                settle({ ok: true, agents });
+            }
+            catch (err) {
+                settle({ ok: true, error: `agents.list parse failed: ${err.message}` });
+            }
+        });
+        ws.on("error", (err) => {
+            settle({ ok: false, error: err.message });
+        });
+        ws.on("close", () => {
+            // If the socket closes before `agents.list` resolved we still treat
+            // L2 as ok (open fired) and emit no agents.
+            settle({ ok: true });
+        });
+    });
+}
+export async function probeOpenclawAgents(profile, opts = {}) {
+    const probe = opts.probe ?? defaultWsProbe;
+    const prepared = prepareGatewayProfile({
+        name: "probe",
+        url: profile.url,
+        ...(profile.token ? { token: profile.token } : {}),
+        ...(profile.tokenFile ? { tokenFile: profile.tokenFile } : {}),
+    });
+    return probe({
+        url: profile.url,
+        token: prepared.resolvedToken,
+        timeoutMs: opts.timeoutMs ?? 3000,
+    });
+}
+/**
+ * Async variant that includes L2 (gateway reachability) and L3 (agent listing)
+ * probes for runtimes that talk to external services. Used by the production
+ * `list_runtimes` and first-connect snapshot paths.
+ *
+ * `cfg` is optional so existing callers without a loaded config (e.g. tests)
+ * can keep using the sync `collectRuntimeSnapshot()` — when absent, the result
+ * is identical to that function.
+ */
+export async function collectRuntimeSnapshotAsync(opts = {}) {
+    const base = collectRuntimeSnapshot();
+    const gateways = opts.cfg?.openclawGateways ?? [];
+    if (gateways.length === 0)
+        return base;
+    // Default daemon-side budget is 3s — it must stay below the Hub's
+    // `list_runtimes` ack wait (5s, see backend/hub/routers/daemon_control.py)
+    // so a single slow gateway can't blow the whole snapshot to a 504.
+    const timeoutMs = opts.timeoutMs ?? 3000;
+    const capped = gateways.slice(0, RUNTIME_ENDPOINTS_CAP);
+    const endpoints = await Promise.all(capped.map(async (g) => {
+        try {
+            const res = await probeOpenclawAgents(g, {
+                probe: opts.wsProbe,
+                timeoutMs,
+            });
+            const entry = { name: g.name, url: g.url, reachable: res.ok };
+            if (res.version)
+                entry.version = res.version;
+            if (res.error)
+                entry.error = res.error;
+            if (res.agents)
+                entry.agents = res.agents;
+            return entry;
+        }
+        catch (err) {
+            return {
+                name: g.name,
+                url: g.url,
+                reachable: false,
+                error: err.message,
+            };
+        }
+    }));
+    const out = { ...base };
+    out.runtimes = base.runtimes.map((r) => r.id === "openclaw-acp" ? { ...r, endpoints } : r);
+    return out;
+}
+/**
+ * Reconcile every agent identity carried by the `hello.agents` snapshot
+ * against the on-disk `identity.md`. Best-effort: a malformed entry or a
+ * file-system error for one agent never aborts the rest.
+ *
+ * Identity-snapshot semantics intentionally only touch the metadata
+ * line + Bio body — Role/Boundaries paragraphs the user authored locally
+ * are preserved (see `applyAgentIdentity`). Missing identity.md files
+ * (agent provisioned on a different daemon, or workspace cleared) are
+ * silently skipped.
+ */
+export function applyHelloIdentitySnapshot(snapshot) {
+    const out = { updated: 0, skipped: 0 };
+    if (!Array.isArray(snapshot))
+        return out;
+    for (const entry of snapshot) {
+        if (!entry || typeof entry.agentId !== "string") {
+            out.skipped += 1;
+            continue;
+        }
+        try {
+            const result = applyAgentIdentity(entry.agentId, {
+                displayName: entry.displayName,
+                bio: entry.bio,
+            });
+            if (result.changed)
+                out.updated += 1;
+            else
+                out.skipped += 1;
+        }
+        catch (err) {
+            out.skipped += 1;
+            daemonLog.warn("hello.identity apply failed", {
+                agentId: entry.agentId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return out;
+}
 /**
  * Re-read `config.json` and reconcile the running gateway against it. New
  * agents in config but not in gateway snapshot → `addChannel`; agents in
@@ -564,7 +1093,11 @@ function readAgentRuntimesFromCredentials(agentIds) {
                 entry.runtime = creds.runtime;
             if (creds.cwd)
                 entry.cwd = creds.cwd;
-            if (entry.runtime || entry.cwd)
+            if (creds.openclawGateway)
+                entry.openclawGateway = creds.openclawGateway;
+            if (creds.openclawAgent)
+                entry.openclawAgent = creds.openclawAgent;
+            if (entry.runtime || entry.cwd || entry.openclawGateway || entry.openclawAgent)
                 out[id] = entry;
         }
         catch {
@@ -652,11 +1185,21 @@ export function setRoute(params) {
     if (p.pattern && typeof p.pattern === "string" && !match.conversationPrefix) {
         match.conversationPrefix = p.pattern;
     }
+    // Fall back to defaultRoute.extraArgs (mirrors adapter/cwd inheritance
+    // above) so dashboard-driven `set_route` calls that only carry agentId +
+    // pattern still pick up operator-wide flags like `--permission-mode
+    // bypassPermissions`. Without this, every newly provisioned agent lost
+    // those flags and Bash/MCP tool calls would deadlock on permission prompts.
+    const extraArgs = Array.isArray(route?.extraArgs)
+        ? route.extraArgs.slice()
+        : Array.isArray(cfg.defaultRoute.extraArgs)
+            ? cfg.defaultRoute.extraArgs.slice()
+            : undefined;
     const newRule = {
         match,
         adapter,
         cwd,
-        ...(Array.isArray(route?.extraArgs) ? { extraArgs: route.extraArgs.slice() } : {}),
+        ...(extraArgs ? { extraArgs } : {}),
     };
     const routes = Array.isArray(cfg.routes) ? cfg.routes.slice() : [];
     // Replace an existing matching rule. We use the canonical signature
@@ -743,5 +1286,14 @@ function inferHubUrl(cfg) {
             // skip
         }
     }
+    if (ids.length === 0) {
+        const discovered = discoverAgentCredentials({
+            credentialsDir: path.join(homedir(), ".botcord", "credentials"),
+        });
+        for (const a of discovered.agents) {
+            if (a.hubUrl)
+                return a.hubUrl;
+        }
+    }
     return null;
 }