agentlife 2.3.0 → 2.4.0

package/dist/index.js

@@ -2710,13 +2710,22 @@ function runStartupPurge(state) {
   console.log("[agentlife] surfaces DB: %d persisted%s%s", state.surfaceDb.size, purged > 0 ? ` (purged ${purged} past grace period)` : "", backfilled > 0 ? ` (backfilled ${backfilled} agent mappings from history)` : "");
 }
 
-// render-widgets.ts
-var PROVISIONED_IDS = new Set(PROVISIONED_AGENTS.filter((a) => !a.existingAgent).map((a) => a.id));
-function listSpecialistIds(runtime) {
+// onboarding.ts
+var PROVISIONED_IDS = new Set(PROVISIONED_AGENTS.map((a) => a.id));
+function userAgentIds(runtime) {
   const cfg = runtime.config.loadConfig();
   const list = cfg?.agents?.list ?? [];
   return list.map((a) => a?.id).filter((id) => !!id && !PROVISIONED_IDS.has(id));
 }
+function isOnboarding(_state, runtime) {
+  return userAgentIds(runtime).length === 0;
+}
+function snapshotOnboarding(state, runtime) {
+  const count = userAgentIds(runtime).length;
+  return { isActive: count === 0, userAgentCount: count };
+}
+
+// render-widgets.ts
 function recentActivityCount(state, agentId, sinceMs) {
   if (!state.historyDb)
     return 0;
@@ -2770,7 +2779,7 @@ function agentEmoji(runtime, agentId) {
   return found?.identity?.emoji ?? "\uD83C\uDFAF";
 }
 function renderAgentWidget(state, runtime, agentId, log) {
-  if (PROVISIONED_IDS.has(agentId))
+  if (!userAgentIds(runtime).includes(agentId))
     return;
   const entry = state.agentRegistry.get(agentId);
   if (!entry) {
@@ -2790,13 +2799,12 @@ function renderAgentWidget(state, runtime, agentId, log) {
   log(`[render-widgets] rendered ${agentId}-intro`);
 }
 function renderAllAgentWidgets(state, runtime, log) {
-  const ids = listSpecialistIds(runtime);
-  if (ids.length === 0) {
-    log("[render-widgets] no user agents — rendering welcome widget");
+  if (isOnboarding(state, runtime)) {
+    log("[render-widgets] onboarding active — rendering welcome widget");
     renderWelcomeWidget(state, log);
     return;
   }
-  for (const id of ids) {
+  for (const id of userAgentIds(runtime)) {
     try {
       renderAgentWidget(state, runtime, id, log);
     } catch (e) {
@@ -2983,13 +2991,13 @@ function registerSurfacesService(api, state) {
         state.surfaceDb = new SurfaceDb(db);
       }
       runStartupPurge(state);
-      const FLOW_INPUT_IDS = new Set(["welcome-input"]);
+      const onboarding = isOnboarding(state, api.runtime);
       let inputPurged = 0;
       for (const [surfaceId, meta] of state.surfaceDb.entries()) {
         const headerLine = meta.lines[0] ?? "";
         if (!/\binput\b/.test(headerLine))
           continue;
-        if (FLOW_INPUT_IDS.has(surfaceId))
+        if (onboarding)
           continue;
         state.surfaceDb.delete(surfaceId);
         inputPurged++;
@@ -2997,6 +3005,9 @@ function registerSurfacesService(api, state) {
       if (inputPurged > 0) {
         console.log("[agentlife] purged %d stale input surfaces on startup", inputPurged);
       }
+      if (!onboarding) {
+        deleteWelcomeWidget(state, console.log);
+      }
       await loadRegistryFromDisk(state);
       console.log("[agentlife] surface persistence service started (SQLite: %s)", state.historyDbPath);
       setTimeout(async () => {
@@ -6115,15 +6126,15 @@ function registerPromptStateHook(api, state2) {
     if (isInternalSession(sessionKey))
       return;
     const dashboardState = buildDashboardStateContext(state2, agentId);
-    const isOnboarding = sessionKey === ONBOARDING_SESSION_KEY;
-    const appendSystemContext = isOnboarding ? dashboardState ? `${ONBOARDING_PLAYBOOK}
+    const isOnboardingTurn = sessionKey === ONBOARDING_SESSION_KEY && isOnboarding(state2, api.runtime);
+    const appendSystemContext = isOnboardingTurn ? dashboardState ? `${ONBOARDING_PLAYBOOK}
 
 ${dashboardState}` : ONBOARDING_PLAYBOOK : dashboardState;
     if (!appendSystemContext) {
       console.log("[agentlife:prompt-state] agentId=%s — no context to inject (surfaceDb size=%d)", agentId ?? "NONE", state2.surfaceDb?.size ?? 0);
       return;
     }
-    if (isOnboarding) {
+    if (isOnboardingTurn) {
       console.log("[agentlife:prompt-state] onboarding session — injecting %d chars (playbook + dashboard)", appendSystemContext.length);
     } else {
       console.log("[agentlife:prompt-state] agentId=%s injecting %d chars dashboard state", agentId ?? "NONE", appendSystemContext.length);
@@ -6222,15 +6233,12 @@ function registerAgentGateway(api, state2) {
       configFields.push("subagents");
     if (identity)
       configFields.push("identity");
-    if (!existing) {
-      const provisionedIds = new Set(PROVISIONED_AGENTS.map((a) => a.id));
-      if (!provisionedIds.has(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);
-        }
+    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);
       }
     }
     respond(true, { status, id, name, model, workspace, description, ...configFields.length ? { configFields } : {} });
@@ -6624,6 +6632,9 @@ function registerUsageGateway(api, state2) {
 var guidedDismissSent = new Set;
 var warnedMissingOrigin = new Set;
 function registerSurfacesGateway(api, state2) {
+  api.registerGatewayMethod("agentlife.onboarding.state", ({ respond }) => {
+    respond(true, snapshotOnboarding(state2, api.runtime));
+  }, { scope: "operator.read" });
   api.registerGatewayMethod("agentlife.surfaces", ({ params, respond, context }) => {
     captureBridge(context);
     const now = Date.now();
@@ -6633,13 +6644,13 @@ function registerSurfacesGateway(api, state2) {
       respond(true, { surfaces: [] });
       return;
     }
-    const FLOW_INPUT_IDS = new Set(["welcome-input"]);
+    const onboarding = isOnboarding(state2, api.runtime);
     for (const [surfaceId, meta] of state2.surfaceDb.entries()) {
       if (isExpired(meta, now))
         continue;
       const headerLine = meta.lines[0] ?? "";
       const isInput = /\binput\b/.test(headerLine);
-      if (isInput && !FLOW_INPUT_IDS.has(surfaceId))
+      if (isInput && !onboarding)
         continue;
       if (meta.lines.length > 0) {
         surfaceEntries.push({ surfaceId, dsl: meta.lines.join(`

package/package.json

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