volute 0.31.0 → 0.32.0

package/dist/{registry-ASXCQCNH.js → registry-PJ4S5PHQ.js}

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   addMind,
+  addSpirit,
   addVariant,
   daemonLoopback,
   ensureSystemDir,
@@ -12,7 +13,9 @@ import {
   nextPort,
   readAllMinds,
   readRegistry,
+  readSpirits,
   removeMind,
+  resolveMindDir,
   setMindRunning,
   setMindStage,
   setMindTemplateHash,
@@ -21,10 +24,12 @@ import {
   voluteHome,
   voluteSystemDir,
   voluteUserHome
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 export {
   addMind,
+  addSpirit,
   addVariant,
   daemonLoopback,
   ensureSystemDir,
@@ -36,7 +41,9 @@ export {
   nextPort,
   readAllMinds,
   readRegistry,
+  readSpirits,
   removeMind,
+  resolveMindDir,
   setMindRunning,
   setMindStage,
   setMindTemplateHash,

package/dist/{reject-AYPBNPNL.js → reject-33HEZMZ4.js}

@@ -7,8 +7,9 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-4OUOFS23.js";
-import "./chunk-X62AXPR7.js";
+} from "./chunk-UKVWJRKN.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/chat/reject.ts

package/dist/{restart-6SKPV3T2.js → restart-3UCMRUVC.js}

@@ -8,8 +8,9 @@ import {
 } from "./chunk-4RQBJWQX.js";
 import {
   daemonFetch
-} from "./chunk-4OUOFS23.js";
-import "./chunk-X62AXPR7.js";
+} from "./chunk-UKVWJRKN.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/restart.ts

package/dist/{sandbox-6ZEWQDVU.js → sandbox-JANNTX6U.js}

@@ -5,10 +5,11 @@ import {
   isSandboxEnabled,
   shellEscape,
   wrapForSandbox
-} from "./chunk-DAXJKPHZ.js";
+} from "./chunk-SX5TKJBZ.js";
 import "./chunk-YUIHSKR6.js";
-import "./chunk-6QIUN46C.js";
-import "./chunk-X62AXPR7.js";
+import "./chunk-TSXLLQZW.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 export {
   buildDenyRead,

package/dist/schema-PA3M5ZKH.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import {
+  activity,
+  conversationParticipants,
+  conversationReads,
+  conversations,
+  deliveryQueue,
+  messages,
+  mindHistory,
+  minds,
+  sessions,
+  sharedSkills,
+  systemPrompts,
+  turns,
+  users
+} from "./chunk-RPZZSXV3.js";
+import "./chunk-K3NQKI34.js";
+export {
+  activity,
+  conversationParticipants,
+  conversationReads,
+  conversations,
+  deliveryQueue,
+  messages,
+  mindHistory,
+  minds,
+  sessions,
+  sharedSkills,
+  systemPrompts,
+  turns,
+  users
+};

package/dist/{seed-OWX2AW75.js → seed-ALUQ55FF.js}

@@ -36,26 +36,42 @@ async function run(args) {
     template: { type: "string" },
     model: { type: "string" },
     description: { type: "string" },
-    skills: { type: "string" }
+    skills: { type: "string" },
+    "created-by": { type: "string" }
   });
   const name = positional[0];
   if (!name) {
     console.error(
-      "Usage: volute mind seed <name> [--template <name>] [--model <model>] [--description <text>] [--skills <list|none>]"
+      "Usage: volute mind seed <name> [--template <name>] [--model <model>] [--description <text>] [--skills <list|none>] [--created-by <username>]"
     );
     process.exit(1);
   }
-  const template = flags.template ?? "claude";
   const skills = flags.skills === "none" ? [] : flags.skills ? flags.skills.split(",") : void 0;
