mercury-agent 0.4.26 → 0.4.27

package/README.md

@@ -131,6 +131,7 @@ Each space is a user-defined memory boundary with its own workspace and pi sessi
 | **Media** | Images, documents, voice notes | [docs/media/overview.md](docs/media/overview.md) |
 | **KB Distillation** | Extract lasting knowledge from chats | [docs/kb-distillation.md](docs/kb-distillation.md) |
 | **Extensions** | TypeScript plugins for CLIs, skills, jobs, hooks | [docs/extensions.md](docs/extensions.md) |
+| **DM Auto-Space** | Auto-create isolated spaces per customer DM | [docs/rate-limiting.md](docs/rate-limiting.md) |
 
 ---
 
@@ -377,6 +378,28 @@ Supported OAuth providers: Anthropic, GitHub Copilot, Google Gemini CLI, Antigra
 | `MERCURY_TRIGGER_PATTERNS` | `@Mercury,Mercury` | Trigger patterns |
 | `MERCURY_ADMINS` | — | Pre-seeded admin user IDs |
 
+### DM Auto-Space
+
+Auto-create isolated spaces for each customer who DMs your bot. Each customer gets their own space with persistent context, configurable permissions, and rate limits.
+
+```yaml
+# mercury.yaml
+dm_auto_space:
+  enabled: true
+  admin_ids:                                    # platform IDs — auto-link to "main" space
+    - "24417056866472"                          # WhatsApp LID, Telegram user ID, etc.
+  default_system_prompt: "You are a helpful assistant."
+  default_member_permissions: "prompt,prefs.get"  # restrict customers to chat only
+
+runtime:
+  rate_limit_daily_member: 20                   # global daily cap for members (0 = unlimited)
+  rate_limit_daily_admin: 0                     # global daily cap for admins (0 = unlimited)
+```
+
+`admin_ids` values are platform-specific identifiers — check the dashboard Conversations page to see the format (e.g. WhatsApp LID digits, Telegram numeric user ID).
+
+Auto-created spaces are seeded with `trigger.match=always`, `context.mode=context`, and the configured member permissions. Per-space rate limits are manageable from the dashboard.
+
 ### Per-space Config
 
 Conversations are discovered from incoming traffic. Unlinked conversations stay idle until you attach them to a space via `mercury link <conversation-id> <space-id>` or the dashboard.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mercury-agent",
-  "version": "0.4.26",
+  "version": "0.4.27",
   "description": "Personal AI assistant for chat platforms (WhatsApp, Slack, Discord, Telegram)",
   "license": "MIT",
   "author": "Avishai Tsabari",

package/resources/templates/mercury.example.yaml

