@dotsetlabs/dotclaw 2.4.0 → 2.6.0

package/.env.example

@@ -8,16 +8,18 @@
 # (they are NOT read from .env unless the script explicitly loads dotenv).
 
 # --- Required (app runtime) ---
+# Set at least one provider token (Telegram or Discord).
+
 # Telegram bot token from @BotFather
-TELEGRAM_BOT_TOKEN=123456789:replace-with-real-token
+# TELEGRAM_BOT_TOKEN=123456789:replace-with-real-token
+
+# Discord bot token (from Discord Developer Portal)
+# DISCORD_BOT_TOKEN=replace-with-discord-token
 
 # OpenRouter API key
 OPENROUTER_API_KEY=sk-or-replace-with-real-key
 
 # --- Optional (app runtime) ---
-# Discord bot token (enables Discord provider)
-# DISCORD_BOT_TOKEN=replace-with-discord-token
-
 # Brave Search API key (enables WebSearch tool in the agent)
 BRAVE_SEARCH_API_KEY=replace-with-brave-key
 
@@ -27,11 +29,8 @@ TZ=America/New_York
 # GitHub Personal Access Token (enables gh CLI in containers)
 # GH_TOKEN=ghp_your_token_here
 
-# OpenAI API key (enables OpenAI TTS provider; falls back to OPENROUTER_API_KEY)
-# OPENAI_API_KEY=sk-replace-with-openai-key
-
-# Override vision model for the AnalyzeImage tool (defaults to openai/gpt-4o)
-# DOTCLAW_VISION_MODEL=openai/gpt-4o
+# Container-only overrides (for example OPENAI_API_KEY or DOTCLAW_VISION_MODEL)
+# should be set per group in ~/.dotclaw/data/registered_groups.json under containerConfig.env.
 
 # --- Optional: System (set in shell before starting) ---
 # Override DotClaw home directory (defaults to ~/.dotclaw)
@@ -63,7 +62,7 @@ TZ=America/New_York
 # AUTOTUNE_OUTPUT_DIR=~/.dotclaw/prompts
 # AUTOTUNE_CANARY_FRACTION=0.1
 # AUTOTUNE_BEHAVIOR_CONFIG_PATH=~/.dotclaw/config/behavior.json
-# AUTOTUNE_BEHAVIOR_REPORT_DIR=~/.dotclaw/config
+# AUTOTUNE_BEHAVIOR_REPORT_DIR=~/.dotclaw/data
 # AUTOTUNE_BEHAVIOR_ENABLED=1
 
 # --- Internal (do not set) ---

package/README.md

@@ -23,9 +23,10 @@ Personal OpenRouter-based assistant for Telegram and Discord. Each request runs
 
 - Node.js 20+
 - Docker (running)
-- Telegram bot token (from @BotFather)
+- At least one provider token:
+  - Telegram bot token (from @BotFather), or
+  - Discord bot token
 - OpenRouter API key
-- Discord bot token (optional — for Discord provider)
 
 ## Quick Start
 
@@ -64,7 +65,10 @@ dotclaw groups       # List registered chats
 dotclaw build        # Build the Docker container image
 dotclaw add-instance # Create and start an isolated instance
 dotclaw instances    # List discovered instances
+dotclaw install-service   # Install launchd/systemd service
+dotclaw uninstall-service # Remove launchd/systemd service
 dotclaw version      # Show installed version
+dotclaw help         # Show help
 ```
 
 Instance flags:
@@ -80,7 +84,7 @@ All configuration and data is stored in `~/.dotclaw/`:
 
 ```
 ~/.dotclaw/
-  .env                    # Secrets (Telegram, OpenRouter keys)
+  .env                    # Secrets (provider tokens, OpenRouter key, optional Brave/GH keys)
   config/
     runtime.json          # Runtime overrides
     model.json            # Model selection
