maniflow-mission-control 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# Mission Control Plugin for OpenClaw
+
+Syncs agent lifecycle events from OpenClaw to the Mission Control dashboard (Convex backend) in real time.
+
+## Architecture
+
+### Internal Hook (HOOK.md)
+
+- **File:** `hooks/mission-control/handler.ts`
+- **Events:** `agent:bootstrap`, `gateway:startup`
+- **Role:** Stores session info, reads the user prompt, sends "start" event
+
+### Typed Plugin Hooks (api.on)
+
+- **File:** `src/index.ts`
+- **Events:** `agent_end`, `after_tool_call`
+- **Role:** Sends "end" and "progress" events with sub-second latency
+
+### Event Flow
+
+```
+Agent starts   -> HOOK.md agent:bootstrap   -> handler.ts sends "start"
+Agent uses tool -> api.on("after_tool_call") -> index.ts sends "progress"
+Agent finishes  -> api.on("agent_end")       -> index.ts sends "end"
+```
+
+### Shared State
+
+Both files coordinate via `Symbol.for()` globals:
+
+- `mission-control:sessionInfo` — `Map<string, {agentId, sessionId}>` mapping session keys to IDs (set by handler.ts, read by index.ts)
+
+### Dedup
+
+OpenClaw may fire `agent_end` twice per turn (intermediate + final message snapshot). The plugin uses a `Map<string, number>` keyed by `sessionKey → messageCount`. If `agent_end` fires again with the same message count, it's a duplicate and is skipped.
+
+## Configuration
+
+| Env var | Required | Description |
+|---------|----------|-------------|
+| `CONVEX_URL` | Yes | Self-hosted Convex backend URL (port 443, not 8443) |
+
+## Requirements
+
+- OpenClaw >= 2026.2.3 (for `api.on()` typed hooks)

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Mission Control Plugin for OpenClaw
+ *
+ * Syncs agent lifecycle events to Mission Control via authenticated HTTP
+ * actions on hosted Convex.
+ *
+ * Integrates with OpenClaw's infrastructure:
+ * - Uses registerService for background task subscriber (proper lifecycle)
+ * - Uses device identity for cryptographic authentication
+ * - Stores state in OC's state directory
+ *
+ * BYOB Mode: When MC_GATEWAY_ID is set, the plugin subscribes to Convex
+ * for task assignments, enabling local gateways to receive tasks without
+ * inbound HTTP connectivity.
+ */
+import type { PluginApi } from "openclaw";
+export default function register(api: PluginApi): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAgC,MAAM,UAAU,CAAC;AA0IxE,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,SAAS,QAkC9C"}

package/dist/index.js

