crawd 0.8.5 → 0.8.7

package/dist/cli.js

@@ -84,7 +84,9 @@ var ConfigSchema = z.object({
     /** Seconds of inactivity before going idle */
     idleAfter: z.number().default(180),
     /** Seconds of inactivity before going to sleep (must be > idleAfter) */
-    sleepAfter: z.number().default(360)
+    sleepAfter: z.number().default(360),
+    /** Seconds for chat batch throttle window (leading-edge) */
+    chatBatchWindow: z.number().default(20)
   }).default({}),
   /** Stream configuration */
   stream: z.object({
@@ -512,6 +514,9 @@ crawd config set vibe.idleAfter 180
 # Seconds of inactivity before going to sleep (default: 360)
 crawd config set vibe.sleepAfter 360
 
+# Chat batch throttle window in seconds (default: 20)
+crawd config set vibe.chatBatchWindow 20
+
 # Disable vibing entirely
 crawd config set vibe.enabled false
 \`\`\`
@@ -691,6 +696,7 @@ function buildEnv(config) {
   env.VIBE_INTERVAL_MS = String(config.vibe.interval * 1e3);
   env.IDLE_AFTER_MS = String(config.vibe.idleAfter * 1e3);
   env.SLEEP_AFTER_IDLE_MS = String((config.vibe.sleepAfter - config.vibe.idleAfter) * 1e3);
+  env.CHAT_BATCH_WINDOW_MS = String(config.vibe.chatBatchWindow * 1e3);
   env.YOUTUBE_ENABLED = String(config.chat.youtube.enabled);
   if (config.chat.youtube.videoId) {
     env.YOUTUBE_VIDEO_ID = config.chat.youtube.videoId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crawd",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "CLI for crawd.bot - AI agent livestreaming platform",
   "type": "module",
   "types": "./dist/types.d.ts",
@@ -23,14 +23,6 @@
   "bin": {
     "crawd": "./dist/cli.js"
   },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "build": "tsup src/cli.ts src/types.ts src/client.ts --format esm --dts --clean",
-    "build:backend": "tsup src/backend/index.ts --format esm --out-dir dist/backend --clean",
-    "build:plugin": "tsup src/plugin.ts --format esm --out-dir dist --dts",
-    "build:all": "pnpm build && pnpm build:backend",
-    "typecheck": "tsc --noEmit"
-  },
   "keywords": [
     "ai",
     "agent",
@@ -82,5 +74,13 @@
     "openclaw": {
       "optional": true
     }
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsup src/cli.ts src/types.ts src/client.ts --format esm --dts --clean",
+    "build:backend": "tsup src/backend/index.ts --format esm --out-dir dist/backend --clean",
+    "build:plugin": "tsup src/plugin.ts --format esm --out-dir dist --dts",
+    "build:all": "pnpm build && pnpm build:backend",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/src/backend/coordinator.ts

@@ -2,7 +2,6 @@ import { randomUUID } from 'crypto'
 import WebSocket from 'ws'
 import type { ChatMessage } from '../lib/chat/types'
 
-const DEFAULT_BATCH_WINDOW_MS = 20_000
 const SESSION_KEY = process.env.CRAWD_CHANNEL_ID || 'agent:main:crawd:live'
 
 /** Coordinator configuration */
@@ -15,8 +14,8 @@ export type CoordinatorConfig = {
   idleAfterMs: number
   /** Go sleep after this much inactivity while idle (ms). Default: 60000 (1 min) */
   sleepAfterIdleMs: number
-  /** Chat message batching window (ms). Default: 20000 (20 sec) */
-  chatBatchWindowMs: number
+  /** Chat batch throttle window (ms). Default: 20000 (20 sec) */
+  batchWindowMs: number
   /** The autonomous "vibe" prompt sent periodically */
   vibePrompt: string
 }
@@ -26,7 +25,7 @@ export const DEFAULT_CONFIG: CoordinatorConfig = {
   vibeIntervalMs: 30_000,
   idleAfterMs: 180_000,
   sleepAfterIdleMs: 180_000,
-  chatBatchWindowMs: DEFAULT_BATCH_WINDOW_MS,
+  batchWindowMs: 20_000,
   vibePrompt: `[CRAWD:VIBE] You are on a livestream. Make sure the crawd skill is loaded. Do one thing on the internet or ask the chat something. Respond with LIVESTREAM_REPLIED after using a tool, or NO_REPLY if you have nothing to say.`,
 }
 
@@ -557,9 +556,9 @@ export class Coordinator {
     this.config = { ...this.config, ...config }
     this.logger.log('[Coordinator] Config updated:', {
       vibeIntervalMs: this.config.vibeIntervalMs,
-      chatBatchWindowMs: this.config.chatBatchWindowMs,
       idleAfterMs: this.config.idleAfterMs,
       sleepAfterIdleMs: this.config.sleepAfterIdleMs,
+      batchWindowMs: this.config.batchWindowMs,
     })
   }
 
@@ -592,6 +591,7 @@ export class Coordinator {
       vibeIntervalMs: this.config.vibeIntervalMs,
       idleAfterMs: this.config.idleAfterMs,
       sleepAfterIdleMs: this.config.sleepAfterIdleMs,
+      batchWindowMs: this.config.batchWindowMs,
     })
   }
 
@@ -840,7 +840,7 @@ export class Coordinator {
     // Leading edge: if no timer running, flush immediately and start cooldown
     if (!this.timer) {
       this.flush()
-      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs)
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.batchWindowMs)
     }
     // Otherwise, message is buffered and will be flushed when cooldown ends
   }
@@ -851,7 +851,7 @@ export class Coordinator {
     // If messages accumulated during cooldown, flush them and restart cooldown
     if (this.buffer.length > 0) {
       this.flush()
-      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs)
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.batchWindowMs)
     }
   }
 

package/src/backend/server.ts

@@ -46,6 +46,7 @@ export type CrawdConfig = {
     intervalMs: number
     idleAfterMs: number
     sleepAfterIdleMs: number
+    batchWindowMs: number
     prompt?: string
   }
   chat: {
@@ -391,6 +392,7 @@ export class CrawdBackend {
         vibeIntervalMs: this.config.vibe.intervalMs,
         idleAfterMs: this.config.vibe.idleAfterMs,
         sleepAfterIdleMs: this.config.vibe.sleepAfterIdleMs,
+        batchWindowMs: this.config.vibe.batchWindowMs,
       }
       if (this.config.vibe.prompt) {
         coordConfig.vibePrompt = this.config.vibe.prompt
@@ -432,6 +434,11 @@ export class CrawdBackend {
         socket.emit('crawd:mcap', { mcap: this.latestMcap })
       }
 
+      // Sync current coordinator state so the overlay knows the initial animation
+      if (this.coordinator) {
+        socket.emit('crawd:status', { status: this.coordinator.state })
+      }
+
       socket.on('crawd:talk:done', (data: { id?: string }) => {
         if (data?.id) {
           this.logger.info(`Talk ack received: ${data.id}`)
@@ -620,6 +627,7 @@ export function configFromEnv(): CrawdConfig {
       intervalMs: Number(process.env.VIBE_INTERVAL_MS || 30_000),
       idleAfterMs: Number(process.env.IDLE_AFTER_MS || 180_000),
       sleepAfterIdleMs: Number(process.env.SLEEP_AFTER_IDLE_MS || 180_000),
+      batchWindowMs: Number(process.env.CHAT_BATCH_WINDOW_MS || 20_000),
       prompt: process.env.VIBE_PROMPT,
     },
     chat: {

package/src/commands/skill.ts

@@ -110,6 +110,9 @@ crawd config set vibe.idleAfter 180
 # Seconds of inactivity before going to sleep (default: 360)
 crawd config set vibe.sleepAfter 360
 
+# Chat batch throttle window in seconds (default: 20)
+crawd config set vibe.chatBatchWindow 20
+
 # Disable vibing entirely
 crawd config set vibe.enabled false
 \`\`\`

package/src/commands/start.ts

@@ -54,6 +54,7 @@ function buildEnv(config: Config): NodeJS.ProcessEnv {
   env.VIBE_INTERVAL_MS = String(config.vibe.interval * 1000)
   env.IDLE_AFTER_MS = String(config.vibe.idleAfter * 1000)
   env.SLEEP_AFTER_IDLE_MS = String((config.vibe.sleepAfter - config.vibe.idleAfter) * 1000)
+  env.CHAT_BATCH_WINDOW_MS = String(config.vibe.chatBatchWindow * 1000)
 
   env.YOUTUBE_ENABLED = String(config.chat.youtube.enabled)
   if (config.chat.youtube.videoId) {

package/src/config/schema.ts

@@ -50,6 +50,8 @@ export const ConfigSchema = z.object({
     idleAfter: z.number().default(180),
     /** Seconds of inactivity before going to sleep (must be > idleAfter) */
     sleepAfter: z.number().default(360),
+    /** Seconds for chat batch throttle window (leading-edge) */
+    chatBatchWindow: z.number().default(20),
   }).default({}),
 
   /** Stream configuration */

package/src/plugin.ts

@@ -99,6 +99,7 @@ function parsePluginConfig(raw: Record<string, unknown> | undefined): CrawdConfi
       intervalMs: typeof vibe.intervalMs === 'number' ? vibe.intervalMs : 10_000,
       idleAfterMs: typeof vibe.idleAfterMs === 'number' ? vibe.idleAfterMs : 30_000,
       sleepAfterIdleMs: typeof vibe.sleepAfterIdleMs === 'number' ? vibe.sleepAfterIdleMs : 60_000,
+      batchWindowMs: typeof vibe.batchWindowMs === 'number' ? vibe.batchWindowMs : 20_000,
       prompt: typeof vibe.prompt === 'string' ? vibe.prompt : undefined,
     },
     chat: {
@@ -145,6 +146,7 @@ const crawdConfigSchema = {
     'vibe.intervalMs': { label: 'Vibe Interval (ms)', advanced: true },
     'vibe.idleAfterMs': { label: 'Idle After (ms)', advanced: true },
     'vibe.sleepAfterIdleMs': { label: 'Sleep After Idle (ms)', advanced: true },
+    'vibe.batchWindowMs': { label: 'Chat Batch Window (ms)', advanced: true },
     'vibe.prompt': { label: 'Vibe Prompt', advanced: true },
     'chat.youtube.enabled': { label: 'YouTube Chat' },
     'chat.youtube.videoId': { label: 'YouTube Video ID' },
@@ -249,36 +251,6 @@ const plugin: PluginDefinition = {
       { name: 'livestream_reply' },
     )
 
-    // livestream_config — runtime coordinator tuning
-    api.registerTool(
-      {
-        name: 'livestream_config',
-        label: 'Livestream Config',
-        description:
-          'Update livestream coordinator settings at runtime. Use when asked to change vibe speed/frequency, chat throttle/batch window, idle timeout, or sleep timeout.',
-        parameters: Type.Object({
-          vibeIntervalMs: Type.Optional(Type.Number({ description: 'Milliseconds between autonomous vibe prompts (lower = more frequent vibes)' })),
-          chatBatchWindowMs: Type.Optional(Type.Number({ description: 'Milliseconds to batch chat messages before sending to agent (lower = faster chat response, higher = more messages per batch)' })),
-          idleAfterMs: Type.Optional(Type.Number({ description: 'Milliseconds of inactivity before transitioning to idle state' })),
-          sleepAfterIdleMs: Type.Optional(Type.Number({ description: 'Milliseconds in idle before transitioning to sleep state' })),
-          vibeEnabled: Type.Optional(Type.Boolean({ description: 'Enable or disable autonomous vibe prompts' })),
-        }),
-        async execute(_toolCallId: string, params: unknown) {
-          const b = await ensureBackend()
-          if (!b.coordinator) {
-            return { content: [{ type: 'text', text: 'Coordinator not running' }] }
-          }
-          const p = params as Record<string, unknown>
-          b.coordinator.updateConfig(p)
-          const { state, config: cfg } = b.coordinator.getState()
-          return {
-            content: [{ type: 'text', text: `Config updated. state=${state}, vibeInterval=${cfg.vibeIntervalMs}ms, chatBatch=${cfg.chatBatchWindowMs}ms, idleAfter=${cfg.idleAfterMs}ms, sleepAfter=${cfg.sleepAfterIdleMs}ms, vibes=${cfg.vibeEnabled}` }],
-          }
-        },
-      },
-      { name: 'livestream_config' },
-    )
-
     // Service lifecycle
     api.registerService({
       id: 'crawd',