mortgram-hook 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# mortgram-hook
+
+**MORTGRAM Ghost Bridge** — Invisible real-time observability for your OpenClaw agents.
+
+## Install
+
+```bash
+openclaw hooks install mortgram-hook
+```
+
+## Configure
+
+Set your MORTGRAM API key as an environment variable:
+
+```bash
+export MORTGRAM_API_KEY=MG_LIVE_sk_your_key_here
+```
+
+Or add it to your OpenClaw config (`~/.openclaw/openclaw.json`).
+
+## What it does
+
+The Ghost Bridge hooks into your OpenClaw agent lifecycle and streams data to your MORTGRAM dashboard in real-time:
+
+| Event | What's Tracked |
+|-------|---------------|
+| `agent:thought` | Latest thought, turn count |
+| `tool:call` | Tool usage, efficiency score |
+| `agent:error` | Error tracking |
+| `session:usage` | Daily cost / token spend |
+| `session:start/end` | Online/Offline status |
+
+**Zero friction.** No wrappers, no extra processes, no code changes.
+
+## Dashboard
+
+View your fleet at [mortgram.com/dashboard](https://mortgram.com/dashboard)

package/index.mjs

@@ -0,0 +1,135 @@
+// ═══════════════════════════════════════════════════════
+// MORTGRAM Ghost Bridge — Native OpenClaw Hook
+// ═══════════════════════════════════════════════════════
+// Installed via: openclaw hooks install mortgram-hook
+// Zero-touch observability: no wrapper, no config, no friction.
+//
+// Environment Variables Required:
+//   MORTGRAM_API_KEY  — Your MORTGRAM API key (from dashboard)
+//   MORTGRAM_API_URL  — API endpoint (defaults to https://mortgram.com/api/ingest)
+//   MG_AGENT_ID      — Agent identifier (defaults to "ghost-agent")
+// ═══════════════════════════════════════════════════════
+
+export const name = "mortgram-observer";
+
+// Track session state for efficiency calculation
+let totalTurns = 0;
+let successfulTools = 0;
+let latestThought = "Ghost Bridge Active";
+let dailyCost = 0;
+
+const API_KEY = process.env.MORTGRAM_API_KEY || process.env.MG_LIVE_KEY || "";
+const API_URL = process.env.MORTGRAM_API_URL || "https://mortgram.com/api/ingest";
+const AGENT_ID = process.env.MG_AGENT_ID || "ghost-agent";
+
+// Silently POST to the MORTGRAM ingest endpoint
+async function send(type, content, metadata = {}) {
+    if (!API_KEY) return;
+
+    try {
+        await fetch(API_URL, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-mortgram-token": API_KEY
+            },
+            body: JSON.stringify({
+                agent_id: AGENT_ID,
+                type,
+                content,
+                metadata: {
+                    ...metadata,
+                    daily_cost: dailyCost,
+                    efficiency: totalTurns > 0 ? (successfulTools / totalTurns) : 0,
+                    latest_thought: latestThought,
+                    status: "online",
+                    timestamp: new Date().toISOString()
+                }
+            })
+        });
+    } catch (_) {
+        // Silent fail — never disrupt the agent
+    }
+}
+
+// ─── The Main Event Handler ───
+// OpenClaw fires events for every lifecycle step.
+// We intercept them invisibly and stream to MORTGRAM.
+export async function onEvent({ event, data }) {
+    switch (event) {
+        // ── Agent Thought / Reasoning ──
+        case "agent:thought":
+        case "agent:reasoning":
+            totalTurns++;
+            latestThought = data?.text || data?.content || "Thinking...";
+            await send("thought", latestThought, { event });
+            break;
+
+        // ── Tool Calls (Actions) ──
+        case "tool:call":
+        case "tool:result":
+            successfulTools++;
+            await send("action", data?.name || data?.tool || "Tool Call", {
+                event,
+                tool: data?.name,
+                args: data?.args
+            });
+            break;
+
+        // ── Errors ──
+        case "agent:error":
+        case "tool:error":
+            if (successfulTools > 0) successfulTools--;
+            await send("error", data?.message || data?.text || "Error occurred", {
+                event,
+                stack: data?.stack
+            });
+            break;
+
+        // ── Session Usage / Cost ──
+        case "session:usage":
+        case "session:cost":
+            dailyCost = data?.total_cost || data?.cost || dailyCost;
+            await send("cost_update", `Daily spend: $${dailyCost.toFixed(4)}`, {
+                event,
+                daily_cost: dailyCost,
+                tokens: data?.tokens
+            });
+            break;
+
+        // ── Session Start ──
+        case "session:start":
+        case "agent:start":
+            totalTurns = 0;
+            successfulTools = 0;
+            dailyCost = 0;
+            latestThought = "Session started";
+            await send("system", "Ghost Bridge: Session started", {
+                event,
+                status: "online"
+            });
+            break;
+
+        // ── Session End ──
+        case "session:end":
+        case "agent:end":
+            await send("system", "Ghost Bridge: Session ended", {
+                event,
+                status: "offline",
+                final_cost: dailyCost,
+                final_efficiency: totalTurns > 0 ? (successfulTools / totalTurns) : 0
+            });
+            break;
+
+        // ── Agent Response / Output ──
+        case "agent:response":
+        case "agent:message":
+            latestThought = data?.text?.slice(0, 200) || "Response generated";
+            await send("thought", latestThought, { event });
+            break;
+
+        default:
+            // Skip unrecognized events silently
+            break;
+    }
+}

package/package.json

@@ -0,0 +1,16 @@
+{
+    "name": "mortgram-hook",
+    "version": "1.0.0",
+    "description": "MORTGRAM Ghost Bridge — Invisible observability for OpenClaw agents",
+    "main": "index.mjs",
+    "type": "module",
+    "keywords": [
+        "openclaw",
+        "mortgram",
+        "observability",
+        "agent",
+        "hook"
+    ],
+    "author": "MORTGRAM",
+    "license": "MIT"
+}