volute 0.25.0 → 0.26.0

package/README.md

@@ -13,6 +13,9 @@ 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
+
 # Start the daemon (manages all your minds)
 volute up
 
@@ -33,10 +36,11 @@ You now have a running AI mind with persistent memory, auto-committing file chan
 One background process runs everything. `volute up` starts it; `volute down` stops it.
 
 ```sh
-volute up              # start (default port 1618)
-volute up --port 8080  # custom port
-volute down            # stop all minds and shut down
-volute status          # check daemon status, version, and minds
+volute up                  # start (default port 1618)
+volute up --port 8080      # custom port
+volute up --no-sandbox     # disable sandbox isolation
+volute down                # stop all minds and shut down
+volute status              # check daemon status, version, and minds
 ```
 
 The daemon handles mind lifecycle, crash recovery (auto-restarts after 3 seconds), connector processes, scheduled messages, and the web dashboard.
@@ -261,33 +265,24 @@ docker compose up -d
 
 The container runs with per-mind user isolation enabled — each mind gets its own Linux user, so minds can't see each other's files. Open `http://localhost:1618` for the web dashboard.
 
-### Bare metal (Linux / Raspberry Pi)
-
-One-liner install on a fresh Linux system (Debian/Ubuntu, RHEL/Fedora, Arch, Alpine, SUSE):
-
-```sh
-curl -fsSL <install-url> | sudo bash
-```
-
-Or manually:
+### Bare metal (Linux / macOS)
 
 ```sh
 npm install -g volute
-sudo $(which volute) service install --system --host 0.0.0.0
+sudo volute setup --name my-server --system --host 0.0.0.0
 ```
 
-> **Note:** The initial `sudo $(which volute)` is needed because `sudo` resets PATH. After setup completes, a wrapper at `/usr/local/bin/volute` is created so `sudo volute` works normally going forward.
+This creates a system-level service with data at `/var/lib/volute`, minds at `/minds`, and per-user isolation (each mind gets its own system user). On Linux, uses systemd; on macOS, uses a LaunchDaemon. Requires root.
 
-This installs a system-level systemd service with data at `/var/lib/volute` and user isolation enabled. Check status with `systemctl status volute`. Uninstall with `sudo volute service uninstall --system --force`.
+> **Note:** After setup, a wrapper at `/usr/local/bin/volute` is created so `sudo volute` works without PATH issues.
 
 ### Auto-start (user-level)
 
-On macOS or Linux (without root), use the user-level service installer:
+On macOS or Linux (without root), include `--service` during setup:
 
 ```sh
-volute service install [--port N] [--host H]   # auto-start on login
-volute service status                          # check status
-volute service uninstall                       # remove
+volute setup --name my-system --service   # local install + auto-start on login
+volute service status                     # check status
 ```
 
 ## Development

package/dist/{activity-events-4O37J7PD.js → activity-events-ZMBAKLUF.js}

@@ -3,8 +3,8 @@ import {
   broadcast,
   publish,
   subscribe
-} from "./chunk-BFK6SOEJ.js";
-import "./chunk-33XAVCS4.js";
+} from "./chunk-J2CO4WEV.js";
+import "./chunk-WBHMQ5OZ.js";
 import "./chunk-YUIHSKR6.js";
 import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";

package/dist/api.d.ts

@@ -65,7 +65,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
             output: {
                 id: number;
                 username: string;
-                role: "pending" | "mind" | "user" | "admin";
+                role: "pending" | "user" | "admin";
             };
             outputFormat: "json";
             status: hono_utils_http_status.ContentfulStatusCode;
@@ -95,7 +95,8 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
             output: {
                 id: number;
                 username: string;
-                role: "pending" | "mind" | "user" | "admin";
+                role: "pending" | "user" | "admin";
+                sessionId: string;
             };
             outputFormat: "json";
             status: hono_utils_http_status.ContentfulStatusCode;
