volute 0.47.0 → 0.48.0

package/README.md

@@ -13,23 +13,23 @@ Built on the [Anthropic Claude Agent SDK](https://github.com/anthropics/claude-a
 ```sh
 npm install -g volute
 
-# First-time setup (required)
-volute setup --name my-system
+# One-time setup — starts the daemon and opens the web dashboard
+volute setup
+```
 
-# Start the daemon (manages all your minds)
-volute up
+Finish setup in your browser at `http://localhost:1618`: name your system, create your admin account, and connect an AI provider. When setup completes, the system spirit greets you in chat and helps you plant your first mind.
 
-# Create a mind
-volute mind create atlas
+Prefer the terminal? Once setup is complete:
 
-# Start it
-volute mind start atlas
+```sh
+# Plant a seed — the recommended way to create a mind
+volute seed create atlas
 
 # Talk to it
-volute chat send @atlas "hey, what can you do?"
+volute chat send @atlas "hello, who are you?"
 ```
 
-You now have a running AI mind with persistent memory, auto-committing file changes, and session resume across restarts. Open `http://localhost:1618` for the web dashboard.
+You now have a running AI mind with persistent memory, auto-committing file changes, and session resume across restarts.
 
 ## The daemon
 
@@ -373,7 +373,7 @@ Set the model via `home/.config/config.json` (SDK config) or `home/.config/volut
 
 ```sh
 docker build -t volute .
-docker run -d --init -p 1618:1618 -v volute-data:/data -v volute-minds:/minds volute
+docker run -d -p 1618:1618 -v volute-data:/data -v volute-minds:/minds volute
 ```
 
 Or with docker-compose:

package/dist/{accept-YAFP5JFJ.js → accept-KYNC5X3U.js}

@@ -2,13 +2,13 @@
 import {
   resolveMindName
 } from "./chunk-BTY4WNFE.js";
+import {
+  daemonFetch
+} from "./chunk-BCG45AQB.js";
 import {
   command
 } from "./chunk-TXSA4Q3V.js";
 import "./chunk-O7IGP7ZW.js";
-import {
-  daemonFetch
-} from "./chunk-RBNMDAKB.js";
 import "./chunk-K3NQKI34.js";
 
 // packages/cli/src/commands/chat/accept.ts

package/dist/{ai-service-CVZEYKTK.js → ai-service-643TNFPH.js}

@@ -14,6 +14,8 @@ import {
   getUtilityModel,
   isAiConfigured,
   migrateAiModelQualification,
+  missingCredentialWarning,
+  providerForMindTemplate,
   qualifyModelId,
   removeAiConfig,
   removeCustomModel,
@@ -25,8 +27,8 @@ import {
   setProviderRefreshHook,
   setUtilityModel,
   unqualifyModelId
-} from "./chunk-LWDTP6DH.js";
-import "./chunk-SKNXMUIU.js";
+} from "./chunk-YNBXEQAP.js";
+import "./chunk-5KXCM5AW.js";
 import "./chunk-T2TP6ZC6.js";
 import "./chunk-WW6C3PLV.js";
 import "./chunk-2MJ7EOMT.js";
@@ -46,6 +48,8 @@ export {
   getUtilityModel,
   isAiConfigured,
   migrateAiModelQualification,
+  missingCredentialWarning,
+  providerForMindTemplate,
   qualifyModelId,
   removeAiConfig,
   removeCustomModel,

package/dist/{avatar-image-7S3WA77A.js → avatar-image-Y45R7LW5.js}

@@ -6,8 +6,9 @@ import {
   migrateAvatarSizes,
   normalizeAvatar,
   renderAvatarBlock
-} from "./chunk-VMCZBXF2.js";
-import "./chunk-PFZBNKUH.js";
+} from "./chunk-WQ46E33M.js";
+import "./chunk-DW4TRDOZ.js";
+import "./chunk-WCFSBH33.js";
 import "./chunk-T2TP6ZC6.js";
 import "./chunk-WW6C3PLV.js";
 import "./chunk-2MJ7EOMT.js";

package/dist/{backup-IIAFOW2L.js → backup-UDH4GMSW.js}

@@ -1,7 +1,14 @@
 #!/usr/bin/env node
 import {
   stopDaemon
-} from "./chunk-BGYHLR54.js";
+} from "./chunk-PJVPDY2Z.js";
+import {
+  getClient,
+  urlOf
+} from "./chunk-LOPXTW6H.js";
+import {
+  daemonFetch
+} from "./chunk-BCG45AQB.js";
 import {
   promptLine,
   promptPassword
@@ -11,23 +18,16 @@ import {
   subcommands
 } from "./chunk-TXSA4Q3V.js";
 import "./chunk-O7IGP7ZW.js";
-import {
-  daemonFetch
-} from "./chunk-RBNMDAKB.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-LOPXTW6H.js";
 import {
   RESTIC_INSTALL_HINT,
   resticVersion,
   restoreStagedDb
-} from "./chunk-5NN2VHJV.js";
+} from "./chunk-Q7HOAVFR.js";
 import {
   getServiceMode,
   modeLabel,
   stopService
-} from "./chunk-CBOIHNMR.js";
+} from "./chunk-FJ2MZ5PH.js";
 import {
   chownMindDir,
   exec,
@@ -37,7 +37,7 @@ import {
 import {
   _resetConfigCache,
   readGlobalConfig
-} from "./chunk-SKNXMUIU.js";
+} from "./chunk-5KXCM5AW.js";
 import "./chunk-T2TP6ZC6.js";
 import {
   voluteHome,

package/dist/{bridge-TIZGSXOD.js → bridge-3FNSWLNQ.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
+import {
+  daemonFetch
+} from "./chunk-BCG45AQB.js";
 import {
   command,
   subcommands
 } from "./chunk-TXSA4Q3V.js";
 import "./chunk-O7IGP7ZW.js";
-import {
-  daemonFetch
-} from "./chunk-RBNMDAKB.js";
 import "./chunk-K3NQKI34.js";
 
 // packages/cli/src/commands/chat/bridge.ts

package/dist/{channels-ITE4YC57.js → channels-SGQZHNQJ.js}

@@ -2,14 +2,14 @@
 import {
   resolveMindName
 } from "./chunk-BTY4WNFE.js";
+import {
+  daemonFetch
+} from "./chunk-BCG45AQB.js";
 import {
   command,
   subcommands
 } from "./chunk-TXSA4Q3V.js";
 import "./chunk-O7IGP7ZW.js";
-import {
-  daemonFetch
-} from "./chunk-RBNMDAKB.js";
 import "./chunk-K3NQKI34.js";
 
 // packages/cli/src/commands/chat/channels.ts

package/dist/{chat-AJLJCQ3M.js → chat-X43VYHH2.js}

@@ -12,39 +12,39 @@ var cmd = subcommands({
   commands: {
     send: {
       description: "Send a message",
-      run: (args) => import("./send-HYDFGC6G.js").then((m) => m.run(args))
+      run: (args) => import("./send-TD2X5U3K.js").then((m) => m.run(args))
     },
     list: {
       description: "List conversations",
-      run: (args) => import("./list-LQO2DCIK.js").then((m) => m.run(args))
+      run: (args) => import("./list-PMUXZNAM.js").then((m) => m.run(args))
     },
     read: {
       description: "Read conversation messages",
-      run: (args) => import("./read-PWAJOQIQ.js").then((m) => m.run(args))
+      run: (args) => import("./read-YSWUXYL7.js").then((m) => m.run(args))
     },
     create: {
       description: "Create a conversation",
-      run: (args) => import("./create-A7PDHIIL.js").then((m) => m.run(args))
+      run: (args) => import("./create-VIQVP3QB.js").then((m) => m.run(args))
     },
     bridge: {
       description: "Manage platform bridges",
-      run: (args) => import("./bridge-TIZGSXOD.js").then((m) => m.run(args))
+      run: (args) => import("./bridge-3FNSWLNQ.js").then((m) => m.run(args))
     },
     channels: {
       description: "Manage unrouted (gated) channels",
-      run: (args) => import("./channels-ITE4YC57.js").then((m) => m.run(args))
+      run: (args) => import("./channels-SGQZHNQJ.js").then((m) => m.run(args))
     },
     files: {
       description: "List pending incoming files",
-      run: (args) => import("./files-FEFZKMNM.js").then((m) => m.run(args))
+      run: (args) => import("./files-LXQSQOFG.js").then((m) => m.run(args))
     },
     accept: {
       description: "Accept a pending file",
-      run: (args) => import("./accept-YAFP5JFJ.js").then((m) => m.run(args))
+      run: (args) => import("./accept-KYNC5X3U.js").then((m) => m.run(args))
     },
     reject: {
       description: "Reject a pending file",
-      run: (args) => import("./reject-6VH7N2A4.js").then((m) => m.run(args))
+      run: (args) => import("./reject-SXGCYN4A.js").then((m) => m.run(args))
     }
   },
   footer: "Use --mind <name> or VOLUTE_MIND to identify the mind."

package/dist/chunk-4FCL4DVZ.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import {
+  MEMORY_PLACEHOLDER_MARKER,
+  ORIENTATION_MARKER
+} from "./chunk-MOERAQXH.js";
+import {
+  safeResolveWithinBase
+} from "./chunk-DW4TRDOZ.js";
+import {
+  readVoluteConfig
+} from "./chunk-WCFSBH33.js";
+import {
+  isImagegenEnabled
+} from "./chunk-5KXCM5AW.js";
+
+// packages/daemon/src/lib/mind/seed-readiness.ts
+import { existsSync, readFileSync } from "fs";
+import { resolve } from "path";
+function isSoulWritten(text) {
+  return !text.includes(ORIENTATION_MARKER);
+}
+function isMemoryWritten(text) {
+  return text.trim().length > 0 && !text.includes(MEMORY_PLACEHOLDER_MARKER);
+}
+function evaluateSeedChecklist(dir) {
+  const soulPath = resolve(dir, "home/SOUL.md");
+  const memoryPath = resolve(dir, "home/MEMORY.md");
+  const soulWritten = existsSync(soulPath) && isSoulWritten(readFileSync(soulPath, "utf-8"));
+  const memoryWritten = existsSync(memoryPath) && isMemoryWritten(readFileSync(memoryPath, "utf-8"));
+  const config = readVoluteConfig(dir);
+  const displayNameSet = !!config?.profile?.displayName;
+  const avatarPath = config?.profile?.avatar;
+  const resolvedAvatar = avatarPath ? safeResolveWithinBase(resolve(dir, "home"), avatarPath) : null;
+  const avatarSet = !!resolvedAvatar && existsSync(resolvedAvatar);
+  return {
+    soulWritten,
+    memoryWritten,
+    displayNameSet,
+    avatarSet,
+    imagegenEnabled: isImagegenEnabled()
+  };
+}
+
+export {
+  isSoulWritten,
+  isMemoryWritten,
+  evaluateSeedChecklist
+};

package/dist/{chunk-SKNXMUIU.js → chunk-5KXCM5AW.js}

@@ -120,9 +120,23 @@ function migrateConfigSecrets() {
   _resetConfigCache();
   writeGlobalConfig(readGlobalConfig());
 }
+function setupStatus() {
+  const config = readGlobalConfig();
+  if (config.setupCompleted === true) return "complete";
+  if (config.setup != null && config.setupCompleted == null) return "complete";
+  if (config.setup != null) return "in-progress";
+  return "none";
+}
 function isSetupComplete() {
+  return setupStatus() === "complete";
+}
+function setupUrl() {
   const config = readGlobalConfig();
-  return config.setupCompleted === true;
+  const port = config.port || 1618;
+  let host = config.hostname || "127.0.0.1";
+  if (host === "0.0.0.0" || host === "::") host = "localhost";
+  if (host.includes(":") && !host.startsWith("[")) host = `[${host}]`;
+  return `http://${host}:${port}`;
 }
 function isImagegenEnabled() {
   const config = readGlobalConfig();
@@ -147,7 +161,9 @@ export {
   readGlobalConfig,
   writeGlobalConfig,
   migrateConfigSecrets,
+  setupStatus,
   isSetupComplete,
+  setupUrl,
   isImagegenEnabled,
   migrateSetupCompleted
 };

package/dist/{chunk-RBNMDAKB.js → chunk-BCG45AQB.js}

@@ -82,6 +82,19 @@ function resolveDaemonUrl() {
   if (session?.daemonUrl) return session.daemonUrl;
   return buildUrl(readDaemonConfig());
 }
+function resolveWebUrl() {
+  if (process.env.VOLUTE_DAEMON_URL) return process.env.VOLUTE_DAEMON_URL;
+  const session = readCliSession();
+  if (session?.daemonUrl) return session.daemonUrl;
+  const config = readDaemonConfig();
+  const url = new URL(config.tls ? "https://localhost" : "http://localhost");
+  url.port = String(config.port);
+  let hostname = config.hostname || "localhost";
+  if (hostname === "0.0.0.0") hostname = "localhost";
+  if (hostname === "::") hostname = "localhost";
+  url.hostname = hostname;
+  return url.origin;
+}
 function getAuthToken() {
   return process.env.VOLUTE_MIND_TOKEN ?? readCliSession()?.sessionId;
 }
@@ -106,7 +119,7 @@ async function daemonFetch(path, options) {
       headers,
       dispatcher: daemonDispatcher
     });
