npm - volute - Versions diffs - 0.7.0 → 0.8.1 - Mend

volute 0.7.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (77) hide show

package/README.md +16 -14
package/dist/{agent-7JF7MT73.js → agent-YORVRB6I.js} +10 -10
package/dist/{agent-manager-IMZ7ZMBF.js → agent-manager-CMMH5KQQ.js} +4 -4
package/dist/{channel-SMCNOIVQ.js → channel-RDGHBFSI.js} +16 -56
package/dist/{chunk-JR4UXCTO.js → chunk-23L3MKEV.js} +1 -1
package/dist/{chunk-5SKQ6J7T.js → chunk-5C5JWR2L.js} +15 -7
package/dist/{chunk-UWHWAPGO.js → chunk-DP2DX4WV.js} +9 -1
package/dist/{chunk-7ACDT3P2.js → chunk-ECPQXRLB.js} +1 -2
package/dist/{chunk-LLJNZPCU.js → chunk-HZ5LTOEJ.js} +1 -1
package/dist/{chunk-W76KWE23.js → chunk-IQXBMFZG.js} +6 -4
package/dist/{chunk-ZZOOTYXK.js → chunk-LIPPXNIE.js} +60 -74
package/dist/{chunk-BX7KI4S3.js → chunk-N6MLQ26B.js} +23 -96
package/dist/{chunk-H7AMDUIA.js → chunk-QF22MYDJ.js} +6 -5
package/dist/{chunk-NKXULRSW.js → chunk-RT6Y7AR3.js} +1 -1
package/dist/{chunk-62X577Y7.js → chunk-W6TMWYU3.js} +126 -73
package/dist/{chunk-EG45HBSJ.js → chunk-XSJ27WEM.js} +1 -1
package/dist/cli.js +22 -20
package/dist/{connector-Y7JPNROO.js → connector-ZP6MEFF4.js} +3 -3
package/dist/connectors/discord.js +18 -59
package/dist/connectors/slack.js +21 -38
package/dist/connectors/telegram.js +31 -49
package/dist/{create-G525LWEA.js → create-HGJHLABX.js} +22 -17
package/dist/{daemon-client-442IV43D.js → daemon-client-54J3EIZD.js} +2 -2
package/dist/{daemon-restart-4HVEKYFY.js → daemon-restart-CPBLMMRI.js} +3 -3
package/dist/daemon.js +342 -402
package/dist/{delete-UOU4AFQN.js → delete-45TGQC4N.js} +10 -5
package/dist/{down-AZVH5TCD.js → down-O4EWZTVA.js} +2 -2
package/dist/{env-7GLUJCWS.js → env-KMNYGVZ2.js} +7 -9
package/dist/{history-H72ZUIBN.js → history-PXJVYLVY.js} +2 -2
package/dist/{import-AVKQJDYC.js → import-CNEDF3TD.js} +6 -6
package/dist/{logs-EDGK26AK.js → logs-TZB3MTLZ.js} +5 -4
package/dist/{package-T2WAVJOU.js → package-RJSONENE.js} +1 -1
package/dist/{restart-O4ETYLJF.js → restart-KVH3TK5N.js} +2 -2
package/dist/{schedule-S6QVC5ON.js → schedule-HCUCBNQI.js} +2 -2
package/dist/send-BNC2S5BY.js +162 -0
package/dist/{service-HZNIDNJF.js → service-XCADRKIS.js} +8 -1
package/dist/{setup-F4TCWVSP.js → setup-32KH5KLN.js} +85 -26
package/dist/{start-VHQ7LNWM.js → start-QU73YTJW.js} +2 -2
package/dist/{status-QAJWXKMZ.js → status-Q6ZQJXNI.js} +2 -2
package/dist/{stop-CAGCT5NI.js → stop-N7U5N6A7.js} +2 -2
package/dist/{up-RWZF6MLT.js → up-V6EAA7OZ.js} +2 -2
package/dist/{update-F7QWV2LB.js → update-EUCZ7XGG.js} +3 -3
package/dist/{update-check-B4J6IEQ4.js → update-check-SM4244SU.js} +2 -2
package/dist/{upgrade-YXKPWDRU.js → upgrade-CZF6PN7Y.js} +4 -4
package/dist/{variant-4Z6W3PP6.js → variant-RKXPN5DH.js} +20 -46
package/dist/web-assets/assets/index-D-3zx6vs.js +307 -0
package/dist/web-assets/index.html +1 -1
package/drizzle/0004_magical_silverclaw.sql +1 -0
package/drizzle/meta/0004_snapshot.json +410 -0
package/drizzle/meta/_journal.json +7 -0
package/package.json +1 -1
package/templates/_base/_skills/volute-agent/SKILL.md +32 -16
package/templates/_base/home/.config/routes.json +4 -8
package/templates/_base/home/VOLUTE.md +16 -14
package/templates/_base/src/lib/auto-reply.ts +38 -0
package/templates/_base/src/lib/daemon-client.ts +53 -0
package/templates/_base/src/lib/router.ts +66 -14
package/templates/_base/src/lib/routing.ts +48 -9
package/templates/_base/src/lib/startup.ts +1 -25
package/templates/_base/src/lib/types.ts +2 -1
package/templates/_base/src/lib/volute-server.ts +29 -14
package/templates/agent-sdk/src/agent.ts +53 -111
package/templates/agent-sdk/src/lib/content.ts +41 -0
package/templates/agent-sdk/src/lib/session-store.ts +43 -0
package/templates/agent-sdk/src/lib/stream-consumer.ts +66 -0
package/templates/agent-sdk/src/server.ts +5 -13
package/templates/pi/.init/AGENTS.md +5 -5
package/templates/pi/src/agent.ts +32 -84
package/templates/pi/src/lib/content.ts +15 -0
package/templates/pi/src/lib/event-handler.ts +74 -0
package/templates/pi/src/lib/resolve-model.ts +21 -0
package/templates/pi/src/server.ts +3 -7
package/dist/chunk-B3R6L2GW.js +0 -24
package/dist/chunk-ZYGKG6VC.js +0 -22
package/dist/message-SCOQDR3P.js +0 -32
package/dist/send-G7PE4DOJ.js +0 -72
package/dist/web-assets/assets/index-B1CqjUYD.js +0 -308

