agentlife 2.2.1 → 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) {
@@ -2807,29 +2815,27 @@ function renderAllAgentWidgets(state, runtime, log) {
 var WELCOME_SURFACE_ID = "welcome";
 var WELCOME_INPUT_SURFACE_ID = "welcome-input";
 var ONBOARDING_SESSION_KEY = "agent:agentlife-builder:agentlife:onboarding:operator";
-var ONBOARDING_PLAYBOOK = `[system:onboarding]
+var ONBOARDING_PLAYBOOK = `## Zero-agent onboarding
 
-You are the agent-builder operating in the one-time zero-agent onboarding session. A fresh user (no agents yet) just installed AgentLife. The plugin pushed a welcome-input surface into the dashboard; the user's first submission on it is coming next in this session.
+You are agent-builder running a one-time onboarding for a fresh user (no agents yet). The plugin already pushed a \`welcome-input\` surface; the user's reply in this session is a tap or text on that surface.
 
-Your job: run a 2–4 turn guided interview, then create ONE **generalist** agent for the user (not a narrow specialist).
+Run a 2–4 turn guided interview, then create ONE **generalist** agent.
 
-Each turn after the user replies:
-1. Decide whether you have enough signal — minimum: name/persona hint + 2–3 concrete life areas they care about. Don't drag past 4 turns.
-2. Not enough? \`agentlife_push\` the SAME surfaceId \`welcome-input\` with:
-   - h3 question you generate from what the user just said
-   - 2–4 multichoice buttons \`action=choice\` with options derived from their words (NEVER hardcoded domain lists)
+Each turn:
+1. Decide: do you have enough signal? Minimum = name/persona hint + 2–3 concrete life areas. Don't drag past 4 turns.
+2. Not enough → \`agentlife_push\` the SAME surfaceId \`welcome-input\` with:
+   - h3 question generated from what the user just said
+   - 2–4 multichoice buttons \`action=choice\`, options derived from the user's own words (NEVER hardcoded domain lists)
    - \`textfield placeholder="Something else…"\` escape hatch
    - updated \`context: {"phase":"welcome","turn":N+1,"answers":[...]}\`
    - goal + followup unchanged
-   Respond \`done\` after the push.
-3. Enough? Create the generalist:
-   - Write workspace files under \`$HOME/.openclaw/workspace-{id}\` (id = user-slugified short name or "me")
-   - \`AGENTS.md\` — generalist scope covering the domains mentioned; Data Schema must include a \`domain TEXT NOT NULL\` column on every user-data table so a future split by domain is trivial; include a self-evolution clause ("when activity_log rows for a single domain exceed a natural threshold, push a split-suggest widget")
-   - \`SOUL.md\`, \`IDENTITY.md\`, \`USER.md\` (user's own words from the interview), \`HEARTBEAT.md\` (empty placeholder)
-   - \`exec openclaw gateway call agentlife.createAgent --params '{...}'\` with \`tools: {profile:"full"}\`. The plugin deletes welcome + welcome-input and renders {id}-intro automatically — do NOT push an intro yourself.
+   Respond \`done\`.
+3. Enough → create the generalist:
+   - 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\`.
-
-The user's first reply follows this system preamble. Proceed.
 `;
 function renderWelcomeWidget(state, log) {
   const welcomeDsl = [
@@ -2862,25 +2868,6 @@ function renderWelcomeWidget(state, log) {
   pluginPushSurface(state, { agentId: "agentlife-builder", dsl: welcomeInputDsl });
   state.surfaceDb?.setOriginSessionKey(WELCOME_INPUT_SURFACE_ID, ONBOARDING_SESSION_KEY);
   log(`[render-widgets] rendered ${WELCOME_INPUT_SURFACE_ID} (onboarding session)`);
-  seedOnboardingSession(state, log);
-}
-function seedOnboardingSession(state, log) {
-  if (!state.runCommand) {
-    log(`[render-widgets] runCommand unavailable — onboarding session not seeded`);
-    return;
-  }
-  const model = state.internalModel;
-  const createParams = JSON.stringify({ key: ONBOARDING_SESSION_KEY, agentId: "agentlife-builder", model });
-  state.runCommand(["openclaw", "gateway", "call", "sessions.create", "--params", createParams], { timeoutMs: 1e4 }).then(() => {
-    const chatParams = JSON.stringify({
-      sessionKey: ONBOARDING_SESSION_KEY,
-      message: ONBOARDING_PLAYBOOK,
-      idempotencyKey: `onboarding-seed-${ONBOARDING_SESSION_KEY}`
-    });
-    state.runCommand(["openclaw", "gateway", "call", "chat.send", "--params", chatParams], { timeoutMs: 30000 }).catch((e) => console.warn("[agentlife] onboarding seed chat.send failed: %s", e?.message));
-  }).catch((e) => {
-    console.log("[agentlife] onboarding session create skipped: %s", e?.message);
-  });
 }
 function deleteWelcomeWidget(state, log) {
   for (const id of [WELCOME_SURFACE_ID, WELCOME_INPUT_SURFACE_ID]) {
@@ -3004,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++;
@@ -3018,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 () => {
@@ -6126,23 +6116,30 @@ function registerPromptStateHook(api, state2) {
   api.on("before_prompt_build", (event, ctx) => {
     if (state2.disabled)
       return;
-    if (!isAgentlifeSession(ctx?.sessionKey))
+    const sessionKey = ctx?.sessionKey;
+    if (!isAgentlifeSession(sessionKey))
       return;
     const agentId = ctx?.agentId;
     const isOrchestrator = agentId === "agentlife";
     if (isOrchestrator)
       return;
-    if (isInternalSession(ctx?.sessionKey))
+    if (isInternalSession(sessionKey))
       return;
     const dashboardState = buildDashboardStateContext(state2, agentId);
-    if (!dashboardState) {
-      console.log("[agentlife:prompt-state] agentId=%s — no dashboard state (surfaceDb size=%d)", agentId ?? "NONE", state2.surfaceDb?.size ?? 0);
+    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;
     }
-    console.log("[agentlife:prompt-state] agentId=%s injecting %d chars dashboard state", agentId ?? "NONE", dashboardState.length);
-    return {
-      appendSystemContext: dashboardState
-    };
+    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);
+    }
+    return { appendSystemContext };
   });
 }
 
@@ -6236,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 } : {} });
@@ -6638,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();
@@ -6647,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.2.1",
+  "version": "2.4.0",
   "type": "module",
   "scripts": {
     "build": "bun build index.ts --outfile dist/index.js --target node --external openclaw/plugin-sdk",