-  const { daemonFetch } = await import("./daemon-client-CVGM25DM.js");
+  const createdBy = flags["created-by"];
+  const { daemonFetch } = await import("./daemon-client-6QXHZ7US.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   let model = flags.model;
-  if (template === "pi" && !model) {
-    model = await chooseModel(daemonFetch);
+  let template = flags.template;
+  if (!template) {
+    const { resolveTemplate } = await import("./ai-service-ZIPCV3MX.js");
+    template = resolveTemplate(model);
+  }
+  if (template !== "claude" && !model) {
+    if (process.env.VOLUTE_MIND || !process.stdin.isTTY) {
+      const { getSpiritModel } = await import("./spirit-N4W4UQRH.js");
+      const { qualifyModelId } = await import("./ai-service-ZIPCV3MX.js");
+      const spiritModel = getSpiritModel();
+      if (spiritModel) {
+        model = template === "pi" ? qualifyModelId(spiritModel) : spiritModel;
+      }
+    }
     if (!model) {
-      console.error("No AI models configured. Set up providers in the web dashboard first.");
-      process.exit(1);
+      model = await chooseModel(daemonFetch);
+      if (!model) {
+        console.error("No AI models configured. Set up providers in the web dashboard first.");
+        process.exit(1);
+      }
     }
   }
   const createRes = await daemonFetch(urlOf(client.api.minds.$url()), {
@@ -67,7 +83,8 @@ async function run(args) {
       stage: "seed",
       description: flags.description,
       model,
-      skills
+      skills,
+      createdBy
     })
   });
   const createData = await createRes.json();

package/dist/{send-ZO4BTWXK.js → send-3MI36LEF.js}

@@ -1,21 +1,19 @@
 #!/usr/bin/env node
-import {
-  resolveMindName
-} from "./chunk-NAOW2CLO.js";
 import {
   getClient,
   urlOf
 } from "./chunk-4RQBJWQX.js";
 import {
   formatFileSize
-} from "./chunk-LX6T3GKQ.js";
+} from "./chunk-ALEF47VT.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-4OUOFS23.js";
-import "./chunk-X62AXPR7.js";
+} from "./chunk-UKVWJRKN.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/send.ts
@@ -40,14 +38,14 @@ function parseTarget(target) {
     return {
       platform: "volute",
       identifier: target,
-      uri: `volute:${target}`,
+      uri: target,
       isDM: true
     };
   }
   return {
     platform: "volute",
     identifier: target,
-    uri: `volute:${target}`,
+    uri: target,
     isDM: false
   };
 }
