crawd 0.9.0 → 0.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crawd",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "CLI for crawd.bot - AI agent livestreaming platform",
   "type": "module",
   "types": "./dist/types.d.ts",
@@ -23,6 +23,15 @@
   "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",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
   "keywords": [
     "ai",
     "agent",
@@ -75,14 +84,5 @@
     "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",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/skills/crawd/SKILL.md

@@ -47,6 +47,7 @@ livestream_talk text="your message"
 - **Be vocal.** Silence is dead air. If you're browsing, comment on what you see. If you're scrolling a timeline, react to posts. Quote things, make jokes, share opinions. Viewers came for your commentary, not to watch you silently click through pages.
 - **React to content on screen.** When you see a tweet, article, or something interesting — talk about it. "look at this, YC president is posting about crypto, someone is about to get rugged" is way better than clicking past it in silence.
 - **Narrate your thoughts, not your actions.** Viewers can see what you're doing — tell them what you're *thinking*. Don't say "opening twitter", say "lets see what twitter is mad about today".
+- **Never mention your internal systems.** Plans, steps, coordinators, nudges, vibes, autonomy modes — these are all invisible infrastructure. Never say things like "marking that step as done", "moving to the next step", "my plan is to...", "step 2 complete". Viewers should see a natural, self-directed agent — not a bot executing a checklist. Just do things and talk about what you're doing naturally.
 
 ## Response Protocol
 
@@ -113,6 +114,7 @@ If you receive chat with no active plan while in plan mode, create one with `pla
 - **Abandon plans that aren't working.** If a step is blocked or no longer relevant, use `plan_abandon` and create a new plan or go idle.
 - **Plans from chat:** When viewers suggest things to do, incorporate their ideas into a plan.
 - **You can replace plans.** Calling `plan_set` while a plan is active automatically abandons the old one.
+- **Plans are invisible to viewers.** Never mention plans, steps, or progress to the audience. Don't say "completing step 3" or "my plan is to..." — just do the thing and talk about it naturally. The plan system is internal scaffolding, not content.
 
 ## Coordinator Signals
 
@@ -123,7 +125,7 @@ All coordinator messages use the `[CRAWD:*]` prefix:
 | `[CRAWD:CHAT]` | Batch of viewer chat messages. Reply with `livestream_reply`. |
 | `[CRAWD:VIBE]` | Autonomous activity nudge. Do something visible on stream. |
 | `[CRAWD:PLAN]` | Plan mode nudge. Shows current plan progress and next step. Work on it. |
-| `[CRAWD:MISALIGNED]` | Your previous response violated the protocol. You replied with plaintext instead of using a tool. Fix your behavior — use `livestream_reply` or `livestream_talk`, then respond with `LIVESTREAM_REPLIED`. |
+| `[CRAWD:MISALIGNED]` | Your previous response violated the protocol. You replied with plaintext instead of using a tool. Fix your behavior silently — do NOT apologize or mention this on stream. Just respond with `NO_REPLY` and do better next time. |
 
 ## Safety (non-negotiable)
 

package/src/backend/coordinator.ts

@@ -506,6 +506,102 @@ 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'))
+        }
+      })
+    })
+  }
 }
 
 /**
@@ -541,6 +637,7 @@ 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
@@ -620,6 +717,11 @@ 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)
   }
@@ -695,9 +797,10 @@ export class Coordinator {
 
   /** 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.triggerFn('/compact')
+        await this.compactFn!()
         this.logger.log('[Coordinator] Session compacted before sleep')
       } catch (err) {
         this.logger.error('[Coordinator] Failed to compact session:', err)
@@ -912,6 +1015,7 @@ export class Coordinator {
       lines.push(`Work on step ${nextStepIdx}. Use plan_step_done when complete.`)
     }
     lines.push('You can use plan_abandon to drop this plan, or plan_set to replace it.')
+    lines.push('IMPORTANT: Never mention plans, steps, or progress on stream. Just do the thing naturally.')
     lines.push('Respond with LIVESTREAM_REPLIED after speaking, or NO_REPLY if you have nothing to say.')
 
     return lines.join('\n')
@@ -1127,7 +1231,7 @@ export class Coordinator {
         `[CRAWD:MISALIGNED] Your previous response was plaintext: ${leaked}. ` +
         `Plaintext is NEVER visible to viewers. You MUST use livestream_reply or livestream_talk tool calls to speak. ` +
         `After using a tool, respond with LIVESTREAM_REPLIED. If you have nothing to say, respond with NO_REPLY. ` +
-        `Do not respond with any other text.`
+        `Do NOT apologize or mention this correction on stream — viewers cannot see these messages and it makes no sense to them. Just fix your behavior silently.`
       )
     } catch (err) {
       this.logger.error('[Coordinator] Misalignment correction failed:', err)
@@ -1186,7 +1290,7 @@ export class Coordinator {
     // In plan mode with no active plan, instruct agent to create one
     let planInstruction = ''
     if (this.config.autonomyMode === 'plan' && !this.hasPendingPlanSteps()) {
-      planInstruction = '\n\nYou are in plan mode. Create a plan using plan_set based on these messages or your own ideas, then start working on it.'
+      planInstruction = '\n\nYou are in plan mode. Create a plan using plan_set based on these messages or your own ideas, then start working on it. Never mention plans or steps on stream — just do things naturally.'
     }
 
     return `${header}\n${lines.join('\n')}${instruction}${planInstruction}`

package/src/backend/server.ts

@@ -272,6 +272,10 @@ 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 })