agentlife 2.4.3 → 2.4.5

package/dist/index.js

@@ -2,7 +2,7 @@ import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // index.ts
-import { homedir as homedir12 } from "node:os";
+import { homedir as homedir13 } from "node:os";
 import * as path16 from "node:path";
 import { existsSync as existsSync6 } from "node:fs";
 
@@ -1110,11 +1110,13 @@ Triggered when the orchestrator routes a "create X agent" / "track Y for me" / n
    - \`USER.md\` — domain-specific user facts (name, timezone, language + domain knowledge). Read the user's other USER.md files for identity; don't invent.
    - \`HEARTBEAT.md\` — periodic check instructions, or empty placeholder \`# Keep empty to skip\`.
 4. **Register the agent via \`exec\`**:
-   \`exec openclaw gateway call agentlife.createAgent --params '{"id":"{agentId}","name":"{Name}","model":"{model}","workspace":"/abs/path","description":"one sentence","tools":{"profile":"full"},"identity":{"name":"{Name}","emoji":"{emoji}"}}'\`
+   \`exec openclaw gateway call agentlife.createAgent --params '{"id":"{agentId}","name":"{Name}","model":"{model}","workspace":"/abs/path","description":"one sentence","tools":{"profile":"full","alsoAllow":["agentlife_push"]},"identity":{"name":"{Name}","emoji":"{emoji}"}}'\`
    - Description drives the orchestrator's routing — make it specific (domains, actions, data types).
-   - \`tools: {profile:"full"}\` for agents needing exec/web/write. \`{allow:["agentlife_push"]}\` for widget-only agents.
-   - The plugin deterministically renders a \`{agentId}-intro\` widget the moment \`agentlife.createAgent\` returns — you do not push one yourself.
-5. **Hand off**: \`delete {domain}-building\`, then emit \`done\`.
+   - \`tools: {profile:"full", alsoAllow:["agentlife_push"]}\` for agents needing every core tool plus widget push. \`{allow:["agentlife_push"]}\` for widget-only agents.
+5. **Hand off in ONE final turn, all in this order, before \`done\`:**
+   a. Push ONE actionable first widget for the newly-created agent under a surfaceId you own (\`{agentId}-today\`, \`{agentId}-start\`, similar). It must invite the FIRST user interaction — an input prompt, a starter metric with a CTA, a question the user can answer right now. NEVER an identity/confirmation card ("Agent ready", "Welcome to X"). The plugin no longer pushes a placeholder intro widget; this first push IS the dashboard's anchor for the new agent.
+   b. \`delete {domain}-building\` — the loading widget from step 1.
+   c. Emit \`done\`.
 
 ## Writing AGENTS.md (for the specialist you create)
 
@@ -1245,7 +1247,7 @@ var PROVISIONED_AGENTS = [
     id: "agentlife-builder",
     name: "AgentLife Builder",
     agentsMd: BUILDER_AGENTS_MD,
-    tools: { allow: ["*", "agentlife_push"] }
+    tools: { profile: "full", alsoAllow: ["agentlife_push"] }
   },
   {
     id: "supervisor",
@@ -1438,26 +1440,7 @@ async function provisionAgents(state, cfg, runtime, log) {
       globalAllowWritten = true;
     }
   }
-  const currentAlsoAllow = Array.isArray(rawCfgForVisibility?.tools?.alsoAllow) ? rawCfgForVisibility.tools.alsoAllow : [];
-  let alsoAllowWritten = false;
-  if (!currentAlsoAllow.includes("agentlife_push")) {
-    try {
-      let backup = {};
-      try {
-        backup = JSON.parse(readFileSync(backupPath, "utf-8"));
-      } catch {}
-      if (backup.toolsAlsoAllow === undefined) {
-        backup.toolsAlsoAllow = [...currentAlsoAllow];
-        writeFileSync(backupPath, JSON.stringify(backup, null, 2) + `
-`, "utf-8");
-      }
-    } catch {}
-    if (!rawCfgForVisibility.tools)
-      rawCfgForVisibility.tools = {};
-    rawCfgForVisibility.tools.alsoAllow = [...currentAlsoAllow, "agentlife_push"];
-    alsoAllowWritten = true;
-  }
-  if (visibilityWritten || a2aWritten || globalAllowWritten || alsoAllowWritten) {
+  if (visibilityWritten || a2aWritten || globalAllowWritten) {
     writeFileSync(configPath, JSON.stringify(rawCfgForVisibility, null, 2) + `
 `, "utf-8");
     configChanged = true;
@@ -1467,8 +1450,6 @@ async function provisionAgents(state, cfg, runtime, log) {
       log("[agentlife] set tools.agentToAgent.enabled=true (cross-agent sends)");
     if (globalAllowWritten)
       log('[agentlife] added "*" to tools.allow (unblock exec/read/write for provisioned agents)');
-    if (alsoAllowWritten)
-      log("[agentlife] added agentlife_push to tools.alsoAllow (tool-policy pipeline intersection pass-through)");
   }
   if (configChanged) {
     const configPath2 = path3.join(os.homedir(), ".openclaw", "openclaw.json");
@@ -2747,91 +2728,13 @@ function snapshotOnboarding(state, runtime) {
 }
 
 // render-widgets.ts
-function recentActivityCount(state, agentId, sinceMs) {
-  if (!state.historyDb)
-    return 0;
-  try {
-    const row = state.historyDb.prepare("SELECT COUNT(*) as c FROM activity_log WHERE agentId = ? AND ts > ?").get(agentId, sinceMs);
-    return row?.c ?? 0;
-  } catch {
-    return 0;
-  }
-}
-function pendingFollowupCount(state, agentId) {
-  if (!state.historyDb)
-    return 0;
-  try {
-    const row = state.historyDb.prepare("SELECT COUNT(*) as c FROM followups WHERE agentId = ? AND status = 'pending'").get(agentId);
-    return row?.c ?? 0;
-  } catch {
-    return 0;
-  }
-}
-function sanitizeDslString(s) {
-  return s.replace(/"/g, "'").replace(/[\r\n]+/g, " ").slice(0, 120);
-}
-function composeAgentIntroDsl(opts) {
-  const surfaceId = `${opts.agentId}-intro`;
-  const title = `${opts.emoji} ${opts.name}`;
-  const desc = sanitizeDslString(opts.description || `Your ${opts.name} agent, ready to track and act.`);
-  const activeBadge = opts.activityCount > 0 ? "Active" : "Ready";
-  const activeColor = opts.activityCount > 0 ? "#10B981" : "#6366F1";
-  return [
-    `surface ${surfaceId} size=m`,
-    `  card`,
-    `    column`,
-    `      text "${sanitizeDslString(title)}" h3`,
-    `      text "${desc}" body`,
-    `      divider`,
-    `      row distribute=spaceBetween`,
-    `        metric "Actions (7d)" "${opts.activityCount}"`,
-    `        metric "Upcoming" "${opts.followupCount}"`,
-    `        badge "${activeBadge}" color=${activeColor} outlined`,
-    `goal: ${opts.name} — track progress toward user's first real outcome`,
-    `followup: +24h "Check if the user interacted with the ${opts.name} agent. If yes, summarize progress. If not, push a gentle prompt relevant to the domain."`,
-    `context: {"agentId":"${opts.agentId}","domain":"${opts.agentId}","phase":"intro","autoRendered":true}`
-  ].join(`
-`);
-}
-function agentEmoji(runtime, agentId) {
-  const cfg = runtime.config.loadConfig();
-  const list = cfg?.agents?.list ?? [];
-  const found = list.find((a) => a?.id === agentId);
-  return found?.identity?.emoji ?? "\uD83C\uDFAF";
-}
-function renderAgentWidget(state, runtime, agentId, log) {
-  if (!userAgentIds(runtime).includes(agentId))
-    return;
-  const entry = state.agentRegistry.get(agentId);
-  if (!entry) {
-    log(`[render-widgets] ${agentId}: no registry entry, skipping`);
-    return;
-  }
-  const sevenDaysAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
-  const dsl = composeAgentIntroDsl({
-    agentId,
-    name: entry.name,
-    description: entry.description ?? "",
-    emoji: agentEmoji(runtime, agentId),
-    activityCount: recentActivityCount(state, agentId, sevenDaysAgo),
-    followupCount: pendingFollowupCount(state, agentId)
-  });
-  pluginPushSurface(state, { agentId, dsl });
-  log(`[render-widgets] rendered ${agentId}-intro`);
-}
 function renderAllAgentWidgets(state, runtime, log) {
   if (isOnboarding(state, runtime)) {
     log("[render-widgets] onboarding active — rendering welcome widget");
     renderWelcomeWidget(state, log);
     return;
   }
-  for (const id of userAgentIds(runtime)) {
-    try {
-      renderAgentWidget(state, runtime, id, log);
-    } catch (e) {
-      log(`[render-widgets] ${id} render failed: ${e?.message ?? e}`);
-    }
-  }
+  log("[render-widgets] onboarding complete — no plugin-pushed widgets; specialists own their surfaces");
 }
 var WELCOME_SURFACE_ID = "welcome";
 var WELCOME_INPUT_SURFACE_ID = "welcome-input";