@@ -1,84 +1,84 @@
-# Copy to mercury.yaml in your project root (optional).
-# Precedence: MERCURY_* env vars override this file when the env key is set.
-# Secrets (API keys, tokens, MERCURY_API_SECRET, etc.) belong in .env only — not here.
-
-# server:
-#   port: 8787
-#   bot_username: mercury
-
-# model:
-#   chain:
-#     - provider: anthropic
-#       model: claude-sonnet-4-20250514
-#   # Legacy single primary + optional fallback (when chain is omitted):
-#   # provider: anthropic
-#   # model: claude-sonnet-4-20250514
-#   # fallback_provider: openai
-#   # fallback: gpt-4o-mini
-#   # max_retries_per_leg: 2
-#   # chain_budget_ms: 120000
-#   # capabilities: { tools: false }
-
-# Top-level alias for model.chain (optional; model.chain wins if both are set):
-# model_chain:
-#   - provider: google
-#     model: gemini-2.5-flash
-
-# ingress:
-#   discord: false
-#   slack: false
-#   teams: false
-#   whatsapp: false
-#   telegram: false
-
-# runtime:
-#   data_dir: .mercury
-#   # auth_path: ...
-#   # whatsapp_auth_dir: .mercury/whatsapp-auth
-#   max_concurrency: 2
-#   log_level: info
-#   log_format: text
-#   rate_limit_per_user: 10
-#   rate_limit_window_ms: 60000
-#   rate_limit_daily_member: 0     # 0 = unlimited; global daily message cap for members
-#   rate_limit_daily_admin: 0      # 0 = unlimited; global daily message cap for admins
-
-# trigger:
-#   patterns: "@Mercury,Mercury"
-#   match: mention
-
-# conditional_context:
-#   enabled: true
-#   classifier: heuristic
-#   # classifier_provider: groq
-#   # classifier_model: llama-3.3-70b-versatile
-
-# compaction:
-#   keep_recent_tokens: 20000
-#   # After each full-session run, auto-compact if the pi session has more than this many entries (10–10000). Omit to disable.
-#   # auto_compact_threshold: 50
-
-# agent:
-#   image: ghcr.io/avishai-tsabari/mercury-agent:latest
-#   container_timeout_ms: 300000
-#   container_bwrap_docker_compat: false
-
-# discord:
-#   gateway_duration_ms: 600000
-
-# telegram:
-#   format_enabled: true
-
-# media:
-#   enabled: true
-#   max_size_mb: 10
-
-# permissions:
-#   admins: ""
-
-# dm_auto_space:
-#   enabled: false
-#   admin_numbers:                              # auto-link to "main" space
-#     - "972501234567"
-#   default_system_prompt: ""                   # seeded into auto-created customer spaces
-#   default_member_permissions: "prompt,prefs.get"  # restrict customers to chat only
+# Copy to mercury.yaml in your project root (optional).
+# Precedence: MERCURY_* env vars override this file when the env key is set.
+# Secrets (API keys, tokens, MERCURY_API_SECRET, etc.) belong in .env only — not here.
+
+# server:
+#   port: 8787
+#   bot_username: mercury
+
+# model:
+#   chain:
+#     - provider: anthropic
+#       model: claude-sonnet-4-20250514
+#   # Legacy single primary + optional fallback (when chain is omitted):
+#   # provider: anthropic
+#   # model: claude-sonnet-4-20250514
+#   # fallback_provider: openai
+#   # fallback: gpt-4o-mini
+#   # max_retries_per_leg: 2
+#   # chain_budget_ms: 120000
+#   # capabilities: { tools: false }
+
+# Top-level alias for model.chain (optional; model.chain wins if both are set):
+# model_chain:
+#   - provider: google
+#     model: gemini-2.5-flash
+
+# ingress:
+#   discord: false
+#   slack: false
+#   teams: false
+#   whatsapp: false
+#   telegram: false
+
+# runtime:
+#   data_dir: .mercury
+#   # auth_path: ...
+#   # whatsapp_auth_dir: .mercury/whatsapp-auth
+#   max_concurrency: 2
+#   log_level: info
+#   log_format: text
+#   rate_limit_per_user: 10
+#   rate_limit_window_ms: 60000
+#   rate_limit_daily_member: 0     # 0 = unlimited; global daily message cap for members
+#   rate_limit_daily_admin: 0      # 0 = unlimited; global daily message cap for admins
+
+# trigger:
+#   patterns: "@Mercury,Mercury"
+#   match: mention
+
+# conditional_context:
+#   enabled: true
+#   classifier: heuristic
+#   # classifier_provider: groq
+#   # classifier_model: llama-3.3-70b-versatile
+
+# compaction:
+#   keep_recent_tokens: 20000
+#   # After each full-session run, auto-compact if the pi session has more than this many entries (10–10000). Omit to disable.
+#   # auto_compact_threshold: 50
+
+# agent:
+#   image: ghcr.io/avishai-tsabari/mercury-agent:latest
+#   container_timeout_ms: 300000
+#   container_bwrap_docker_compat: false
+
+# discord:
+#   gateway_duration_ms: 600000
+
+# telegram:
+#   format_enabled: true
+
+# media:
+#   enabled: true
+#   max_size_mb: 10
+
+# permissions:
+#   admins: ""
+
+# dm_auto_space:
+#   enabled: false
+#   admin_ids:                              # auto-link to "main" space
+#     - "972501234567"
+#   default_system_prompt: ""                   # seeded into auto-created customer spaces
+#   default_member_permissions: "prompt,prefs.get"  # restrict customers to chat only