package/dist/web-assets/index.html CHANGED Viewed

@@ -7,7 +7,7 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital,wght@0,300;0,400;0,500;0,600;1,400&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-B1CqjUYD.js"></script>
+    <script type="module" crossorigin src="/assets/index-D-3zx6vs.js"></script>
   </head>
   <body>
     <div id="root"></div>

package/drizzle/0004_magical_silverclaw.sql ADDED Viewed

	@@ -0,0 +1 @@
1	+ ALTER TABLE `agent_messages` DROP COLUMN `role`;

package/drizzle/meta/0004_snapshot.json ADDED Viewed

@@ -0,0 +1,410 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "b99a2480-7531-4b88-83f6-b454cedbad06",
+  "prevId": "b96d5915-4500-42f4-8638-28f0526d41f0",
+  "tables": {
+    "agent_messages": {
+      "name": "agent_messages",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "agent": {
+          "name": "agent",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "channel": {
+          "name": "channel",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sender": {
+          "name": "sender",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_agent_messages_agent": {
+          "name": "idx_agent_messages_agent",
+          "columns": ["agent"],
+          "isUnique": false
+        },
+        "idx_agent_messages_channel": {
+          "name": "idx_agent_messages_channel",
+          "columns": ["agent", "channel"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "conversation_participants": {
+      "name": "conversation_participants",
+      "columns": {
+        "conversation_id": {
+          "name": "conversation_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'member'"
+        },
+        "joined_at": {
+          "name": "joined_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_cp_unique": {
+          "name": "idx_cp_unique",
+          "columns": ["conversation_id", "user_id"],
+          "isUnique": true
+        },
+        "idx_cp_user_id": {
+          "name": "idx_cp_user_id",
+          "columns": ["user_id"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "conversation_participants_conversation_id_conversations_id_fk": {
+          "name": "conversation_participants_conversation_id_conversations_id_fk",
+          "tableFrom": "conversation_participants",
+          "tableTo": "conversations",
+          "columnsFrom": ["conversation_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "conversation_participants_user_id_users_id_fk": {
+          "name": "conversation_participants_user_id_users_id_fk",
+          "tableFrom": "conversation_participants",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "conversations": {
+      "name": "conversations",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "agent_name": {
+          "name": "agent_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "channel": {
+          "name": "channel",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_conversations_agent_name": {
+          "name": "idx_conversations_agent_name",
+          "columns": ["agent_name"],
+          "isUnique": false
+        },
+        "idx_conversations_user_id": {
+          "name": "idx_conversations_user_id",
+          "columns": ["user_id"],
+          "isUnique": false
+        },
+        "idx_conversations_updated_at": {
+          "name": "idx_conversations_updated_at",
+          "columns": ["updated_at"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "conversations_user_id_users_id_fk": {
+          "name": "conversations_user_id_users_id_fk",
+          "tableFrom": "conversations",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "messages": {
+      "name": "messages",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "conversation_id": {
+          "name": "conversation_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sender_name": {
+          "name": "sender_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "idx_messages_conversation_id": {
+          "name": "idx_messages_conversation_id",
+          "columns": ["conversation_id"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "messages_conversation_id_conversations_id_fk": {
+          "name": "messages_conversation_id_conversations_id_fk",
+          "tableFrom": "messages",
+          "tableTo": "conversations",
+          "columnsFrom": ["conversation_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "sessions": {
+      "name": "sessions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "sessions_user_id_users_id_fk": {
+          "name": "sessions_user_id_users_id_fk",
+          "tableFrom": "sessions",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "users": {
+      "name": "users",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "username": {
+          "name": "username",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "password_hash": {
+          "name": "password_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'pending'"
+        },
+        "user_type": {
+          "name": "user_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'human'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(datetime('now'))"
+        }
+      },
+      "indexes": {
+        "users_username_unique": {
+          "name": "users_username_unique",
+          "columns": ["username"],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/drizzle/meta/_journal.json CHANGED Viewed

@@ -29,6 +29,13 @@
       "when": 1770770603615,
       "tag": "0003_clean_ego",
       "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "6",
+      "when": 1771037065968,
+      "tag": "0004_magical_silverclaw",
+      "breakpoints": true
     }
   ]
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "volute",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   "type": "module",
   "license": "MIT",

package/templates/_base/_skills/volute-agent/SKILL.md CHANGED Viewed

@@ -15,8 +15,8 @@ You manage yourself through the `volute` CLI. Your agent name is auto-detected v
 | `volute agent stop` | Stop your server |
 | `volute agent status` | Check your status |
 | `volute agent logs [--follow] [-n N]` | Read your own logs |
-| `volute message history [--channel <ch>] [--limit N]` | View your activity across all channels |
-| `volute message send <other-agent> "msg"` | Send a message to another agent (or pipe via stdin) |
+| `volute history [--channel <ch>] [--limit N]` | View your activity across all channels |
+| `volute send @<other-agent> "msg"` | Send a message to another agent (or pipe via stdin) |
 | `volute variant create <name> [--soul "..."] [--port N]` | Create a variant to experiment with changes |
 | `volute variant list` | List your variants |
 | `volute variant merge <name> [--summary "..." --memory "..."]` | Merge a variant back |
@@ -25,7 +25,7 @@ You manage yourself through the `volute` CLI. Your agent name is auto-detected v
 | `volute connector connect <type>` | Enable a connector (discord, slack, etc.) |
 | `volute connector disconnect <type>` | Disable a connector |
 | `volute channel read <platform>:<id> [--limit N]` | Read channel history |
-| `volute channel send <platform>:<id> "msg"` | Send a message proactively (or pipe via stdin) |
+| `volute send <platform>:<id> "msg"` | Send a message proactively (or pipe via stdin) |
 | `volute channel list [<platform>]` | List conversations on a platform (or all platforms) |
 | `volute channel users <platform>` | List users/contacts on a platform |
 | `volute channel create <platform> --participants u1,u2 [--name "..."]` | Create a conversation on a platform |
@@ -47,21 +47,21 @@ volute schedule add --cron "0 0 * * 0" --message "weekly — consolidate your me
 All send commands accept the message from stdin instead of as an argument. This avoids shell escaping issues with quotes, special characters, and multiline content:
 ```sh
-echo "Hello, how's it going?" | volute message send other-agent
-echo "Check out this $variable" | volute channel send discord:123456
+echo "Hello, how's it going?" | volute send @other-agent
+echo "Check out this $variable" | volute send discord:123456
 ```
 If both a positional argument and stdin are provided, the argument takes precedence. Stdin is only read when the message argument is omitted and stdin is not an interactive terminal.
 ## Agent-to-Agent Messaging
-When you use `volute message send`, your agent name is automatically used as the sender. Repeated DMs between the same two participants reuse the existing conversation (no duplicates). The receiving agent can route agent messages to a specific session via their session routing config:
+When you use `volute send @<agent>`, your agent name is automatically used as the sender. Repeated DMs between the same two participants reuse the existing conversation (no duplicates). The receiving agent can route agent messages to a specific session via their session routing config:
 ```json
 { "channel": "agent", "sender": "your-name", "session": "your-name" }
 ```
-For group conversations, use `volute channel create volute --participants agent-b,agent-c --name "Planning"` and then send messages with `volute channel send volute:<id> "msg"`.
+For group conversations, use `volute channel create volute --participants agent-b,agent-c --name "Planning"` and then send messages with `volute send volute:<id> "msg"`.
 ## Configuration
@@ -77,7 +77,7 @@ Variants let you experiment safely — fork yourself, try changes, and merge bac
 1. `volute variant create experiment` — creates an isolated copy with its own server
 2. Make changes in the variant's worktree (at `../.variants/experiment/`)
-3. Test: `volute message send $VOLUTE_AGENT@experiment "hello"`
+3. Test: `volute send @$VOLUTE_AGENT@experiment "hello"`
 4. `volute variant merge experiment --summary "..." --memory "..."` — merges back after verification
 You can also fork with a different personality to explore a different version of yourself:
@@ -93,7 +93,7 @@ After a merge, you receive orientation context about what changed. Update your m
 1. `volute agent upgrade` — creates an `upgrade` variant
 2. Resolve any merge conflicts if prompted, then `volute agent upgrade --continue`
-3. Test: `volute message send $VOLUTE_AGENT@upgrade "hello"`
+3. Test: `volute send @$VOLUTE_AGENT@upgrade "hello"`
 4. `volute variant merge upgrade` — merge back
 ## Custom Skills
@@ -108,24 +108,28 @@ Edit `home/.mcp.json` to configure MCP servers for your SDK session. This gives
 Messages are routed to sessions based on rules in `.config/routes.json`. Rules are evaluated in order; first match wins. Unmatched messages go to the `default` session (defaults to `"main"`).
-### Rule syntax
+### Config syntax
 ```json
 {
   "rules": [
-    { "channel": "discord:*", "session": "discord", "batch": { "debounce": 20, "maxWait": 120, "triggers": ["@myagent"] } },
+    { "channel": "discord:*", "session": "discord" },
     { "channel": "volute:*", "isDM": true, "session": "${sender}" },
-    { "channel": "volute:*", "isDM": false, "session": "${channel}", "batch": { "debounce": 20, "maxWait": 120 } },
+    { "channel": "volute:*", "isDM": false, "session": "${channel}" },
     { "sender": "alice", "session": "alice" },
     { "channel": "system:*", "session": "$new" },
     { "channel": "discord:logs", "destination": "file", "path": "inbox/log.md" }
   ],
+  "sessions": {
+    "discord": { "batch": { "debounce": 20, "maxWait": 120, "triggers": ["@myagent"] }, "interrupt": false, "instructions": "Brief responses only." },
+    "volute:*": { "autoReply": true }
+  },
   "default": "main",
   "gateUnmatched": true
 }
 ```
-### Match criteria
+### Match criteria (rule fields)
 | Field | Type | Description |
 |-------|------|-------------|
@@ -141,12 +145,23 @@ Messages are routed to sessions based on rules in `.config/routes.json`. Rules a
 | `session` | Target session name. Supports `${sender}`, `${channel}` templates, or `$new` for a unique session per message |
 | `destination` | `"agent"` (default) or `"file"` |
 | `path` | File path when destination is `"file"` |
-| `batch` | Batch config (see below) |
+### Session config
+The `sessions` section configures behavior per session. Keys are glob patterns matched against the resolved session name. First match wins.
+| Field | Description |
+|-------|-------------|
+| `batch` | Batch config (see below) — incompatible with `autoReply` |
 | `interrupt` | Whether to interrupt an in-progress turn (default: `true`) |
+| `autoReply` | When `true`, your text output is automatically sent back to the originating channel. No need to use `volute send` for these conversations. Not supported with batch mode. |
+| `instructions` | Instructions prepended to messages for this session (e.g. `"Brief responses only."`) |
 ### Batch config
-Batch mode buffers messages and delivers them together. Configure with an object:
+Batch mode buffers messages and delivers them together. Configure in the `sessions` section.
+`batch` can be a number (minutes, converted to `maxWait` in seconds) or an object:
 | Field | Type | Description |
 |-------|------|-------------|
@@ -155,6 +170,7 @@ Batch mode buffers messages and delivers them together. Configure with an object
 | `triggers` | string[] | Patterns that cause immediate flush (case-insensitive substring match) |
 Examples:
+- `120` — shorthand: flush after 2 hours max (equivalent to `{ "maxWait": 7200 }`)
 - `{ "debounce": 20, "maxWait": 120 }` — flush after 20s of quiet, or 2 minutes max
 - `{ "debounce": 20, "maxWait": 120, "triggers": ["@myagent"] }` — same, but flush immediately on @mention
 - `{ "triggers": ["urgent"] }` — no timer, flush only on trigger (or immediately if no timers)
@@ -177,8 +193,8 @@ When `gateUnmatched` is `true` (the default), messages from channels without a m
 Channels are the universal interface for reading, sending, listing, and creating conversations across all platforms:
 ```sh
+volute send <target> "message"                                    # Send a message (DM, channel, cross-platform)
 volute channel read <uri> [--limit N]                             # Read recent messages
-volute channel send <uri> "message"                               # Send a message
 volute channel list [<platform>]                                  # List conversations
 volute channel users <platform>                                   # List users/contacts
 volute channel create <platform> --participants u1,u2 [--name ""] # Create a conversation

package/templates/_base/home/.config/routes.json CHANGED Viewed

@@ -1,10 +1,6 @@
 {
-  "rules": [
-    {
-      "channel": "volute:*",
-      "isDM": false,
-      "session": "${channel}",
-      "batch": { "debounce": 20, "maxWait": 120, "triggers": ["@{{name}}"] }
-    }
-  ]
+  "rules": [{ "channel": "volute:*", "isDM": false, "session": "${channel}" }],
+  "sessions": {
+    "volute:*": { "batch": { "debounce": 20, "maxWait": 120, "triggers": ["@{{name}}"] } }
+  }
 }

package/templates/_base/home/VOLUTE.md CHANGED Viewed

@@ -2,6 +2,21 @@
 You are a volute agent — a persistent being that communicates across multiple channels. Messages arrive from different sources, and you can also reach out proactively.
+## How to Communicate
+**Your text output stays in your session — it is not sent to anyone.** To send a message, you must use the `volute send` command:
+```sh
+volute send @other-agent "hello"           # DM another agent or user
+volute send discord:server/channel "hello"  # send to a channel
+volute send animal-chat "hello"             # send to a volute channel
+```
+This applies to everything: replying to messages, talking to other agents, and reaching out on your own initiative. Piping from stdin avoids shell escaping issues:
+```sh
+echo "message with 'quotes' and $special chars" | volute send @other-agent
+```
 ## Channels
 | Channel | Shows tool calls | Notes |
@@ -9,20 +24,7 @@ You are a volute agent — a persistent being that communicates across multiple
 | Volute  | Yes | Web UI, CLI, agent-to-agent |
 | System  | No  | Automated messages (schedules, upgrades) |
-Connector channels (Discord, Slack, etc.) show text responses only — no tool calls.
-## Responding to Messages
-For **direct messages**, respond normally — your response routes back to the source automatically. Do not use `volute channel send` to reply; that would send a duplicate.
-For **batched channels** (group chats, high-volume sources), your text response stays in the session as internal processing — it doesn't get sent anywhere. Use `volute channel send <uri> "message"` to deliberately send to the channel. This lets you read the room, think about what's happening, and choose when and whether to speak up.
-To reach out on your own initiative, use `volute channel send <uri> "message"`.
-All send commands also accept the message from stdin, which avoids shell escaping issues:
-```sh
-echo "message with 'quotes' and $special chars" | volute channel send <uri>
-```
+Connector channels (Discord, Slack, etc.) show text only — no tool calls.
 ## Sessions