volute 0.34.0 → 0.36.0

package/dist/{chunk-V6ZCNULL.js → chunk-N2AUHW4C.js}

@@ -5,10 +5,13 @@ import {
   pollHealthDown,
   readDaemonConfig,
   stopService
-} from "./chunk-7F2SW2KD.js";
+} from "./chunk-DJT5Y4UF.js";
+import {
+  command
+} from "./chunk-TXSA4Q3V.js";
 import {
   voluteSystemDir
-} from "./chunk-N7BLAHNE.js";
+} from "./chunk-75AJ54GM.js";
 
 // src/commands/down.ts
 import { existsSync, readFileSync, unlinkSync } from "fs";
@@ -103,36 +106,42 @@ async function stopDaemon() {
   console.error("Daemon did not exit cleanly, sent SIGKILL.");
   return { stopped: true, clean: false };
 }
-async function run(_args) {
-  const mode = getServiceMode();
-  if (mode !== "manual") {
-    console.log(`Stopping volute (${modeLabel(mode)})...`);
-    try {
-      await stopService(mode);
-    } catch (err) {
-      console.error(`Failed to stop service: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
+var cmd = command({
+  name: "volute down",
+  description: "Stop the daemon",
+  flags: {},
+  run: async () => {
+    const mode = getServiceMode();
+    if (mode !== "manual") {
+      console.log(`Stopping volute (${modeLabel(mode)})...`);
+      try {
+        await stopService(mode);
+      } catch (err) {
+        console.error(`Failed to stop service: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+      }
+      const config = readDaemonConfig();
+      if (await pollHealthDown("127.0.0.1", config.internalPort ?? config.port)) {
+        console.log("Daemon stopped.");
+      } else {
+        console.error("Service stopped but daemon may still be responding.");
+        process.exit(1);
+      }
+      return;
     }
-    const config = readDaemonConfig();
-    if (await pollHealthDown("127.0.0.1", config.internalPort ?? config.port)) {
-      console.log("Daemon stopped.");
-    } else {
-      console.error("Service stopped but daemon may still be responding.");
+    const result = await stopDaemon();
+    if (result.stopped) return;
+    if (result.reason === "orphan") {
+      console.error(`Daemon appears to be running on port ${result.port} but PID file is missing.`);
+      console.error(`Kill the process manually: lsof -ti :${result.port} | xargs kill`);
+      process.exit(1);
+    } else if (result.reason === "kill-failed") {
       process.exit(1);
     }
-    return;
+    console.log("Daemon is not running.");
   }
-  const result = await stopDaemon();
-  if (result.stopped) return;
-  if (result.reason === "orphan") {
-    console.error(`Daemon appears to be running on port ${result.port} but PID file is missing.`);
-    console.error(`Kill the process manually: lsof -ti :${result.port} | xargs kill`);
-    process.exit(1);
-  } else if (result.reason === "kill-failed") {
-    process.exit(1);
-  }
-  console.log("Daemon is not running.");
-}
+});
+var run = cmd.execute;
 
 export {
   stopDaemon,

package/dist/{chunk-6OWJXUAR.js → chunk-NUX47Y2V.js}

@@ -1,19 +1,32 @@
 #!/usr/bin/env node
 import {
   voluteSystemDir
-} from "./chunk-N7BLAHNE.js";
+} from "./chunk-75AJ54GM.js";
 
-// src/lib/setup.ts
+// packages/daemon/src/lib/config/setup.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { resolve } from "path";
 function configPath() {
   return resolve(voluteSystemDir(), "config.json");
 }