@@ -0,0 +1,239 @@
+/**
+ * Mission Control Plugin for OpenClaw
+ *
+ * Syncs agent lifecycle events to Mission Control via authenticated HTTP
+ * actions on hosted Convex.
+ *
+ * Integrates with OpenClaw's infrastructure:
+ * - Uses registerService for background task subscriber (proper lifecycle)
+ * - Uses device identity for cryptographic authentication
+ * - Stores state in OC's state directory
+ *
+ * BYOB Mode: When MC_GATEWAY_ID is set, the plugin subscribes to Convex
+ * for task assignments, enabling local gateways to receive tasks without
+ * inbound HTTP connectivity.
+ */
+import { TaskSubscriber, bootstrapSubscriber } from "./subscriber.js";
+/** Shared session info set by handler.ts on agent:bootstrap */
+function getSessionInfo() {
+    const key = Symbol.for("mission-control:sessionInfo");
+    const g = globalThis;
+    if (!g[key]) {
+        g[key] = new Map();
+    }
+    return g[key];
+}
+async function sendToConvex(payload) {
+    const convexUrl = process.env.MC_CONVEX_URL;
+    const apiToken = process.env.MC_API_TOKEN;
+    if (!convexUrl || !apiToken)
+        return;
+    try {
+        console.log("[mission-control:typed] POST /openclaw/event", payload.action, payload.sessionKey);
+        const response = await fetch(`${convexUrl}/openclaw/event`, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${apiToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            console.error("[mission-control:typed] HTTP error:", response.status, text);
+            return;
+        }
+        console.log("[mission-control:typed] OK:", payload.action);
+    }
+    catch (err) {
+        console.error("[mission-control:typed] fetch error:", err instanceof Error ? err.message : err);
+    }
+}
+/**
+ * Handle agent_end typed hook.
+ */
+function handleAgentEnd(event, ctx) {
+    const sessionKey = ctx.sessionKey;
+    const agentId = ctx.agentId;
+    if (!sessionKey || !agentId) {
+        console.log("[mission-control:typed] agent_end missing sessionKey or agentId, skipping");
+        return;
+    }
+    const messages = event.messages;
+    // Extract last assistant response from messages array if available
+    let response = null;
+    if (Array.isArray(messages)) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (msg?.role === "assistant" && msg.content) {
+                if (Array.isArray(msg.content)) {
+                    const textParts = msg.content
+                        .filter((p) => p.type === "text")
+                        .map((p) => p.text || "")
+                        .join("\n");
+                    if (textParts) {
+                        response = textParts;
+                        break;
+                    }
+                }
+                else if (typeof msg.content === "string") {
+                    response = msg.content;
+                    break;
+                }
+            }
+        }
+    }
+    if (response && response.length > 1000) {
+        response = response.slice(0, 1000) + "...";
+    }
+    // Resolve runId from sessionInfo (set by handler.ts on bootstrap)
+    const sessionInfo = getSessionInfo();
+    const info = sessionInfo.get(sessionKey);
+    const runId = info?.sessionId ?? sessionKey;
+    console.log(`[mission-control:typed] agent_end for ${sessionKey} success=${event.success}`);
+    void sendToConvex({
+        runId,
+        action: "end",
+        sessionKey,
+        agentId,
+        timestamp: new Date().toISOString(),
+        response,
+        error: event.error ?? null,
+        eventType: "typed-hook:agent_end",
+    });
+}
+/**
+ * Handle after_tool_call typed hook.
+ */
+function handleToolCall(event, ctx) {
+    const sessionKey = ctx.sessionKey;
+    const agentId = ctx.agentId;
+    if (!sessionKey || !agentId)
+        return;
+    const toolName = (event.toolName ?? event.name ?? "unknown");
+    const sessionInfo = getSessionInfo();
+    const info = sessionInfo.get(sessionKey);
+    const runId = info?.sessionId ?? sessionKey;
+    void sendToConvex({
+        runId,
+        action: "progress",
+        sessionKey,
+        agentId,
+        timestamp: new Date().toISOString(),
+        message: `Tool completed: ${toolName}`,
+        eventType: "typed-hook:after_tool_call",
+    });
+}
+export default function register(api) {
+    const convexUrl = process.env.MC_CONVEX_URL;
+    if (!convexUrl) {
+        api.logger.warn("mission-control: No MC_CONVEX_URL set, plugin inactive");
+        return;
+    }
+    api.on("agent_end", handleAgentEnd);
+    api.on("after_tool_call", handleToolCall);
+    api.logger.info({
+        msg: "mission-control: Typed hooks registered (agent_end, after_tool_call)",
+        convexUrl,
+    });
+    // BYOB Mode: Register task subscriber as OC service (proper lifecycle)
+    const gatewayId = process.env.MC_GATEWAY_ID;
+    const apiToken = process.env.MC_API_TOKEN;
+    if (gatewayId && apiToken) {
+        api.logger.info({
+            msg: "mission-control: BYOB mode enabled, registering task subscriber service",
+            gatewayId,
+        });
+        // Register as a proper OC service for lifecycle management
+        const subscriberService = createTaskSubscriberService(api, {
+            convexUrl,
+            apiToken,
+            gatewayId,
+        });
+        api.registerService(subscriberService);
+    }
+}
+/**
+ * Trigger an agent run via localhost loopback to /hooks/agent.
+ * This avoids needing OC core changes - we just POST to ourselves.
+ */
+async function triggerAgentViaLoopback(task) {
+    const port = process.env.MC_GATEWAY_PORT || process.env.OPENCLAW_PORT || "18789";
+    const hooksToken = process.env.MC_HOOKS_TOKEN || process.env.OPENCLAW_HOOKS_TOKEN;
+    if (!hooksToken) {
+        throw new Error("MC_HOOKS_TOKEN or OPENCLAW_HOOKS_TOKEN required for loopback");
+    }
+    const url = `http://127.0.0.1:${port}/hooks/agent`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Authorization": `Bearer ${hooksToken}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            sessionKey: task.sessionKey,
+            message: task.message,
+            agentId: task.agentId,
+            // Include runId in metadata so MC can correlate
+            metadata: { runId: task.runId },
+        }),
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`Loopback trigger failed: ${response.status} ${text}`);
+    }
+}
+/**
+ * Create the BYOB task subscriber as an OC service.
+ * This integrates with OC's service lifecycle (start/stop on gateway start/stop).
+ */
+function createTaskSubscriberService(_api, config) {
+    let subscriber = null;
+    return {
+        id: "mission-control-task-subscriber",
+        start: async (ctx) => {
+            ctx.logger.info("mission-control: Starting task subscriber service");
+            // Bootstrap: authenticate and get Convex URL
+            const bootstrap = await bootstrapSubscriber({
+                mcConvexUrl: config.convexUrl,
+                mcApiToken: config.apiToken,
+                gatewayId: config.gatewayId,
+            });
+            if (!bootstrap) {
+                ctx.logger.error("mission-control: Failed to bootstrap task subscriber");
+                return;
+            }
+            subscriber = new TaskSubscriber({
+                convexUrl: bootstrap.convexUrl,
+                gatewayId: bootstrap.gatewayId,
+                pollIntervalMs: 3000,
+                logger: {
+                    info: (msg, data) => ctx.logger.info(`${msg} ${JSON.stringify(data ?? {})}`),
+                    error: (msg, data) => ctx.logger.error(`${msg} ${JSON.stringify(data ?? {})}`),
+                    warn: (msg, data) => ctx.logger.warn(`${msg} ${JSON.stringify(data ?? {})}`),
+                },
+                onTask: async (assignment) => {
+                    ctx.logger.info(`Received task: ${assignment.taskId}`);
+                    await triggerAgentViaLoopback({
+                        sessionKey: assignment.sessionKey,
+                        message: assignment.message,
+                        agentId: assignment.agentId,
+                        runId: assignment.runId,
+                    });
+                },
+            });
+            // Start polling (runs in background)
+            void subscriber.start();
+            ctx.logger.info("mission-control: Task subscriber started");
+        },
+        stop: async (ctx) => {
+            if (subscriber) {
+                subscriber.stop();
+                subscriber = null;
+                ctx.logger.info("mission-control: Task subscriber stopped");
+            }
+        },
+    };
+}
+// Legacy startTaskSubscriber function removed - now using registerService pattern
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/subscriber.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Task Subscriber for BYOB (Bring Your Own Bot)
+ *
+ * Polls Convex for pending task assignments and triggers agent runs.
+ * This enables local/BYOB gateways to receive tasks without requiring
+ * inbound HTTP connectivity.
+ */
+interface TaskAssignment {
+    _id: string;
+    taskId: string;
+    message: string;
+    sessionKey: string;
+    gatewayId: string;
+    agentId?: string;
+    status: "pending" | "claimed" | "completed" | "expired";
+    runId?: string;
+    tenantId: string;
+    createdAt: number;
+    expiresAt: number;
+}
+export interface TaskSubscriberConfig {
+    convexUrl: string;
+    gatewayId: string;
+    pollIntervalMs?: number;
+    onTask: (assignment: TaskAssignment & {
+        runId: string;
+    }) => Promise<void>;
+    logger?: {
+        info: (msg: string, data?: Record<string, unknown>) => void;
+        error: (msg: string, data?: Record<string, unknown>) => void;
+        warn: (msg: string, data?: Record<string, unknown>) => void;
+    };
+}
+export declare class TaskSubscriber {
+    private client;
+    private gatewayId;
+    private pollIntervalMs;
+    private running;
+    private onTask;
+    private logger;
+    constructor(config: TaskSubscriberConfig);
+    start(): Promise<void>;
+    stop(): void;
+    private pollOnce;
+    private sleep;
+}
+/**
+ * Bootstrap the subscriber by authenticating with Convex and getting config.
+ */
+export declare function bootstrapSubscriber(config: {
+    mcConvexUrl: string;
+    mcApiToken: string;
+    gatewayId: string;
+}): Promise<{
+    convexUrl: string;
+    gatewayId: string;
+} | null>;
+export {};
+//# sourceMappingURL=subscriber.d.ts.map