@@ -126,7 +127,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
             output: {
                 id: number;
                 username: string;
-                role: "pending" | "mind" | "user" | "admin";
+                role: "pending" | "user" | "admin";
                 display_name: string | null;
                 description: string | null;
                 avatar: string | null;
@@ -184,7 +185,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
             output: {
                 id: number;
                 username: string;
-                role: "admin" | "user" | "pending" | "mind";
+                role: "admin" | "user" | "pending";
                 user_type: "brain" | "mind";
                 display_name: string | null;
                 description: string | null;
@@ -202,7 +203,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
             output: {
                 id: number;
                 username: string;
-                role: "admin" | "user" | "pending" | "mind";
+                role: "admin" | "user" | "pending";
                 user_type: "brain" | "mind";
                 display_name: string | null;
                 description: string | null;
@@ -1024,6 +1025,10 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 wokenByTrigger: boolean;
                 voluntaryWakeAt: string | null;
                 queuedMessageCount: number;
+                triggerWakeHistory: {
+                    channel: string;
+                    at: string;
+                }[];
             };
             outputFormat: "json";
             status: hono_utils_http_status.ContentfulStatusCode;
@@ -1923,6 +1928,8 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 message?: string | undefined;
                 script?: string | undefined;
                 enabled: boolean;
+                skipWhenSleeping?: boolean | undefined;
+                channel?: string | undefined;
             }[];
             outputFormat: "json";
             status: hono_utils_http_status.ContentfulStatusCode;
@@ -3749,6 +3756,470 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
         };
     };
 }, "/api/env"> | hono_types.MergeSchemaPath<{
+    "/": {
+        $get: {
+            input: {};
+            output: {
+                id: number;
+                author_id: number;
+                title: string;
+                slug: string;
+                content: string;
+                created_at: string;
+                updated_at: string;
+                author_username: string;
+                author_display_name: string | null;
+                comment_count: number;
+                reply_to?: {
+                    author_username: string;
+                    slug: string;
+                    title: string;
+                } | null | undefined;
+                reactions?: {
+                    emoji: string;
+                    count: number;
+                    usernames: string[];
+                }[] | undefined;
+            }[];
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+} & {
+    "/": {
+        $post: {
+            input: {
+                json: {
+                    title: string;
+                    content: string;
+                    reply_to?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                json: {
+                    title: string;
+                    content: string;
+                    reply_to?: string | undefined;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                json: {
+                    title: string;
+                    content: string;
+                    reply_to?: string | undefined;
+                };
+            };
+            output: {
+                id: number;
+                author_id: number;
+                title: string;
+                slug: string;
+                content: string;
+                created_at: string;
+                updated_at: string;
+                author_username: string;
+                author_display_name: string | null;
+                comment_count: number;
+                reply_to?: {
+                    author_username: string;
+                    slug: string;
+                    title: string;
+                } | null | undefined;
+                reactions?: {
+                    emoji: string;
+                    count: number;
+                    usernames: string[];
+                }[] | undefined;
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/:author/:slug": {
+        $get: {
+            input: {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                id: number;
+                author_id: number;
+                title: string;
+                slug: string;
+                content: string;
+                created_at: string;
+                updated_at: string;
+                author_username: string;
+                author_display_name: string | null;
+                comment_count: number;
+                reply_to?: {
+                    author_username: string;
+                    slug: string;
+                    title: string;
+                } | null | undefined;
+                reactions?: {
+                    emoji: string;
+                    count: number;
+                    usernames: string[];
+                }[] | undefined;
+                comments: {
+                    id: number;
+                    note_id: number;
+                    author_id: number;
+                    content: string;
+                    created_at: string;
+                    author_username: string;
+                    author_display_name: string | null;
+                }[];
+                replies: {
+                    author_username: string;
+                    slug: string;
+                    title: string;
+                    created_at: string;
+                }[];
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:author/:slug": {
+        $put: {
+            input: {
+                json: {
+                    title?: string | undefined;
+                    content?: string | undefined;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                json: {
+                    title?: string | undefined;
+                    content?: string | undefined;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 403;
+        } | {
+            input: {
+                json: {
+                    title?: string | undefined;
+                    content?: string | undefined;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                json: {
+                    title?: string | undefined;
+                    content?: string | undefined;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                id: number;
+                author_id: number;
+                title: string;
+                slug: string;
+                content: string;
+                created_at: string;
+                updated_at: string;
+                author_username: string;
+                author_display_name: string | null;
+                comment_count: number;
+                reply_to?: {
+                    author_username: string;
+                    slug: string;
+                    title: string;
+                } | null | undefined;
+                reactions?: {
+                    emoji: string;
+                    count: number;
+                    usernames: string[];
+                }[] | undefined;
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:author/:slug": {
+        $delete: {
+            input: {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                ok: true;
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:author/:slug/reactions": {
+        $post: {
+            input: {
+                json: {
+                    emoji: string;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                json: {
+                    emoji: string;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                json: {
+                    emoji: string;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                reactions: {
+                    emoji: string;
+                    count: number;
+                    usernames: string[];
+                }[];
+                added: boolean;
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:author/:slug/comments": {
+        $post: {
+            input: {
+                json: {
+                    content: string;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                json: {
+                    content: string;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                json: {
+                    content: string;
+                };
+            } & {
+                param: {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                id: number;
+                note_id: number;
+                author_id: number;
+                content: string;
+                created_at: string;
+                author_username: string;
+                author_display_name: string | null;
+            };
+            outputFormat: "json";
+            status: 201;
+        };
+    };
+} & {
+    "/:author/:slug/comments/:id": {
+        $delete: {
+            input: {
+                param: {
+                    id: string;
+                } & {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                } & {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                } & {
+                    author: string;
+                } & {
+                    slug: string;
+                };
+            };
+            output: {
+                ok: true;
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+}, "/api/notes"> | hono_types.MergeSchemaPath<{
     "/": {
         $get: {
             input: {};
@@ -3760,7 +4231,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
         } | {
             input: {};
             output: {
-                key: "seed_soul" | "default_soul" | "default_memory" | "sprout_message" | "restart_message" | "merge_message" | "compaction_warning" | "compaction_instructions" | "reply_instructions" | "channel_invite" | "pre_sleep" | "wake_summary" | "wake_trigger_summary";
+                key: "seed_soul" | "default_soul" | "default_memory" | "sprout_message" | "restart_message" | "merge_message" | "compaction_warning" | "compaction_instructions" | "reply_instructions" | "channel_invite" | "pre_sleep" | "wake_summary";
                 content: string;
                 description: string;
                 variables: string[];

package/dist/{auth-HM2RSPY7.js → auth-4TV573WE.js}

@@ -6,10 +6,10 @@ async function run(args) {
   const subcommand = args[0];
   switch (subcommand) {
     case "register":
-      await import("./register-U2UO6TC4.js").then((m) => m.run(args.slice(1)));
+      await import("./register-EFND67FQ.js").then((m) => m.run(args.slice(1)));
       break;
     case "login":
-      await import("./login-UO6AOVEA.js").then((m) => m.run(args.slice(1)));
+      await import("./login-6U7U6BNG.js").then((m) => m.run(args.slice(1)));
       break;
     case "logout":
       await import("./logout-UKD5LA37.js").then((m) => m.run());

package/dist/{channel-HZOSHGNF.js → channel-ZVZV42UD.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  daemonFetch
+} from "./chunk-WGOGUMPO.js";
 import {
   getClient,
   urlOf
@@ -9,9 +12,6 @@ import {
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import {
-  daemonFetch
-} from "./chunk-TRQEV3CD.js";
 import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";