agentlife 2.6.31 → 2.6.32

package/dist/index.js

@@ -1838,12 +1838,15 @@ async function provisionAgents(state, cfg, runtime, log) {
     }
   }
   const provisionedIds = new Set(PROVISIONED_AGENTS.map((a) => a.id));
+  const backfilledSubagentIds = [];
   for (const agent of currentList) {
     if (provisionedIds.has(agent.id))
       continue;
     if (!agent.subagents) {
       agent.subagents = { allowAgents: ["*"] };
       configChanged = true;
+      if (agent.id)
+        backfilledSubagentIds.push(agent.id);
       log(`[agentlife] backfilled subagents for ${agent.id}`);
     }
   }
@@ -1856,6 +1859,18 @@ async function provisionAgents(state, cfg, runtime, log) {
   const configPath = path4.join(os.homedir(), ".openclaw", "openclaw.json");
   const rawCfgForVisibility = JSON.parse(readFileSync2(configPath, "utf-8"));
   const backupPath = path4.join(os.homedir(), ".openclaw", "agentlife", "config-backup.json");
+  if (backfilledSubagentIds.length > 0) {
+    try {
+      let backup = {};
+      try {
+        backup = JSON.parse(readFileSync2(backupPath, "utf-8"));
+      } catch {}
+      const existing = Array.isArray(backup.subagentsBackfilledIds) ? backup.subagentsBackfilledIds : [];
+      backup.subagentsBackfilledIds = [...new Set([...existing, ...backfilledSubagentIds])];
+      writeFileSync(backupPath, JSON.stringify(backup, null, 2) + `
+`, "utf-8");
+    } catch {}
+  }
   let visibilityWritten = false;
   const currentVisibility = rawCfgForVisibility?.tools?.sessions?.visibility;
   if (currentVisibility !== "all") {
@@ -3277,17 +3292,21 @@ function pollFollowups(state) {
   }
   sweepCounter++;
   if (sweepCounter % 5 === 0 && state.surfaceIndex && state.followupQueue && state.fileSurfaceStorage) {
-    sweepExpiredSurfaces({
-      index: state.surfaceIndex,
-      queue: state.followupQueue,
-      storage: state.fileSurfaceStorage
-    }).then((r) => {
-      for (const sid of r.purged)
-        broadcastDelete(sid);
-      if (r.purged.length > 0) {
-        console.log("[agentlife:sweep] purged %d expired surfaces", r.purged.length);
-      }
-    }).catch((e) => console.warn("[agentlife:sweep] error: %s", e?.message));
+    try {
+      sweepExpiredSurfaces({
+        index: state.surfaceIndex,
+        queue: state.followupQueue,
+        storage: state.fileSurfaceStorage
+      }).then((r) => {
+        for (const sid of r.purged)
+          broadcastDelete(sid);
+        if (r.purged.length > 0) {
+          console.log("[agentlife:sweep] purged %d expired surfaces", r.purged.length);
+        }
+      }).catch((e) => console.warn("[agentlife:sweep] error: %s", e?.message));
+    } catch (e) {
+      console.warn("[agentlife] sweep invocation failed synchronously: %s", e?.message);
+    }
   }
 }
 
@@ -3983,7 +4002,6 @@ async function restoreConfigFromBackup(api, backupPath) {
     delete fileCfg.agents?.defaults?.maxConcurrent;
   }
   await writeRawConfigToDisk(fileCfg);
-  await fs5.unlink(backupPath);
   console.log("[agentlife] restored config: maxPingPongTurns=%s, maxConcurrent=%s", backup.maxPingPongTurns ?? "default", backup.maxConcurrent ?? "default");
   return `config restored`;
 }
