@dotsetlabs/dotclaw 2.1.0 → 2.2.0

package/.env.example

@@ -27,6 +27,12 @@ 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
+
 # --- Optional: System (set in shell before starting) ---
 # Override DotClaw home directory (defaults to ~/.dotclaw)
 # DOTCLAW_HOME=~/.dotclaw
@@ -39,12 +45,18 @@ TZ=America/New_York
 # Required for non-interactive bootstrap
 # DOTCLAW_BOOTSTRAP_CHAT_ID=123456789
 
+# Explicit provider selection (telegram or discord)
+# DOTCLAW_BOOTSTRAP_PROVIDER=telegram
+
 # Optional bootstrap defaults
 # DOTCLAW_BOOTSTRAP_GROUP_NAME=main
 # DOTCLAW_BOOTSTRAP_GROUP_FOLDER=main
 # DOTCLAW_BOOTSTRAP_BUILD=true
 # DOTCLAW_BOOTSTRAP_SELF_CHECK=true
 
+# Required for non-interactive configure
+# DOTCLAW_CONFIGURE_CHAT_ID=123456789
+
 # --- Optional: autotune (advanced) ---
 # Autotune uses dotenv, so these can live in .env if you run `npm run autotune`.
 # AUTOTUNE_TRACE_DIR=~/.dotclaw/traces

package/README.md

@@ -120,10 +120,13 @@ Or see:
 
 ```bash
 npm run dev          # Run with hot reload
-npm run build        # Compile TypeScript
+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)
+npm run build:all    # Build both host and container
 npm run lint         # Run ESLint
 npm test             # Run tests
-./container/build.sh # Rebuild agent container
+dotclaw build        # Rebuild agent container (or: ./container/build.sh)
 ```
 
 ## License

package/config-examples/runtime.json

@@ -15,6 +15,9 @@
       "port": 3002
     },
     "memory": {
+      "recall": {
+        "minScore": 0.35
+      },
       "embeddings": {
         "enabled": true
       }
@@ -22,32 +25,70 @@
     "routing": {
       "model": "moonshotai/kimi-k2.5",
       "fallbacks": ["anthropic/claude-sonnet-4-5", "openai/gpt-4.1"],
-      "maxOutputTokens": 4096,
-      "maxToolSteps": 50,
-      "temperature": 0.2,
+      "allowedModels": [],
+      "maxOutputTokens": 0,
+      "maxToolSteps": 200,
+      "temperature": 0.6,
       "recallMaxResults": 8,
       "recallMaxTokens": 1500
     },
+    "webhook": {
+      "enabled": false,
+      "port": 3003,
+      "token": ""
+    },
     "streaming": {
       "enabled": true,
       "chunkFlushIntervalMs": 200,
       "editIntervalMs": 400,
       "maxEditLength": 3800
     },
+    "telegram": {
+      "enabled": true
+    },
+    "discord": {
+      "enabled": false
+    },
     "toolBudgets": {
       "enabled": false
     }
   },
   "agent": {
     "assistantName": "Rain",
-    "reasoning": { "effort": "low" },
+    "reasoning": { "effort": "medium" },
+    "context": {
+      "maxHistoryTurns": 40,
+      "contextPruning": {
+        "softTrimMaxChars": 4000,
+        "softTrimHeadChars": 1500,
+        "softTrimTailChars": 1500,
+        "keepLastAssistant": 3
+      }
+    },
     "promptPacks": {
       "enabled": true
     },
     "tools": {
       "enableBash": true,
       "enableWebSearch": true,
-      "enableWebFetch": true
+      "enableWebFetch": true,
+      "bash": {
+        "timeoutMs": 600000
+      },
+      "process": {
+        "maxSessions": 16,
+        "maxOutputBytes": 1048576,
+        "defaultTimeoutMs": 1800000
+      }
+    },
+    "tts": {
+      "provider": "edge-tts",
+      "openaiModel": "tts-1",
+      "openaiVoice": "alloy"
+    },
+    "mcp": {
+      "enabled": true,
+      "servers": []
     }
   }
 }

package/config-examples/tool-budgets.json

@@ -6,7 +6,7 @@
       "Bash": 2000,
       "Python": 1500,
       "GitClone": 400,