@@ -119,7 +123,7 @@ Or see:
 ## Development
 
 ```bash
-npm run dev          # Run with hot reload
+npm run dev          # Run from source (tsx)
 npm run dev:up       # Full dev cycle: rebuild container + kill stale daemons + start dev
 npm run dev:down     # Remove all running dotclaw agent containers
 npm run build        # Compile TypeScript (host)

package/config-examples/runtime.json

@@ -4,8 +4,17 @@
     "container": {
       "mode": "daemon",
       "privileged": true,
+      "daemonPollMs": 100,
       "instanceId": ""
     },
+    "messageQueue": {
+      "promptMaxChars": 24000
+    },
+    "concurrency": {
+      "maxAgents": 4,
+      "laneStarvationMs": 15000,
+      "maxConsecutiveInteractive": 3
+    },
     "metrics": {
       "port": 3001,
       "enabled": true
@@ -20,6 +29,10 @@
       },
       "embeddings": {
         "enabled": true
+      },
+      "backend": {
+        "strategy": "builtin",
+        "modulePath": ""
       }
     },
     "routing": {
@@ -30,7 +43,11 @@
       "maxToolSteps": 200,
       "temperature": 0.6,
       "recallMaxResults": 8,
-      "recallMaxTokens": 1500
+      "recallMaxTokens": 1500,
+      "hostFailover": {
+        "enabled": true,
+        "maxRetries": 1
+      }
     },
     "webhook": {
       "enabled": false,
@@ -39,7 +56,7 @@
     },
     "streaming": {
       "enabled": true,
-      "chunkFlushIntervalMs": 200,
+      "chunkFlushIntervalMs": 120,
       "editIntervalMs": 400,
       "maxEditLength": 3800
     },
@@ -57,6 +74,7 @@
     "assistantName": "Rain",
     "reasoning": { "effort": "medium" },
     "context": {
+      "recentContextTokens": 0,
       "maxHistoryTurns": 40,
       "contextPruning": {
         "softTrimMaxChars": 4000,
@@ -72,22 +90,30 @@
       "enableBash": true,
       "enableWebSearch": true,
       "enableWebFetch": true,
+      "completionGuard": {
+        "idempotentRetryAttempts": 2,
+        "idempotentRetryBackoffMs": 500,
+        "repeatedSignatureThreshold": 3,
+        "repeatedRoundThreshold": 2,
+        "nonRetryableFailureThreshold": 3,
+        "forceSynthesisAfterTools": true
+      },
       "bash": {
         "timeoutMs": 600000
-      },
-      "process": {
-        "maxSessions": 16,
-        "maxOutputBytes": 1048576,
-        "defaultTimeoutMs": 1800000
       }
     },
+    "process": {
+      "maxSessions": 16,
+      "maxOutputBytes": 1048576,
+      "defaultTimeoutMs": 1800000
+    },
     "tts": {
       "provider": "edge-tts",
       "openaiModel": "tts-1",
       "openaiVoice": "alloy"
     },
     "mcp": {
-      "enabled": true,
+      "enabled": false,
       "servers": []
     }
   }

package/config-examples/tool-policy.json

@@ -13,6 +13,8 @@
       "Bash",
       "Python",
       "Browser",
+      "Process",
+      "AnalyzeImage",
       "mcp__dotclaw__send_message",
       "mcp__dotclaw__send_file",
       "mcp__dotclaw__send_photo",
@@ -41,14 +43,22 @@
       "mcp__dotclaw__memory_forget",
       "mcp__dotclaw__memory_list",
       "mcp__dotclaw__memory_search",
-      "mcp__dotclaw__memory_stats"
+      "mcp__dotclaw__memory_stats",
+      "mcp__dotclaw__get_config",
+      "mcp__dotclaw__set_tool_policy",
+      "mcp__dotclaw__set_behavior",
+      "mcp__dotclaw__set_mcp_config",
+      "mcp__dotclaw__subagent"
     ],
     "deny": [],
     "max_per_run": {
       "Bash": 128,
       "Python": 64,
       "WebSearch": 40,
-      "WebFetch": 60
+      "WebFetch": 60,
+      "Process": 128,
+      "AnalyzeImage": 16,
+      "mcp__dotclaw__subagent": 8
     },
     "default_max_per_run": 256
   }

package/container/agent-runner/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "dotclaw-agent-runner",
-  "version": "1.9.0",
+  "version": "2.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "dotclaw-agent-runner",
-      "version": "1.9.0",
+      "version": "2.3.0",
       "dependencies": {
         "@openrouter/sdk": "^0.3.0",
         "cron-parser": "^5.0.0",

package/container/agent-runner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotclaw-agent-runner",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "type": "module",
   "description": "Container-side agent runner for DotClaw",
   "main": "dist/index.js",

package/container/agent-runner/src/agent-config.ts

@@ -56,6 +56,14 @@ export type AgentRuntimeConfig = {
       enableBash: boolean;
       enableWebSearch: boolean;
       enableWebFetch: boolean;
+      completionGuard: {
+        idempotentRetryAttempts: number;
+        idempotentRetryBackoffMs: number;
+        repeatedSignatureThreshold: number;
+        repeatedRoundThreshold: number;
+        nonRetryableFailureThreshold: number;
+        forceSynthesisAfterTools: boolean;
+      };
       webfetch: {
         blockPrivate: boolean;
         allowlist: string[];
@@ -143,7 +151,7 @@ export type AgentRuntimeConfig = {
 
 const CONFIG_PATH = '/workspace/config/runtime.json';
 const DEFAULT_DEFAULT_MODEL = 'moonshotai/kimi-k2.5';
-const DEFAULT_DAEMON_POLL_MS = 200;
+const DEFAULT_DAEMON_POLL_MS = 100;
 const DEFAULT_DAEMON_HEARTBEAT_INTERVAL_MS = 1_000;
 
 const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
@@ -163,7 +171,7 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
   context: {
     maxContextTokens: 128_000,
     compactionTriggerTokens: 120_000,
-    recentContextTokens: 0, // 0 = auto: 50% of model context window
+    recentContextTokens: 0, // 0 = auto: 35% of model context window (capped at 24K)
     summaryUpdateEveryMessages: 20,
     maxOutputTokens: 8192,
     summaryMaxOutputTokens: 2048,
@@ -198,6 +206,14 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
     enableBash: true,
     enableWebSearch: true,
     enableWebFetch: true,
+    completionGuard: {
+      idempotentRetryAttempts: 2,
+      idempotentRetryBackoffMs: 500,
+      repeatedSignatureThreshold: 3,
+      repeatedRoundThreshold: 2,
+      nonRetryableFailureThreshold: 3,
+      forceSynthesisAfterTools: true
+    },
     webfetch: {
       blockPrivate: true,
       allowlist: [],
@@ -256,7 +272,7 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
     screenshotQuality: 80
   },
   mcp: {
-    enabled: true,
+    enabled: false,
     servers: [],
     connectionTimeoutMs: 10_000
   },

package/container/agent-runner/src/container-protocol.ts

@@ -13,6 +13,7 @@ export interface ContainerInput {
   userName?: string;
   maxToolSteps?: number;
   memoryRecall?: string[];
+  memoryRecallAttempted?: boolean;
   userProfile?: string | null;
   memoryStats?: {
     total: number;
@@ -92,4 +93,14 @@ export interface ContainerOutput {
   replyToId?: string;
   /** Set by the host container-runner when stdout was truncated before parsing */
   stdoutTruncated?: boolean;
+  /** Number of in-loop idempotent tool retries attempted */
+  tool_retry_attempts?: number;
+  /** True when a forced final synthesis pass was used after tool execution */
+  tool_outcome_verification_forced?: boolean;
+  /** True when repeated tool signatures triggered loop-break protection */
+  tool_loop_breaker_triggered?: boolean;
+  /** Reason emitted when the tool loop breaker triggered */
+  tool_loop_breaker_reason?: string;
+  /** Error from fire-and-forget memory extraction in daemon mode */
+  memory_extraction_error?: string;
 }

package/container/agent-runner/src/context-overflow-recovery.ts

@@ -0,0 +1,39 @@
+export type ContextMessageLike = {
+  role: 'user' | 'assistant';
+  content: string;
+};
+
+export type ContextOverflowRecoveryPlan = {
+  toCompact: ContextMessageLike[];
+  toKeep: ContextMessageLike[];
+  retryInput: Array<{ role: 'user' | 'assistant'; content: string }>;
+};
+
+export function buildContextOverflowRecoveryPlan(params: {
+  contextMessages: ContextMessageLike[];
+  emergencySummary?: string | null;
+  keepRecentCount?: number;
+}): ContextOverflowRecoveryPlan {
+  const keepRecentCount = Number.isFinite(params.keepRecentCount)
+    ? Math.max(1, Math.floor(Number(params.keepRecentCount)))
+    : 4;
+  const contextMessages = Array.isArray(params.contextMessages)
+    ? params.contextMessages
+    : [];
+
+  const keepStart = Math.max(0, contextMessages.length - keepRecentCount);
+  const toCompact = contextMessages.slice(0, keepStart);
+  const toKeep = contextMessages.slice(keepStart);
+  const emergencySummary = (params.emergencySummary || '').trim();
+
+  const retryInput = emergencySummary
+    ? [{ role: 'user' as const, content: `[Previous conversation summary: ${emergencySummary}]` },
+      ...toKeep.map(msg => ({ role: msg.role, content: msg.content }))]
+    : toKeep.map(msg => ({ role: msg.role, content: msg.content }));
+
+  return {
+    toCompact,
+    toKeep,
+    retryInput
+  };
+}