package/src/config-file.ts

@@ -167,7 +167,7 @@ const mercuryFileSchema = z
     dm_auto_space: z
       .object({
         enabled: z.boolean().optional(),
-        admin_numbers: z.array(z.string()).optional(),
+        admin_ids: z.array(z.string()).optional(),
         default_system_prompt: z.string().optional(),
         default_member_permissions: z.string().optional(),
       })
@@ -294,8 +294,8 @@ function flattenMercuryFile(f: MercuryFile): RawMercuryConfigInput {
   if (f.dm_auto_space?.enabled != null) {
     o.dmAutoSpaceEnabled = f.dm_auto_space.enabled;
   }
-  if (f.dm_auto_space?.admin_numbers != null) {
-    o.dmAutoSpaceAdminNumbers = f.dm_auto_space.admin_numbers.join(",");
+  if (f.dm_auto_space?.admin_ids != null) {
+    o.dmAutoSpaceAdminIds = f.dm_auto_space.admin_ids.join(",");
   }
   if (f.dm_auto_space?.default_system_prompt != null) {
     o.dmAutoSpaceDefaultSystemPrompt = f.dm_auto_space.default_system_prompt;
@@ -370,7 +370,7 @@ const CAMEL_TO_ENV: Record<string, string> = {
   rateLimitDailyMember: "MERCURY_RATE_LIMIT_DAILY_MEMBER",
   rateLimitDailyAdmin: "MERCURY_RATE_LIMIT_DAILY_ADMIN",
   dmAutoSpaceEnabled: "MERCURY_DM_AUTO_SPACE_ENABLED",
-  dmAutoSpaceAdminNumbers: "MERCURY_DM_AUTO_SPACE_ADMIN_NUMBERS",
+  dmAutoSpaceAdminIds: "MERCURY_DM_AUTO_SPACE_ADMIN_IDS",
   dmAutoSpaceDefaultSystemPrompt: "MERCURY_DM_AUTO_SPACE_DEFAULT_SYSTEM_PROMPT",
   dmAutoSpaceDefaultMemberPermissions:
     "MERCURY_DM_AUTO_SPACE_DEFAULT_MEMBER_PERMISSIONS",

package/src/config.ts

@@ -252,7 +252,7 @@ const schema = z.object({
 
   // ─── DM Auto-Space ─────────────────────────────────────────────────
   dmAutoSpaceEnabled: booleanFromEnv.default(false),
-  dmAutoSpaceAdminNumbers: z.string().default(""),
+  dmAutoSpaceAdminIds: z.string().default(""),
   dmAutoSpaceDefaultSystemPrompt: z.string().default(""),
   dmAutoSpaceDefaultMemberPermissions: z.string().default("prompt,prefs.get"),
 });

package/src/core/conversation.ts

@@ -9,7 +9,7 @@ export interface ConversationResolution {
 
 export interface AutoSpaceConfig {
   enabled: boolean;
-  adminNumbers: string[];
+  adminIds: string[];
   defaultSystemPrompt: string;
   defaultMemberPermissions: string;
   rateLimitDailyMember: number;
@@ -61,7 +61,7 @@ export function resolveConversation(
   if (!autoSpace?.enabled || kind !== "dm") return null;
 
   const senderNormalized = normalizePhone(externalId);
-  const isAdmin = autoSpace.adminNumbers.some(
+  const isAdmin = autoSpace.adminIds.some(
     (n) => normalizePhone(n) === senderNormalized,
   );
 

package/src/core/handler.ts

@@ -28,7 +28,7 @@ export function createMessageHandler(opts: MessageHandlerOptions) {
   const autoSpaceConfig: AutoSpaceConfig | undefined = config.dmAutoSpaceEnabled
     ? {
         enabled: true,
-        adminNumbers: config.dmAutoSpaceAdminNumbers
+        adminIds: config.dmAutoSpaceAdminIds
           .split(",")
           .map((s) => s.trim())
           .filter(Boolean),