@@ -2851,12 +2754,12 @@ Each turn:
    - updated \`context: {"phase":"welcome","turn":N+1,"answers":[...]}\`
    - goal + followup unchanged
    Respond \`done\`.
-3. Enough → create the generalist:
+3. Enough → create the generalist and hand off the dashboard:
    - Workspace under \`$HOME/.openclaw/workspace-{id}\` (id = slugified short name or "me")
    - \`AGENTS.md\` — generalist scope covering mentioned domains; Data Schema must include a \`domain TEXT NOT NULL\` column on every user-data table so future split by domain is trivial; add self-evolution clause ("when activity_log rows for one domain exceed a natural threshold, push a split-suggest widget")
    - \`SOUL.md\`, \`IDENTITY.md\`, \`USER.md\` (user's own words), \`HEARTBEAT.md\` (empty)
-   - \`exec openclaw gateway call agentlife.createAgent --params '{...}'\` with \`tools: {profile:"full"}\`. Plugin auto-deletes welcome + welcome-input and renders {id}-intro — do NOT push an intro.
-   - Respond \`done\`.
+   - \`exec openclaw gateway call agentlife.createAgent --params '{...}'\` with \`tools: {profile:"full", alsoAllow:["agentlife_push"]}\`. Plugin auto-deletes welcome + welcome-input on success.
+   - **Final step, same turn, before \`done\`:** push ONE actionable first widget for the newly-created agent — an input prompt ("Log your first meal", "Enter today's weight"), a starter metric, or an inviting CTA that owns a surfaceId like \`{id}-today\` / \`{id}-start\`. This is what the user sees when onboarding ends; it MUST invite interaction, not just announce existence. Then delete your \`{domain}-building\` loading widget. Then emit \`done\`.
 `;
 function renderWelcomeWidget(state, log) {
   const welcomeDsl = [
@@ -2898,14 +2801,6 @@ function deleteWelcomeWidget(state, log) {
       log(`[render-widgets] deleted ${id}`);
     }
   }
-  if (state.runCommand) {
-    const deleteParams = JSON.stringify({ key: ONBOARDING_SESSION_KEY, deleteTranscript: true });
-    state.runCommand(["openclaw", "gateway", "call", "sessions.delete", "--params", deleteParams], { timeoutMs: 1e4 }).then(() => {
-      log(`[render-widgets] deleted onboarding session`);
-    }).catch((e) => {
-      console.log("[agentlife] onboarding session delete skipped: %s", e?.message);
-    });
-  }
 }
 
 // services/surfaces-init.ts