@@ -7462,11 +7480,11 @@ function registerAgentGateway(api, state2) {
     const subagents = params?.subagents && typeof params.subagents === "object" ? params.subagents : undefined;
     const identity = params?.identity && typeof params.identity === "object" ? params.identity : undefined;
     if (!id) {
-      respond(false, { error: "missing agent id" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing agent id" });
       return;
     }
     if (!workspace) {
-      respond(false, { error: "missing workspace path" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing workspace path" });
       return;
     }
     const cfg = api.runtime.config.loadConfig();
@@ -7474,9 +7492,9 @@ function registerAgentGateway(api, state2) {
     const providerInConfig = provider ? authenticatedProvidersFromConfig(cfg).has(provider) : false;
     const siblingAuth = provider ? findSiblingAuthProfile(provider, id) : null;
     if (provider && !providerInConfig && !siblingAuth) {
-      respond(false, {
-        error: `missing provider credentials for ${provider}; configure ${provider} before creating an agent with ${model}`,
+      respond(false, undefined, {
         code: "missing_provider_auth",
+        message: `missing provider credentials for ${provider}; configure ${provider} before creating an agent with ${model}`,
         provider,
         model
       });
@@ -7562,16 +7580,16 @@ function registerAgentGateway(api, state2) {
       }
     }
     respond(true, { status, id, name, model, workspace, description, ...authCopied ? { authCopied: true } : {}, ...configFields.length ? { configFields } : {} });
-  });
+  }, { scope: "operator.admin" });
   api.registerGatewayMethod("agentlife.deleteAgent", async ({ params, respond }) => {
     const id = typeof params?.id === "string" ? params.id.trim() : "";
     if (!id) {
-      respond(false, { error: "missing agent id" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing agent id" });
       return;
     }
     const provisionedIds = new Set(PROVISIONED_AGENTS.map((a) => a.id));
     if (provisionedIds.has(id)) {
-      respond(false, { error: "cannot delete provisioned agent" });
+      respond(false, undefined, { code: "FAILED", message: "cannot delete provisioned agent" });
       return;
     }
     const cleanup = {
@@ -7709,7 +7727,7 @@ function registerAgentGateway(api, state2) {
     }
     console.log("[agentlife] deleted agent: %s (config=%s, registry=%s, surfaces=%d, sessions=%d, cron=%d, historyRows=%d, agentDb=%s, state=%s, workspace=%s)", id, removedFromConfig, removedFromRegistry, cleanup.surfacesCleared, cleanup.sessions, cleanup.cronJobs, cleanup.historyRows, cleanup.agentDbDeleted, cleanup.stateDeleted, cleanup.workspaceDeleted);
     respond(true, { status: "deleted", id, removedFromConfig, removedFromRegistry, cleanup });
-  });
+  }, { scope: "operator.admin" });
   api.registerGatewayMethod("agentlife.agents", ({ respond }) => {
     const agents = {};
     for (const [id, entry] of state2.agentRegistry.entries()) {
@@ -7726,11 +7744,11 @@ function registerDbGateway(api, state2) {
     const sql = typeof params?.sql === "string" ? params.sql.trim() : "";
     const sqlParams = Array.isArray(params?.params) ? params.params : [];
     if (!agentId)
-      return respond(false, { error: "missing agentId" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "missing agentId" });
     if (!sql)
-      return respond(false, { error: "missing sql" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "missing sql" });
     if (/^\s*SELECT\b/i.test(sql))
-      return respond(false, { error: "use agentlife.db.query for SELECT" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "use agentlife.db.query for SELECT" });
     try {
       const db = getOrCreateAgentDb(state2, agentId);
       if (sqlParams.length > 0) {
@@ -7741,19 +7759,19 @@ function registerDbGateway(api, state2) {
         respond(true, { changes: 0, lastInsertRowid: 0 });
       }
     } catch (err) {
-      respond(false, { error: err?.message ?? "db error" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "db error" });
     }
-  });
+  }, { scope: "operator.admin" });
   api.registerGatewayMethod("agentlife.db.query", ({ params, respond }) => {
     const agentId = typeof params?.agentId === "string" ? params.agentId.trim() : "";
     const sql = typeof params?.sql === "string" ? params.sql.trim() : "";
     const sqlParams = Array.isArray(params?.params) ? params.params : [];
     if (!agentId)
-      return respond(false, { error: "missing agentId" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "missing agentId" });
     if (!sql)
-      return respond(false, { error: "missing sql" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "missing sql" });
     if (!/^\s*SELECT\b/i.test(sql))
-      return respond(false, { error: "use agentlife.db.exec for non-SELECT" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "use agentlife.db.exec for non-SELECT" });
     try {
       const db = getOrCreateAgentDb(state2, agentId);
       const rows = db.prepare(sql).all(...sqlParams);
@@ -7763,9 +7781,9 @@ function registerDbGateway(api, state2) {
       const columns = result.length > 0 ? Object.keys(result[0]) : [];
       respond(true, { rows: result, columns, count: result.length, truncated });
     } catch (err) {
-      respond(false, { error: err?.message ?? "db error" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "db error" });
     }
-  });
+  }, { scope: "operator.admin" });
 }
 
 // gateway/history.ts
@@ -7806,7 +7824,7 @@ function registerHistoryGateway(api, state2) {
       const rows = db.prepare(`SELECT * FROM surface_events ${where} ORDER BY createdAt DESC LIMIT ? OFFSET ?`).all(...bind);
       respond(true, { events: rows, count: rows.length });
     } catch (err) {
-      respond(false, { error: err?.message ?? "history error" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "history error" });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.history.widgets", ({ params, respond }) => {
@@ -7847,7 +7865,7 @@ function registerHistoryGateway(api, state2) {
       `).all(...bind, limit, offset);
       respond(true, { widgets: rows, count: rows.length, hasMore: rows.length >= limit });
     } catch (err) {
-      respond(false, { error: err?.message ?? "history.widgets error" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "history.widgets error" });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.trace", ({ params, respond }) => {
@@ -7904,7 +7922,7 @@ function registerHistoryGateway(api, state2) {
       }));
       respond(true, { entries, hasMore });
     } catch (err) {
-      respond(false, { error: err?.message ?? "trace query failed" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "trace query failed" });
     }
   }, { scope: "operator.read" });
 }
@@ -7977,13 +7995,13 @@ function registerUsageGateway(api, state2) {
         bySession: bySessionRows
       });
     } catch (err) {
-      respond(false, { error: err?.message ?? "usage query error" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "usage query error" });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.surfaceUsage", ({ params, respond }) => {
     const surfaceId = typeof params?.surfaceId === "string" ? params.surfaceId.trim() : "";
     if (!surfaceId)
-      return respond(false, { error: "missing surfaceId" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "missing surfaceId" });
     try {
       const db = getOrCreateHistoryDb(state2);
       const rows = db.prepare(`SELECT * FROM surface_usage WHERE surfaceId = ? ORDER BY createdAt DESC`).all(surfaceId);
@@ -7999,7 +8017,7 @@ function registerUsageGateway(api, state2) {
       }, { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, totalTokens: 0, estimatedCost: 0, llmCalls: 0 });
       respond(true, { surfaceId, entries: rows, totals });
     } catch (err) {
-      respond(false, { error: err?.message ?? "surface usage error" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "surface usage error" });
     }
   }, { scope: "operator.read" });
 }
@@ -8048,7 +8066,7 @@ function registerSurfacesGateway(api, state2) {
   api.registerGatewayMethod("agentlife.dismiss", async ({ params, respond }) => {
     const surfaceId = params?.surfaceId;
     if (!surfaceId || typeof surfaceId !== "string") {
-      respond(false, { error: "missing surfaceId" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing surfaceId" });
       return;
     }
     const view2 = getSurface(state2, surfaceId);
@@ -8119,7 +8137,7 @@ function registerSurfacesGateway(api, state2) {
     const surfaceId = typeof params?.surfaceId === "string" ? params.surfaceId.trim() : "";
     const event = typeof params?.event === "string" ? params.event.trim() : "";
     if (!surfaceId || !event) {
-      respond(false, { error: "missing surfaceId or event" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing surfaceId or event" });
       return;
     }
     const agentId = getAgentId(state2, surfaceId) ?? undefined;
@@ -8131,7 +8149,7 @@ function registerSurfacesGateway(api, state2) {
     const message = typeof params?.message === "string" ? params.message : "";
     const sessionKey = typeof params?.sessionKey === "string" ? params.sessionKey : "";
     if (!message) {
-      respond(false, { error: "missing message" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing message" });
       return;
     }
     broadcastInput(message, sessionKey);
@@ -8140,7 +8158,7 @@ function registerSurfacesGateway(api, state2) {
   api.registerGatewayMethod("agentlife.chain.get", ({ params, respond }) => {
     const root = typeof params?.root === "string" ? params.root.trim() : "";
     if (!root) {
-      respond(false, { error: "missing root" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing root" });
       return;
     }
     if (!state2.surfaceIndex) {
@@ -8164,7 +8182,7 @@ function registerSurfacesGateway(api, state2) {
   api.registerGatewayMethod("agentlife.action", ({ params, respond }) => {
     const surfaceId = typeof params?.surfaceId === "string" ? params.surfaceId.trim() : "";
     if (!surfaceId) {
-      respond(false, { error: "missing surfaceId" });
+      respond(false, undefined, { code: "INVALID_REQUEST", message: "missing surfaceId" });
       return;
     }
     const view2 = getSurface(state2, surfaceId);
@@ -8255,7 +8273,7 @@ function registerAutomationsGateway(api, state2) {
       const name = typeof params?.name === "string" ? params.name.trim() : "";
       const automationPath = typeof params?.path === "string" ? params.path.trim() : "";
       if (!type || !name || !automationPath) {
-        respond(false, { error: "missing required fields: type, name, path" });
+        respond(false, undefined, { code: "INVALID_REQUEST", message: "missing required fields: type, name, path" });
         return;
       }
       const surfaceId = typeof params?.surfaceId === "string" ? params.surfaceId.trim() : "";
@@ -8263,7 +8281,7 @@ function registerAutomationsGateway(api, state2) {
       const id = registerAutomation(state2, { surfaceId, agentId, type, name, path: automationPath });
       respond(true, { id, surfaceId, agentId, type, name, path: automationPath, status: "running" });
     } catch (err) {
-      respond(false, { error: err?.message ?? "register failed" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "register failed" });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.automations.list", ({ params, respond }) => {
@@ -8304,7 +8322,7 @@ function registerAutomationsGateway(api, state2) {
         }))
       });
     } catch (err) {
-      respond(false, { error: err?.message ?? "list failed" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "list failed" });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.automations.update", ({ params, respond }) => {
@@ -8312,28 +8330,28 @@ function registerAutomationsGateway(api, state2) {
       const id = typeof params?.id === "number" ? params.id : parseInt(params?.id, 10);
       const status = typeof params?.status === "string" ? params.status.trim() : "";
       if (!id || !status || !["running", "stopped", "error"].includes(status)) {
-        respond(false, { error: "missing id or invalid status (running|stopped|error)" });
+        respond(false, undefined, { code: "INVALID_REQUEST", message: "missing id or invalid status (running|stopped|error)" });
         return;
       }
       const db = getOrCreateHistoryDb(state2);
       db.prepare("UPDATE automations SET status = ?, updatedAt = ? WHERE id = ?").run(status, Date.now(), id);
       respond(true, { id, status });
     } catch (err) {
-      respond(false, { error: err?.message ?? "update failed" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "update failed" });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.automations.remove", ({ params, respond }) => {
     try {
       const id = typeof params?.id === "number" ? params.id : parseInt(params?.id, 10);
       if (!id) {
-        respond(false, { error: "missing id" });
+        respond(false, undefined, { code: "INVALID_REQUEST", message: "missing id" });
         return;
       }
       const db = getOrCreateHistoryDb(state2);
       db.prepare("UPDATE automations SET status = 'removed', updatedAt = ? WHERE id = ?").run(Date.now(), id);
       respond(true, { id, status: "removed" });
     } catch (err) {
-      respond(false, { error: err?.message ?? "remove failed" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "remove failed" });
     }
   }, { scope: "operator.write" });
 }
@@ -8466,7 +8484,7 @@ function registerAdminGateway(api, state2) {
         cleanup: { pending: cleanupPending, failed: cleanupFailed, exhausted: cleanupExhausted }
       });
     } catch (err) {
-      respond(false, { error: err?.message ?? "quality metrics unavailable" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "quality metrics unavailable" });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.health.list", ({ respond }) => {
@@ -8487,7 +8505,7 @@ function registerAdminGateway(api, state2) {
       const rows = runDailyCycle(db, day);
       respond(true, { day, rows });
     } catch (err) {
-      respond(false, { error: err?.message ?? "observability runCycle failed" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "observability runCycle failed" });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.sweep.run", ({ respond }) => {
@@ -8495,7 +8513,7 @@ function registerAdminGateway(api, state2) {
       const result = runDailySweep(state2);
       respond(true, result);
     } catch (err) {
-      respond(false, { error: err?.message ?? "daily sweep failed" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "daily sweep failed" });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.bootstrap", ({ params, respond }) => {
@@ -8623,7 +8641,6 @@ function registerAdminGateway(api, state2) {
         dbPath,
         dbPath ? `${dbPath}-wal` : null,
         dbPath ? `${dbPath}-shm` : null,
-        path15.join(baseDir, "config-backup.json"),
         path15.join(baseDir, "notification-config.json"),
         path15.join(baseDir, "canvas-node-identity.json")
       ].filter(Boolean);
@@ -8662,7 +8679,7 @@ function registerAdminGateway(api, state2) {
       });
     } catch (err) {
       console.error("[agentlife] uninstall failed:", err);
-      respond(false, { error: err?.message ?? "unknown error during uninstall" });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? "unknown error during uninstall" });
     }
   });
   api.registerGatewayMethod("agentlife.config.get", ({ respond }) => {
@@ -9316,20 +9333,20 @@ function registerProvidersGateway(api, state2) {
       }));
       respond(true, { providers });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.providers.set", async ({ params, respond }) => {
     const provider = typeof params?.provider === "string" ? params.provider.trim() : "";
     const apiKey = typeof params?.apiKey === "string" ? params.apiKey.trim() : "";
     if (!provider)
-      return respond(false, { error: "provider is empty" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "provider is empty" });
     if (!apiKey)
-      return respond(false, { error: "apiKey is empty" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "apiKey is empty" });
     try {
       const catalog = await ensureCatalog(run ?? null);
       if (catalog.length > 0 && !catalog.some((e) => e.provider === provider)) {
-        return respond(false, { error: `unknown provider: ${provider}` });
+        return respond(false, undefined, { code: "NOT_FOUND", message: `unknown provider: ${provider}` });
       }
     } catch {}
     try {
@@ -9350,13 +9367,13 @@ function registerProvidersGateway(api, state2) {
       writeConfig(nextCfg);
       respond(true, { provider, configured: true, profileId });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.providers.delete", ({ params, respond }) => {
     const provider = typeof params?.provider === "string" ? params.provider.trim() : "";
     if (!provider)
-      return respond(false, { error: "provider is empty" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "provider is empty" });
     try {
       const cfg = readConfig();
       const profiles = cfg?.auth?.profiles;
@@ -9395,14 +9412,14 @@ function registerProvidersGateway(api, state2) {
       }
       respond(true, { provider, configured: false });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.providers.test", async ({ params, respond }) => {
     const provider = typeof params?.provider === "string" ? params.provider.trim() : "";
     const apiKey = typeof params?.apiKey === "string" ? params.apiKey.trim() : "";
     if (!provider)
-      return respond(false, { error: "provider is empty" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "provider is empty" });
     if (!apiKey)
       return respond(true, { ok: false, error: "apiKey required — type a key before testing" });
     try {
@@ -9428,7 +9445,7 @@ function registerProvidersGateway(api, state2) {
       });
       respond(true, { models: deduped });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.providers.health", ({ respond }) => {
@@ -9458,23 +9475,23 @@ function registerProvidersGateway(api, state2) {
       }
       respond(true, { probes });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.providers.loginCodex", async ({ respond }) => {
     if (!run)
-      return respond(false, { error: "runCommand unavailable" });
+      return respond(false, undefined, { code: "UNAVAILABLE", message: "runCommand unavailable" });
     try {
       const result = await run(["openclaw", "capability", "model", "auth", "login", "--provider", "openai-codex"], { timeoutMs: 180000 });
       const combined = `${result?.stdout ?? ""}
 ${result?.stderr ?? ""}`;
       const urlMatch = combined.match(/https:\/\/\S+/);
       if ((result?.code ?? 0) !== 0 && !urlMatch) {
-        return respond(false, { error: (result?.stderr ?? "").trim() || "codex login failed" });
+        return respond(false, undefined, { code: "FAILED", message: (result?.stderr ?? "").trim() || "codex login failed" });
       }
       respond(true, { url: urlMatch?.[0] ?? null, completed: (result?.code ?? 0) === 0 });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
 }
@@ -9510,13 +9527,13 @@ function registerModelsConfigGateway(api) {
         fallbacks: Array.isArray(m.fallbacks) ? m.fallbacks.filter((x) => typeof x === "string") : []
       });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.models.defaults.setPrimary", ({ params, respond }) => {
     const model = typeof params?.model === "string" ? params.model.trim() : "";
     if (!model)
-      return respond(false, { error: "model is required" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "model is required" });
     try {
       const cfg = readConfig();
       cfg.agents = cfg.agents ?? {};
@@ -9526,26 +9543,26 @@ function registerModelsConfigGateway(api) {
       writeConfig(cfg);
       respond(true, { ok: true });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.models.defaults.setInternal", ({ params, respond }) => {
     const model = typeof params?.model === "string" ? params.model.trim() : "";
     if (!model)
-      return respond(false, { error: "model is required" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "model is required" });
     try {
       const cfg = readPluginConfig2();
       cfg.internalModel = model;
       writePluginConfig2(cfg);
       respond(true, { ok: true });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.models.fallbacks.set", ({ params, respond }) => {
     const models = Array.isArray(params?.models) ? params.models.filter((x) => typeof x === "string") : null;
     if (!models)
-      return respond(false, { error: "models must be an array of strings" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "models must be an array of strings" });
     try {
       const cfg = readConfig();
       cfg.agents = cfg.agents ?? {};
@@ -9555,7 +9572,7 @@ function registerModelsConfigGateway(api) {
       writeConfig(cfg);
       respond(true, { ok: true });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.agents.list", ({ respond }) => {
@@ -9569,23 +9586,23 @@ function registerModelsConfigGateway(api) {
       })).filter((a) => a.id !== null && a.name !== null);
       respond(true, { agents });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.agents.setModel", ({ params, respond }) => {
     const agentId = typeof params?.agentId === "string" ? params.agentId.trim() : "";
     if (!agentId)
-      return respond(false, { error: "agentId is required" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "agentId is required" });
     const model = params?.model;
     if (model !== null && typeof model !== "string") {
-      return respond(false, { error: "model must be string or null" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "model must be string or null" });
     }
     try {
       const cfg = readConfig();
       const list = Array.isArray(cfg?.agents?.list) ? cfg.agents.list : [];
       const idx = list.findIndex((a) => a?.id === agentId);
       if (idx < 0)
-        return respond(false, { error: `agent not found: ${agentId}` });
+        return respond(false, undefined, { code: "NOT_FOUND", message: `agent not found: ${agentId}` });
       if (model === null) {
         delete list[idx].model;
       } else {
@@ -9594,19 +9611,19 @@ function registerModelsConfigGateway(api) {
       writeConfig(cfg);
       respond(true, { ok: true });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
   api.registerGatewayMethod("agentlife.agents.setModel.bulk", ({ params, respond }) => {
     const updates = Array.isArray(params?.updates) ? params.updates : null;
     if (!updates)
-      return respond(false, { error: "updates must be an array" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "updates must be an array" });
     for (const u of updates) {
       if (!u || typeof u.agentId !== "string" || !u.agentId.trim()) {
-        return respond(false, { error: "each update needs agentId (string)" });
+        return respond(false, undefined, { code: "INVALID_REQUEST", message: "each update needs agentId (string)" });
       }
       if (u.model !== null && typeof u.model !== "string") {
-        return respond(false, { error: "each update model must be string or null" });
+        return respond(false, undefined, { code: "INVALID_REQUEST", message: "each update model must be string or null" });
       }
     }
     try {
@@ -9627,7 +9644,7 @@ function registerModelsConfigGateway(api) {
       writeConfig(cfg);
       respond(true, { ok: true, applied });
     } catch (err) {
-      respond(false, { error: err?.message ?? String(err) });
+      respond(false, undefined, { code: "INTERNAL", message: err?.message ?? String(err) });
     }
   }, { scope: "operator.write" });
 }
@@ -9818,7 +9835,7 @@ function register(api) {
     const serverUrl = typeof params?.serverUrl === "string" ? params.serverUrl.trim() : "";
     const apiKey = typeof params?.apiKey === "string" ? params.apiKey.trim() : "";
     if (!serverUrl || !apiKey) {
-      return respond(false, { error: "missing serverUrl or apiKey" });
+      return respond(false, undefined, { code: "INVALID_REQUEST", message: "missing serverUrl or apiKey" });
     }
     try {
       const { writeFileSync: writeFileSync12, mkdirSync: mkdirSync10 } = __require("node:fs");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlife",
-  "version": "2.6.31",
+  "version": "2.6.32",
   "description": "Native mobile dashboard for OpenClaw — agents push live widgets, automations, and remote-access surfaces to your phone via the AgentLife plugin relay.",
   "keywords": [
     "openclaw",