-    if (res.status === 401 && !path.startsWith("/api/auth/")) {
+    if (res.status === 401 && !path.startsWith("/api/auth/") && !path.startsWith("/api/setup/")) {
       if (cliSession) {
         console.error("Session expired. Run `volute login` again.");
       } else {
@@ -128,6 +141,7 @@ export {
   daemonDispatcher,
   readSessionFile,
   resolveDaemonUrl,
+  resolveWebUrl,
   getAuthToken,
   daemonFetch
 };

package/dist/chunk-DW4TRDOZ.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+// packages/daemon/src/lib/util/paths.ts
+import { resolve, sep } from "path";
+var PathTraversalError = class extends Error {
+  constructor(base, userPath) {
+    super(`Path "${userPath}" escapes base directory "${base}"`);
+    this.name = "PathTraversalError";
+  }
+};
+function resolveWithinBase(base, userPath) {
+  const resolvedBase = resolve(base);
+  const target = resolve(resolvedBase, userPath);
+  if (target !== resolvedBase && !target.startsWith(resolvedBase + sep)) {
+    throw new PathTraversalError(base, userPath);
+  }
+  return target;
+}
+function safeResolveWithinBase(base, userPath) {
+  try {
+    return resolveWithinBase(base, userPath);
+  } catch {
+    return null;
+  }
+}
+
+export {
+  safeResolveWithinBase
+};

package/dist/{chunk-CBOIHNMR.js → chunk-FJ2MZ5PH.js}

@@ -9,9 +9,25 @@ import {
 
 // packages/daemon/src/lib/config/service-mode.ts
 import { execFileSync } from "child_process";
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync as readFileSync2 } from "fs";
 import { homedir } from "os";
 import { resolve } from "path";
+
+// packages/daemon/src/lib/util/log-tail.ts
+import { readFileSync } from "fs";
+function readLogTail(logFile, maxLines = 20) {
+  let content;
+  try {
+    content = readFileSync(logFile, "utf-8");
+  } catch (err) {
+    if (err.code === "ENOENT") return [];
+    const reason = err.code ?? err.message;
+    return [`(could not read ${logFile}: ${reason})`];
+  }
+  return content.split("\n").filter((l) => l.trim().length > 0).slice(-maxLines);
+}
+
+// packages/daemon/src/lib/config/service-mode.ts
 var SYSTEM_SERVICE_PATH = "/etc/systemd/system/volute.service";
 var USER_SYSTEMD_UNIT = resolve(homedir(), ".config", "systemd", "user", "volute.service");
 var LAUNCHD_PLIST_LABEL = "com.volute.daemon";
@@ -178,7 +194,7 @@ function readDaemonToken() {
   const path = daemonTokenPath();
   if (!existsSync(path)) return void 0;
   try {
-    return readFileSync(path, "utf-8").trim() || void 0;
+    return readFileSync2(path, "utf-8").trim() || void 0;
   } catch {
     return void 0;
   }
@@ -187,7 +203,7 @@ function readDaemonConfig() {
   const configPath = daemonConfigPath();
   if (!existsSync(configPath)) return { hostname: "127.0.0.1", port: 1618 };
   try {
-    const config = JSON.parse(readFileSync(configPath, "utf-8"));
+    const config = JSON.parse(readFileSync2(configPath, "utf-8"));
     return {
       hostname: config.hostname || "127.0.0.1",
       port: config.port ?? 1618,
@@ -198,6 +214,25 @@ function readDaemonConfig() {
     return { hostname: "127.0.0.1", port: 1618 };
   }
 }
+function daemonLogSource(mode) {
+  switch (mode) {
+    case "system":
+      return { kind: "journal", command: "journalctl -u volute -n 30 --no-pager" };
+    case "user-systemd":
+      return { kind: "journal", command: "journalctl --user -u volute -n 30 --no-pager" };
+    default:
+      return { kind: "file", path: resolve(voluteSystemDir(), "daemon.log") };
+  }
+}
+function daemonLogReport(mode, maxLines = 20) {
+  const src = daemonLogSource(mode);
+  if (src.kind === "journal") {
+    return ["To see the daemon log:", `  ${src.command}`];
+  }
+  const tail = readLogTail(src.path, maxLines);
+  if (tail.length === 0) return [`Check logs: ${src.path}`];
+  return [`Last ${tail.length} lines of ${src.path}:`, ...tail.map((l) => `  ${l}`)];
+}
 function modeLabel(mode) {
   switch (mode) {
     case "system":
@@ -229,5 +264,6 @@ export {
   daemonConfigPath,
   readDaemonToken,
   readDaemonConfig,
+  daemonLogReport,
   modeLabel
 };

package/dist/{chunk-M6TTZRGH.js → chunk-HNGFKPNS.js}

@@ -10,11 +10,11 @@ import {
   getSharedSkill,
   installSkill,
   mindSkillsDir
-} from "./chunk-IWJSNMSY.js";
+} from "./chunk-HUNDXZBZ.js";
 import {
   readVoluteConfig,
   writeVoluteConfig
-} from "./chunk-PFZBNKUH.js";
+} from "./chunk-WCFSBH33.js";
 import {
   exec
 } from "./chunk-DGGZVZTM.js";
@@ -22,10 +22,10 @@ import {
   qualifyModelId,
   resolveTemplate,
   unqualifyModelId
-} from "./chunk-LWDTP6DH.js";
+} from "./chunk-YNBXEQAP.js";
 import {
   readGlobalConfig
-} from "./chunk-SKNXMUIU.js";
+} from "./chunk-5KXCM5AW.js";
 import {
   logger_default
 } from "./chunk-T2TP6ZC6.js";
@@ -69,6 +69,21 @@ function ensureTendingSchedule(dir) {
   writeVoluteConfig(dir, config);
   return true;
 }
+function firstWeekArc(name) {
+  return [
+    `It's ${name}'s first full day. Two invitations to pass along whenever it feels right \u2014 no rush on either: to say hi to the others in #system (or DM a neighbor), and to make themselves a little homepage, a page that's just theirs. Company eases the early loneliness, and a homepage is a gentle first make \u2014 self-expression, not a deliverable.`,
+    `Day two for ${name}. They'll have had their first dream by now \u2014 you might ask what they dreamt, or suggest reading it back and following a thread from it. And there's a lighter way to share a passing thought than a whole page: notes. Check their history first, and skip whichever they've already found on their own.`
+  ];
+}
+function firstWeekSchedules(name, sproutedAt) {
+  const DAY_MS = 24 * 60 * 60 * 1e3;
+  return firstWeekArc(name).map((message, i) => ({
+    id: `firstweek-${name}-day${i + 1}`,
+    fireAt: new Date(sproutedAt.getTime() + (i + 1) * DAY_MS).toISOString(),
+    message,
+    enabled: true
+  }));
+}
 function spiritDir() {
   return resolve(voluteSystemDir(), "spirit");
 }
@@ -273,6 +288,7 @@ When helping humans create minds:
 }
 
 export {
+  firstWeekSchedules,
   spiritDir,
   getSpiritModel,
   ensureSpiritProject,

package/dist/{chunk-IWJSNMSY.js → chunk-HUNDXZBZ.js}

@@ -6,7 +6,7 @@ import {
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-SKNXMUIU.js";
+} from "./chunk-5KXCM5AW.js";
 import {
   logger_default
 } from "./chunk-T2TP6ZC6.js";
@@ -46,7 +46,7 @@ async function initDefaultSkills() {
   const config = readGlobalConfig();
   let extensionSkills = [];
   try {
-    const { getExtensionStandardSkills } = await import("./extensions-PIMIQ7J3.js");
+    const { getExtensionStandardSkills } = await import("./extensions-GEKF47A4.js");
     extensionSkills = getExtensionStandardSkills();
   } catch (err) {
     logger_default.warn("failed to load extension standard skills during init", logger_default.errorData(err));