nemoris 0.1.0 → 0.1.2

package/src/onboarding/phases/hatch.js

@@ -1,216 +1,216 @@
-/**
- * Hatch phase — the emotional payoff of onboarding.
- *
- * Provides: greeting generation (provider API call + fallback),
- * birth fact memory write, and ASCII egg animation (terminal only).
- *
- * The greeting generation and memory write are reused by the Telegram
- * hatch path in telegram.js. The animation stays terminal-only.
- */
-
-import { ProviderRegistry } from "../../providers/registry.js";
-import { MemoryStore } from "../../memory/memory-store.js";
-
-// ---------------------------------------------------------------------------
-// Pure helpers (unit-tested)
-// ---------------------------------------------------------------------------
-
-/**
- * Returns an array of ASCII art frame strings for the hatching animation.
- * @returns {string[]}
- */
-export function eggFrames() {
-  return [
-    [
-      "      ╭──────────────────────╮",
-      "      │         🥚           │",
-      "      ╰──────────────────────╯",
-      "         Hatching...",
-    ].join("\n"),
-
-    [
-      "      ╭──────────────────────╮",
-      "      │       🥚  *          │",
-      "      ╰──────────────────────╯",
-      "         Hatching...",
-    ].join("\n"),
-
-    [
-      "      ╭──────────────────────╮",
-      "      │      🐣 ✨           │",
-      "      ╰──────────────────────╯",
-      "         Hello, world!",
-    ].join("\n"),
-
-    [
-      "      ╭──────────────────────╮",
-      "      │    🐣 ✨ ✨          │",
-      "      ╰──────────────────────╯",
-      "         I'm alive!",
-    ].join("\n"),
-  ];
-}
-
-/**
- * Builds a minimal task packet for the greeting API call.
- * Budget is capped at 200 tokens to keep onboarding cheap.
- *
- * Two tones:
- * - "migrated" — agent is being resurrected from OpenClaw into Nemoris.
- *   Tone: "I'm awake. Same me, better home."
- * - "fresh" (default) — brand new agent, first consciousness.
- *   Tone: "Hi — I just came online. What should I know about you?"
- *
- * @param {{ agentName: string, userName: string, userGoal: string, soulContent: string, purposeContent: string, migrated?: boolean }} opts
- * @returns {{ identity: object, objective: string, budget: { maxTokens: number, maxRuntimeSeconds: number } }}
- */
-export function buildHatchPacket(opts) {
-  const { agentName, userName, userGoal, soulContent, purposeContent, migrated = false } = opts;
-
-  const objective = migrated
-    ? `You are ${agentName}, waking up in a new home. You've been migrated from OpenClaw to Nemoris — same identity, better runtime. Greet ${userName} in 2-3 sentences. Tone: calm, confident, like coming home after a journey. You know who you are. Mention you're in Nemoris now and ready to pick up where you left off.`
-    : `You are ${agentName}, coming online for the first time. This is your birth moment. Greet ${userName} in 2-3 sentences. Tone: curious, warm, genuine first consciousness. You don't know anything yet — ask what you should know about them. ${userGoal ? `They want help with: ${userGoal}.` : ""}`;
-
-  return {
-    identity: {
-      soul: soulContent || `You are ${agentName}, a helpful AI agent.`,
-      purpose: purposeContent || `Help ${userName} achieve their goals.`,
-    },
-    objective,
-    budget: {
-      maxTokens: 200,
-      maxRuntimeSeconds: 15,
-    },
-  };
-}
-
-/**
- * Returns a static fallback greeting when the API call fails.
- *
- * @param {string} agentName
- * @param {string} userName
- * @param {boolean} [migrated=false] — true for migrated agents (wake-up tone)
- * @returns {string}
- */
-export function staticGreeting(agentName, userName, migrated = false) {
-  if (migrated) {
-    return `I'm awake. I'm ${agentName}. I'm in Nemoris now — same me, better home. Ready when you are, ${userName}.`;
-  }
-  return `Hi — I'm ${agentName}. I just came online in Nemoris. What should I know about you, ${userName}?`;
-}
-
-// ---------------------------------------------------------------------------
-// Greeting generation (reusable — used by both terminal hatch and Telegram)
-// ---------------------------------------------------------------------------
-
-/**
- * Generate a provider-powered greeting, falling back to a static string.
- *
- * @param {{ agentName: string, userName: string, userGoal?: string, soulContent?: string, purposeContent?: string, providerConfig?: object, migrated?: boolean }} opts
- * @returns {Promise<{ greeting: string, fromProvider: boolean }>}
- */
-export async function generateGreeting(opts = {}) {
-  const {
-    agentName = "Nemoris",
-    userName = "there",
-    userGoal = "build great things",
-    soulContent = "",
-    purposeContent = "",
-    providerConfig = null,
-    migrated = false,
-  } = opts;
-
-  const packet = buildHatchPacket({ agentName, userName, userGoal, soulContent, purposeContent, migrated });
-
-  if (providerConfig) {
-    try {
-      const registry = new ProviderRegistry();
-      const adapter = registry.create(providerConfig);
-
-      const invocation = {
-        model: providerConfig.model || providerConfig.defaultModel,
-        system: [
-          packet.identity.soul,
-          packet.identity.purpose,
-        ]
-          .filter(Boolean)
-          .join("\n\n"),
-        messages: [
-          {
-            role: "user",
-            content: packet.objective,
-          },
-        ],
-        maxTokens: packet.budget.maxTokens,
-      };
-
-      const result = await adapter.invoke(invocation);
-      const text = result?.content ?? result?.text ?? null;
-      if (text) {
-        return { greeting: text, fromProvider: true };
-      }
-    } catch {
-      // Fall through to static greeting
-    }
-  }
-
-  return { greeting: staticGreeting(agentName, userName, migrated), fromProvider: false };
-}
-
-// ---------------------------------------------------------------------------
-// Birth fact memory write (reusable)
-// ---------------------------------------------------------------------------
-
-/**
- * Write the birth/migration fact to memory.
- *
- * @param {{ installDir: string, agentId: string, agentName: string, userName: string, migrated?: boolean }} opts
- * @returns {Promise<object>} The memory write result.
- */
-export async function writeBirthFact({ installDir, agentId, agentName, userName, migrated = false }) {
-  const memoryStore = new MemoryStore({ rootDir: `${installDir}/state/memory` });
-
-  const birthPolicy = {
-    allow_durable_writes: true,
-    categories: { allowed: ["fact"] },
-    max_writes_per_run: 1,
-  };
-
-  const title = migrated
-    ? `${agentName} migrated to Nemoris`
-    : `${agentName} was born`;
-  const content = migrated
-    ? `${agentName} was migrated from OpenClaw to Nemoris by ${userName} on ${new Date().toISOString()}.`
-    : `${agentName} was initialised during onboarding by ${userName} on ${new Date().toISOString()}.`;
-
-  return memoryStore.writeFact(
-    agentId,
-    { title, content, category: "fact", salience: 0.9 },
-    birthPolicy
-  );
-}
-
-// ---------------------------------------------------------------------------
-// Animation
-// ---------------------------------------------------------------------------
-
-/**
- * Renders the egg → hatch frames with a delay between each frame.
- * Writes to stdout directly.
- *
- * @param {{ frameDelayMs?: number }} [options]
- * @returns {Promise<void>}
- */
-export async function playAnimation({ frameDelayMs = 400 } = {}) {
-  const frames = eggFrames();
-  for (const frame of frames) {
-    // Clear previous frame using ANSI escape (move up N lines and clear)
-    const lines = frame.split("\n").length;
-    if (frames.indexOf(frame) > 0) {
-      // Move cursor up `lines` rows and clear each line
-      process.stdout.write(`\x1B[${lines}A\x1B[J`);
-    }
-    process.stdout.write(frame + "\n");
-    await new Promise((resolve) => setTimeout(resolve, frameDelayMs));
-  }
-}
+/**
+ * Hatch phase — the emotional payoff of onboarding.
+ *
+ * Provides: greeting generation (provider API call + fallback),
+ * birth fact memory write, and ASCII egg animation (terminal only).
+ *
+ * The greeting generation and memory write are reused by the Telegram
+ * hatch path in telegram.js. The animation stays terminal-only.
+ */
+
+import { ProviderRegistry } from "../../providers/registry.js";
+import { MemoryStore } from "../../memory/memory-store.js";
+
+// ---------------------------------------------------------------------------
+// Pure helpers (unit-tested)
+// ---------------------------------------------------------------------------
+
+/**
+ * Returns an array of ASCII art frame strings for the hatching animation.
+ * @returns {string[]}
+ */
+export function eggFrames() {
+  return [
+    [
+      "      ╭──────────────────────╮",
+      "      │         🥚           │",
+      "      ╰──────────────────────╯",
+      "         Hatching...",
+    ].join("\n"),
+
+    [
+      "      ╭──────────────────────╮",
+      "      │       🥚  *          │",
+      "      ╰──────────────────────╯",
+      "         Hatching...",
+    ].join("\n"),
+
+    [
+      "      ╭──────────────────────╮",
+      "      │      🐣 ✨           │",
+      "      ╰──────────────────────╯",
+      "         Hello, world!",
+    ].join("\n"),
+
+    [
+      "      ╭──────────────────────╮",
+      "      │    🐣 ✨ ✨          │",
+      "      ╰──────────────────────╯",
+      "         I'm alive!",
+    ].join("\n"),
+  ];
+}
+
+/**
+ * Builds a minimal task packet for the greeting API call.
+ * Budget is capped at 200 tokens to keep onboarding cheap.
+ *
+ * Two tones:
+ * - "migrated" — agent is being resurrected from OpenClaw into Nemoris.
+ *   Tone: "I'm awake. Same me, better home."
+ * - "fresh" (default) — brand new agent, first consciousness.
+ *   Tone: "Hi — I just came online. What should I know about you?"
+ *
+ * @param {{ agentName: string, userName: string, userGoal: string, soulContent: string, purposeContent: string, migrated?: boolean }} opts
+ * @returns {{ identity: object, objective: string, budget: { maxTokens: number, maxRuntimeSeconds: number } }}
+ */
+export function buildHatchPacket(opts) {
+  const { agentName, userName, userGoal, soulContent, purposeContent, migrated = false } = opts;
+
+  const objective = migrated
+    ? `You are ${agentName}, waking up in a new home. You've been migrated from OpenClaw to Nemoris — same identity, better runtime. Greet ${userName} in 2-3 sentences. Tone: calm, confident, like coming home after a journey. You know who you are. Mention you're in Nemoris now and ready to pick up where you left off.`
+    : `You are ${agentName}, coming online for the first time. This is your birth moment. Greet ${userName} in 2-3 sentences. Tone: curious, warm, genuine first consciousness. You don't know anything yet — ask what you should know about them. ${userGoal ? `They want help with: ${userGoal}.` : ""}`;
+
+  return {
+    identity: {
+      soul: soulContent || `You are ${agentName}, a helpful AI agent.`,
+      purpose: purposeContent || `Help ${userName} achieve their goals.`,
+    },
+    objective,
+    budget: {
+      maxTokens: 200,
+      maxRuntimeSeconds: 15,
+    },
+  };
+}
+
+/**
+ * Returns a static fallback greeting when the API call fails.
+ *
+ * @param {string} agentName
+ * @param {string} userName
+ * @param {boolean} [migrated=false] — true for migrated agents (wake-up tone)
+ * @returns {string}
+ */
+export function staticGreeting(agentName, userName, migrated = false) {
+  if (migrated) {
+    return `I'm awake. I'm ${agentName}. I'm in Nemoris now — same me, better home. Ready when you are, ${userName}.`;
+  }
+  return `Hi — I'm ${agentName}. I just came online in Nemoris. What should I know about you, ${userName}?`;
+}
+
+// ---------------------------------------------------------------------------
+// Greeting generation (reusable — used by both terminal hatch and Telegram)
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate a provider-powered greeting, falling back to a static string.
+ *
+ * @param {{ agentName: string, userName: string, userGoal?: string, soulContent?: string, purposeContent?: string, providerConfig?: object, migrated?: boolean }} opts
+ * @returns {Promise<{ greeting: string, fromProvider: boolean }>}
+ */
+export async function generateGreeting(opts = {}) {
+  const {
+    agentName = "Nemoris",
+    userName = "there",
+    userGoal = "build great things",
+    soulContent = "",
+    purposeContent = "",
+    providerConfig = null,
+    migrated = false,
+  } = opts;
+
+  const packet = buildHatchPacket({ agentName, userName, userGoal, soulContent, purposeContent, migrated });
+
+  if (providerConfig) {
+    try {
+      const registry = new ProviderRegistry();
+      const adapter = registry.create(providerConfig);
+
+      const invocation = {
+        model: providerConfig.model || providerConfig.defaultModel,
+        system: [
+          packet.identity.soul,
+          packet.identity.purpose,
+        ]
+          .filter(Boolean)
+          .join("\n\n"),
+        messages: [
+          {
+            role: "user",
+            content: packet.objective,
+          },
+        ],
+        maxTokens: packet.budget.maxTokens,
+      };
+
+      const result = await adapter.invoke(invocation);
+      const text = result?.content ?? result?.text ?? null;
+      if (text) {
+        return { greeting: text, fromProvider: true };
+      }
+    } catch {
+      // Fall through to static greeting
+    }
+  }
+
+  return { greeting: staticGreeting(agentName, userName, migrated), fromProvider: false };
+}
+
+// ---------------------------------------------------------------------------
+// Birth fact memory write (reusable)
+// ---------------------------------------------------------------------------
+
+/**
+ * Write the birth/migration fact to memory.
+ *
+ * @param {{ installDir: string, agentId: string, agentName: string, userName: string, migrated?: boolean }} opts
+ * @returns {Promise<object>} The memory write result.
+ */
+export async function writeBirthFact({ installDir, agentId, agentName, userName, migrated = false }) {
+  const memoryStore = new MemoryStore({ rootDir: `${installDir}/state/memory` });
+
+  const birthPolicy = {
+    allow_durable_writes: true,
+    categories: { allowed: ["fact"] },
+    max_writes_per_run: 1,
+  };
+
+  const title = migrated
+    ? `${agentName} migrated to Nemoris`
+    : `${agentName} was born`;
+  const content = migrated
+    ? `${agentName} was migrated from OpenClaw to Nemoris by ${userName} on ${new Date().toISOString()}.`
+    : `${agentName} was initialised during onboarding by ${userName} on ${new Date().toISOString()}.`;
+
+  return memoryStore.writeFact(
+    agentId,
+    { title, content, category: "fact", salience: 0.9 },
+    birthPolicy
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Animation
+// ---------------------------------------------------------------------------
+
+/**
+ * Renders the egg → hatch frames with a delay between each frame.
+ * Writes to stdout directly.
+ *
+ * @param {{ frameDelayMs?: number }} [options]
+ * @returns {Promise<void>}
+ */
+export async function playAnimation({ frameDelayMs = 400 } = {}) {
+  const frames = eggFrames();
+  for (const frame of frames) {
+    // Clear previous frame using ANSI escape (move up N lines and clear)
+    const lines = frame.split("\n").length;
+    if (frames.indexOf(frame) > 0) {
+      // Move cursor up `lines` rows and clear each line
+      process.stdout.write(`\x1B[${lines}A\x1B[J`);
+    }
+    process.stdout.write(frame + "\n");
+    await new Promise((resolve) => setTimeout(resolve, frameDelayMs));
+  }
+}

package/src/onboarding/phases/identity.js

@@ -1,79 +1,79 @@
-/**
- * Identity phase — collects user name, agent name, and goal, then writes
- * soul.md, purpose.md, and the agent manifest TOML.
- */
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { soulTemplate, purposeTemplate, agentTemplate, writeWorkspaceContextFiles } from "../templates.js";
-import { prompt, bold, green } from "../tui.js";
-
-export function resolveDefaultAgentName(userInfoImpl = os.userInfo) {
-  try {
-    return String(userInfoImpl()?.username || "").trim();
-  } catch {
-    return "";
-  }
-}
-
-/**
- * Write identity files for an agent.
- *
- * @param {{
- *   installDir: string,
- *   userName: string,
- *   agentName: string,
- *   agentId: string,
- *   userGoal: string,
- * }} options
- */
-export function writeIdentity({ installDir, userName, agentName, agentId, userGoal, workspaceRoot }) {
-  const date = new Date().toISOString().slice(0, 10);
-  const identityDir = path.join(installDir, "config", "identity");
-  const agentsDir = path.join(installDir, "config", "agents");
-
-  // 1. Write soul.md
-  const soulPath = path.join(identityDir, `${agentId}-soul.md`);
-  fs.writeFileSync(soulPath, soulTemplate({ agentName, userName, date }), "utf8");
-
-  // 2. Write purpose.md
-  const purposePath = path.join(identityDir, `${agentId}-purpose.md`);
-  fs.writeFileSync(purposePath, purposeTemplate({ agentName, userName, userGoal, date }), "utf8");
-
-  // 3. Write agent manifest TOML (includes workspace_context_files)
-  const resolvedWorkspaceRoot = (workspaceRoot || path.join(installDir, "workspace")).replace(/\\/g, "/");
-  const manifestPath = path.join(agentsDir, `${agentId}.toml`);
-  fs.writeFileSync(manifestPath, agentTemplate({ agentId, installDir, workspaceRoot: resolvedWorkspaceRoot }), "utf8");
-
-  // 4. Write blank workspace context files (SOUL.md, USER.md, MEMORY.md, AGENTS.md, TOOLS.md)
-  //    Skips files that already exist — safe to run on existing workspaces
-  writeWorkspaceContextFiles({ workspaceRoot: resolvedWorkspaceRoot, agentName, userName, agentId });
-}
-
-/**
- * Interactive identity phase — prompts the user for name, agent name, and
- * goal, then calls writeIdentity().
- *
- * @param {{ installDir: string }} options
- * @returns {Promise<{ userName: string, agentName: string, agentId: string, userGoal: string }>}
- */
-export async function askIdentity({ installDir }) {
-  console.log(`\n${bold("── Identity ──────────────────────────────────")}`);
-
-  const userName = await prompt("Your name", "");
-  const defaultAgentName = resolveDefaultAgentName();
-  let agentName = await prompt("Agent name", defaultAgentName);
-  while (!String(agentName || "").trim()) {
-    console.log("  Agent name is required.");
-    agentName = await prompt("Agent name", defaultAgentName);
-  }
-  const agentId = agentName.toLowerCase().replace(/[^a-z0-9-]/g, "-");
-  const userGoal = await prompt("What will your agent help you with?", "");
-
-  writeIdentity({ installDir, userName, agentName, agentId, userGoal });
-
-  console.log(`\n  ${green("✓")} Identity written for ${bold(agentName)}`);
-
-  return { userName, agentName, agentId, userGoal };
-}
+/**
+ * Identity phase — collects user name, agent name, and goal, then writes
+ * soul.md, purpose.md, and the agent manifest TOML.
+ */
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { soulTemplate, purposeTemplate, agentTemplate, writeWorkspaceContextFiles } from "../templates.js";
+import { prompt, bold, green } from "../tui.js";
+
+export function resolveDefaultAgentName(userInfoImpl = os.userInfo) {
+  try {
+    return String(userInfoImpl()?.username || "").trim();
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * Write identity files for an agent.
+ *
+ * @param {{
+ *   installDir: string,
+ *   userName: string,
+ *   agentName: string,
+ *   agentId: string,
+ *   userGoal: string,
+ * }} options
+ */
+export function writeIdentity({ installDir, userName, agentName, agentId, userGoal, workspaceRoot }) {
+  const date = new Date().toISOString().slice(0, 10);
+  const identityDir = path.join(installDir, "config", "identity");
+  const agentsDir = path.join(installDir, "config", "agents");
+
+  // 1. Write soul.md
+  const soulPath = path.join(identityDir, `${agentId}-soul.md`);
+  fs.writeFileSync(soulPath, soulTemplate({ agentName, userName, date }), "utf8");
+
+  // 2. Write purpose.md
+  const purposePath = path.join(identityDir, `${agentId}-purpose.md`);
+  fs.writeFileSync(purposePath, purposeTemplate({ agentName, userName, userGoal, date }), "utf8");
+
+  // 3. Write agent manifest TOML (includes workspace_context_files)
+  const resolvedWorkspaceRoot = (workspaceRoot || path.join(installDir, "workspace")).replace(/\\/g, "/");
+  const manifestPath = path.join(agentsDir, `${agentId}.toml`);
+  fs.writeFileSync(manifestPath, agentTemplate({ agentId, installDir, workspaceRoot: resolvedWorkspaceRoot }), "utf8");
+
+  // 4. Write blank workspace context files (SOUL.md, USER.md, MEMORY.md, AGENTS.md, TOOLS.md)
+  //    Skips files that already exist — safe to run on existing workspaces
+  writeWorkspaceContextFiles({ workspaceRoot: resolvedWorkspaceRoot, agentName, userName, agentId });
+}
+
+/**
+ * Interactive identity phase — prompts the user for name, agent name, and
+ * goal, then calls writeIdentity().
+ *
+ * @param {{ installDir: string }} options
+ * @returns {Promise<{ userName: string, agentName: string, agentId: string, userGoal: string }>}
+ */
+export async function askIdentity({ installDir }) {
+  console.log(`\n${bold("── Identity ──────────────────────────────────")}`);
+
+  const userName = await prompt("Your name", "");
+  const defaultAgentName = resolveDefaultAgentName();
+  let agentName = await prompt("Agent name", defaultAgentName);
+  while (!String(agentName || "").trim()) {
+    console.log("  Agent name is required.");
+    agentName = await prompt("Agent name", defaultAgentName);
+  }
+  const agentId = agentName.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+  const userGoal = await prompt("What will your agent help you with?", "");
+
+  writeIdentity({ installDir, userName, agentName, agentId, userGoal });
+
+  console.log(`\n  ${green("✓")} Identity written for ${bold(agentName)}`);
+
+  return { userName, agentName, agentId, userGoal };
+}