-      "NpmInstall": 300
+      "PackageInstall": 300
     }
   },
   "groups": {

package/config-examples/tool-policy.json

@@ -7,7 +7,7 @@
       "Glob",
       "Grep",
       "GitClone",
-      "NpmInstall",
+      "PackageInstall",
       "WebSearch",
       "WebFetch",
       "Bash",

package/container/Dockerfile

@@ -37,6 +37,7 @@ RUN apt-get update && apt-get install -y \
     tree \
     ripgrep \
     graphviz \
+    poppler-utils \
     && rm -rf /var/lib/apt/lists/*
 
 # Install GitHub CLI (not in standard Debian repos)
@@ -51,7 +52,7 @@ RUN curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
 RUN echo 'node ALL=(ALL) NOPASSWD: ALL' > /etc/sudoers.d/node && chmod 0440 /etc/sudoers.d/node
 
 # Install common Python packages
-RUN pip3 install --break-system-packages pandas numpy requests beautifulsoup4 matplotlib Pillow openpyxl pyyaml tabulate chardet
+RUN pip3 install --break-system-packages pandas numpy requests beautifulsoup4 matplotlib Pillow openpyxl pyyaml tabulate chardet pdfminer.six httpx lxml cssselect python-docx python-pptx
 
 # Set Chromium path for agent-browser
 ENV AGENT_BROWSER_EXECUTABLE_PATH=/usr/bin/chromium
@@ -60,6 +61,9 @@ ENV PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium
 # Install agent-browser globally
 RUN npm install -g agent-browser
 
+# Enable pnpm via corepack (cross-platform lockfiles)
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
 # Create app directory
 WORKDIR /app
 

package/container/agent-runner/package.json

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

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

@@ -27,13 +27,19 @@ export type AgentRuntimeConfig = {
       summaryMaxOutputTokens: number;
       temperature: number;
       maxContextMessageTokens: number;
+      maxHistoryTurns: number;
+      contextPruning: {
+        softTrimMaxChars: number;
+        softTrimHeadChars: number;
+        softTrimTailChars: number;
+        keepLastAssistant: number;
+      };
     };
     memory: {
       maxResults: number;
       maxTokens: number;
       extraction: {
         enabled: boolean;
-        async: boolean;
         maxMessages: number;
         maxOutputTokens: number;
       };
@@ -98,6 +104,9 @@ export type AgentRuntimeConfig = {
       model: string;
       baseUrl: string;
       defaultVoice: string;
+      provider: 'edge-tts' | 'openai';
+      openaiModel: string;
+      openaiVoice: string;
     };
     browser: {
       enabled: boolean;
@@ -124,6 +133,11 @@ export type AgentRuntimeConfig = {
       maxSkills: number;
       maxSummaryChars: number;
     };
+    process: {
+      maxSessions: number;
+      maxOutputBytes: number;
+      defaultTimeoutMs: number;
+    };
   };
 };
 
@@ -147,21 +161,27 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
     canaryRate: 0.1
   },
   context: {
-    maxContextTokens: 24_000,
-    compactionTriggerTokens: 20_000,
+    maxContextTokens: 128_000,
+    compactionTriggerTokens: 120_000,
     recentContextTokens: 8000,
     summaryUpdateEveryMessages: 20,
-    maxOutputTokens: 4096,
+    maxOutputTokens: 8192,
     summaryMaxOutputTokens: 2048,
-    temperature: 0.2,
-    maxContextMessageTokens: 3000
+    temperature: 0.6,
+    maxContextMessageTokens: 4000,
+    maxHistoryTurns: 40,
+    contextPruning: {
+      softTrimMaxChars: 4_000,
+      softTrimHeadChars: 1_500,
+      softTrimTailChars: 1_500,
+      keepLastAssistant: 3
+    }
   },
   memory: {
     maxResults: 6,
     maxTokens: 2000,
     extraction: {
       enabled: true,
-      async: true,
       maxMessages: 4,
       maxOutputTokens: 1024
     },
@@ -173,7 +193,7 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
     memory: 'deepseek/deepseek-v3.2'
   },
   tools: {
-    maxToolSteps: 50,
+    maxToolSteps: 200,
     outputLimitBytes: 400_000,
     enableBash: true,
     enableWebSearch: true,
@@ -189,7 +209,7 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
       timeoutMs: 20_000
     },
     bash: {
-      timeoutMs: 120_000,
+      timeoutMs: 600_000,
       outputLimitBytes: 200_000
     },
     grepMaxFileBytes: 1_000_000,
@@ -225,7 +245,10 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
     enabled: true,
     model: 'edge-tts',
     baseUrl: '',
-    defaultVoice: 'en-US-AriaNeural'
+    defaultVoice: 'en-US-AriaNeural',
+    provider: 'edge-tts',
+    openaiModel: 'tts-1',
+    openaiVoice: 'alloy'
   },
   browser: {
     enabled: true,
@@ -233,21 +256,27 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
     screenshotQuality: 80
   },
   mcp: {
-    enabled: false,
+    enabled: true,
     servers: [],
     connectionTimeoutMs: 10_000
   },
   reasoning: {
-    effort: 'low',
+    effort: 'medium',
   },
   skills: {
     enabled: true,
     maxSkills: 32,
     maxSummaryChars: 4000,
+  },
+  process: {
+    maxSessions: 16,
+    maxOutputBytes: 1_048_576,
+    defaultTimeoutMs: 1_800_000,
   }
 };
 
 let cachedConfig: AgentRuntimeConfig | null = null;
+let cachedMtime: number | null = null;
 
 function cloneConfig<T>(value: T): T {
   return JSON.parse(JSON.stringify(value)) as T;
@@ -257,20 +286,25 @@ function isPlainObject(value: unknown): value is Record<string, unknown> {
   return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 
-function mergeDefaults<T>(base: T, overrides: unknown): T {
+function mergeDefaults<T>(base: T, overrides: unknown, pathPrefix = ''): T {
   if (!isPlainObject(overrides)) return cloneConfig(base);
   const result = cloneConfig(base) as Record<string, unknown>;
   const baseObj = base as Record<string, unknown>;
   for (const [key, value] of Object.entries(overrides)) {
     const current = baseObj[key];
+    const fullPath = pathPrefix ? `${pathPrefix}.${key}` : key;
     if (isPlainObject(current) && isPlainObject(value)) {
-      result[key] = mergeDefaults(current, value);
+      result[key] = mergeDefaults(current, value, fullPath);
       continue;
     }
     if (Array.isArray(current) && Array.isArray(value)) {
       result[key] = value;
       continue;
     }
+    if (current !== undefined && typeof value !== typeof current) {
+      console.error(`[agent-config] ${fullPath}: expected ${typeof current}, got ${typeof value}. Using default.`);
+      continue;
+    }
     if (typeof value === typeof current) {
       result[key] = value as unknown;
     }
@@ -291,7 +325,17 @@ function readJson(filePath: string): unknown {
 }
 
 export function loadAgentConfig(): AgentRuntimeConfig {
-  if (cachedConfig) return cachedConfig;
+  if (cachedConfig) {
+    // Check if file has been modified since last load
+    try {
+      const stat = fs.statSync(CONFIG_PATH);
+      if (cachedMtime !== null && stat.mtimeMs === cachedMtime) {
+        return cachedConfig;
+      }
+    } catch {
+      return cachedConfig;
+    }
+  }
   const raw = readJson(CONFIG_PATH);
 
   let defaultModel = DEFAULT_DEFAULT_MODEL;
@@ -326,5 +370,11 @@ export function loadAgentConfig(): AgentRuntimeConfig {
     daemonHeartbeatIntervalMs,
     agent: mergeDefaults(DEFAULT_AGENT_CONFIG, agentOverrides)
   };
+  try {
+    const stat = fs.statSync(CONFIG_PATH);
+    cachedMtime = stat.mtimeMs;
+  } catch {
+    cachedMtime = null;
+  }
   return cachedConfig;
 }

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

@@ -36,6 +36,10 @@ export interface ContainerInput {
   modelOverride?: string;
   modelFallbacks?: string[];
   reasoningEffort?: 'off' | 'low' | 'medium' | 'high';
+  modelCapabilities?: {
+    context_length: number;
+    max_completion_tokens?: number;
+  };
   modelContextTokens?: number;
   modelMaxOutputTokens?: number;
   modelTemperature?: number;
@@ -84,6 +88,8 @@ export interface ContainerOutput {
     output_truncated?: boolean;
   }>;
   latency_ms?: number;
+  /** Reply-to message ID parsed from agent output [[reply_to:<id>]] tags */
+  replyToId?: string;
   /** Set by the host container-runner when stdout was truncated before parsing */
   stdoutTruncated?: boolean;
 }

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

