@openclaw-cloud/agent-controller 0.1.0 → 0.1.2

package/.claude/cc-notify.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# Claude Code hook: notify OpenClaw on Stop/PermissionRequest
+# Reads JSON from stdin, sends system event
+
+EVENT_TYPE="${CC_HOOK_EVENT:-unknown}"
+PROJECT="${CC_PROJECT:-unknown}"
+INPUT=$(cat)
+
+case "$EVENT_TYPE" in
+  Stop)
+    REASON=$(echo "$INPUT" | jq -r '.stop_reason // "completed"' 2>/dev/null)
+    TRANSCRIPT=$(echo "$INPUT" | jq -r '.transcript_summary // ""' 2>/dev/null)
+    if [ -n "$TRANSCRIPT" ] && [ "$TRANSCRIPT" != "null" ]; then
+      MSG="🏁 CC [$PROJECT] finished ($REASON): $TRANSCRIPT"
+    else
+      MSG="🏁 CC [$PROJECT] finished ($REASON)"
+    fi
+    ;;
+  Notification)
+    NOTIF_TYPE=$(echo "$INPUT" | jq -r '.notification_type // "unknown"' 2>/dev/null)
+    MSG="⚠️ CC [$PROJECT] notification: $NOTIF_TYPE"
+    ;;
+  *)
+    MSG="🔔 CC [$PROJECT] hook: $EVENT_TYPE"
+    ;;
+esac
+
+# Truncate to 500 chars
+MSG="${MSG:0:500}"
+
+openclaw system event --text "$MSG" --mode now 2>/dev/null &
+exit 0

package/.claude/settings.json

@@ -0,0 +1,31 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "CC_HOOK_EVENT=Stop CC_PROJECT=agent-controller .claude/cc-notify.sh"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "permission_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "CC_HOOK_EVENT=Notification CC_PROJECT=agent-controller .claude/cc-notify.sh"
+          }
+        ]
+      }
+    ]
+  },
+  "instructions": [
+    "This is the agent-controller (Node.js + TypeScript). Runs inside agent containers/VMs.",
+    "Tests: npx jest --forceExit",
+    "Communicates with backend via Centrifugo WebSocket.",
+    "Push to origin after each commit. Target branch: master."
+  ]
+}

package/CLAUDE.md

@@ -0,0 +1,48 @@
+# CLAUDE.md — Agent Controller Context
+
+## Quick Reference
+
+```bash
+npx jest --forceExit           # Run tests
+npx tsc --noEmit               # Type check
+npm run build                  # Build
+```
+
+## Architecture
+
+Agent-controller is a Node.js process that runs inside every agent container (K8s pod) or VM. It's the single communication interface between the agent and the backend.
+
+### Communication Flow
+```
+Backend → Centrifugo WS (port 8000) → agent-controller → local agent process
+agent-controller → Centrifugo HTTP API (port 9000) → Backend (heartbeat processing)
+```
+
+### Key Components
+- **WebSocket client** — Connects to Centrifugo, subscribes to agent channel
+- **Heartbeat publisher** — Sends periodic heartbeats via Centrifugo HTTP API (server-side publish)
+- **Command handlers** — Processes commands from backend (backup, reconfigure, etc.)
+- **Board handler** — Kanban board integration (claim cards, move cards, report status)
+- **JWT auth** — Fetches JWT from backend's `/api/internal/centrifugo-token` endpoint, auto-refreshes before expiry (24h TTL)
+
+### Environment Variables
+- `AGENT_ID` — UUID of this agent
+- `AGENT_TOKEN` — Internal auth token
+- `CENTRIFUGO_URL` — WebSocket URL (port 8000, converted from http→ws)
+- `CENTRIFUGO_INTERNAL_URL` — HTTP API URL (port 9000) for server-side publish
+- `CENTRIFUGO_API_KEY` — API key for HTTP API auth
+- `API_BASE_URL` — Backend API URL for JWT fetch
+
+### Deployment
+
+Agent-controller is delivered via **npm** (not Docker image copy):
+
+- **K8s pods**: `npm install -g @openclaw-cloud/agent-controller` in agent Dockerfile (`backend/charts/openclaw-kube/Dockerfile`)
+- **VMs**: `npm install -g @openclaw-cloud/agent-controller` in EC2 user-data script (`backend/src/modules/vm-provisioner/user-data.ts`)
+- Runs in same container/VM as OpenClaw agent (not sidecar)
+- Started via bash wrapper in K8s StatefulSet command
+- PID monitoring: if agent-controller dies, `kill 1` terminates container → K8s restarts pod
+
+### Docker
+
+The `Dockerfile` in this repo is for **local development and testing only**. It is NOT used in production. Production installs agent-controller from npm registry.

package/__tests__/backup.test.ts

