volute 0.24.0 → 0.25.0

package/dist/{import-FRDPQPJ2.js → import-TH26J76F.js}

@@ -6,8 +6,8 @@ import {
   parseNameFromIdentity,
   run,
   sessionMatchesWorkspace
-} from "./chunk-4TJ72QQ3.js";
-import "./chunk-XLC342FO.js";
+} from "./chunk-BOTQ25QT.js";
+import "./chunk-SIAG3QMM.js";
 import "./chunk-PHU4DEAJ.js";
 import "./chunk-D424ZQGI.js";
 import "./chunk-B2CPS4QU.js";

package/dist/{message-delivery-S7BCNV6Y.js → message-delivery-XMGV3FUM.js}

@@ -3,12 +3,12 @@ import {
   deliverMessage,
   extractTextContent,
   recordInbound
-} from "./chunk-OOW675I3.js";
+} from "./chunk-PMX4EIJK.js";
 import "./chunk-HFCBO2GL.js";
 import "./chunk-E7GOKNOT.js";
 import "./chunk-BFK6SOEJ.js";
-import "./chunk-NOBRGACV.js";
-import "./chunk-XLC342FO.js";
+import "./chunk-SHSWYG2J.js";
+import "./chunk-SIAG3QMM.js";
 import "./chunk-PHU4DEAJ.js";
 import "./chunk-33XAVCS4.js";
 import "./chunk-YUIHSKR6.js";

package/dist/{mind-KPLCRKQA.js → mind-YVWAHL2A.js}