@@ -204,11 +204,8 @@ async function processRequests(): Promise<void> {
       if (!output) {
         throw new Error('Agent worker returned no output');
       }
-      if (fs.existsSync(cancelFile)) {
-        try { fs.unlinkSync(cancelFile); } catch { /* already removed */ }
-        try { fs.unlinkSync(filePath); } catch { /* request file already removed */ }
-        continue;
-      }
+      // Response completed successfully — always write it.
+      // Cancel during execution is already handled by runRequestWithCancellation().
       const responsePath = path.join(RESPONSES_DIR, `${requestId}.json`);
       const tmpPath = responsePath + '.tmp';
       fs.writeFileSync(tmpPath, JSON.stringify(output));
@@ -275,6 +272,21 @@ process.on('uncaughtException', (err) => {
   process.exit(1);
 });
 
+// --- MCP hot-reload ---
+
+const MCP_RELOAD_FILE = '/workspace/ipc/mcp_reload';
+
+async function checkMcpReload(): Promise<void> {
+  try {
+    if (fs.existsSync(MCP_RELOAD_FILE)) {
+      fs.unlinkSync(MCP_RELOAD_FILE);
+      log('MCP reload signal detected — agent will pick up new config on next run');
+    }
+  } catch {
+    // ignore
+  }
+}
+
 // --- Main loop ---
 
 async function loop(): Promise<void> {
@@ -284,6 +296,7 @@ async function loop(): Promise<void> {
 
   while (!shuttingDown) {
     try {
+      await checkMcpReload();
       await processRequests();
     } catch (err) {
       log(`Daemon loop error: ${err instanceof Error ? err.message : String(err)}`);