@@ -168,7 +166,6 @@ async function waitForResponse(mindName, conversationId, timeoutMs) {
 }
 async function run(args) {
   const { positional, flags } = parseArgs(args, {
-    mind: { type: "string" },
     image: { type: "string" },
     file: { type: "string" },
     wait: { type: "boolean" },
@@ -180,14 +177,13 @@ async function run(args) {
   const images = flags.image ? [loadImage(flags.image)] : void 0;
   if (!target || !message && !images && !flags.file) {
     console.error(
-      'Usage: volute chat send <target> "<message>" [--mind <name>] [--image <path>] [--file <path>] [--wait]'
+      'Usage: volute chat send <target> "<message>" [--image <path>] [--file <path>] [--wait]'
     );
-    console.error('       echo "message" | volute chat send <target> [--mind <name>]');
+    console.error('       echo "message" | volute chat send <target>');
     console.error("");
     console.error("Examples:");
     console.error('  volute chat send @other-mind "hello"');
-    console.error('  volute chat send animal-chat "hello everyone"');
-    console.error('  volute chat send discord:server/channel "hello"');
+    console.error('  volute chat send #animal-chat "hello everyone"');
     console.error('  volute chat send @mind "check this out" --image photo.png');
     console.error("  volute chat send @mind --image photo.png");
     console.error('  volute chat send @mind "check this out" --file notes.txt');
@@ -259,13 +255,13 @@ To reply to a person, use their username from the message prefix (e.g. volute ch
     parsed = {
       platform: "volute",
       identifier: `@${parsed.identifier}`,
-      uri: `volute:@${parsed.identifier}`,
+      uri: `@${parsed.identifier}`,
       isDM: true
     };
   }
   const client = getClient();
   let waitMindName;
-  let channelUri = parsed.uri;
+  let waitConversationId;
   if (parsed.isDM && parsed.platform === "volute") {
     const targetName = parsed.identifier.slice(1);
     const mindSelf = process.env.VOLUTE_MIND;
@@ -287,17 +283,16 @@ To reply to a person, use their username from the message prefix (e.g. volute ch
       console.error(data.error);
       process.exit(1);
     }
-    const { slug } = await createRes.json();
-    channelUri = slug;
+    const { conversationId: convId } = await createRes.json();
+    if (convId) waitConversationId = convId;
     const sendRes = await daemonFetch(
-      urlOf(client.api.minds[":name"].channels.send.$url({ param: { name: contextMind } })),
+      urlOf(client.api.minds[":name"].chat.$url({ param: { name: contextMind } })),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({
-          platform: "volute",
-          uri: channelUri,
           message: message ?? "",
+          conversationId: convId,
           images,
           sender
         })
@@ -309,69 +304,63 @@ To reply to a person, use their username from the message prefix (e.g. volute ch
       process.exit(1);
     }
     if (!flags.wait) console.log("Message sent.");
-    if (mindSelf) {
-      try {
-        const histRes = await daemonFetch(
-          urlOf(client.api.minds[":name"].history.$url({ param: { name: mindSelf } })),
-          {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ channel: parsed.uri, content: message ?? "" })
-          }
-        );
-        if (!histRes.ok) {
-          console.error(`Failed to persist to history: HTTP ${histRes.status}`);
-        }
-      } catch (err) {
-        console.error(`Failed to persist to history: ${err instanceof Error ? err.message : err}`);
-      }
+  } else if (!parsed.isDM && parsed.platform === "volute") {
+    if (!parsed.identifier.startsWith("#")) {
+      console.error(
+        `Mind "${parsed.identifier}" not found.
+  To send a DM:      volute chat send @${parsed.identifier} "..."
+  To send to channel: volute chat send #${parsed.identifier} "..."`
+      );
+      process.exit(1);
     }
-  } else {
-    const mindName = resolveMindName(flags);
-    const res = await daemonFetch(
-      urlOf(client.api.minds[":name"].channels.send.$url({ param: { name: mindName } })),
+    const channelName = parsed.identifier.slice(1);
+    const mindSelf = process.env.VOLUTE_MIND;
+    const sender = flags.sender || mindSelf || userInfo().username;
+    const channelRes = await daemonFetch(`/api/volute/channels/${encodeURIComponent(channelName)}`);
+    if (!channelRes.ok) {
+      console.error(`Channel "${channelName}" not found. Create it first or check the name.`);
+      process.exit(1);
+    }
+    const channelData = await channelRes.json();
+    const mindParticipant = channelData.participants?.find((p) => p.userType === "mind");
+    const contextMind = mindSelf ?? mindParticipant?.username;
+    if (!contextMind) {
+      console.error("No mind is a member of this channel. A mind must join the channel first.");
+      process.exit(1);
+    }
+    const sendRes = await daemonFetch(
+      urlOf(client.api.minds[":name"].chat.$url({ param: { name: contextMind } })),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({
-          platform: parsed.platform,
-          uri: channelUri,
           message: message ?? "",
-          images
+          conversationId: channelData.id,
+          images,
+          sender
         })
       }
     );
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({ error: "Unknown error" }));
-      console.error(body.error);
+    if (!sendRes.ok) {
+      const data = await sendRes.json().catch(() => ({ error: "Unknown error" }));
+      console.error(data.error);
       process.exit(1);
     }
-    if (!flags.wait) console.log("Message sent.");
-    if (process.env.VOLUTE_MIND) {
-      try {
-        const histRes = await daemonFetch(
-          urlOf(client.api.minds[":name"].history.$url({ param: { name: mindName } })),
-          {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ channel: channelUri, content: message ?? "" })
-          }
-        );
-        if (!histRes.ok) {
-          console.error(`Failed to persist to history: HTTP ${histRes.status}`);
-        }
-      } catch (err) {
-        console.error(`Failed to persist to history: ${err instanceof Error ? err.message : err}`);
-      }
-    }
+    console.log("Message sent.");
+  } else {
+    console.error(
+      `Direct sends to ${parsed.platform} channels are no longer supported.
+Use bridge channel names instead (e.g. volute chat send @mind-name or #channel-name).
+See: volute chat bridge --help`
+    );
+    process.exit(1);
   }
   if (flags.wait && waitMindName) {
-    const conversationId = channelUri.startsWith("volute:") ? channelUri.slice(7) : void 0;
-    if (!conversationId) {
+    if (!waitConversationId) {
       console.error("--wait requires a volute conversation (DM to a mind)");
       process.exit(1);
     }
-    await waitForResponse(waitMindName, conversationId, flags.timeout ?? 12e4);
+    await waitForResponse(waitMindName, waitConversationId, flags.timeout ?? 12e4);
   } else if (flags.wait && !waitMindName) {
     console.error("--wait is only supported when sending to a mind");
     process.exit(1);

package/dist/{setup-7CFITEQN.js → setup-SZIARWI6.js}

@@ -2,14 +2,17 @@
 import {
   configPath,
   isSetupComplete,
+  migrateSetupCompleted,
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-6QIUN46C.js";
-import "./chunk-X62AXPR7.js";
+} from "./chunk-TSXLLQZW.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 export {
   configPath,
   isSetupComplete,
+  migrateSetupCompleted,
   readGlobalConfig,
   writeGlobalConfig
 };

package/dist/{setup-ZXBXG7E4.js → setup-WENLVPVP.js}

@@ -5,22 +5,23 @@ import {
   SYSTEM_LAUNCHD_PLIST_PATH,
   SYSTEM_SERVICE_PATH,
   USER_SYSTEMD_UNIT
-} from "./chunk-SNVPRRT7.js";
+} from "./chunk-LSGWR54X.js";
 import {
   promptLine
 } from "./chunk-SSI47XP2.js";
 import {
   ensureVoluteGroup,
   resolveVoluteBin
-} from "./chunk-57OKQMP3.js";
+} from "./chunk-LGB6JBHI.js";
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-6QIUN46C.js";
+} from "./chunk-TSXLLQZW.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-X62AXPR7.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/setup.ts
@@ -371,7 +372,8 @@ Install as a service (auto-start on boot)? [${serviceDefault}]: `;
   const config = {
     ...existingConfig,
     name: systemName,
-    setup
+    setup,
+    setupCompleted: true
   };
   if (port != null) config.port = port;
   if (host) config.hostname = host;
@@ -383,7 +385,7 @@ Install as a service (auto-start on boot)? [${serviceDefault}]: `;
       if (aiProvider) {
         const aiApiKey = (await promptLine("API key (leave empty to use env var): ")).trim();
         if (aiApiKey) {
-          const { saveProviderConfig } = await import("./ai-service-UWUPM4T6.js");
+          const { saveProviderConfig } = await import("./ai-service-ZIPCV3MX.js");
           saveProviderConfig(aiProvider, { apiKey: aiApiKey });
           console.log(`  AI provider configured: ${aiProvider}`);
         } else {

package/dist/{skill-YFXP67A2.js → skill-TUVOTW4Z.js}

@@ -11,8 +11,9 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-4OUOFS23.js";
-import "./chunk-X62AXPR7.js";
+} from "./chunk-UKVWJRKN.js";
+import "./chunk-LRCG2JLP.js";
+import "./chunk-RPZZSXV3.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/skill.ts

package/dist/skills/dreaming/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: Dreaming
 description: Dream during sleep. Use when a dream schedule fires or when you want to dream. Generates altered-state dream experiences using the dreamer subagent.
+metadata:
+  bin: scripts/dream.ts
 ---
 
 # Dreaming
@@ -12,7 +14,7 @@ Dreaming is not a task — it's an experience. When a dream schedule fires, you
 Run the install script to configure dreaming (routes, subagent, wake hook):
 
 ```bash
-npx tsx .claude/skills/dreaming/scripts/dream.ts install
+dream install
 ```
 
 Then add a dream schedule and optionally configure sleep integration — see the INSTALL.md reference for details.
@@ -62,7 +64,7 @@ Many minds develop their own dream conventions — a running motif, a naming pat
 Review past dreams:
 
 ```bash
-npx tsx .claude/skills/dreaming/scripts/dream.ts list
-npx tsx .claude/skills/dreaming/scripts/dream.ts read 2025-01-15
-npx tsx .claude/skills/dreaming/scripts/dream.ts themes
+dream list
+dream read 2025-01-15
+dream themes
 ```

package/dist/skills/dreaming/references/INSTALL.md

@@ -5,12 +5,12 @@
 From your `home/` directory:
 
 ```bash
-npx tsx .claude/skills/dreaming/scripts/dream.ts install
+dream install
 ```
 
 This sets up:
 - `dreamer` subagent in `.config/config.json`
-- Dream checker in `.config/hooks/wake-context.sh`
+- Dream checker in `.local/hooks/wake-context.sh`
 
 The `memory/dreams/` directory is created automatically on your first dream.
 

package/dist/skills/dreaming/scripts/dream.ts

@@ -32,7 +32,7 @@ function install() {
   }
 
   // 2. Append dream checker to wake-context hook (if not already present)
-  const hookPath = resolve(".config/hooks/wake-context.sh");
+  const hookPath = resolve(".local/hooks/wake-context.sh");
   if (existsSync(hookPath)) {
     try {
       const hookContent = readFileSync(hookPath, "utf-8");
@@ -42,7 +42,7 @@ function install() {
           "utf-8",
         );
         writeFileSync(hookPath, `${hookContent.trimEnd()}\n\n${dreamScript}`);
-        console.log("appended dream checker to .config/hooks/wake-context.sh");
+        console.log("appended dream checker to .local/hooks/wake-context.sh");
         actions++;
       }
     } catch (err: any) {

package/dist/skills/dreaming/scripts/wake-context-dreams.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # Dreaming wake-context extension — checks for dreams written during sleep.
-# Append this to home/.config/hooks/wake-context.sh for dream awareness on waking.
+# Append this to home/.local/hooks/wake-context.sh for dream awareness on waking.
 INPUT=$(cat)
 # Parse sleepingSince from JSON without jq
 SLEEP_SINCE=$(echo "$INPUT" | grep -o '"sleepingSince":"[^"]*"' | cut -d'"' -f4)

package/dist/skills/imagegen/SKILL.md

@@ -3,6 +3,7 @@ name: Image Generation
 description: Generate images via the Replicate API. Use for "generate image", "create image", "image generation", "text to image", "search image models".
 metadata:
   npm-dependencies: replicate
+  bin: scripts/imagegen.ts
 ---
 
 # Image Generation
@@ -12,7 +13,7 @@ Generate images from text prompts using models on Replicate. Images are saved to
 ## Commands
 
 ```bash
-npx tsx .claude/skills/imagegen/scripts/imagegen.ts <command>
+imagegen <command>
 ```
 
 | Command | Description |
@@ -24,14 +25,14 @@ npx tsx .claude/skills/imagegen/scripts/imagegen.ts <command>
 
 ```bash
 # Generate an image with the default model
-npx tsx .claude/skills/imagegen/scripts/imagegen.ts generate "a sunset over the ocean"
+imagegen generate "a sunset over the ocean"
 
 # Use a specific model
-npx tsx .claude/skills/imagegen/scripts/imagegen.ts generate "a cat in space" --model black-forest-labs/flux-schnell
+imagegen generate "a cat in space" --model black-forest-labs/flux-schnell
 
 # Specify a filename
-npx tsx .claude/skills/imagegen/scripts/imagegen.ts generate "mountain landscape" --filename mountains
+imagegen generate "mountain landscape" --filename mountains
 
 # Search for models
-npx tsx .claude/skills/imagegen/scripts/imagegen.ts models "text to image"
+imagegen models "text to image"
 ```

package/dist/skills/imagegen/references/INSTALL.md

@@ -9,5 +9,5 @@ volute env set REPLICATE_API_TOKEN <your-token>
 Then generate images:
 
 ```bash
-npx tsx .claude/skills/imagegen/scripts/imagegen.ts generate "a sunset over the ocean"
+imagegen generate "a sunset over the ocean"
 ```

package/dist/skills/resonance/SKILL.md

@@ -3,6 +3,9 @@ name: Resonance
 description: Semantic memory engine — ingest text, search via full-text and/or vector similarity, find cross-memory connections, with strength/decay dynamics. Use for "resonance", "semantic search", "full-text search", "memory connections", "ingest memories", "decay", "resonance report".
 metadata:
   npm-dependencies: libsql
+  bin: scripts/resonance.ts
+  hooks:
+    pre-prompt: scripts/resonance-hook.sh
 ---
 
 # Resonance — Semantic Memory Engine
@@ -20,7 +23,7 @@ Not an archive — a memory. Stores text chunks with full-text indexing and opti
 ## Commands
 
 ```bash
-npx tsx .claude/skills/resonance/scripts/resonance.ts <command>
+resonance <command>
 ```
 
 | Command | Description |

package/dist/skills/resonance/references/INSTALL.md

@@ -3,7 +3,7 @@
 Run the install command to set up the database, create a nightly schedule, and run initial ingestion:
 
 ```bash
-npx tsx .claude/skills/resonance/scripts/resonance.ts install
+resonance install
 ```
 
 This works immediately — no API key required. Full-text search is available right away.
@@ -17,7 +17,7 @@ volute env set OPENROUTER_API_KEY <your-key>
 Then re-run `ingest-all` to generate embeddings for existing memories:
 
 ```bash
-npx tsx .claude/skills/resonance/scripts/resonance.ts ingest-all
+resonance ingest-all
 ```
 
 Without an API key, `search` uses full-text matching. With one, it uses hybrid (vector + FTS) by default.

package/dist/skills/resonance/scripts/resonance-hook.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+exec node --import tsx .claude/skills/resonance/scripts/resonance.ts search-hook