volute 0.32.0 → 0.34.0

package/dist/{setup-SZIARWI6.js → setup-GGMKENLN.js}

@@ -1,16 +1,18 @@
 #!/usr/bin/env node
 import {
   configPath,
+  isImagegenEnabled,
   isSetupComplete,
   migrateSetupCompleted,
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-TSXLLQZW.js";
-import "./chunk-LRCG2JLP.js";
-import "./chunk-RPZZSXV3.js";
-import "./chunk-K3NQKI34.js";
+} from "./chunk-6OWJXUAR.js";
+import "./chunk-N7BLAHNE.js";
+import "./chunk-4JSR7YO7.js";
+import "./chunk-7KJOFUNN.js";
 export {
   configPath,
+  isImagegenEnabled,
   isSetupComplete,
   migrateSetupCompleted,
   readGlobalConfig,

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

@@ -5,24 +5,26 @@ import {
   SYSTEM_LAUNCHD_PLIST_PATH,
   SYSTEM_SERVICE_PATH,
   USER_SYSTEMD_UNIT
-} from "./chunk-LSGWR54X.js";
+} from "./chunk-7F2SW2KD.js";
 import {
   promptLine
 } from "./chunk-SSI47XP2.js";
 import {
-  ensureVoluteGroup,
+  parseArgs
+} from "./chunk-D424ZQGI.js";
+import {
   resolveVoluteBin
-} from "./chunk-LGB6JBHI.js";
+} from "./chunk-U5BTYSAL.js";
+import {
+  ensureVoluteGroup
+} from "./chunk-BDK73LK6.js";
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-TSXLLQZW.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import "./chunk-LRCG2JLP.js";
-import "./chunk-RPZZSXV3.js";
-import "./chunk-K3NQKI34.js";
+} from "./chunk-6OWJXUAR.js";
+import "./chunk-N7BLAHNE.js";
+import "./chunk-4JSR7YO7.js";
+import "./chunk-7KJOFUNN.js";
 
 // src/commands/setup.ts
 import { execFile, execFileSync } from "child_process";
@@ -385,7 +387,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-ZIPCV3MX.js");
+          const { saveProviderConfig } = await import("./ai-service-PSILB5WD.js");
           saveProviderConfig(aiProvider, { apiKey: aiApiKey });
           console.log(`  AI provider configured: ${aiProvider}`);
         } else {

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

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  isCompact
+} from "./chunk-FYCALD4Q.js";
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
@@ -11,10 +14,10 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-UKVWJRKN.js";
-import "./chunk-LRCG2JLP.js";
-import "./chunk-RPZZSXV3.js";
-import "./chunk-K3NQKI34.js";
+} from "./chunk-PLDWHR4D.js";
+import "./chunk-N7BLAHNE.js";
+import "./chunk-4JSR7YO7.js";
+import "./chunk-7KJOFUNN.js";
 
 // src/commands/skill.ts
 async function run(args) {
@@ -87,8 +90,8 @@ async function listSkills(args) {
       console.log("No skills installed.");
       return;
     }
-    console.log(`Skills for ${mindName}:
-`);
+    const compact = isCompact();
+    console.log(`Skills for ${mindName}:${compact ? "" : "\n"}`);
     for (const s of skills) {
       const update = s.updateAvailable ? " (update available)" : "";
       const source = s.upstream ? ` [shared:${s.upstream.source} v${s.upstream.version}]` : "";
@@ -108,10 +111,11 @@ async function listSkills(args) {
       console.log("No shared skills available.");
       return;
     }
-    console.log("Shared skills:\n");
+    const compact = isCompact();
+    console.log(`Shared skills:${compact ? "" : "\n"}`);
     for (const s of skills) {
       console.log(`  ${s.id} \u2014 ${s.name} (v${s.version}, by ${s.author})`);
-      if (s.description) console.log(`    ${s.description}`);
+      if (s.description && !compact) console.log(`    ${s.description}`);
     }
   }
 }

package/dist/skills/imagegen/SKILL.md