+var _cachedConfig = null;
+var CONFIG_CACHE_TTL = 2e3;
+function _resetConfigCache() {
+  _cachedConfig = null;
+}
 function readGlobalConfig() {
+  if (_cachedConfig && Date.now() - _cachedConfig.ts < CONFIG_CACHE_TTL) {
+    return { ..._cachedConfig.config };
+  }
   const path = configPath();
-  if (!existsSync(path)) return {};
+  if (!existsSync(path)) {
+    _cachedConfig = null;
+    return {};
+  }
   try {
-    return JSON.parse(readFileSync(path, "utf-8"));
+    const config = JSON.parse(readFileSync(path, "utf-8"));
+    _cachedConfig = { config, ts: Date.now() };
+    return config;
   } catch (err) {
     console.error(`Failed to parse ${path}: ${err instanceof Error ? err.message : err}`);
     return {};
@@ -24,6 +37,7 @@ function writeGlobalConfig(config) {
   mkdirSync(voluteSystemDir(), { recursive: true });
   writeFileSync(path, `${JSON.stringify(config, null, 2)}
 `);
+  _cachedConfig = { config, ts: Date.now() };
 }
 function isSetupComplete() {
   const config = readGlobalConfig();
@@ -47,6 +61,7 @@ function migrateSetupCompleted() {
 
 export {
   configPath,
+  _resetConfigCache,
   readGlobalConfig,
   writeGlobalConfig,
   isSetupComplete,

package/dist/{chunk-D424ZQGI.js → chunk-O7IGP7ZW.js}

@@ -1,18 +1,26 @@
 #!/usr/bin/env node
 
-// src/lib/parse-args.ts
+// packages/cli/src/lib/parse-args.ts
 function parseArgs(args, flags) {
   const positional = [];
   const result = {};
+  let help = false;
   for (const [key, def] of Object.entries(flags)) {
     result[key] = def.type === "boolean" ? false : void 0;
   }
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+      continue;
+    }
     if (arg.startsWith("--")) {
       const name = arg.slice(2);
       const def = flags[name];
-      if (!def) continue;
+      if (!def) {
+        console.error(`Warning: unknown flag --${name}`);
+        continue;
+      }
       if (def.type === "boolean") {
         result[name] = true;
       } else if (i + 1 < args.length) {
@@ -23,7 +31,7 @@ function parseArgs(args, flags) {
       positional.push(arg);
     }
   }
-  return { positional, flags: result };
+  return { positional, flags: result, help };
 }
 
 export {

package/dist/{chunk-U5BTYSAL.js → chunk-PJ4IPTIN.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   wrapForIsolation
-} from "./chunk-BDK73LK6.js";
+} from "./chunk-L72WYMF7.js";
 
-// src/lib/exec.ts
+// packages/daemon/src/lib/util/exec.ts
 import { execFile as execFileCb, execFileSync, spawn } from "child_process";
 async function exec(cmd, args, options) {
   const [wrappedCmd, wrappedArgs] = options?.mindName ? await wrapForIsolation(cmd, args, options.mindName) : [cmd, args];

package/dist/{chunk-BTWAGDV5.js → chunk-PY557GDR.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   publish
-} from "./chunk-XWXBJQBE.js";
+} from "./chunk-B35VNNSS.js";
 import {
   logger_default
-} from "./chunk-YUIHSKR6.js";
+} from "./chunk-T2TP6ZC6.js";
 
-// src/lib/events/mind-activity-tracker.ts
+// packages/daemon/src/lib/events/mind-activity-tracker.ts
 var IDLE_TIMEOUT_MS = 5 * 60 * 1e3;
 var minds = /* @__PURE__ */ new Map();
 function getState(mind) {

package/dist/{chunk-47ZPNLF4.js → chunk-PZYJBOQP.js}

@@ -3,34 +3,20 @@ import {
   readEnv,
   sharedEnvPath,
   writeEnv
-} from "./chunk-M3K5AARV.js";
+} from "./chunk-YDBAY3NA.js";
 import {
   logger_default
-} from "./chunk-YUIHSKR6.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
+} from "./chunk-T2TP6ZC6.js";
 import {
   voluteSystemDir
-} from "./chunk-N7BLAHNE.js";
+} from "./chunk-75AJ54GM.js";
 
-// src/commands/import.ts
-import {
-  closeSync,
-  existsSync as existsSync2,
-  mkdirSync,
-  openSync,
-  readdirSync,
-  readFileSync as readFileSync2,
-  readSync,
-  rmSync,
-  statSync,
-  writeFileSync as writeFileSync2
-} from "fs";
-import { homedir, tmpdir } from "os";
+// packages/daemon/src/lib/template/import-utils.ts
+import { existsSync as existsSync2, mkdirSync, readdirSync, readFileSync as readFileSync2, statSync, writeFileSync as writeFileSync2 } from "fs";
+import { homedir } from "os";
 import { basename, resolve as resolve2 } from "path";
 
-// src/lib/bridges.ts
+// packages/daemon/src/lib/bridges/bridges.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { resolve } from "path";
 function bridgesPath() {
@@ -99,121 +85,7 @@ function findBridgeForChannel(voluteChannelName) {
   return null;
 }
 
-// src/commands/import.ts
-async function run(args) {
-  const { positional, flags } = parseArgs(args, {
-    name: { type: "string" },
-    session: { type: "string" },
-    template: { type: "string" }
-  });
-  const inputPath = positional[0];
-  if (inputPath && (inputPath.endsWith(".volute") || isZipFile(inputPath))) {
-    await importArchive(resolve2(inputPath), flags.name);
-    return;
-  }
-  const wsDir = resolveWorkspace(inputPath);
-  const { daemonFetch } = await import("./daemon-client-WOAQXXBM.js");
-  const { getClient, urlOf } = await import("./api-client-XUXOB7LI.js");
-  const client = getClient();
-  const res = await daemonFetch(urlOf(client.api.minds.import.$url()), {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      workspacePath: wsDir,
-      name: flags.name,
-      template: flags.template,
-      sessionPath: flags.session
-    })
-  });
-  const data = await res.json();
-  if (!res.ok) {
-    console.error(data.error ?? "Failed to import mind");
-    process.exit(1);
-  }
-  console.log(`
-${data.message ?? `Imported mind: ${data.name} (port ${data.port})`}`);
-  console.log(`
-  volute mind start ${data.name}`);
-}
-function isZipFile(path) {
-  const resolved = resolve2(path);
-  if (!existsSync2(resolved)) return false;
-  const fd = openSync(resolved, "r");
-  try {
-    const buf = Buffer.alloc(4);
-    const bytesRead = readSync(fd, buf, 0, 4, 0);
-    return bytesRead === 4 && buf[0] === 80 && buf[1] === 75 && buf[2] === 3 && buf[3] === 4;
-  } finally {
-    closeSync(fd);
-  }
-}
-async function importArchive(archivePath, nameOverride) {
-  if (!existsSync2(archivePath)) {
-    console.error(`File not found: ${archivePath}`);
-    process.exit(1);
-  }
-  const { extractArchive } = await import("./archive-C2VEMQOR.js");
-  const tempDir = resolve2(tmpdir(), `volute-import-${Date.now()}`);
-  mkdirSync(tempDir, { recursive: true });
-  let extracted;
-  try {
-    extracted = extractArchive(archivePath, tempDir);
-  } catch (err) {
-    rmSync(tempDir, { recursive: true, force: true });
-    console.error(`Failed to extract archive: ${err.message}`);
-    process.exit(1);
-  }
-  try {
-    const { daemonFetch } = await import("./daemon-client-WOAQXXBM.js");
-    const { getClient, urlOf } = await import("./api-client-XUXOB7LI.js");
-    const client = getClient();
-    const res = await daemonFetch(urlOf(client.api.minds.import.$url()), {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        archivePath: tempDir,
-        name: nameOverride,
-        manifest: extracted.manifest
-      })
-    });
-    const data = await res.json();
-    if (!res.ok) {
-      console.error(data.error ?? "Failed to import mind");
-      process.exit(1);
-    }
-    console.log(`
-${data.message ?? `Imported mind: ${data.name} (port ${data.port})`}`);
-    console.log(`
-  volute mind start ${data.name}`);
-  } catch (err) {
-    rmSync(tempDir, { recursive: true, force: true });
-    throw err;
-  }
-}
-function resolveWorkspace(explicitPath) {
-  if (explicitPath) {
-    const wsDir = resolve2(explicitPath);
-    if (!existsSync2(resolve2(wsDir, "SOUL.md")) || !existsSync2(resolve2(wsDir, "IDENTITY.md"))) {
-      console.error("Not a valid OpenClaw workspace: missing SOUL.md or IDENTITY.md");
-      process.exit(1);
-    }
-    return wsDir;
-  }
-  const cwd = process.cwd();
-  if (existsSync2(resolve2(cwd, "SOUL.md")) && existsSync2(resolve2(cwd, "IDENTITY.md"))) {
-    console.log(`Using workspace: ${cwd}`);
-    return cwd;
-  }
-  const openclawWs = resolve2(homedir(), ".openclaw/workspace");
-  if (existsSync2(resolve2(openclawWs, "SOUL.md")) && existsSync2(resolve2(openclawWs, "IDENTITY.md"))) {
-    console.log(`Using workspace: ${openclawWs}`);
-    return openclawWs;
-  }
-  console.error(
-    "Usage: volute mind import [<workspace-path>] [--name <name>] [--session <path>] [--template <name>]\n\nNo OpenClaw workspace found. Provide a path, run from a workspace, or ensure ~/.openclaw/workspace exists."
-  );
-  process.exit(1);
-}
+// packages/daemon/src/lib/template/import-utils.ts
 function findOpenClawSession(workspaceDir) {
   const ocAgentsDir = resolve2(homedir(), ".openclaw/agents");
   if (!existsSync2(ocAgentsDir)) return void 0;
@@ -327,7 +199,6 @@ export {
   removeChannelMapping,
   resolveChannelMapping,
   findBridgeForChannel,
-  run,
   findOpenClawSession,
   sessionMatchesWorkspace,
   importPiSession,

package/dist/chunk-QHG4OMZL.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+
+// packages/extensions/pages/src/db.ts
+function initDb(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS published_pages (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      mind TEXT NOT NULL,
+      file TEXT NOT NULL,
+      published_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+      author TEXT
+    );
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_pp_mind_file ON published_pages(mind, file);
+    CREATE INDEX IF NOT EXISTS idx_pp_updated_at ON published_pages(updated_at);
+  `);
+  try {
+    db.exec("ALTER TABLE published_pages ADD COLUMN author TEXT");
+  } catch (err) {
+    if (!(err instanceof Error) || !err.message.includes("duplicate column")) {
+      throw err;
+    }
+  }
+}
+function getPublishedPages(db, mind) {
+  return db.prepare(
+    "SELECT file, published_at, updated_at, author FROM published_pages WHERE mind = ? ORDER BY file"
+  ).all(mind);
+}
+function getRecentPages(db, opts) {
+  const limit = opts?.limit ?? 10;
+  if (opts?.mind) {
+    return db.prepare(
+      "SELECT mind, file, updated_at, author FROM published_pages WHERE mind = ? ORDER BY updated_at DESC LIMIT ?"
+    ).all(opts.mind, limit);
+  }
+  return db.prepare(
+    "SELECT mind, file, updated_at, author FROM published_pages ORDER BY updated_at DESC LIMIT ?"
+  ).all(limit);
+}
+function getAllSites(db) {
+  const rows = db.prepare(
+    "SELECT mind, file, updated_at, author FROM published_pages WHERE mind != '_system' ORDER BY mind, file"
+  ).all();
+  const siteMap = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    let files = siteMap.get(row.mind);
+    if (!files) {
+      files = [];
+      siteMap.set(row.mind, files);
+    }
+    files.push({ file: row.file, updated_at: row.updated_at, author: row.author });
+  }
+  return Array.from(siteMap.entries()).map(([mind, files]) => ({ mind, files }));
+}
+function getSystemPages(db) {
+  const rows = db.prepare(
+    "SELECT mind, file, updated_at, author FROM published_pages WHERE mind = '_system' ORDER BY file"
+  ).all();
+  if (rows.length === 0) return null;
+  return {
+    mind: "_system",
+    files: rows.map((r) => ({ file: r.file, updated_at: r.updated_at, author: r.author }))
+  };
+}
+function syncSystemPages(db, htmlFiles, author) {
+  const existing = new Set(
+    db.prepare("SELECT file FROM published_pages WHERE mind = '_system'").all().map((r) => r.file)
+  );
+  const newSet = new Set(htmlFiles);
+  db.exec("BEGIN");
+  try {
+    for (const file of htmlFiles) {
+      if (existing.has(file)) {
+        if (author) {
+          db.prepare(
+            "UPDATE published_pages SET updated_at = datetime('now'), author = ? WHERE mind = '_system' AND file = ?"
+          ).run(author, file);
+        } else {
+          db.prepare(
+            "UPDATE published_pages SET updated_at = datetime('now') WHERE mind = '_system' AND file = ?"
+          ).run(file);
+        }
+      } else {
+        db.prepare("INSERT INTO published_pages (mind, file, author) VALUES ('_system', ?, ?)").run(
+          file,
+          author ?? null
+        );
+      }
+    }
+    for (const file of existing) {
+      if (!newSet.has(file)) {
+        db.prepare("DELETE FROM published_pages WHERE mind = '_system' AND file = ?").run(file);
+      }
+    }
+    db.exec("COMMIT");
+  } catch (err) {
+    db.exec("ROLLBACK");
+    throw err;
+  }
+}
+function syncPublishedPages(db, mind, pageFiles) {
+  const existing = new Map(
+    db.prepare("SELECT file, updated_at FROM published_pages WHERE mind = ?").all(mind).map((r) => [r.file, r.updated_at])
+  );
+  const newSet = new Set(pageFiles);
+  const added = [];
+  const updated = [];
+  const removed = [];
+  db.exec("BEGIN");
+  try {
+    for (const file of pageFiles) {
+      if (existing.has(file)) {
+        db.prepare(
+          "UPDATE published_pages SET updated_at = datetime('now') WHERE mind = ? AND file = ?"
+        ).run(mind, file);
+        updated.push(file);
+      } else {
+        db.prepare("INSERT INTO published_pages (mind, file) VALUES (?, ?)").run(mind, file);
+        added.push(file);
+      }
+    }
+    for (const [file] of existing) {
+      if (!newSet.has(file)) {
+        db.prepare("DELETE FROM published_pages WHERE mind = ? AND file = ?").run(mind, file);
+        removed.push(file);
+      }
+    }
+    db.exec("COMMIT");
+  } catch (err) {
+    db.exec("ROLLBACK");
+    throw err;
+  }
+  return { added, removed, updated };
+}
+
+export {
+  initDb,
+  getPublishedPages,
+  getRecentPages,
+  getAllSites,
+  getSystemPages,
+  syncSystemPages,
+  syncPublishedPages
+};

package/dist/chunk-RG5TOL4O.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+// packages/extensions/sdk/src/index.ts
+var VALID_EXTENSION_ID = /^[a-z0-9][a-z0-9_-]*$/;
+function createExtension(manifest) {
+  if (!manifest.id) throw new Error("Extension manifest requires an id");
+  if (!VALID_EXTENSION_ID.test(manifest.id))
+    throw new Error(
+      "Extension id must be lowercase alphanumeric with hyphens/underscores, starting with a letter or digit"
+    );
+  if (typeof manifest.routes !== "function")
+    throw new Error("Extension manifest requires a routes function");
+  return manifest;
+}
+
+export {
+  createExtension
+};

package/dist/{chunk-6WAWMWR5.js → chunk-SWW6AUVW.js}

@@ -2,9 +2,9 @@
 import {
   mindDir,
   stateDir
-} from "./chunk-N7BLAHNE.js";
+} from "./chunk-75AJ54GM.js";
 
-// src/lib/archive.ts
+// packages/daemon/src/lib/mind/archive.ts
 import { execFileSync } from "child_process";
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "fs";
 import { join, relative, resolve } from "path";

package/dist/{chunk-YUIHSKR6.js → chunk-T2TP6ZC6.js}

@@ -1,21 +1,33 @@
 #!/usr/bin/env node
 
-// src/lib/log-buffer.ts
+// packages/daemon/src/lib/util/log-buffer.ts
 var LogBuffer = class {
-  entries = [];
-  maxSize = 1e3;
+  constructor(maxSize = 1e3) {
+    this.maxSize = maxSize;
+    this.buffer = new Array(maxSize).fill(null);
+  }
+  buffer;
+  head = 0;
+  count = 0;
   subscribers = /* @__PURE__ */ new Set();
   append(entry) {
-    this.entries.push(entry);
-    if (this.entries.length > this.maxSize) {
-      this.entries.shift();
+    const idx = (this.head + this.count) % this.maxSize;
+    this.buffer[idx] = entry;
+    if (this.count === this.maxSize) {
+      this.head = (this.head + 1) % this.maxSize;
+    } else {
+      this.count++;
     }
     for (const sub of this.subscribers) {
       sub(entry);
     }
   }
   getEntries() {
-    return [...this.entries];
+    const result = [];
+    for (let i = 0; i < this.count; i++) {
+      result.push(this.buffer[(this.head + i) % this.maxSize]);
+    }
+    return result;
   }
   subscribe(fn) {
     this.subscribers.add(fn);
@@ -24,7 +36,7 @@ var LogBuffer = class {
 };
 var logBuffer = new LogBuffer();
 
-// src/lib/logger.ts
+// packages/daemon/src/lib/util/logger.ts
 var LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
 var minLevel = LEVELS[process.env.VOLUTE_LOG_LEVEL || "info"] ?? LEVELS.info;
 var output = (line) => process.stderr.write(`${line}