crawd 0.8.3 → 0.8.5

package/dist/backend/index.js

@@ -11205,13 +11205,14 @@ var YouTubeChatClient = class extends BaseChatClient {
 // src/backend/coordinator.ts
 import { randomUUID } from "crypto";
 import WebSocket from "ws";
-var BATCH_WINDOW_MS = 2e4;
+var DEFAULT_BATCH_WINDOW_MS = 2e4;
 var SESSION_KEY = process.env.CRAWD_CHANNEL_ID || "agent:main:crawd:live";
 var DEFAULT_CONFIG = {
   vibeEnabled: true,
   vibeIntervalMs: 3e4,
   idleAfterMs: 18e4,
   sleepAfterIdleMs: 18e4,
+  chatBatchWindowMs: DEFAULT_BATCH_WINDOW_MS,
   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.`
 };
 var realClock = {
@@ -11443,7 +11444,7 @@ var GatewayClient = class _GatewayClient {
 };
 var STARTUP_GRACE_MS = 3e4;
 var SLEEP_CHECK_INTERVAL_MS = 1e4;
-var Coordinator = class {
+var Coordinator = class _Coordinator {
   buffer = [];
   timer = null;
   triggerFn;
@@ -11482,6 +11483,7 @@ var Coordinator = class {
     this.config = { ...this.config, ...config2 };
     this.logger.log("[Coordinator] Config updated:", {
       vibeIntervalMs: this.config.vibeIntervalMs,
+      chatBatchWindowMs: this.config.chatBatchWindowMs,
       idleAfterMs: this.config.idleAfterMs,
       sleepAfterIdleMs: this.config.sleepAfterIdleMs
     });
@@ -11648,14 +11650,18 @@ var Coordinator = class {
       this._busy = true;
       try {
         const replies = await this.triggerFn(this.config.vibePrompt);
-        if (replies.some((r) => r.trim().toUpperCase() === "NO_REPLY")) {
+        const agentReplies = replies.filter((r) => !this.isApiError(r));
+        if (agentReplies.some((r) => r.trim().toUpperCase() === "NO_REPLY")) {
           noReply = true;
-        } else if (!this.isCompliantReply(replies)) {
-          misaligned = replies.filter((r) => {
+        } else if (!this.isCompliantReply(agentReplies)) {
+          misaligned = agentReplies.filter((r) => {
             const t = r.trim().toUpperCase();
             return t !== "NO_REPLY" && t !== "LIVESTREAM_REPLIED";
           });
         }
+        if (replies.length > agentReplies.length) {
+          this.logger.warn(`[Coordinator] Filtered ${replies.length - agentReplies.length} API error(s) from vibe response`);
+        }
       } catch (err) {
         this.logger.error("[Coordinator] Vibe failed:", err);
       } finally {
@@ -11701,26 +11707,31 @@ var Coordinator = class {
     }
     if (!this.timer) {
       this.flush();
-      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), BATCH_WINDOW_MS);
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs);
     }
   }
   onCooldownEnd() {
     this.timer = null;
     if (this.buffer.length > 0) {
       this.flush();
-      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), BATCH_WINDOW_MS);
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs);
     }
   }
   /** Whether the coordinator is busy processing a flush or talk */
   get busy() {
     return this._busy;
   }
+  /** Detect API/gateway errors surfaced as reply strings (e.g. rate limits) */
+  static API_ERROR_RE = /^\d{3}\s+(status\s+code|error)|^rate\s*limit|^too\s+many\s+requests|^overloaded|^server\s+error/i;
+  isApiError(reply) {
+    return _Coordinator.API_ERROR_RE.test(reply.trim());
+  }
   /** Check if agent replies are compliant (NO_REPLY or LIVESTREAM_REPLIED) */
   isCompliantReply(replies) {
     if (replies.length === 0) return true;
     return replies.every((r) => {
       const t = r.trim().toUpperCase();
-      return t === "NO_REPLY" || t === "LIVESTREAM_REPLIED";
+      return t === "NO_REPLY" || t === "LIVESTREAM_REPLIED" || this.isApiError(r);
     });
   }
   /** Send misalignment correction when agent responds with plaintext */
@@ -11746,8 +11757,12 @@ var Coordinator = class {
       this._busy = true;
       try {
         const replies = await this.triggerFn(batchText);
-        if (!this.isCompliantReply(replies)) {
-          await this.sendMisalignment(replies.filter((r) => {
+        const agentReplies = replies.filter((r) => !this.isApiError(r));
+        if (replies.length > agentReplies.length) {
+          this.logger.warn(`[Coordinator] Filtered ${replies.length - agentReplies.length} API error(s) from chat response`);
+        }
+        if (!this.isCompliantReply(agentReplies)) {
+          await this.sendMisalignment(agentReplies.filter((r) => {
             const t = r.trim().toUpperCase();
             return t !== "NO_REPLY" && t !== "LIVESTREAM_REPLIED";
           }));

package/dist/plugin.js

@@ -11206,13 +11206,14 @@ var YouTubeChatClient = class extends BaseChatClient {
 // src/backend/coordinator.ts
 import { randomUUID } from "crypto";
 import WebSocket from "ws";
-var BATCH_WINDOW_MS = 2e4;
+var DEFAULT_BATCH_WINDOW_MS = 2e4;
 var SESSION_KEY = process.env.CRAWD_CHANNEL_ID || "agent:main:crawd:live";
 var DEFAULT_CONFIG = {
   vibeEnabled: true,
   vibeIntervalMs: 3e4,
   idleAfterMs: 18e4,
   sleepAfterIdleMs: 18e4,
+  chatBatchWindowMs: DEFAULT_BATCH_WINDOW_MS,
   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.`
 };
 var realClock = {
@@ -11321,7 +11322,7 @@ var OneShotGateway = class {
 };
 var STARTUP_GRACE_MS = 3e4;
 var SLEEP_CHECK_INTERVAL_MS = 1e4;
-var Coordinator = class {
+var Coordinator = class _Coordinator {
   buffer = [];
   timer = null;
   triggerFn;
@@ -11360,6 +11361,7 @@ var Coordinator = class {
     this.config = { ...this.config, ...config2 };
     this.logger.log("[Coordinator] Config updated:", {
       vibeIntervalMs: this.config.vibeIntervalMs,
+      chatBatchWindowMs: this.config.chatBatchWindowMs,
       idleAfterMs: this.config.idleAfterMs,
       sleepAfterIdleMs: this.config.sleepAfterIdleMs
     });
@@ -11526,14 +11528,18 @@ var Coordinator = class {
       this._busy = true;
       try {
         const replies = await this.triggerFn(this.config.vibePrompt);
-        if (replies.some((r) => r.trim().toUpperCase() === "NO_REPLY")) {
+        const agentReplies = replies.filter((r) => !this.isApiError(r));
+        if (agentReplies.some((r) => r.trim().toUpperCase() === "NO_REPLY")) {
           noReply = true;
-        } else if (!this.isCompliantReply(replies)) {
-          misaligned = replies.filter((r) => {
+        } else if (!this.isCompliantReply(agentReplies)) {
+          misaligned = agentReplies.filter((r) => {
             const t = r.trim().toUpperCase();
             return t !== "NO_REPLY" && t !== "LIVESTREAM_REPLIED";
           });
         }
+        if (replies.length > agentReplies.length) {
+          this.logger.warn(`[Coordinator] Filtered ${replies.length - agentReplies.length} API error(s) from vibe response`);
+        }
       } catch (err) {
         this.logger.error("[Coordinator] Vibe failed:", err);
       } finally {
@@ -11579,26 +11585,31 @@ var Coordinator = class {
     }
     if (!this.timer) {
       this.flush();
-      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), BATCH_WINDOW_MS);
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs);
     }
   }
   onCooldownEnd() {
     this.timer = null;
     if (this.buffer.length > 0) {
       this.flush();
-      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), BATCH_WINDOW_MS);
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs);
     }
   }
   /** Whether the coordinator is busy processing a flush or talk */
   get busy() {
     return this._busy;
   }
+  /** Detect API/gateway errors surfaced as reply strings (e.g. rate limits) */
+  static API_ERROR_RE = /^\d{3}\s+(status\s+code|error)|^rate\s*limit|^too\s+many\s+requests|^overloaded|^server\s+error/i;
+  isApiError(reply) {
+    return _Coordinator.API_ERROR_RE.test(reply.trim());
+  }
   /** Check if agent replies are compliant (NO_REPLY or LIVESTREAM_REPLIED) */
   isCompliantReply(replies) {
     if (replies.length === 0) return true;
     return replies.every((r) => {
       const t = r.trim().toUpperCase();
-      return t === "NO_REPLY" || t === "LIVESTREAM_REPLIED";
+      return t === "NO_REPLY" || t === "LIVESTREAM_REPLIED" || this.isApiError(r);
     });
   }
   /** Send misalignment correction when agent responds with plaintext */
@@ -11624,8 +11635,12 @@ var Coordinator = class {
       this._busy = true;
       try {
         const replies = await this.triggerFn(batchText);
-        if (!this.isCompliantReply(replies)) {
-          await this.sendMisalignment(replies.filter((r) => {
+        const agentReplies = replies.filter((r) => !this.isApiError(r));
+        if (replies.length > agentReplies.length) {
+          this.logger.warn(`[Coordinator] Filtered ${replies.length - agentReplies.length} API error(s) from chat response`);
+        }
+        if (!this.isCompliantReply(agentReplies)) {
+          await this.sendMisalignment(agentReplies.filter((r) => {
             const t = r.trim().toUpperCase();
             return t !== "NO_REPLY" && t !== "LIVESTREAM_REPLIED";
           }));
@@ -12309,6 +12324,33 @@ var plugin = {
       },
       { name: "livestream_reply" }
     );
+    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, params) {
+          const b = await ensureBackend();
+          if (!b.coordinator) {
+            return { content: [{ type: "text", text: "Coordinator not running" }] };
+          }
+          const p = params;
+          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" }
+    );
     api.registerService({
       id: "crawd",
       start: async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crawd",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "CLI for crawd.bot - AI agent livestreaming platform",
   "type": "module",
   "types": "./dist/types.d.ts",

package/src/backend/coordinator.ts

@@ -2,7 +2,7 @@ import { randomUUID } from 'crypto'
 import WebSocket from 'ws'
 import type { ChatMessage } from '../lib/chat/types'
 
-const BATCH_WINDOW_MS = 20_000
+const DEFAULT_BATCH_WINDOW_MS = 20_000
 const SESSION_KEY = process.env.CRAWD_CHANNEL_ID || 'agent:main:crawd:live'
 
 /** Coordinator configuration */
@@ -15,6 +15,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
   /** The autonomous "vibe" prompt sent periodically */
   vibePrompt: string
 }
@@ -24,6 +26,7 @@ export const DEFAULT_CONFIG: CoordinatorConfig = {
   vibeIntervalMs: 30_000,
   idleAfterMs: 180_000,
   sleepAfterIdleMs: 180_000,
+  chatBatchWindowMs: DEFAULT_BATCH_WINDOW_MS,
   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.`,
 }
 
@@ -554,6 +557,7 @@ 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,
     })
@@ -765,14 +769,19 @@ export class Coordinator {
       this._busy = true
       try {
         const replies = await this.triggerFn(this.config.vibePrompt)
-        if (replies.some(r => r.trim().toUpperCase() === 'NO_REPLY')) {
+        // Filter out API errors (429s, rate limits) — not agent responses
+        const agentReplies = replies.filter(r => !this.isApiError(r))
+        if (agentReplies.some(r => r.trim().toUpperCase() === 'NO_REPLY')) {
           noReply = true
-        } else if (!this.isCompliantReply(replies)) {
-          misaligned = replies.filter(r => {
+        } else if (!this.isCompliantReply(agentReplies)) {
+          misaligned = agentReplies.filter(r => {
             const t = r.trim().toUpperCase()
             return t !== 'NO_REPLY' && t !== 'LIVESTREAM_REPLIED'
           })
         }
+        if (replies.length > agentReplies.length) {
+          this.logger.warn(`[Coordinator] Filtered ${replies.length - agentReplies.length} API error(s) from vibe response`)
+        }
       } catch (err) {
         this.logger.error('[Coordinator] Vibe failed:', err)
       } finally {
@@ -831,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(), BATCH_WINDOW_MS)
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs)
     }
     // Otherwise, message is buffered and will be flushed when cooldown ends
   }
@@ -842,19 +851,26 @@ 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(), BATCH_WINDOW_MS)
+      this.timer = this.clock.setTimeout(() => this.onCooldownEnd(), this.config.chatBatchWindowMs)
     }
   }
 
   /** Whether the coordinator is busy processing a flush or talk */
   get busy(): boolean { return this._busy }
 
+  /** Detect API/gateway errors surfaced as reply strings (e.g. rate limits) */
+  private static readonly API_ERROR_RE = /^\d{3}\s+(status\s+code|error)|^rate\s*limit|^too\s+many\s+requests|^overloaded|^server\s+error/i
+
+  private isApiError(reply: string): boolean {
+    return Coordinator.API_ERROR_RE.test(reply.trim())
+  }
+
   /** Check if agent replies are compliant (NO_REPLY or LIVESTREAM_REPLIED) */
   private isCompliantReply(replies: string[]): boolean {
     if (replies.length === 0) return true
     return replies.every(r => {
       const t = r.trim().toUpperCase()
-      return t === 'NO_REPLY' || t === 'LIVESTREAM_REPLIED'
+      return t === 'NO_REPLY' || t === 'LIVESTREAM_REPLIED' || this.isApiError(r)
     })
   }
 
@@ -889,8 +905,12 @@ export class Coordinator {
       this._busy = true
       try {
         const replies = await this.triggerFn(batchText)
-        if (!this.isCompliantReply(replies)) {
-          await this.sendMisalignment(replies.filter(r => {
+        const agentReplies = replies.filter(r => !this.isApiError(r))
+        if (replies.length > agentReplies.length) {
+          this.logger.warn(`[Coordinator] Filtered ${replies.length - agentReplies.length} API error(s) from chat response`)
+        }
+        if (!this.isCompliantReply(agentReplies)) {
+          await this.sendMisalignment(agentReplies.filter(r => {
             const t = r.trim().toUpperCase()
             return t !== 'NO_REPLY' && t !== 'LIVESTREAM_REPLIED'
           }))

package/src/plugin.ts

@@ -249,6 +249,36 @@ 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',