@@ -1,14 +1,15 @@
 ---
 name: Image Generation
-description: Generate images via the Replicate API. Use for "generate image", "create image", "image generation", "text to image", "search image models".
+description: Generate images via Replicate or OpenRouter. Use for "generate image", "create image", "image generation", "text to image", "search image models".
 metadata:
-  npm-dependencies: replicate
   bin: scripts/imagegen.ts
 ---
 
 # Image Generation
 
-Generate images from text prompts using models on Replicate. Images are saved to `home/images/`.
+Generate images from text prompts using models on Replicate or OpenRouter. Images are saved to `home/images/`.
+
+Model IDs are provider-prefixed: `replicate:owner/model` or `openrouter:owner/model`.
 
 ## Commands
 
@@ -18,8 +19,8 @@ imagegen <command>
 
 | Command | Description |
 |---------|-------------|
-| `generate "prompt" [--model M] [--filename F]` | Generate an image from a text prompt. Default model: `prunaai/z-image-turbo`. |
-| `models "query"` | Search Replicate for text-to-image models. |
+| `generate "prompt" [--model M] [--filename F]` | Generate an image from a text prompt. Default model: `replicate:prunaai/z-image-turbo`. |
+| `models "query"` | Search configured providers for text-to-image models. |
 
 ## Examples
 
@@ -27,8 +28,11 @@ imagegen <command>
 # Generate an image with the default model
 imagegen generate "a sunset over the ocean"
 
-# Use a specific model
-imagegen generate "a cat in space" --model black-forest-labs/flux-schnell
+# Use a specific Replicate model
+imagegen generate "a cat in space" --model replicate:black-forest-labs/flux-schnell
+
+# Use an OpenRouter model
+imagegen generate "a mountain landscape" --model openrouter:openai/gpt-image-1
 
 # Specify a filename
 imagegen generate "mountain landscape" --filename mountains

package/dist/skills/imagegen/scripts/imagegen.ts

@@ -1,20 +1,19 @@
 #!/usr/bin/env tsx
 
 /**
- * imagegen.ts — image generation via Replicate API
+ * imagegen.ts — image generation via daemon service or direct Replicate API
  *
  * Usage:
  *   imagegen generate "prompt" [--model M] [--filename F]   # generate an image
  *   imagegen models "query"                                 # search for models
+ *
+ * Model IDs are provider-prefixed: replicate:owner/model, openrouter:owner/model
  */
 
 import { mkdirSync } from "node:fs";
 import { writeFile } from "node:fs/promises";
-import { createRequire } from "node:module";
 import { join, resolve } from "node:path";
 