package/dist/subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber.d.ts","sourceRoot":"","sources":["../src/subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,CAAC,UAAU,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC5D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC7D,CAAC;CACH;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAA8C;gBAEhD,MAAM,EAAE,oBAAoB;IAYlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,IAAI,IAAI,IAAI;YAIE,QAAQ;IAiEtB,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAkC3D"}

package/dist/subscriber.js

@@ -0,0 +1,138 @@
+/**
+ * Task Subscriber for BYOB (Bring Your Own Bot)
+ *
+ * Polls Convex for pending task assignments and triggers agent runs.
+ * This enables local/BYOB gateways to receive tasks without requiring
+ * inbound HTTP connectivity.
+ */
+import { ConvexHttpClient } from "convex/browser";
+// Function references for Convex API (will be constructed at runtime)
+const PENDING_FOR_GATEWAY = "taskAssignments:pendingForGateway";
+const CLAIM_ASSIGNMENT = "taskAssignments:claimAssignment";
+const COMPLETE_ASSIGNMENT = "taskAssignments:completeAssignment";
+export class TaskSubscriber {
+    client;
+    gatewayId;
+    pollIntervalMs;
+    running = false;
+    onTask;
+    logger;
+    constructor(config) {
+        this.client = new ConvexHttpClient(config.convexUrl);
+        this.gatewayId = config.gatewayId;
+        this.pollIntervalMs = config.pollIntervalMs ?? 3000;
+        this.onTask = config.onTask;
+        this.logger = config.logger ?? {
+            info: (msg, data) => console.log(`[mc-subscriber] ${msg}`, data ?? ""),
+            error: (msg, data) => console.error(`[mc-subscriber] ${msg}`, data ?? ""),
+            warn: (msg, data) => console.warn(`[mc-subscriber] ${msg}`, data ?? ""),
+        };
+    }
+    async start() {
+        if (this.running) {
+            this.logger.warn("Subscriber already running");
+            return;
+        }
+        this.running = true;
+        this.logger.info("Starting task subscriber", {
+            gatewayId: this.gatewayId,
+            pollIntervalMs: this.pollIntervalMs,
+        });
+        while (this.running) {
+            try {
+                await this.pollOnce();
+            }
+            catch (err) {
+                this.logger.error("Poll error", {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+            await this.sleep(this.pollIntervalMs);
+        }
+        this.logger.info("Task subscriber stopped");
+    }
+    stop() {
+        this.running = false;
+    }
+    async pollOnce() {
+        // Query for pending assignments
+        const pending = await this.client.query(PENDING_FOR_GATEWAY, { gatewayId: this.gatewayId });
+        if (pending.length === 0)
+            return;
+        this.logger.info(`Found ${pending.length} pending assignment(s)`);
+        for (const assignment of pending) {
+            // Generate a unique run ID
+            const runId = crypto.randomUUID();
+            // Try to claim the assignment (atomic)
+            const result = await this.client.mutation(CLAIM_ASSIGNMENT, { assignmentId: assignment._id, runId });
+            if (!result.ok) {
+                this.logger.info("Assignment already claimed", {
+                    assignmentId: assignment._id,
+                    reason: result.reason,
+                });
+                continue;
+            }
+            this.logger.info("Claimed assignment", {
+                assignmentId: assignment._id,
+                taskId: assignment.taskId,
+                runId,
+            });
+            // Execute the task
+            try {
+                await this.onTask({ ...assignment, runId });
+                // Mark as completed
+                await this.client.mutation(COMPLETE_ASSIGNMENT, { assignmentId: assignment._id });
+                this.logger.info("Assignment completed", {
+                    assignmentId: assignment._id,
+                    taskId: assignment.taskId,
+                });
+            }
+            catch (err) {
+                this.logger.error("Task execution failed", {
+                    assignmentId: assignment._id,
+                    taskId: assignment.taskId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                // Still mark as completed (with error state logged)
+                await this.client.mutation(COMPLETE_ASSIGNMENT, { assignmentId: assignment._id }).catch(() => { });
+            }
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Bootstrap the subscriber by authenticating with Convex and getting config.
+ */
+export async function bootstrapSubscriber(config) {
+    try {
+        const response = await fetch(`${config.mcConvexUrl}/gateway/subscribe`, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${config.mcApiToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ gatewayId: config.gatewayId }),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            console.error("[mc-subscriber] Bootstrap failed:", response.status, text);
+            return null;
+        }
+        const data = await response.json();
+        if (!data.ok) {
+            console.error("[mc-subscriber] Bootstrap error:", data.error);
+            return null;
+        }
+        return {
+            convexUrl: data.convexUrl,
+            gatewayId: data.gatewayId,
+        };
+    }
+    catch (err) {
+        console.error("[mc-subscriber] Bootstrap fetch error:", err instanceof Error ? err.message : err);
+        return null;
+    }
+}
+//# sourceMappingURL=subscriber.js.map

package/dist/subscriber.js.map

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

package/hooks/mission-control/HOOK.md

@@ -0,0 +1,18 @@
+---
+name: mission-control
+description: "Sync agent lifecycle events to Mission Control dashboard via Convex"
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📊",
+        "events": ["gateway:startup", "agent:bootstrap"],
+        "always": true,
+      },
+  }
+---
+
+# Mission Control Integration
+
+Sends agent lifecycle events to the Mission Control Convex backend for real-time task tracking.
+Uses authenticated HTTP requests to the hosted Convex `/openclaw/event` endpoint (Bearer token auth via MC_API_TOKEN).