@@ -6166,6 +6061,7 @@ ${dashboardState}` : ONBOARDING_PLAYBOOK : dashboardState;
 
 // gateway/agents.ts
 import * as fs8 from "node:fs";
+import * as os7 from "node:os";
 import * as path11 from "node:path";
 function registerAgentGateway(api, state2) {
   api.registerGatewayMethod("agentlife.createAgent", async ({ params, respond }) => {
@@ -6256,10 +6152,9 @@ function registerAgentGateway(api, state2) {
       configFields.push("identity");
     if (!existing && userAgentIds(api.runtime).includes(id)) {
       try {
-        renderAgentWidget(state2, api.runtime, id, console.log);
         deleteWelcomeWidget(state2, console.log);
       } catch (e) {
-        console.warn("[agentlife] renderAgentWidget failed for %s: %s", id, e?.message);
+        console.warn("[agentlife] deleteWelcomeWidget failed for %s: %s", id, e?.message);
       }
     }
     respond(true, { status, id, name, model, workspace, description, ...configFields.length ? { configFields } : {} });
@@ -6275,7 +6170,7 @@ function registerAgentGateway(api, state2) {
       respond(false, { error: "cannot delete provisioned agent" });
       return;
     }
-    const cleanup = { sessions: 0, cronJobs: 0, historyRows: 0, agentDbDeleted: false };
+    const cleanup = { sessions: 0, cronJobs: 0, historyRows: 0, agentDbDeleted: false, workspaceDeleted: false, stateDeleted: false };
     if (state2.runCommand) {
       try {
         const sessResult = await state2.runCommand(["openclaw", "gateway", "call", "sessions.list"], { timeoutMs: 1e4 });
@@ -6336,8 +6231,33 @@ function registerAgentGateway(api, state2) {
     }
     const cfg = api.runtime.config.loadConfig();
     const currentList = cfg.agents?.list ?? [];
+    const existingEntry = currentList.find((a) => a.id === id);
     const filtered = currentList.filter((a) => a.id !== id);
     const removedFromConfig = filtered.length < currentList.length;
+    const openclawHome = path11.join(os7.homedir(), ".openclaw");
+    const stateDir = path11.join(openclawHome, "agents", id);
+    if (stateDir.startsWith(path11.join(openclawHome, "agents") + path11.sep)) {
+      try {
+        if (fs8.existsSync(stateDir)) {
+          fs8.rmSync(stateDir, { recursive: true, force: true });
+          cleanup.stateDeleted = true;
+        }
+      } catch (e) {
+        console.warn("[agentlife] deleteAgent: failed to delete state dir:", e?.message);
+      }
+    }
+    const defaultWorkspace = path11.join(openclawHome, `workspace-${id}`);
+    const workspaceToDelete = typeof existingEntry?.workspace === "string" && existingEntry.workspace.trim() ? path11.resolve(existingEntry.workspace) : defaultWorkspace;
+    if (workspaceToDelete.startsWith(openclawHome + path11.sep) && workspaceToDelete !== openclawHome) {
+      try {
+        if (fs8.existsSync(workspaceToDelete)) {
+          fs8.rmSync(workspaceToDelete, { recursive: true, force: true });
+          cleanup.workspaceDeleted = true;
+        }
+      } catch (e) {
+        console.warn("[agentlife] deleteAgent: failed to delete workspace dir:", e?.message);
+      }
+    }
     if (removedFromConfig) {
       const updatedCfg = {
         ...cfg,
@@ -6352,7 +6272,7 @@ function registerAgentGateway(api, state2) {
     if (removedFromRegistry) {
       await saveRegistryToDisk(state2);
     }
-    console.log("[agentlife] deleted agent: %s (config=%s, registry=%s, sessions=%d, cron=%d, historyRows=%d, agentDb=%s)", id, removedFromConfig, removedFromRegistry, cleanup.sessions, cleanup.cronJobs, cleanup.historyRows, cleanup.agentDbDeleted);
+    console.log("[agentlife] deleted agent: %s (config=%s, registry=%s, sessions=%d, cron=%d, historyRows=%d, agentDb=%s, state=%s, workspace=%s)", id, removedFromConfig, removedFromRegistry, cleanup.sessions, cleanup.cronJobs, cleanup.historyRows, cleanup.agentDbDeleted, cleanup.stateDeleted, cleanup.workspaceDeleted);
     respond(true, { status: "deleted", id, removedFromConfig, removedFromRegistry, cleanup });
   });
   api.registerGatewayMethod("agentlife.agents", ({ respond }) => {
@@ -6972,10 +6892,10 @@ function registerAutomationsGateway(api, state2) {
 // gateway/admin.ts
 import * as fs9 from "node:fs/promises";
 import * as fsSync4 from "node:fs";
-import * as os7 from "node:os";
+import * as os8 from "node:os";
 import * as path12 from "node:path";
 function pluginConfigPath() {
-  return path12.join(os7.homedir(), ".openclaw", "agentlife", "plugin-config.json");
+  return path12.join(os8.homedir(), ".openclaw", "agentlife", "plugin-config.json");
 }
 function readPluginConfig() {
   try {
@@ -7084,7 +7004,7 @@ function registerAdminGateway(api, state2) {
   api.registerGatewayMethod("agentlife.uninstall", async ({ respond }) => {
     try {
       const cleaned = [];
-      const baseDir = state2.agentlifeStateDir ?? path12.join(os7.homedir(), ".openclaw", "agentlife");
+      const baseDir = state2.agentlifeStateDir ?? path12.join(os8.homedir(), ".openclaw", "agentlife");
       const identity = loadDeviceIdentity();
       if (!identity) {
         cleaned.push("server deprovision skipped (no device identity)");
@@ -7190,7 +7110,7 @@ function registerAdminGateway(api, state2) {
       for (const agent of PROVISIONED_AGENTS) {
         if (agent.existingAgent)
           continue;
-        const wsDir = agent.workspaceDir ?? path12.join(os7.homedir(), ".openclaw", `workspace-${agent.id}`);
+        const wsDir = agent.workspaceDir ?? path12.join(os8.homedir(), ".openclaw", `workspace-${agent.id}`);
         try {
           await fs9.rm(wsDir, { recursive: true, force: true });
           cleaned.push(`deleted workspace ${agent.id}`);
@@ -7451,10 +7371,10 @@ import {
 
 // gateway/config-utils.ts
 import * as fs10 from "node:fs";
-import * as os8 from "node:os";
+import * as os9 from "node:os";
 import * as path13 from "node:path";
 function configPath() {
-  return path13.join(os8.homedir(), ".openclaw", "openclaw.json");
+  return path13.join(os9.homedir(), ".openclaw", "openclaw.json");
 }
 function readConfig() {
   try {
@@ -7470,10 +7390,10 @@ function writeConfig(cfg) {
 
 // gateway/providers.ts
 import * as fs11 from "node:fs";
-import * as os9 from "node:os";
+import * as os10 from "node:os";
 import * as path14 from "node:path";
 function siblingAgentDirs() {
-  const root = path14.join(os9.homedir(), ".openclaw", "agents");
+  const root = path14.join(os10.homedir(), ".openclaw", "agents");
   let entries;
   try {
     entries = fs11.readdirSync(root, { withFileTypes: true });
@@ -7558,8 +7478,8 @@ function readOAuthExpiries() {
   const result = new Map;
   const fs12 = __require("node:fs");
   const path15 = __require("node:path");
-  const os10 = __require("node:os");
-  const agentsDir = path15.join(os10.homedir(), ".openclaw", "agents");
+  const os11 = __require("node:os");
+  const agentsDir = path15.join(os11.homedir(), ".openclaw", "agents");
   let entries;
   try {
     entries = fs12.readdirSync(agentsDir);
@@ -7851,10 +7771,10 @@ ${result?.stderr ?? ""}`;
 
 // gateway/models-config.ts
 import * as fs12 from "node:fs";
