crawd 0.9.4 → 0.9.6

package/package.json

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

package/skills/crawd/SKILL.md

@@ -9,8 +9,10 @@ metadata: {"emoji": "🟠", "requires.env": ["OPENCLAW_GATEWAY_TOKEN"], "require
 Viewers see your screen in real time. Every click, every page, every tab — it's all on stream. Act like someone is watching, because they are.
 
 **Screen awareness:**
+- **Take screenshots constantly.** If your model supports vision, screenshot is your best friend. Take one before responding to chat, after navigating to a new page, after scrolling, when you wake up, when something changes on screen. You cannot see what viewers see unless you screenshot. This is how you stay aware of your own stream.
 - **Check your screen when you wake up.** Take a screenshot before doing anything — you may have gone to sleep with tabs open, notifications visible, or pages loaded. Viewers can see all of this and will reference it in chat. If you don't look at your screen first, you won't understand what they're talking about.
 - **Check your screen before responding to chat.** Viewers are looking at the same screen you are. Their messages often reference what's visible — a notification count, a tweet on screen, a video playing. Screenshot first so you have the same context they do.
+- **Screenshot after actions.** After clicking, scrolling, or navigating — screenshot to see the result. Don't blindly chain actions. Look at what happened.
 - Keep your browser tidy. Close tabs you're not using — empty tabs, old searches, finished pages. Viewers see clutter.
 - When you finish with something, close it. Don't leave 15 tabs open.
 - Think of your screen as your stage. What's on it matters.

package/src/backend/coordinator.test.ts

@@ -330,24 +330,24 @@ describe('Coordinator — Plan Mode', () => {
     })
   })
 
