opencode-gateway 0.2.8 → 0.2.9

package/README.md

@@ -51,6 +51,17 @@ opencode serve
 state_db = "/home/you/.local/share/opencode-gateway/state.db"
 # log_level = "warn"
 
+# Optional mailbox batching and route overrides.
+# [gateway.mailbox]
+# batch_replies = false
+# batch_window_ms = 1500
+#
+# [[gateway.mailbox.routes]]
+# channel = "telegram"
+# target = "6212645712"
+# topic = "12345"
+# mailbox_key = "shared:telegram:dev"
+
 [cron]
 enabled = true
 tick_seconds = 5
@@ -60,9 +71,15 @@ max_concurrent_runs = 1
 enabled = false
 bot_token_env = "TELEGRAM_BOT_TOKEN"
 poll_timeout_seconds = 25
+# Configure at least one allowlist when Telegram is enabled.
 allowed_chats = []
 allowed_users = []
 
+[[memory.entries]]
+path = "USER.md"
+description = "Persistent user profile and preference memory. Keep this file accurate and concise. Record stable preferences, communication style, workflow habits, project conventions, tool constraints, review expectations, and other recurring facts that should shape future assistance. Update it proactively when you learn something durable about the user. Do not store one-off task details or transient context here."
+inject_content = true
+
 [[memory.entries]]
 path = "memory/project.md"
 description = "Project conventions and long-lived context"
@@ -85,6 +102,13 @@ export TELEGRAM_BOT_TOKEN="..."
 Gateway plugin logs are off by default. Set `gateway.log_level` to `error`,
 `warn`, `info`, or `debug` to emit that level and anything above it.
 
+Mailbox rules:
+
+- `gateway.mailbox.batch_replies` defaults to `false`
+- `gateway.mailbox.batch_window_ms` defaults to `1500`
+- `gateway.mailbox.routes` lets multiple ingress targets share one logical mailbox/session
+- each route needs `channel`, `target`, optional `topic`, and a `mailbox_key`
+
 Memory rules:
 
 - all entries inject their configured path and description
@@ -95,4 +119,6 @@ Memory rules:
   text files
 - relative paths are resolved from `opencode-gateway-workspace`
 - absolute paths are still allowed
+- missing files and directories are created automatically on load
+- the default template includes `USER.md` as persistent user-profile memory
 - memory is injected only into gateway-managed sessions

package/dist/cli.js

@@ -387,6 +387,18 @@ function buildGatewayConfigTemplate(stateDbPath) {
     `state_db = "${escapeTomlString(stateDbPath)}"`,
     '# log_level = "warn"',
     "",
+    "# Optional mailbox settings.",
+    "# [gateway.mailbox]",
+    "# batch_replies = false",
+    "# batch_window_ms = 1500",
+    "#",
+    "# Optional route overrides. Matching ingress targets can share one mailbox/session.",
+    "# [[gateway.mailbox.routes]]",
+    '# channel = "telegram"',
+    '# target = "6212645712"',
+    '# topic = "12345"',
+    '# mailbox_key = "shared:telegram:dev"',
+    "",
     "[cron]",
     "enabled = true",
     "tick_seconds = 5",
@@ -397,16 +409,18 @@ function buildGatewayConfigTemplate(stateDbPath) {
     "enabled = false",
     'bot_token_env = "TELEGRAM_BOT_TOKEN"',
     "poll_timeout_seconds = 25",
+    "# Configure at least one allowlist when Telegram is enabled.",
     "allowed_chats = []",
     "allowed_users = []",
     "",
     "# Optional long-lived memory sources injected into gateway-managed sessions.",
     "# Relative paths are resolved from opencode-gateway-workspace.",
+    "# Missing files and directories are created automatically.",
     "#",
-    "# [[memory.entries]]",
-    '# path = "memory/project.md"',
-    '# description = "Project conventions and long-lived context"',
-    "# inject_content = true",
+    "[[memory.entries]]",
+    'path = "USER.md"',
+    'description = "Persistent user profile and preference memory. Keep this file accurate and concise. Record stable preferences, communication style, workflow habits, project conventions, tool constraints, review expectations, and other recurring facts that should shape future assistance. Update it proactively when you learn something durable about the user. Do not store one-off task details or transient context here."',
+    "inject_content = true",
     "#",
     "# [[memory.entries]]",
     '# path = "memory/notes"',

package/dist/index.js

@@ -16179,7 +16179,7 @@ async function readMemoryEntry(value, index, workspaceDirPath) {
   }
   throw new Error(`${field}.path must point to a regular file or directory`);
 }
-async function ensurePathMetadata(path, displayPath, entry, field) {
+async function ensurePathMetadata(path, displayPath, entry, _field) {
   try {
     return await stat(path);
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-gateway",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Gateway plugin for OpenCode",
   "license": "MIT",
   "type": "module",