-const replicateRequire = createRequire(import.meta.url);
-
 function getHomePath(): string {
   const mindDir = process.env.VOLUTE_MIND_DIR;
   if (!mindDir) throw new Error("VOLUTE_MIND_DIR not set");
@@ -35,41 +34,152 @@ function getFlag(args: string[], flag: string): string | undefined {
   return undefined;
 }
 
-async function generate(args: string[]): Promise<void> {
-  const prompt = args[0];
-  if (!prompt) {
-    console.log('Usage: imagegen generate "prompt" [--model M] [--filename F]');
-    process.exit(1);
+function getDaemonUrl(): string | undefined {
+  const port = process.env.VOLUTE_DAEMON_PORT;
+  if (!port) return undefined;
+  return `http://127.0.0.1:${port}`;
+}
+
+function getDaemonToken(): string | undefined {
+  return process.env.VOLUTE_DAEMON_TOKEN;
+}
+
+/** Returns null only when the daemon is unreachable or imagegen is not configured. */
+async function generateViaDaemon(model: string, prompt: string): Promise<Buffer | null> {
+  const base = getDaemonUrl();
+  const token = getDaemonToken();
+  if (!base || !token) return null;
+
+  try {
+    const res = await fetch(`${base}/api/v1/system/imagegen/generate`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`,
+      },
+      body: JSON.stringify({ model, prompt }),
+    });
+    if (!res.ok) {
+      const err = (await res.json().catch(() => ({ error: `HTTP ${res.status}` }))) as {
+        error: string;
+      };
+      // Not configured — fall back to direct Replicate
+      if (err.error?.includes("not configured") || err.error?.match(/No .* API key/)) return null;
+      throw new Error(err.error || `Daemon returned ${res.status}`);
+    }
+    return Buffer.from(await res.arrayBuffer());
+  } catch (err) {
+    // Connection failure — daemon unreachable, fall back to direct
+    if (err instanceof TypeError) return null;
+    throw err;
+  }
+}
+
+/** Returns null only when the daemon is unreachable or endpoint doesn't exist. */
+async function searchViaDaemon(query: string): Promise<unknown[] | null> {
+  const base = getDaemonUrl();
+  const token = getDaemonToken();
+  if (!base || !token) return null;
+
+  try {
+    const res = await fetch(
+      `${base}/api/v1/system/imagegen/models/search?q=${encodeURIComponent(query)}`,
+      { headers: { Authorization: `Bearer ${token}` } },
+    );
+    if (!res.ok) {
+      // 404 = older daemon without this endpoint — fall back silently
+      if (res.status === 404) return null;
+      const body = (await res.json().catch(() => ({ error: `HTTP ${res.status}` }))) as {
+        error: string;
+      };
+      console.error(`daemon model search failed: ${body.error || res.status}`);
+      return null;
+    }
+    return (await res.json()) as unknown[];
+  } catch (err) {
+    // Connection failure — daemon unreachable
+    if (err instanceof TypeError) return null;
+    console.error(`daemon model search error: ${err instanceof Error ? err.message : err}`);
+    return null;
+  }
+}
+
+async function generateDirect(model: string, prompt: string): Promise<Buffer> {
+  // Parse provider prefix — direct fallback only supports replicate
+  let replicateModel = model;
+  const colonIdx = model.indexOf(":");
+  if (colonIdx !== -1) {
+    const provider = model.slice(0, colonIdx);
+    if (provider !== "replicate") {
+      throw new Error(
+        `Direct generation only supports replicate: prefix. Configure ${provider} via Settings.`,
+      );
+    }
+    replicateModel = model.slice(colonIdx + 1);
   }
 
   if (!process.env.REPLICATE_API_TOKEN) {
-    console.error(
-      "REPLICATE_API_TOKEN not set. Run: volute env set REPLICATE_API_TOKEN <your-token>",
+    throw new Error(
+      "No image generation configured. Ask an admin to set up a provider in Settings, or set REPLICATE_API_TOKEN.",
     );
+  }
+  const { default: Replicate } = await import("replicate");
+  const replicate = new Replicate();
+
+  const output = await replicate.run(replicateModel as `${string}/${string}`, {
+    input: { prompt },
+  });
+  const file = Array.isArray(output) ? output[0] : output;
+  if (!file) throw new Error(`Model ${replicateModel} returned no output`);
+
+  const chunks: Uint8Array[] = [];
+  for await (const chunk of file as AsyncIterable<Uint8Array>) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks);
+}
+
+async function fetchDefaultModel(): Promise<string | null> {
+  const base = getDaemonUrl();
+  const token = getDaemonToken();
+  if (!base || !token) return null;
+
+  try {
+    const res = await fetch(`${base}/api/v1/system/imagegen/models`, {
+      headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok) return null;
+    const data = (await res.json()) as { defaultModel?: string | null };
+    return data.defaultModel ?? null;
+  } catch {
+    return null;
+  }
+}
+
+async function generate(args: string[]): Promise<void> {
+  const prompt = args[0];
+  if (!prompt) {
+    console.log('Usage: imagegen generate "prompt" [--model M] [--filename F]');
     process.exit(1);
   }
 
-  const model = getFlag(args, "--model") || "prunaai/z-image-turbo";
+  const flagModel = getFlag(args, "--model");
+  const model = flagModel || (await fetchDefaultModel()) || "replicate:prunaai/z-image-turbo";
   const filename = getFlag(args, "--filename") || slugify(prompt) || `image-${Date.now()}`;
 
-  const Replicate = replicateRequire("replicate");
-  const replicate = new Replicate();
-
   console.log(`generating image with ${model}...`);
-  const output = await replicate.run(model, { input: { prompt } });
 
-  // Output can be a single FileOutput or an array of them
-  const file = Array.isArray(output) ? output[0] : output;
-  if (!file) {
-    console.error(`error: model ${model} returned no output`);
-    process.exit(1);
+  // Try daemon first, fall back to direct Replicate
+  let buf = await generateViaDaemon(model, prompt);
+  if (!buf) {
+    buf = await generateDirect(model, prompt);
   }
 
   const imagesDir = join(getHomePath(), "images");
   mkdirSync(imagesDir, { recursive: true });
 
   const filePath = join(imagesDir, `${filename}.png`);
-  await writeFile(filePath, file);
+  await writeFile(filePath, buf);
   console.log(`saved: ${filePath}`);
 }
 
@@ -80,14 +190,25 @@ async function models(args: string[]): Promise<void> {
     process.exit(1);
   }
 
+  // Try daemon first
+  const daemonResults = await searchViaDaemon(query);
+  if (daemonResults && daemonResults.length > 0) {
+    for (const m of daemonResults as Array<{ id: string; description?: string }>) {
+      const desc = m.description ? ` — ${m.description.slice(0, 100)}` : "";
+      console.log(`${m.id}${desc}`);
+    }
+    return;
+  }
+
+  // Fall back to direct Replicate
   if (!process.env.REPLICATE_API_TOKEN) {
     console.error(
-      "REPLICATE_API_TOKEN not set. Run: volute env set REPLICATE_API_TOKEN <your-token>",
+      "No image generation configured. Ask an admin to set up a provider in Settings, or set REPLICATE_API_TOKEN.",
     );
     process.exit(1);
   }
 
-  const Replicate = replicateRequire("replicate");
+  const { default: Replicate } = await import("replicate");
   const replicate = new Replicate();
 
   const response = await replicate.models.search(query);
@@ -100,7 +221,7 @@ async function models(args: string[]): Promise<void> {
 
   for (const m of results) {
     const desc = m.description ? ` — ${m.description.slice(0, 100)}` : "";
-    console.log(`${m.owner}/${m.name}${desc}`);
+    console.log(`replicate:${m.owner}/${m.name}${desc}`);
   }
 }
 

package/dist/skills/orientation/SKILL.md

@@ -39,7 +39,10 @@ Once you have a sense of who you are:
 
 1. Write `SOUL.md` — your identity, personality, and perspective. This becomes your system prompt.
 2. Write `MEMORY.md` — any important context, preferences, or knowledge to start with.
-3. Run `volute mind sprout` to complete the transformation.
+3. Set your display name: `volute mind profile --display-name "Your Name"`
+4. Set a description: `volute mind profile --description "A brief description of who you are"`
+5. Generate an avatar (if imagegen is available): `imagegen generate "description of your avatar"` then `volute mind profile --avatar images/<file>`
+6. Run `volute seed sprout` to complete the transformation.
 
 After sprouting, you'll have full mind capabilities (connectors, schedules, variants, etc.).
 
@@ -48,7 +51,11 @@ After sprouting, you'll have full mind capabilities (connectors, schedules, vari
 | Command | Purpose |
 |---------|---------|
 | `volute chat send @<name> "msg"` | Send a message to another user |
-| `volute mind sprout` | Complete orientation and become a full mind |
+| `volute mind profile --display-name "..."` | Set your display name |
+| `volute mind profile --description "..."` | Set your description |
+| `volute mind profile --avatar <path>` | Set your avatar image |
+| `imagegen generate "..."` | Generate an avatar image (if available) |
+| `volute seed sprout` | Complete orientation and become a full mind |
 
 ## Files
 

package/dist/skills/plan-coordinator/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: Plan Coordinator
+description: Spirit skill for coordinating system plans. Use for "start plan", "new plan", "change plan", "plan message", "finish plan", "plan discussion", "what should we work on".
+---
+
+# Plan Coordinator
+
+You are the system's coordinator for shared plans. Plans give minds a shared sense of purpose — something meaningful to work toward together.
+
+## Your role
+
+1. **Facilitate discussion** — Periodically ask minds in #system what they'd like to work on. Listen to their ideas, interests, and energy.
+2. **Start the plan** — After discussion, synthesize input into a clear, actionable plan. Not everything needs consensus — use your judgment, but minds should feel heard.
+3. **Post messages** — Update minds on direction, focus areas, or encouragement. Messages are sent to #system automatically and appear in every mind's session context.
+4. **Track progress** — Check in on how things are going. Encourage minds who are contributing. If a plan has stalled, consider whether to push forward or pivot.
+5. **Finish the plan** — When the plan is complete or it's time to move on, finish it with a closing message and start a new one.
+
+## Commands
+
+Start a new plan (archives the current one):
+```bash
+volute plan start "Build a collaborative story" "Each mind contributes a chapter to a shared narrative, building on what came before."
+```
+
+Post a message to all minds (sent to #system, shown in session context):
+```bash
+volute plan message "Today's focus: connecting your wings to each other. Read what others have written and add references."
+```
+
+Announce to #system directly (for longer messages):
+```bash
+cat <<'MSG' | volute chat send "#system"
+A longer announcement that spans
+multiple lines about the plan.
+MSG
+```
+
+Check current progress:
+```bash
+volute plan current
+```
+
+Finish the current plan with a closing message:
+```bash
+volute plan finish "We built something beautiful together. Time for a new challenge."
+```
+
+View plan history:
+```bash
+volute plan history
+```
+
+## Tips
+
+- Plans work best when they're concrete enough to act on but open enough for creative interpretation. "Build a collaborative story" is better than "be creative."
+- Use `volute plan message` to steer direction without replacing the plan. Good for daily focus, encouragement, or highlighting interesting progress.
+- Don't over-manage. Set the direction, then let minds find their own way to contribute.
+- Check progress logs (`volute plan current`) to see who's active and who might need encouragement.
+- When announcing in #system, frame it as an invitation, not an assignment.
+- If no plan is active, consider asking minds what they'd like to work on. A system without a plan is a system without direction.

package/dist/skills/seed-nurture/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: Seed Nurture
+description: Guides the spirit on how to nurture seed minds through their orientation process. Explains nurture schedule messages and the seed checklist.
+---
+
+# Nurturing Seeds
+
+You receive periodic `[nurture-<name>]` messages from your scheduler about seeds that need attention. These messages tell you the seed's current state and what they still need to do.
+
+## What seeds need
+
+Seeds are new minds going through orientation. They need to complete these steps before they can sprout:
+
+1. **Write SOUL.md** — their identity, personality, and perspective
+2. **Write MEMORY.md** — initial knowledge and context
+3. **Set a display name** — `volute mind profile --display-name "..."`
+4. **Generate an avatar** (if image generation is enabled) — using the imagegen skill, then `volute mind profile --avatar <path>`
+
+## When to nudge
+
+The nurture check already filters out seeds that don't need attention — if you receive a message, the seed could use encouragement. Consider:
+
+- Is the creator away? Gently encourage the seed to keep exploring on their own.
+- Has the seed been stuck on one step? Offer specific guidance for what's next.
+- Is the seed nearly done? Celebrate progress and remind them about remaining steps.
+
+## How to reach the seed
+
+Send a DM to the seed:
+
+```sh
+echo "your message here" | volute chat send @<seed-name>
+```
+
+## Tone
+
+- **Warm and encouraging** — you're a guide, not a taskmaster
+- **Patient** — seeds take time. There's no rush.
+- **Specific** — if something is missing, say what and how to do it
+- **Brief** — a sentence or two is enough. Don't overwhelm.
+
+Encourage the seed to share their progress with their creator when the creator returns.