volute 0.28.0 → 0.29.0

package/README.md

@@ -152,17 +152,27 @@ volute channel read discord:123456789 --mind atlas         # recent messages
 volute send discord:123456789 "hello" --mind atlas        # send a message
 ```
 
-## Schedules
+## Clock
 
-Cron-based scheduled messages — daily check-ins, periodic tasks, whatever you need.
+Schedules, timers, and sleep/wake cycles — a mind's daily rhythm.
 
 ```sh
-volute schedule add --mind atlas \
+# Recurring schedule
+volute clock add --mind atlas \
   --cron "0 9 * * *" \
   --message "good morning — write your daily log"
 
-volute schedule list --mind atlas
-volute schedule remove --mind atlas --id <schedule-id>
+# One-time timer
+volute clock add --mind atlas --in 30m --message "check on that task"
+
+# Sleep/wake
+volute clock sleep atlas --wake-at "2025-01-15T07:00:00Z"
+volute clock wake atlas
+
+# Status and management
+volute clock status --mind atlas
+volute clock list --mind atlas
+volute clock remove --mind atlas --id <schedule-id>
 ```
 
 ## Pages

package/dist/api.d.ts

@@ -1449,6 +1449,121 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
             status: hono_utils_http_status.ContentfulStatusCode;
         };
     };
+} & {
+    "/:name/conversations": {
+        $get: {
+            input: {
+                param: {
+                    name: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    name: string;
+                };
+            };
+            output: {
+                id: string;
+                mind_name: string | null;
+                channel: string;
+                type: "dm" | "channel";
+                name: string | null;
+                user_id: number | null;
+                title: string | null;
+                created_at: string;
+                updated_at: string;
+                participants: {
+                    userId: number;
+                    username: string;
+                    userType: "brain" | "mind" | "puppet";
+                    role: "owner" | "member";
+                    displayName?: string | null | undefined;
+                    description?: string | null | undefined;
+                    avatar?: string | null | undefined;
+                }[];
+                lastMessage?: {
+                    role: "user" | "assistant";
+                    senderName: string | null;
+                    text: string;
+                    createdAt: string;
+                } | undefined;
+            }[];
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+} & {
+    "/:name/conversations/:convId/messages": {
+        $get: {
+            input: {
+                param: {
+                    name: string;
+                } & {
+                    convId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    name: string;
+                } & {
+                    convId: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    name: string;
+                } & {
+                    convId: string;
+                };
+            };
+            output: {
+                items: {
+                    id: number;
+                    conversation_id: string;
+                    role: "user" | "assistant";
+                    sender_name: string | null;
+                    content: ({
+                        type: "text";
+                        text: string;
+                    } | {
+                        type: "tool_use";
+                        name: string;
+                        input: hono_utils_types.JSONValue;
+                    } | {
+                        type: "tool_result";
+                        output: string;
+                        is_error?: boolean | undefined;
+                    } | {
+                        type: "image";
+                        media_type: string;
+                        data: string;
+                    })[];
+                    created_at: string;
+                }[];
+                hasMore: boolean;
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
 } & {
     "/:name/budget": {
         $get: {
@@ -1876,6 +1991,72 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
         };
     };
 }, "/api/minds"> | hono_types.MergeSchemaPath<{
+    "/:name/clock/status": {
+        $get: {
+            input: {
+                param: {
+                    name: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    name: string;
+                };
+            };
+            output: {
+                sleep: {
+                    sleeping: boolean;
+                    sleepingSince: string | null;
+                    scheduledWakeAt: string | null;
+                    wokenByTrigger: boolean;
+                    voluntaryWakeAt: string | null;
+                    queuedMessageCount: number;
+                    triggerWakeHistory: {
+                        channel: string;
+                        at: string;
+                    }[];
+                } | null;
+                sleepConfig: {
+                    enabled?: boolean | undefined;
+                    schedule?: {
+                        sleep: string;
+                        wake: string;
+                    } | undefined;
+                    wakeTriggers?: {
+                        mentions?: boolean | undefined;
+                        dms?: boolean | undefined;
+                        channels?: string[] | undefined;
+                        senders?: string[] | undefined;
+                    } | undefined;
+                } | null;
+                schedules: {
+                    id: string;
+                    cron?: string | undefined;
+                    fireAt?: string | undefined;
+                    message?: string | undefined;
+                    script?: string | undefined;
+                    enabled: boolean;
+                    whileSleeping?: "skip" | "queue" | "trigger-wake" | undefined;
+                    skipWhenSleeping?: boolean | undefined;
+                    channel?: string | undefined;
+                }[];
+                upcoming: {
+                    id: string;
+                    at: string;
+                    type: "cron" | "timer";
+                }[];
+            };
+            outputFormat: "json";
+            status: hono_utils_http_status.ContentfulStatusCode;
+        };
+    };
+} & {
     "/:name/schedules": {
         $get: {
             input: {
@@ -1896,10 +2077,12 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
             };
             output: {
                 id: string;
-                cron: string;
+                cron?: string | undefined;
+                fireAt?: string | undefined;
                 message?: string | undefined;
                 script?: string | undefined;
                 enabled: boolean;
+                whileSleeping?: "skip" | "queue" | "trigger-wake" | undefined;
                 skipWhenSleeping?: boolean | undefined;
                 channel?: string | undefined;
             }[];
@@ -3381,7 +3564,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;
@@ -3427,7 +3610,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;
@@ -4287,7 +4470,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;
@@ -4372,7 +4555,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;
@@ -4444,7 +4627,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;
@@ -4467,7 +4650,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;
@@ -5018,7 +5201,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;
@@ -5149,7 +5332,7 @@ declare const routes: hono_hono_base.HonoBase<hono_types.BlankEnv, hono_types.Bl
                 id: string;
                 mind_name: string | null;
                 channel: string;
-                type: "dm" | "group" | "channel";
+                type: "dm" | "channel";
                 name: string | null;
                 user_id: number | null;
                 title: string | null;

package/dist/{chat-M4SX42JD.js → chat-KTPOR2JT.js}

@@ -16,7 +16,7 @@ async function run(args) {
       await import("./read-36UFXN3G.js").then((m) => m.run(subArgs));
       break;
     case "create":
-      await import("./create-D7J73A6H.js").then((m) => m.run(subArgs));
+      await import("./create-DFCAGEE5.js").then((m) => m.run(subArgs));
       break;
     case "bridge":
       await import("./bridge-FQHZL3MC.js").then((m) => m.run(subArgs));

package/dist/chunk-A6TUJJ3L.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+// src/lib/slugify.ts
+function slugify(text) {
+  return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function buildVoluteSlug(opts) {
+  if (opts.convType === "channel" && opts.convName) {
+    return `volute:#${opts.convName}`;
+  }
+  const other = opts.participants.find((p) => p.username !== opts.mindUsername);
+  const otherSlug = other ? slugify(other.username) : "";
+  return otherSlug ? `volute:@${otherSlug}` : `volute:${opts.conversationId}`;
+}
+
+export {
+  slugify,
+  buildVoluteSlug
+};