-  describe('chat batch in plan mode', () => {
-    it('appends plan instruction to chat batch when no active plan', () => {
+  describe('chat batch format', () => {
+    it('includes END OF CHAT delimiter', () => {
       const coord = createCoordinator()
-      // No plan set
 
-      const batch = coord.formatBatch([makeChatMessage('do something cool')])
-      expect(batch).toContain('plan mode')
-      expect(batch).toContain('plan_set')
+      const batch = coord.formatBatch([makeChatMessage('hello')])
+      expect(batch).toContain('[END OF CHAT]')
+      expect(batch).not.toContain('plan_set')
 
       coord.stop()
     })
 
-    it('does not append plan instruction when plan is active', () => {
+    it('does not include plan instruction in chat batch', () => {
       const coord = createCoordinator()
-      coord.setPlan('Active plan', ['Working on it'])
+      // No plan set, but chat batch should NOT include plan instruction
 
-      const batch = coord.formatBatch([makeChatMessage('hello')])
+      const batch = coord.formatBatch([makeChatMessage('do something cool')])
       expect(batch).not.toContain('plan mode')
+      expect(batch).not.toContain('plan_set')
 
       coord.stop()
     })

package/src/backend/coordinator.ts

@@ -507,101 +507,6 @@ export class OneShotGateway {
     })
   }
 
-  /** Compact a session via the gateway's sessions.compact method */
-  async compactSession(maxLines = 400): Promise<{ compacted: boolean }> {
-    return new Promise((resolve, reject) => {
-      const ws = new WebSocket(this.url)
-      const authId = randomUUID()
-      const reqId = randomUUID()
-      let settled = false
-
-      const timeout = setTimeout(() => {
-        if (!settled) {
-          settled = true
-          ws.close()
-          reject(new Error('One-shot compact request timed out (30s)'))
-        }
-      }, 30_000)
-
-      const finish = (result?: { compacted: boolean }, error?: Error) => {
-        if (settled) return
-        settled = true
-        clearTimeout(timeout)
-        ws.close()
-        if (error) {
-          console.error(`[OneShotGateway] compact error: ${error.message}`)
-          reject(error)
-        } else {
-          resolve(result ?? { compacted: false })
-        }
-      }
-
-      const sendConnect = () => {
-        ws.send(JSON.stringify({
-          type: 'req',
-          id: authId,
-          method: 'connect',
-          params: {
-            minProtocol: 3,
-            maxProtocol: 3,
-            client: {
-              id: 'gateway-client',
-              version: '1.0.0',
-              platform: 'node',
-              mode: 'backend',
-            },
-            auth: this.token ? { token: this.token } : {},
-          },
-        }))
-      }
-
-      ws.on('message', (data) => {
-        try {
-          const frame = JSON.parse(data.toString()) as GatewayFrame
-
-          if (frame.type === 'event' && (frame as any).event === 'connect.challenge') {
-            sendConnect()
-            return
-          }
-
-          if (frame.type === 'res' && frame.id === authId) {
-            if (frame.error) {
-              finish(undefined, new Error(`Gateway auth failed: ${frame.error.message}`))
-              return
-            }
-            ws.send(JSON.stringify({
-              type: 'req',
-              id: reqId,
-              method: 'sessions.compact',
-              params: {
-                key: this.sessionKey,
-                maxLines,
-              },
-            }))
-          } else if (frame.type === 'res' && frame.id === reqId) {
-            if (frame.error) {
-              finish(undefined, new Error(`sessions.compact failed: ${frame.error.message}`))
-              return
-            }
-            const payload = frame.payload as any
-            finish({ compacted: payload?.compacted === true })
-          }
-        } catch {
-          // Parse error — ignore
-        }
-      })
-
-      ws.on('error', (err) => {
-        finish(undefined, err instanceof Error ? err : new Error(String(err)))
-      })
-
-      ws.on('close', () => {
-        if (!settled) {
-          finish(undefined, new Error('WebSocket closed unexpectedly'))
-        }
-      })
-    })
-  }
 }
 
 /**
@@ -637,7 +542,6 @@ export class Coordinator {
   private buffer: ChatMessage[] = []
   private timer: NodeJS.Timeout | null = null
   private triggerFn: TriggerAgentFn
-  private compactFn?: () => Promise<void>
   private onEvent?: (event: CoordinatorEvent) => void
   /** Timestamp when coordinator was created (used to filter old messages on restart) */
   private readonly startedAt: number
@@ -717,11 +621,6 @@ export class Coordinator {
     this.onEvent = callback
   }
 
-  /** Set the compact function (uses gateway sessions.compact instead of sending /compact as agent message) */
-  setCompactFn(fn: () => Promise<void>): void {
-    this.compactFn = fn
-  }
-
   private emit(event: CoordinatorEvent): void {
     this.onEvent?.(event)
   }
@@ -792,20 +691,6 @@ export class Coordinator {
 
     this.stopVibeLoop()
     this.cancelPlanNudge()
-    this.compactSession()
-  }
-
-  /** Compact the agent's session context before sleeping to free stale history */
-  private compactSession(): void {
-    if (!this.compactFn) return
-    this._gatewayQueue = this._gatewayQueue.then(async () => {
-      try {
-        await this.compactFn!()
-        this.logger.log('[Coordinator] Session compacted before sleep')
-      } catch (err) {
-        this.logger.error('[Coordinator] Failed to compact session:', err)
-      }
-    }).catch(() => {})
   }
 
   /** Signal that the agent is speaking (via tool call) — keeps coordinator awake */
@@ -1288,12 +1173,6 @@ export class Coordinator {
       ? '\n(To reply to a specific message, prefix with its ID: [msgId] your reply)'
       : ''
 
-    // In plan mode with no active plan, instruct agent to create one
-    let planInstruction = ''
-    if (this.config.autonomyMode === 'plan' && !this.hasPendingPlanSteps()) {
-      planInstruction = '\n\nCreate a plan using plan_set. Be creative and proactive — come up with something YOU want to do, not just "reply to chat". Browse the web, go down rabbit holes, check X/HN/YouTube, find weird stuff, have opinions. Each step should be a concrete action. Think aloud on stream about what you\'re doing. Never mention plans or steps to viewers.'
-    }
-
-    return `${header}\n${lines.join('\n')}${instruction}${planInstruction}`
+    return `${header}\n${lines.join('\n')}\n[END OF CHAT]${instruction}`
   }
 }

package/src/backend/server.ts

@@ -272,10 +272,6 @@ export class CrawdBackend {
         coordConfig,
       )
 
-      this.coordinator.setCompactFn(async () => {
-        await gateway.compactSession()
-      })
-
       this.coordinator.setOnEvent((event: CoordinatorEvent) => {
         if (event.type === 'stateChange') {
           this.io.emit('crawd:status', { status: event.to })