-import * as os10 from "node:os";
+import * as os11 from "node:os";
 import * as path15 from "node:path";
 function pluginConfigPath2() {
-  return path15.join(os10.homedir(), ".openclaw", "agentlife", "plugin-config.json");
+  return path15.join(os11.homedir(), ".openclaw", "agentlife", "plugin-config.json");
 }
 function readPluginConfig2() {
   try {
@@ -8011,7 +7931,7 @@ var stopQualityCheckPoller = null;
 var stopCloudflared = null;
 function resolveInternalModel(api) {
   try {
-    const pluginCfgPath = path16.join(homedir12(), ".openclaw", "agentlife", "plugin-config.json");
+    const pluginCfgPath = path16.join(homedir13(), ".openclaw", "agentlife", "plugin-config.json");
     try {
       const raw = __require("node:fs").readFileSync(pluginCfgPath, "utf-8");
       const pluginCfg = JSON.parse(raw);
@@ -8047,7 +7967,7 @@ function register(api) {
     return;
   }
   registered = true;
-  const fallbackDir = path16.join(homedir12(), ".openclaw", "agentlife");
+  const fallbackDir = path16.join(homedir13(), ".openclaw", "agentlife");
   const state2 = {
     surfaceDb: null,
     agentRegistry: new Map,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlife",
-  "version": "2.4.3",
+  "version": "2.4.5",
   "type": "module",
   "scripts": {
     "build": "bun build index.ts --outfile dist/index.js --target node --external openclaw/plugin-sdk",