@@ -92,7 +92,7 @@ describe('handleBackup', () => {
     fakeExecSuccess();
     mockStat.mockResolvedValue({ size: 512 });
     mockReadFile.mockResolvedValue(Buffer.from('fake'));
-    mockFetch.mockResolvedValue({ ok: false, status: 500, statusText: 'Internal Server Error' });
+    mockFetch.mockResolvedValue({ ok: false, status: 500, statusText: 'Internal Server Error', text: () => Promise.resolve('') });
 
     const cmd: AgentCommand = {
       id: '4',

package/__tests__/board-handler.test.ts

@@ -0,0 +1,318 @@
+import { BoardHandler } from '../src/handlers/board-handler';
+import type { AgentApi } from '../src/api';
+import type { BoardInfo, CardDetail, BoardEvent } from '../src/types';
+import childProcess from 'node:child_process';
+
+jest.mock('node:child_process');
+const mockExec = childProcess.exec as unknown as jest.Mock;
+
+function mockApi(overrides: Partial<AgentApi> = {}): AgentApi {
+  return {
+    get: jest.fn(),
+    post: jest.fn(),
+    ...overrides,
+  };
+}
+
+function makeBoardInfo(opts: Partial<{
+  boardId: string;
+  myColumnIds: string[];
+  columns: BoardInfo['board']['columns'];
+}> = {}): BoardInfo {
+  return {
+    board: {
+      id: opts.boardId ?? 'board-1',
+      myColumnIds: opts.myColumnIds ?? ['col-1'],
+      columns: opts.columns ?? [{
+        id: 'col-1',
+        name: 'To Do',
+        type: 'agent',
+        position: 0,
+        cards: [],
+      }],
+    },
+  };
+}
+
+function makeCardDetail(opts: Partial<CardDetail['card']> = {}): CardDetail {
+  return {
+    card: {
+      id: opts.id ?? 'card-1',
+      title: opts.title ?? 'Test task',
+      description: opts.description ?? 'Do the thing',
+      priority: opts.priority ?? 'medium',
+      columnId: opts.columnId ?? 'col-1',
+      columnName: opts.columnName ?? 'To Do',
+      assignedAgentId: opts.assignedAgentId ?? null,
+    },
+  };
+}
+
+function makeResponse(status: number, body: string = ''): Response {
+  return {
+    ok: status >= 200 && status < 300,
+    status,
+    text: () => Promise.resolve(body),
+  } as Response;
+}
+
+describe('BoardHandler', () => {
+  let api: AgentApi;
+  let handler: BoardHandler;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    mockExec.mockImplementation((_cmd: string, _opts: unknown, cb: Function) => {
+      cb(null, Buffer.from('ok'), Buffer.from(''));
+    });
+    api = mockApi();
+    handler = new BoardHandler(api);
+  });
+
+  describe('initialize', () => {
+    it('sets boardId and myColumnIds from API response', async () => {
+      const info = makeBoardInfo({ boardId: 'b-42', myColumnIds: ['c-1', 'c-2'] });
+      (api.get as jest.Mock).mockResolvedValue(info);
+
+      const result = await handler.initialize();
+
+      expect(result).toBe('b-42');
+      expect(handler.getBoardId()).toBe('b-42');
+      expect(api.get).toHaveBeenCalledWith('/api/agent/board');
+    });
+
+    it('claims unassigned card in my column during init (backfill)', async () => {
+      const info = makeBoardInfo({
+        columns: [{
+          id: 'col-1', name: 'To Do', type: 'agent', position: 0,
+          cards: [{ id: 'card-99', title: 'Backfill', assignedAgentId: null }],
+        }],
+      });
+      (api.get as jest.Mock).mockResolvedValue(info);
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(200));
+      // Mock card detail for startTask
+      (api.get as jest.Mock).mockResolvedValueOnce(info).mockResolvedValueOnce(makeCardDetail({ id: 'card-99' }));
+
+      await handler.initialize();
+
+      expect(api.post).toHaveBeenCalledWith('/api/agent/board/cards/card-99/claim');
+    });
+
+    it('returns null on API error', async () => {
+      (api.get as jest.Mock).mockRejectedValue(new Error('network fail'));
+
+      const result = await handler.initialize();
+
+      expect(result).toBeNull();
+      expect(handler.getBoardId()).toBeNull();
+    });
+  });
+
+  describe('onBoardEvent', () => {
+    beforeEach(async () => {
+      const info = makeBoardInfo();
+      (api.get as jest.Mock).mockResolvedValue(info);
+      await handler.initialize();
+      jest.clearAllMocks();
+    });
+
+    it('claims card when card:entered in my column and idle', async () => {
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(200));
+      (api.get as jest.Mock).mockResolvedValue(makeCardDetail());
+
+      const event: BoardEvent = { event: 'card:entered', cardId: 'card-5', columnId: 'col-1' };
+      await handler.onBoardEvent(event);
+
+      expect(api.post).toHaveBeenCalledWith('/api/agent/board/cards/card-5/claim');
+    });
+
+    it('ignores card:entered for column not in myColumnIds', async () => {
+      const event: BoardEvent = { event: 'card:entered', cardId: 'card-5', columnId: 'other-col' };
+      await handler.onBoardEvent(event);
+
+      expect(api.post).not.toHaveBeenCalled();
+    });
+
+    it('ignores card:entered when already working', async () => {
+      // First: claim a card to set state to working
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(200));
+      (api.get as jest.Mock).mockResolvedValue(makeCardDetail());
+      await handler.onBoardEvent({ event: 'card:entered', cardId: 'card-1', columnId: 'col-1' });
+
+      jest.clearAllMocks();
+
+      // Second: new card enters, should be ignored
+      await handler.onBoardEvent({ event: 'card:entered', cardId: 'card-2', columnId: 'col-1' });
+      expect(api.post).not.toHaveBeenCalled();
+    });
+
+    it('ignores card:claimed, card:moved, card:commented events', async () => {
+      for (const event of ['card:claimed', 'card:moved', 'card:commented'] as const) {
+        await handler.onBoardEvent({ event, cardId: 'card-1' });
+      }
+      expect(api.post).not.toHaveBeenCalled();
+      expect(api.get).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('tryClaimCard', () => {
+    beforeEach(async () => {
+      (api.get as jest.Mock).mockResolvedValue(makeBoardInfo());
+      await handler.initialize();
+      jest.clearAllMocks();
+    });
+
+    it('sets state to working on successful claim (200)', async () => {
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(200));
+      (api.get as jest.Mock).mockResolvedValue(makeCardDetail({ id: 'card-10' }));
+
+      await handler.tryClaimCard('card-10');
+
+      expect(handler.getBoardStatus()).toEqual({ state: 'working', cardId: 'card-10' });
+    });
+
+    it('stays idle on 409 (already claimed)', async () => {
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(409));
+
+      await handler.tryClaimCard('card-10');
+
+      expect(handler.getBoardStatus()).toEqual({ state: 'idle', cardId: null });
+    });
+
+    it('stays idle on 500 error', async () => {
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(500, 'Internal error'));
+
+      await handler.tryClaimCard('card-10');
+
+      expect(handler.getBoardStatus()).toEqual({ state: 'idle', cardId: null });
+    });
+
+    it('stays idle on network error', async () => {
+      (api.post as jest.Mock).mockRejectedValue(new Error('connection refused'));
+
+      await handler.tryClaimCard('card-10');
+
+      expect(handler.getBoardStatus()).toEqual({ state: 'idle', cardId: null });
+    });
+  });
+
+  describe('startTask', () => {
+    beforeEach(async () => {
+      (api.get as jest.Mock).mockResolvedValue(makeBoardInfo());
+      await handler.initialize();
+      jest.clearAllMocks();
+    });
+
+    it('fetches card detail and calls openclaw exec', async () => {
+      const detail = makeCardDetail({ id: 'card-20', title: 'Build feature', description: 'Some desc', priority: 'high' });
+      (api.get as jest.Mock).mockResolvedValue(detail);
+
+      await handler.startTask('card-20');
+
+      expect(api.get).toHaveBeenCalledWith('/api/agent/board/cards/card-20');
+      expect(mockExec).toHaveBeenCalledTimes(1);
+      const cmd = mockExec.mock.calls[0][0] as string;
+      expect(cmd).toContain('openclaw system event');
+      expect(cmd).toContain('Build feature');
+      expect(cmd).toContain('Priority: high');
+    });
+
+    it('handles API error gracefully', async () => {
+      (api.get as jest.Mock).mockRejectedValue(new Error('not found'));
+
+      await handler.startTask('card-missing');
+
+      expect(mockExec).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('completeTask', () => {
+    it('resets state to idle and triggers checkQueue', async () => {
+      const info = makeBoardInfo();
+      (api.get as jest.Mock).mockResolvedValue(info);
+      await handler.initialize();
+
+      // Claim a card first
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(200));
+      (api.get as jest.Mock).mockResolvedValueOnce(makeCardDetail()).mockResolvedValueOnce(info);
+
+      await handler.tryClaimCard('card-1');
+      expect(handler.getBoardStatus().state).toBe('working');
+
+      handler.completeTask('card-1');
+      expect(handler.getBoardStatus()).toEqual({ state: 'idle', cardId: null });
+    });
+  });
+
+  describe('checkQueue', () => {
+    beforeEach(async () => {
+      (api.get as jest.Mock).mockResolvedValue(makeBoardInfo());
+      await handler.initialize();
+      jest.clearAllMocks();
+    });
+
+    it('sorts candidates by priority then createdAt', async () => {
+      const info = makeBoardInfo({
+        columns: [{
+          id: 'col-1', name: 'To Do', type: 'agent', position: 0,
+          cards: [
+            { id: 'low-old', title: 'Low old', priority: 'low', assignedAgentId: null, createdAt: '2026-01-01' },
+            { id: 'critical-new', title: 'Critical', priority: 'critical', assignedAgentId: null, createdAt: '2026-02-01' },
+            { id: 'high-old', title: 'High old', priority: 'high', assignedAgentId: null, createdAt: '2026-01-15' },
+          ],
+        }],
+      });
+      (api.get as jest.Mock).mockResolvedValue(info);
+      (api.post as jest.Mock).mockResolvedValue(makeResponse(200));
+      (api.get as jest.Mock).mockResolvedValueOnce(info).mockResolvedValueOnce(makeCardDetail({ id: 'critical-new' }));
+
+      await handler.checkQueue();
+
+      // Should try to claim the critical card first
+      expect(api.post).toHaveBeenCalledWith('/api/agent/board/cards/critical-new/claim');
+    });
+
+    it('does nothing when no unassigned cards', async () => {
+      const info = makeBoardInfo({
+        columns: [{
+          id: 'col-1', name: 'To Do', type: 'agent', position: 0,
+          cards: [
+            { id: 'card-1', title: 'Taken', assignedAgentId: 'agent-1' },
+          ],
+        }],
+      });
+      (api.get as jest.Mock).mockResolvedValue(info);
+
+      await handler.checkQueue();
+
+      expect(api.post).not.toHaveBeenCalled();
+    });
+
+    it('skips cards in columns not in myColumnIds', async () => {
+      const info = makeBoardInfo({
+        myColumnIds: ['col-1'],
+        columns: [
+          { id: 'col-1', name: 'Mine', type: 'agent', position: 0, cards: [] },
+          { id: 'col-2', name: 'Not mine', type: 'human', position: 1, cards: [
+            { id: 'card-x', title: 'Other', assignedAgentId: null },
+          ]},
+        ],
+      });
+      (api.get as jest.Mock).mockResolvedValue(info);
+
+      await handler.checkQueue();
+
+      expect(api.post).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('getters', () => {
+    it('getBoardStatus returns idle by default', () => {
+      expect(handler.getBoardStatus()).toEqual({ state: 'idle', cardId: null });
+    });
+
+    it('getBoardId returns null before initialize', () => {
+      expect(handler.getBoardId()).toBeNull();
+    });
+  });
+});

package/dist/api.d.ts

@@ -0,0 +1,5 @@
+export interface AgentApi {
+    get(path: string): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<Response>;
+}
+export declare function createAgentApi(backendUrl: string, agentToken: string): AgentApi;

package/dist/api.js

@@ -0,0 +1,35 @@
+const TIMEOUT = 10_000;
+export function createAgentApi(backendUrl, agentToken) {
+    async function request(method, path, body) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), TIMEOUT);
+        try {
+            const res = await fetch(`${backendUrl}${path}`, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${agentToken}`,
+                },
+                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+                signal: controller.signal,
+            });
+            return res;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    return {
+        async get(path) {
+            const res = await request('GET', path);
+            if (!res.ok) {
+                throw new Error(`GET ${path} failed: HTTP ${res.status}`);
+            }
+            return res.json();
+        },
+        async post(path, body) {
+            return request('POST', path, body);
+        },
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,MAAM,CAAC;AAOvB,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,UAAkB;IACnE,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,IAAY,EAAE,IAAc;QACjE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,GAAG,IAAI,EAAE,EAAE;gBAC9C,MAAM;gBACN,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,UAAU,UAAU,EAAE;iBACxC;gBACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,IAAY;YACpB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,iBAAiB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAc;YACrC,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/handlers/backup.js

@@ -7,6 +7,7 @@ const TAR_TIMEOUT = 120_000;
 const UPLOAD_TIMEOUT = 120_000;
 export function handleBackup(command) {
     const uploadUrl = command.payload.uploadUrl;
+    const token = command.payload.token;
     if (!uploadUrl) {
         return Promise.resolve({
             id: command.id,
@@ -19,7 +20,7 @@ export function handleBackup(command) {
     const filename = `backup-${timestamp}.tar.gz`;
     const archivePath = path.join(BACKUP_DIR, filename);
     return createArchive(archivePath)
-        .then(() => uploadArchive(archivePath, uploadUrl))
+        .then(() => uploadArchive(archivePath, uploadUrl, token))
         .then(async (size) => {
         await cleanup(archivePath);
         return {
@@ -51,22 +52,22 @@ function createArchive(archivePath) {
         });
     });
 }
-async function uploadArchive(archivePath, uploadUrl) {
+async function uploadArchive(archivePath, uploadUrl, token) {
     const stat = await fs.stat(archivePath);
     const fileBuffer = await fs.readFile(archivePath);
-    const boundary = `----backup-${Date.now()}`;
-    const filename = path.basename(archivePath);
-    const header = Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${filename}"\r\nContent-Type: application/gzip\r\n\r\n`);
-    const footer = Buffer.from(`\r\n--${boundary}--\r\n`);
-    const body = Buffer.concat([header, fileBuffer, footer]);
+    const headers = { 'Content-Type': 'application/gzip' };
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
     const response = await fetch(uploadUrl, {
         method: 'POST',
-        headers: { 'Content-Type': `multipart/form-data; boundary=${boundary}` },
-        body,
+        headers,
+        body: fileBuffer,
         signal: AbortSignal.timeout(UPLOAD_TIMEOUT),
     });
     if (!response.ok) {
-        throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+        const text = await response.text().catch(() => '');
+        throw new Error(`Upload failed: ${response.status} ${response.statusText} ${text}`);
     }
     return stat.size;
 }

package/dist/handlers/backup.js.map

@@ -1 +1 @@
-{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/handlers/backup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/handlers/backup.ts"],"names":[],"mappings":"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"}

package/dist/handlers/board-handler.d.ts

@@ -0,0 +1,18 @@
+import type { AgentApi } from '../api.js';
+import type { BoardState, BoardEvent, BoardInfo } from '../types.js';
+export declare class BoardHandler {
+    private boardState;
+    private myColumnIds;
+    private boardId;
+    private api;
+    constructor(api: AgentApi);
+    initialize(): Promise<string | null>;
+    onBoardEvent(event: BoardEvent): Promise<void>;
+    tryClaimCard(cardId: string): Promise<void>;
+    startTask(cardId: string): Promise<void>;
+    completeTask(cardId: string): void;
+    checkQueue(existingData?: BoardInfo): Promise<void>;
+    getBoardStatus(): BoardState;
+    getBoardId(): string | null;
+    private execOpenclaw;
+}

package/dist/handlers/board-handler.js

@@ -0,0 +1,141 @@
+import { exec } from 'node:child_process';
+const OPENCLAW_TIMEOUT = 30_000;
+export class BoardHandler {
+    boardState = { state: 'idle', cardId: null };
+    myColumnIds = [];
+    boardId = null;
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async initialize() {
+        try {
+            const data = await this.api.get('/api/agent/board');
+            this.boardId = data.board.id;
+            this.myColumnIds = data.board.myColumnIds;
+            console.log(`Board initialized: ${this.boardId}, watching ${this.myColumnIds.length} column(s)`);
+            // Backfill: check for existing unassigned cards in my columns
+            await this.checkQueue(data);
+            return this.boardId;
+        }
+        catch (err) {
+            console.error('Board initialization failed:', err instanceof Error ? err.message : err);
+            return null;
+        }
+    }
+    async onBoardEvent(event) {
+        switch (event.event) {
+            case 'card:entered':
+                if (!event.columnId || !this.myColumnIds.includes(event.columnId))
+                    return;
+                if (this.boardState.state === 'working')
+                    return;
+                await this.tryClaimCard(event.cardId);
+                break;
+            case 'card:claimed':
+            case 'card:moved':
+            case 'card:commented':
+                // Info only, ignore
+                break;
+        }
+    }
+    async tryClaimCard(cardId) {
+        try {
+            const res = await this.api.post(`/api/agent/board/cards/${cardId}/claim`);
+            if (res.ok) {
+                this.boardState = { state: 'working', cardId };
+                console.log(`Claimed card: ${cardId}`);
+                await this.startTask(cardId);
+            }
+            else if (res.status === 409) {
+                console.log(`Card ${cardId} already claimed or agent busy, skipping`);
+            }
+            else {
+                const body = await res.text().catch(() => '');
+                console.error(`Claim card ${cardId} failed (HTTP ${res.status}): ${body}`);
+            }
+        }
+        catch (err) {
+            console.error('tryClaimCard error:', err instanceof Error ? err.message : err);
+        }
+    }
+    async startTask(cardId) {
+        try {
+            const data = await this.api.get(`/api/agent/board/cards/${cardId}`);
+            const card = data.card;
+            const message = [
+                `New task from board: ${card.title}`,
+                card.description ? `Description: ${card.description}` : null,
+                card.priority ? `Priority: ${card.priority}` : null,
+                '',
+                'Instructions:',
+                '- Complete the task described above.',
+                '- Post progress and results as comments using: POST /api/agent/board/cards/' + cardId + '/comments',
+                '- When done, move the card forward using: POST /api/agent/board/cards/' + cardId + '/move',
+            ].filter(Boolean).join('\n');
+            await this.execOpenclaw(message);
+        }
+        catch (err) {
+            console.error(`startTask(${cardId}) error:`, err instanceof Error ? err.message : err);
+        }
+    }
+    completeTask(cardId) {
+        console.log(`Task completed: ${cardId}`);
+        this.boardState = { state: 'idle', cardId: null };
+        this.checkQueue().catch((err) => {
+            console.error('checkQueue after completeTask error:', err instanceof Error ? err.message : err);
+        });
+    }
+    async checkQueue(existingData) {
+        try {
+            const data = existingData ?? await this.api.get('/api/agent/board');
+            const candidates = [];
+            for (const col of data.board.columns) {
+                if (!this.myColumnIds.includes(col.id))
+                    continue;
+                for (const card of col.cards) {
+                    if (!card.assignedAgentId) {
+                        candidates.push(card);
+                    }
+                }
+            }
+            if (candidates.length === 0)
+                return;
+            // Sort by priority (high > medium > low) then by creation date (oldest first)
+            const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+            candidates.sort((a, b) => {
+                const pa = priorityOrder[a.priority ?? 'medium'] ?? 2;
+                const pb = priorityOrder[b.priority ?? 'medium'] ?? 2;
+                if (pa !== pb)
+                    return pa - pb;
+                return (a.createdAt ?? '').localeCompare(b.createdAt ?? '');
+            });
+            console.log(`Queue: ${candidates.length} unassigned card(s) in my columns, trying first`);
+            await this.tryClaimCard(candidates[0].id);
+        }
+        catch (err) {
+            console.error('checkQueue error:', err instanceof Error ? err.message : err);
+        }
+    }
+    getBoardStatus() {
+        return this.boardState;
+    }
+    getBoardId() {
+        return this.boardId;
+    }
+    execOpenclaw(message) {
+        return new Promise((resolve) => {
+            const escaped = message.replace(/'/g, "'\\''");
+            exec(`openclaw system event --text '${escaped}' --mode now`, { timeout: OPENCLAW_TIMEOUT }, (error, stdout, stderr) => {
+                if (error) {
+                    console.error('openclaw system event failed:', stderr.toString() || error.message);
+                }
+                else {
+                    console.log('openclaw system event sent');
+                }
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=board-handler.js.map

package/dist/handlers/board-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-handler.js","sourceRoot":"","sources":["../../src/handlers/board-handler.ts"],"names":[],"mappings":"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"}

package/dist/heartbeat.d.ts

@@ -1,8 +1,9 @@
-import type { HeartbeatPayload } from './types.js';
+import type { BoardState, HeartbeatPayload } from './types.js';
 export interface HeartbeatOptions {
     centrifugoInternalUrl: string;
     centrifugoApiKey: string;
     agentId: string;
+    getBoardStatus?: () => BoardState;
 }
 declare function getMetrics(): HeartbeatPayload['metrics'];
 export declare function startHeartbeat(opts: HeartbeatOptions): NodeJS.Timeout;

package/dist/heartbeat.js

@@ -21,6 +21,7 @@ async function publishHeartbeat(opts) {
         agentId: opts.agentId,
         ts: Date.now(),
         metrics: getMetrics(),
+        ...(opts.getBoardStatus ? { boardStatus: opts.getBoardStatus() } : {}),
     };
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 5000);

package/dist/heartbeat.js.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,7 @@
 import { createConnection } from './connection.js';
 import { startHeartbeat } from './heartbeat.js';
+import { createAgentApi } from './api.js';
+import { BoardHandler } from './handlers/board-handler.js';
 function requireEnv(name) {
     const value = process.env[name];
     if (!value) {
@@ -22,10 +24,43 @@ export function main() {
         console.log(`Backend URL: ${backendUrl} (JWT mode)`);
     }
     const { client } = createConnection({ url, token, agentId, backendUrl: backendUrl || undefined });
+    // Board handler (optional — requires BACKEND_URL and AGENT_TOKEN)
+    let boardHandler = null;
+    const apiBaseUrl = process.env.BACKEND_URL || backendUrl;
+    if (apiBaseUrl && token) {
+        const api = createAgentApi(apiBaseUrl, token);
+        boardHandler = new BoardHandler(api);
+        // Initialize board handler after connection is established
+        boardHandler.initialize().then((boardId) => {
+            if (!boardId) {
+                console.log('No board found for this agent, board handler dormant');
+                return;
+            }
+            const boardChannel = `board:${boardId}`;
+            const boardSub = client.newSubscription(boardChannel);
+            boardSub.on('publication', (ctx) => {
+                const event = ctx.data;
+                if (!event || !event.event)
+                    return;
+                boardHandler.onBoardEvent(event).catch((err) => {
+                    console.error('Board event handler error:', err instanceof Error ? err.message : err);
+                });
+            });
+            boardSub.subscribe();
+            console.log(`Subscribed to board channel: ${boardChannel}`);
+        }).catch((err) => {
+            console.error('Board handler init error:', err instanceof Error ? err.message : err);
+        });
+    }
     let heartbeatTimer;
     if (centrifugoInternalUrl && centrifugoApiKey) {
         console.log(`Heartbeat via Centrifugo internal API: ${centrifugoInternalUrl}`);
-        heartbeatTimer = startHeartbeat({ centrifugoInternalUrl, centrifugoApiKey, agentId });
+        heartbeatTimer = startHeartbeat({
+            centrifugoInternalUrl,
+            centrifugoApiKey,
+            agentId,
+            ...(boardHandler ? { getBoardStatus: () => boardHandler.getBoardStatus() } : {}),
+        });
     }
     else {
         console.warn('CENTRIFUGO_INTERNAL_URL or CENTRIFUGO_API_KEY not set, heartbeat disabled');

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,uBAAuB,CAAC;IAC7G,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;IAC1D,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC;IACxE,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAE9D,OAAO,CAAC,GAAG,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;IAC/D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,gBAAgB,UAAU,aAAa,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC,CAAC;IAElG,IAAI,cAA0C,CAAC;IAC/C,IAAI,qBAAqB,IAAI,gBAAgB,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,0CAA0C,qBAAqB,EAAE,CAAC,CAAC;QAC/E,cAAc,GAAG,cAAc,CAAC,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,IAAI,cAAc;YAAE,aAAa,CAAC,cAAc,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -25,4 +25,55 @@ export interface HeartbeatPayload {
         mem: number;
         uptime: number;
     };
+    boardStatus?: BoardState;
+}
+export interface BoardState {
+    state: 'idle' | 'working';
+    cardId: string | null;
+}
+export interface BoardEvent {
+    event: 'card:entered' | 'card:claimed' | 'card:moved' | 'card:commented';
+    cardId: string;
+    columnId?: string;
+    columnName?: string;
+    title?: string;
+    description?: string;
+    priority?: string;
+    agentId?: string;
+    fromColumnId?: string;
+    toColumnId?: string;
+    authorType?: string;
+    authorId?: string;
+    content?: string;
+}
+export interface BoardInfo {
+    board: {
+        id: string;
+        columns: Array<{
+            id: string;
+            name: string;
+            type: string;
+            position: number;
+            cards: Array<{
+                id: string;
+                title: string;
+                description?: string;
+                priority?: string;
+                assignedAgentId?: string | null;
+                createdAt?: string;
+            }>;
+        }>;
+        myColumnIds: string[];
+    };
+}
+export interface CardDetail {
+    card: {
+        id: string;
+        title: string;
+        description?: string;
+        priority?: string;
+        columnId: string;
+        columnName?: string;
+        assignedAgentId?: string | null;
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-cloud/agent-controller",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/api.ts

@@ -0,0 +1,40 @@
+const TIMEOUT = 10_000;
+
+export interface AgentApi {
+  get(path: string): Promise<unknown>;
+  post(path: string, body?: unknown): Promise<Response>;
+}
+
+export function createAgentApi(backendUrl: string, agentToken: string): AgentApi {
+  async function request(method: string, path: string, body?: unknown): Promise<Response> {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT);
+    try {
+      const res = await fetch(`${backendUrl}${path}`, {
+        method,
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${agentToken}`,
+        },
+        ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        signal: controller.signal,
+      });
+      return res;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+
+  return {
+    async get(path: string): Promise<unknown> {
+      const res = await request('GET', path);
+      if (!res.ok) {
+        throw new Error(`GET ${path} failed: HTTP ${res.status}`);
+      }
+      return res.json();
+    },
+    async post(path: string, body?: unknown): Promise<Response> {
+      return request('POST', path, body);
+    },
+  };
+}

package/src/handlers/backup.ts

@@ -10,6 +10,7 @@ const UPLOAD_TIMEOUT = 120_000;
 
 export function handleBackup(command: AgentCommand): Promise<AgentResponse> {
   const uploadUrl = command.payload.uploadUrl as string;
+  const token = command.payload.token as string;
   if (!uploadUrl) {
     return Promise.resolve({
       id: command.id,
@@ -24,7 +25,7 @@ export function handleBackup(command: AgentCommand): Promise<AgentResponse> {
   const archivePath = path.join(BACKUP_DIR, filename);
 
   return createArchive(archivePath)
-    .then(() => uploadArchive(archivePath, uploadUrl))
+    .then(() => uploadArchive(archivePath, uploadUrl, token))
     .then(async (size) => {
       await cleanup(archivePath);
       return {
@@ -61,28 +62,25 @@ function createArchive(archivePath: string): Promise<void> {
   });
 }
 
-async function uploadArchive(archivePath: string, uploadUrl: string): Promise<number> {
+async function uploadArchive(archivePath: string, uploadUrl: string, token?: string): Promise<number> {
   const stat = await fs.stat(archivePath);
   const fileBuffer = await fs.readFile(archivePath);
 
-  const boundary = `----backup-${Date.now()}`;
-  const filename = path.basename(archivePath);
-
-  const header = Buffer.from(
-    `--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${filename}"\r\nContent-Type: application/gzip\r\n\r\n`,
-  );
-  const footer = Buffer.from(`\r\n--${boundary}--\r\n`);
-  const body = Buffer.concat([header, fileBuffer, footer]);
+  const headers: Record<string, string> = { 'Content-Type': 'application/gzip' };
+  if (token) {
+    headers['Authorization'] = `Bearer ${token}`;
+  }
 
   const response = await fetch(uploadUrl, {
     method: 'POST',
-    headers: { 'Content-Type': `multipart/form-data; boundary=${boundary}` },
-    body,
+    headers,
+    body: fileBuffer,
     signal: AbortSignal.timeout(UPLOAD_TIMEOUT),
   });
 
   if (!response.ok) {
-    throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+    const text = await response.text().catch(() => '');
+    throw new Error(`Upload failed: ${response.status} ${response.statusText} ${text}`);
   }
 
   return stat.size;

package/src/handlers/board-handler.ts

@@ -0,0 +1,152 @@
+import { exec } from 'node:child_process';
+import type { AgentApi } from '../api.js';
+import type { BoardState, BoardEvent, BoardInfo, CardDetail } from '../types.js';
+
+const OPENCLAW_TIMEOUT = 30_000;
+
+export class BoardHandler {
+  private boardState: BoardState = { state: 'idle', cardId: null };
+  private myColumnIds: string[] = [];
+  private boardId: string | null = null;
+  private api: AgentApi;
+
+  constructor(api: AgentApi) {
+    this.api = api;
+  }
+
+  async initialize(): Promise<string | null> {
+    try {
+      const data = await this.api.get('/api/agent/board') as BoardInfo;
+      this.boardId = data.board.id;
+      this.myColumnIds = data.board.myColumnIds;
+      console.log(`Board initialized: ${this.boardId}, watching ${this.myColumnIds.length} column(s)`);
+
+      // Backfill: check for existing unassigned cards in my columns
+      await this.checkQueue(data);
+      return this.boardId;
+    } catch (err) {
+      console.error('Board initialization failed:', err instanceof Error ? err.message : err);
+      return null;
+    }
+  }
+
+  async onBoardEvent(event: BoardEvent): Promise<void> {
+    switch (event.event) {
+      case 'card:entered':
+        if (!event.columnId || !this.myColumnIds.includes(event.columnId)) return;
+        if (this.boardState.state === 'working') return;
+        await this.tryClaimCard(event.cardId);
+        break;
+      case 'card:claimed':
+      case 'card:moved':
+      case 'card:commented':
+        // Info only, ignore
+        break;
+    }
+  }
+
+  async tryClaimCard(cardId: string): Promise<void> {
+    try {
+      const res = await this.api.post(`/api/agent/board/cards/${cardId}/claim`);
+      if (res.ok) {
+        this.boardState = { state: 'working', cardId };
+        console.log(`Claimed card: ${cardId}`);
+        await this.startTask(cardId);
+      } else if (res.status === 409) {
+        console.log(`Card ${cardId} already claimed or agent busy, skipping`);
+      } else {
+        const body = await res.text().catch(() => '');
+        console.error(`Claim card ${cardId} failed (HTTP ${res.status}): ${body}`);
+      }
+    } catch (err) {
+      console.error('tryClaimCard error:', err instanceof Error ? err.message : err);
+    }
+  }
+
+  async startTask(cardId: string): Promise<void> {
+    try {
+      const data = await this.api.get(`/api/agent/board/cards/${cardId}`) as CardDetail;
+      const card = data.card;
+      const message = [
+        `New task from board: ${card.title}`,
+        card.description ? `Description: ${card.description}` : null,
+        card.priority ? `Priority: ${card.priority}` : null,
+        '',
+        'Instructions:',
+        '- Complete the task described above.',
+        '- Post progress and results as comments using: POST /api/agent/board/cards/' + cardId + '/comments',
+        '- When done, move the card forward using: POST /api/agent/board/cards/' + cardId + '/move',
+      ].filter(Boolean).join('\n');
+
+      await this.execOpenclaw(message);
+    } catch (err) {
+      console.error(`startTask(${cardId}) error:`, err instanceof Error ? err.message : err);
+    }
+  }
+
+  completeTask(cardId: string): void {
+    console.log(`Task completed: ${cardId}`);
+    this.boardState = { state: 'idle', cardId: null };
+    this.checkQueue().catch((err) => {
+      console.error('checkQueue after completeTask error:', err instanceof Error ? err.message : err);
+    });
+  }
+
+  async checkQueue(existingData?: BoardInfo): Promise<void> {
+    try {
+      const data = existingData ?? (await this.api.get('/api/agent/board') as BoardInfo);
+      const candidates: Array<{ id: string; priority?: string; createdAt?: string }> = [];
+
+      for (const col of data.board.columns) {
+        if (!this.myColumnIds.includes(col.id)) continue;
+        for (const card of col.cards) {
+          if (!card.assignedAgentId) {
+            candidates.push(card);
+          }
+        }
+      }
+
+      if (candidates.length === 0) return;
+
+      // Sort by priority (high > medium > low) then by creation date (oldest first)
+      const priorityOrder: Record<string, number> = { critical: 0, high: 1, medium: 2, low: 3 };
+      candidates.sort((a, b) => {
+        const pa = priorityOrder[a.priority ?? 'medium'] ?? 2;
+        const pb = priorityOrder[b.priority ?? 'medium'] ?? 2;
+        if (pa !== pb) return pa - pb;
+        return (a.createdAt ?? '').localeCompare(b.createdAt ?? '');
+      });
+
+      console.log(`Queue: ${candidates.length} unassigned card(s) in my columns, trying first`);
+      await this.tryClaimCard(candidates[0].id);
+    } catch (err) {
+      console.error('checkQueue error:', err instanceof Error ? err.message : err);
+    }
+  }
+
+  getBoardStatus(): BoardState {
+    return this.boardState;
+  }
+
+  getBoardId(): string | null {
+    return this.boardId;
+  }
+
+  private execOpenclaw(message: string): Promise<void> {
+    return new Promise((resolve) => {
+      const escaped = message.replace(/'/g, "'\\''");
+      exec(
+        `openclaw system event --text '${escaped}' --mode now`,
+        { timeout: OPENCLAW_TIMEOUT },
+        (error, stdout, stderr) => {
+          if (error) {
+            console.error('openclaw system event failed:', stderr.toString() || error.message);
+          } else {
+            console.log('openclaw system event sent');
+          }
+          resolve();
+        },
+      );
+    });
+  }
+}

package/src/heartbeat.ts

@@ -1,5 +1,5 @@
 import os from 'node:os';
-import type { HeartbeatPayload } from './types.js';
+import type { BoardState, HeartbeatPayload } from './types.js';
 
 const HEARTBEAT_INTERVAL = 30_000;
 const HEARTBEAT_CHANNEL = 'heartbeat:data';
@@ -8,6 +8,7 @@ export interface HeartbeatOptions {
   centrifugoInternalUrl: string;
   centrifugoApiKey: string;
   agentId: string;
+  getBoardStatus?: () => BoardState;
 }
 
 function getMetrics(): HeartbeatPayload['metrics'] {
@@ -33,6 +34,7 @@ async function publishHeartbeat(opts: HeartbeatOptions): Promise<void> {
     agentId: opts.agentId,
     ts: Date.now(),
     metrics: getMetrics(),
+    ...(opts.getBoardStatus ? { boardStatus: opts.getBoardStatus() } : {}),
   };
 
   const controller = new AbortController();

package/src/index.ts

@@ -1,5 +1,8 @@
 import { createConnection } from './connection.js';
 import { startHeartbeat } from './heartbeat.js';
+import { createAgentApi } from './api.js';
+import { BoardHandler } from './handlers/board-handler.js';
+import type { BoardEvent } from './types.js';
 
 function requireEnv(name: string): string {
   const value = process.env[name];
@@ -27,10 +30,47 @@ export function main(): void {
 
   const { client } = createConnection({ url, token, agentId, backendUrl: backendUrl || undefined });
 
+  // Board handler (optional — requires BACKEND_URL and AGENT_TOKEN)
+  let boardHandler: BoardHandler | null = null;
+  const apiBaseUrl = process.env.BACKEND_URL || backendUrl;
+  if (apiBaseUrl && token) {
+    const api = createAgentApi(apiBaseUrl, token);
+    boardHandler = new BoardHandler(api);
+
+    // Initialize board handler after connection is established
+    boardHandler.initialize().then((boardId) => {
+      if (!boardId) {
+        console.log('No board found for this agent, board handler dormant');
+        return;
+      }
+
+      const boardChannel = `board:${boardId}`;
+      const boardSub = client.newSubscription(boardChannel);
+
+      boardSub.on('publication', (ctx) => {
+        const event = ctx.data as BoardEvent;
+        if (!event || !event.event) return;
+        boardHandler!.onBoardEvent(event).catch((err) => {
+          console.error('Board event handler error:', err instanceof Error ? err.message : err);
+        });
+      });
+
+      boardSub.subscribe();
+      console.log(`Subscribed to board channel: ${boardChannel}`);
+    }).catch((err) => {
+      console.error('Board handler init error:', err instanceof Error ? err.message : err);
+    });
+  }
+
   let heartbeatTimer: NodeJS.Timeout | undefined;
   if (centrifugoInternalUrl && centrifugoApiKey) {
     console.log(`Heartbeat via Centrifugo internal API: ${centrifugoInternalUrl}`);
-    heartbeatTimer = startHeartbeat({ centrifugoInternalUrl, centrifugoApiKey, agentId });
+    heartbeatTimer = startHeartbeat({
+      centrifugoInternalUrl,
+      centrifugoApiKey,
+      agentId,
+      ...(boardHandler ? { getBoardStatus: () => boardHandler!.getBoardStatus() } : {}),
+    });
   } else {
     console.warn('CENTRIFUGO_INTERNAL_URL or CENTRIFUGO_API_KEY not set, heartbeat disabled');
   }

package/src/types.ts

@@ -29,4 +29,59 @@ export interface HeartbeatPayload {
     mem: number;
     uptime: number;
   };
+  boardStatus?: BoardState;
+}
+
+export interface BoardState {
+  state: 'idle' | 'working';
+  cardId: string | null;
+}
+
+export interface BoardEvent {
+  event: 'card:entered' | 'card:claimed' | 'card:moved' | 'card:commented';
+  cardId: string;
+  columnId?: string;
+  columnName?: string;
+  title?: string;
+  description?: string;
+  priority?: string;
+  agentId?: string;
+  fromColumnId?: string;
+  toColumnId?: string;
+  authorType?: string;
+  authorId?: string;
+  content?: string;
+}
+
+export interface BoardInfo {
+  board: {
+    id: string;
+    columns: Array<{
+      id: string;
+      name: string;
+      type: string;
+      position: number;
+      cards: Array<{
+        id: string;
+        title: string;
+        description?: string;
+        priority?: string;
+        assignedAgentId?: string | null;
+        createdAt?: string;
+      }>;
+    }>;
+    myColumnIds: string[];
+  };
+}
+
+export interface CardDetail {
+  card: {
+    id: string;
+    title: string;
+    description?: string;
+    priority?: string;
+    columnId: string;
+    columnName?: string;
+    assignedAgentId?: string | null;
+  };
 }