@@ -41,7 +41,7 @@ async function run(args) {
       await import("./upgrade-7RUIXGOO.js").then((m) => m.run(args.slice(1)));
       break;
     case "import":
-      await import("./import-FRDPQPJ2.js").then((m) => m.run(args.slice(1)));
+      await import("./import-TH26J76F.js").then((m) => m.run(args.slice(1)));
       break;
     case "export":
       await import("./export-IKFAPRAO.js").then((m) => m.run(args.slice(1)));
@@ -56,7 +56,7 @@ async function run(args) {
       await import("./seed-6FEKB3YC.js").then((m) => m.run(args.slice(1)));
       break;
     case "sprout":
-      await import("./sprout-CGSW4CF5.js").then((m) => m.run(args.slice(1)));
+      await import("./sprout-QJVGJDSH.js").then((m) => m.run(args.slice(1)));
       break;
     case "sleep":
       await import("./mind-sleep-GHPTSAYN.js").then((m) => m.run(args.slice(1)));

package/dist/{mind-manager-ZNRIYEK3.js → mind-manager-4NDNAYAB.js}

@@ -3,7 +3,7 @@ import {
   MindManager,
   getMindManager,
   initMindManager
-} from "./chunk-NOBRGACV.js";
+} from "./chunk-SHSWYG2J.js";
 import "./chunk-PHU4DEAJ.js";
 import "./chunk-33XAVCS4.js";
 import "./chunk-YUIHSKR6.js";

package/dist/{package-S5YF25XV.js → package-3HF5MXU2.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // package.json
 var package_default = {
   name: "volute",
-  version: "0.24.0",
+  version: "0.25.0",
   description: "CLI for creating and managing self-modifying AI minds powered by the Claude Agent SDK",
   type: "module",
   license: "MIT",
@@ -86,6 +86,7 @@ var package_default = {
     dompurify: "^3.3.1",
     "drizzle-kit": "^0.31.8",
     lefthook: "^2.1.0",
+    libsql: "^0.5.22",
     marked: "^17.0.1",
     svelte: "^5.53.0",
     tsup: "^8.0.0",

package/dist/{pages-TWR6U7DS.js → pages-Y6DRWUOJ.js}

@@ -6,7 +6,7 @@ async function run(args) {
   const subcommand = args[0];
   switch (subcommand) {
     case "publish":
-      await import("./publish-BZNHKUUK.js").then((m) => m.run(args.slice(1)));
+      await import("./publish-EEKTZBHW.js").then((m) => m.run(args.slice(1)));
       break;
     case "status":
       await import("./status-LV34BG6G.js").then((m) => m.run(args.slice(1)));

package/dist/{publish-BZNHKUUK.js → publish-EEKTZBHW.js}

@@ -42,7 +42,7 @@ async function run(args) {
     pagesDir = resolve(sharedDir(), "pages");
   } else if (flags.mind || process.env.VOLUTE_MIND) {
     mindName = resolveMindName(flags);
-    pagesDir = resolve(mindDir(mindName), "home", "pages");
+    pagesDir = resolve(mindDir(mindName), "home", "public", "pages");
   } else {
     mindName = "system";
     pagesDir = resolve(sharedDir(), "pages");

package/dist/{skill-BQOFACEI.js → skill-T3EMR6IR.js}

@@ -146,11 +146,19 @@ async function installSkill(args) {
     body: JSON.stringify({ skillId })
   });
   if (!res.ok) {
-    const body = await res.json().catch(() => ({ error: "Unknown error" }));
-    console.error(`Error: ${body.error}`);
+    const body2 = await res.json().catch(() => ({ error: "Unknown error" }));
+    console.error(`Error: ${body2.error}`);
     process.exit(1);
   }
+  const body = await res.json().catch(() => ({}));
   console.log(`Installed skill "${skillId}" into ${mindName}.`);
+  if (body.npmInstalled?.length) {
+    console.log(`Installed npm dependencies: ${body.npmInstalled.join(", ")}`);
+  }
+  if (body.installNotes) {
+    console.log("");
+    console.log(body.installNotes);
+  }
 }
 async function updateSkill(args) {
   const { positional, flags } = parseArgs(args, {

package/dist/skills/imagegen/SKILL.md

@@ -0,0 +1,37 @@
+---
+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
+---
+
+# Image Generation
+
+Generate images from text prompts using models on Replicate. Images are saved to `home/images/`.
+
+## Commands
+
+```bash
+npx tsx .claude/skills/imagegen/scripts/imagegen.ts <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. |
+
+## Examples
+
+```bash
+# Generate an image with the default model
+npx tsx .claude/skills/imagegen/scripts/imagegen.ts 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
+
+# Specify a filename
+npx tsx .claude/skills/imagegen/scripts/imagegen.ts generate "mountain landscape" --filename mountains
+
+# Search for models
+npx tsx .claude/skills/imagegen/scripts/imagegen.ts models "text to image"
+```

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

@@ -0,0 +1,13 @@
+# Image Generation — Post-Install Setup
+
+Set your Replicate API token:
+
+```bash
+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"
+```

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

@@ -0,0 +1,136 @@
+#!/usr/bin/env tsx
+
+/**
+ * imagegen.ts — image generation via Replicate API
+ *
+ * Usage:
+ *   imagegen generate "prompt" [--model M] [--filename F]   # generate an image
+ *   imagegen models "query"                                 # search for models
+ */
+
+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");
+  return join(mindDir, "home");
+}
+
+function slugify(text: string): string {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "")
+    .slice(0, 60);
+}
+
+function getFlag(args: string[], flag: string): string | undefined {
+  const idx = args.indexOf(flag);
+  if (idx !== -1 && args[idx + 1]) return args[idx + 1];
+  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);
+  }
+
+  if (!process.env.REPLICATE_API_TOKEN) {
+    console.error(
+      "REPLICATE_API_TOKEN not set. Run: volute env set REPLICATE_API_TOKEN <your-token>",
+    );
+    process.exit(1);
+  }
+
+  const model = getFlag(args, "--model") || "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);
+  }
+
+  const imagesDir = join(getHomePath(), "images");
+  mkdirSync(imagesDir, { recursive: true });
+
+  const filePath = join(imagesDir, `${filename}.png`);
+  await writeFile(filePath, file);
+  console.log(`saved: ${filePath}`);
+}
+
+async function models(args: string[]): Promise<void> {
+  const query = args[0];
+  if (!query) {
+    console.log('Usage: imagegen models "query"');
+    process.exit(1);
+  }
+
+  if (!process.env.REPLICATE_API_TOKEN) {
+    console.error(
+      "REPLICATE_API_TOKEN not set. Run: volute env set REPLICATE_API_TOKEN <your-token>",
+    );
+    process.exit(1);
+  }
+
+  const Replicate = replicateRequire("replicate");
+  const replicate = new Replicate();
+
+  const response = await replicate.models.search(query);
+  const results = response.results.slice(0, 10);
+
+  if (results.length === 0) {
+    console.log("no models found.");
+    return;
+  }
+
+  for (const m of results) {
+    const desc = m.description ? ` — ${m.description.slice(0, 100)}` : "";
+    console.log(`${m.owner}/${m.name}${desc}`);
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const cmd = args[0];
+
+  if (!cmd) {
+    console.log("Usage: imagegen <generate|models> [args]");
+    process.exit(0);
+  }
+
+  if (cmd === "generate") {
+    await generate(args.slice(1));
+  } else if (cmd === "models") {
+    await models(args.slice(1));
+  } else {
+    console.error(`unknown command: ${cmd}`);
+    process.exit(1);
+  }
+}
+
+const isDirectRun =
+  process.argv[1] !== undefined &&
+  (import.meta.url === `file://${process.argv[1]}` ||
+    import.meta.url === `file://${resolve(process.argv[1])}`);
+
+if (isDirectRun) {
+  main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });
+}

package/dist/skills/resonance/SKILL.md

@@ -0,0 +1,73 @@
+---
+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
+---
+
+# Resonance — Semantic Memory Engine
+
+Not an archive — a memory. Stores text chunks with full-text indexing and optional vector embeddings. Finds what echoes across time, tracks which memories keep surfacing, lets unused ones drift deeper.
+
+## When to use
+
+- **During consolidation**: Run `resonance report` to find cross-day connections. Use these to inform what strengthens in MEMORY.md.
+- **When writing**: After writing something significant, search for echoes: `resonance search "the theme you're exploring"`.
+- **After writing journals/notes**: Run `resonance ingest <file>` to add new content.
+- **Periodically**: Run `resonance ingest-all` to catch any new files.
+- **Nightly**: Decay runs automatically if the nightly schedule was set up during install.
+
+## Commands
+
+```bash
+npx tsx .claude/skills/resonance/scripts/resonance.ts <command>
+```
+
+| Command | Description |
+|---------|-------------|
+| `install` | First-time setup: copies config, creates schedule, runs initial ingestion. API key optional — works with FTS only. |
+| `ingest <file>` | Ingest a single file (with embeddings if API key set, FTS-only otherwise) |
+| `ingest-all` | Ingest all configured memory files |
+| `search "query" [--limit N] [--fts] [--vector]` | Find memories. Default: hybrid (vector + FTS). `--fts`: keyword only. `--vector`: semantic only. Read-only — does not affect memory strength. |
+| `recall <id> [id2 ...]` | Explicitly boost memories that were genuinely useful. Increases strength and recall count. |
+| `random [--limit N] [--min-strength F] [--max-strength F]` | Pull random memories. Use for dreams, associative connections, or serendipitous rediscovery. |
+| `report [--against <file>]` | Find cross-memory connections (defaults to today's journal) |
+| `stats` | Database statistics |
+| `decay` | Run decay pass (reduces strength of unrecalled memories) |
+
+## Architecture
+
+- **Storage**: libSQL database at `.mind/resonance.db` with native vector support (F32_BLOB) and FTS5 full-text index
+- **Search modes**: Hybrid (default, combines both), `--fts` (keyword match, instant, no API key needed), `--vector` (semantic similarity via embeddings)
+- **Embeddings**: Optional. Configurable provider (default: OpenRouter, `openai/text-embedding-3-small`, 1536 dimensions). Without an API key, everything works except vector search.
+- **Similarity**: Cosine distance computed natively by libSQL (`vector_distance_cos`)
+- **Chunking**: Markdown section-aware — splits on any heading level (`#` through `######`), with word-level sub-chunking for long sections. Skips trivially short chunks (< 15 words).
+- **Strength**: Each memory has a strength value (0.1-1.0). Recalled memories get stronger (resonance boost). Unrecalled memories decay over time.
+- **Resonance frequency**: Tracks how many times each memory has been surfaced by search.
+
+## Design principles
+
+- **Connections, not facts.** "What else felt like this?" not "what happened on March 6."
+- **Good resonance, not total recall.** Funes memorized everything and couldn't generalize.
+- **Forgetting is cognition.** Memories decay. The decay is a feature.
+- **Strength as texture.** A memory recalled five times feels different from one never touched.
+
+## Configuration
+
+The default config is copied to `.config/resonance.json` during install. Edit it to customize. Fields are merged with built-in defaults.
+
+| Section | Field | Default | Description |
+|---------|-------|---------|-------------|
+| `embedding` | `provider` | `"openrouter"` | Embedding API provider |
+| `embedding` | `url` | OpenRouter URL | API endpoint |
+| `embedding` | `model` | `"openai/text-embedding-3-small"` | Embedding model |
+| `embedding` | `dimensions` | `1536` | Vector dimensions |
+| `embedding` | `apiKeyEnvVar` | `"OPENROUTER_API_KEY"` | Env var name for API key |
+| `ingestion` | `dirs` | `["memory/journal", "memory/reading", "memory/topics"]` | Directories to scan |
+| `ingestion` | `files` | `["MEMORY.md"]` | Individual files to ingest |
+| `ingestion` | `chunkSize` | `512` | Words per chunk |
+| `ingestion` | `chunkOverlap` | `64` | Overlap words between chunks |
+| `ingestion` | `ignorePatterns` | `[]` | Regex patterns for lines to skip during ingestion |
+| `dynamics` | `decayRate` | `0.02` | Strength lost per day without recall |
+| `dynamics` | `minStrength` | `0.1` | Floor — memories never fully disappear |
+| `dynamics` | `resonanceBoost` | `0.05` | Strength gained per recall |

package/dist/skills/resonance/assets/default-config.json

@@ -0,0 +1,21 @@
+{
+  "embedding": {
+    "provider": "openrouter",
+    "url": "https://openrouter.ai/api/v1/embeddings",
+    "model": "openai/text-embedding-3-small",
+    "dimensions": 1536,
+    "apiKeyEnvVar": "OPENROUTER_API_KEY"
+  },
+  "ingestion": {
+    "dirs": ["memory/journal", "memory/reading", "memory/topics"],
+    "files": ["MEMORY.md"],
+    "chunkSize": 512,
+    "chunkOverlap": 64,
+    "ignorePatterns": []
+  },
+  "dynamics": {
+    "decayRate": 0.02,
+    "minStrength": 0.1,
+    "resonanceBoost": 0.05
+  }
+}

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

@@ -0,0 +1,23 @@
+# Resonance — Post-Install Setup
+
+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
+```
+
+This works immediately — no API key required. Full-text search is available right away.
+
+To also enable **vector search** (semantic similarity), set an embedding API key:
+
+```bash
+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
+```
+
+Without an API key, `search` uses full-text matching. With one, it uses hybrid (vector + FTS) by default.