@lumin-io/openclaw-diagnostics 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @lumin-io/openclaw-diagnostics — Lumin's deepest hook into OpenClaw.
+ *
+ * Two related but separate APIs in OpenClaw observe a model call:
+ *
+ *   1. `internalDiagnostics.onEvent` — the bus the bundled
+ *      `@openclaw/diagnostics-otel` plugin reads. Carries timing,
+ *      sizes, and provider IDs but the runtime never populates the
+ *      `inputMessages` / `outputMessages` fields the OTel exporter
+ *      tries to read, so the diagnostics-otel content-capture flag
+ *      is effectively non-functional in 2026.5.x. Fixing that needs
+ *      an upstream PR; meanwhile we route around it.
+ *
+ *   2. **Typed hooks** (`llm_input`, `llm_output`) — the registration
+ *      surface used by trusted plugins. These DO carry full content
+ *      (`prompt`, `historyMessages`, `systemPrompt`, `assistantTexts`,
+ *      `usage`) at runtime, which is exactly what an observability
+ *      tool needs.
+ *
+ * This plugin uses (2). On every llm_input / llm_output we build a
+ * Lumin SpanInput and POST to `/v1/spans`. The agent never blocks on
+ * us — failures are swallowed and budgeted with a short timeout.
+ *
+ * Activation prerequisite: non-bundled plugins must opt into
+ * conversation access, so the operator's openclaw.json must contain
+ *
+ *   "plugins": {
+ *     "entries": {
+ *       "lumin-diagnostics": {
+ *         "hooks": { "allowConversationAccess": true }
+ *       }
+ *     }
+ *   }
+ *
+ * The plugin's install step writes that for the operator; if it's
+ * missing, OpenClaw silently drops the hook registration and we
+ * never see content. The plugin warns once at startup if the flag
+ * isn't set so the misconfiguration surfaces immediately.
+ */
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginConfigSchema;
+    register: NonNullable<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition["register"]>;
+} & Pick<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition, "kind" | "reload" | "nodeHostCommands" | "securityAuditCollectors">;
+export default _default;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;;;;;;;;AAwWH,wBA2GG"}

package/dist/index.js

@@ -0,0 +1,384 @@
+/**
+ * @lumin-io/openclaw-diagnostics — Lumin's deepest hook into OpenClaw.
+ *
+ * Two related but separate APIs in OpenClaw observe a model call:
+ *
+ *   1. `internalDiagnostics.onEvent` — the bus the bundled
+ *      `@openclaw/diagnostics-otel` plugin reads. Carries timing,
+ *      sizes, and provider IDs but the runtime never populates the
+ *      `inputMessages` / `outputMessages` fields the OTel exporter
+ *      tries to read, so the diagnostics-otel content-capture flag
+ *      is effectively non-functional in 2026.5.x. Fixing that needs
+ *      an upstream PR; meanwhile we route around it.
+ *
+ *   2. **Typed hooks** (`llm_input`, `llm_output`) — the registration
+ *      surface used by trusted plugins. These DO carry full content
+ *      (`prompt`, `historyMessages`, `systemPrompt`, `assistantTexts`,
+ *      `usage`) at runtime, which is exactly what an observability
+ *      tool needs.
+ *
+ * This plugin uses (2). On every llm_input / llm_output we build a
+ * Lumin SpanInput and POST to `/v1/spans`. The agent never blocks on
+ * us — failures are swallowed and budgeted with a short timeout.
+ *
+ * Activation prerequisite: non-bundled plugins must opt into
+ * conversation access, so the operator's openclaw.json must contain
+ *
+ *   "plugins": {
+ *     "entries": {
+ *       "lumin-diagnostics": {
+ *         "hooks": { "allowConversationAccess": true }
+ *       }
+ *     }
+ *   }
+ *
+ * The plugin's install step writes that for the operator; if it's
+ * missing, OpenClaw silently drops the hook registration and we
+ * never see content. The plugin warns once at startup if the flag
+ * isn't set so the misconfiguration surfaces immediately.
+ */
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+const DEFAULT_HOST = "http://localhost:8000";
+const DEFAULT_PROJECT = "openclaw";
+const DEFAULT_MAX_CONTENT_CHARS = 32_768;
+const DEFAULT_TIMEOUT_MS = 5_000;
+// ----- helpers ------------------------------------------------------------
+function stringify(value, maxLen) {
+    if (value === null || value === undefined)
+        return undefined;
+    let s;
+    if (typeof value === "string") {
+        s = value;
+    }
+    else if (Array.isArray(value)) {
+        s = value
+            .map((v) => (typeof v === "string" ? v : safeJsonStringify(v)))
+            .join("\n");
+    }
+    else {
+        s = safeJsonStringify(value);
+    }
+    if (s.length <= maxLen)
+        return s;
+    return s.slice(0, maxLen - 16) + "…(truncated)";
+}
+function safeJsonStringify(v) {
+    try {
+        const out = JSON.stringify(v);
+        return out === undefined ? String(v) : out;
+    }
+    catch {
+        return String(v);
+    }
+}
+/**
+ * Format an OpenClaw 32-hex traceId / 16-hex spanId as a UUID so it
+ * collides with the trace_id schema Lumin already uses for OTLP-
+ * ingested spans. Also pads / hashes a fallback so we always get a
+ * deterministic 32-hex ID even when the hook runs without a trace
+ * scope.
+ */
+function asUuid(hex, fallback) {
+    const h = (hex || "").toLowerCase().replace(/[^0-9a-f]/g, "");
+    const padded = h.length >= 32 ? h.slice(0, 32) : h.padStart(32, "0");
+    if (!padded || /^0+$/.test(padded)) {
+        const fp = fnv1a64(fallback).padStart(32, "0").slice(-32);
+        return uuidify(fp);
+    }
+    return uuidify(padded);
+}
+function uuidify(hex32) {
+    return `${hex32.slice(0, 8)}-${hex32.slice(8, 12)}-${hex32.slice(12, 16)}-${hex32.slice(16, 20)}-${hex32.slice(20, 32)}`;
+}
+function fnv1a64(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193) >>> 0;
+    }
+    let h2 = 0xcbf29ce4;
+    for (let i = s.length - 1; i >= 0; i--) {
+        h2 ^= s.charCodeAt(i);
+        h2 = Math.imul(h2, 0x01000193) >>> 0;
+    }
+    return h.toString(16).padStart(8, "0") + h2.toString(16).padStart(8, "0");
+}
+function nowIso() {
+    return new Date().toISOString().replace("Z", "000Z");
+}
+/**
+ * Walk an OpenClaw assistant message's content blocks and concatenate
+ * any ``{type: "thinking", thinking: "..."}`` payloads. Reasoning
+ * models attach these BEFORE the visible text, but
+ * ``assistantTexts`` strips them. Returning undefined means "no
+ * thinking blocks present" — the caller should leave the metadata
+ * field absent rather than write an empty string.
+ *
+ * Defensive: lastAssistant is typed as ``unknown`` and provider
+ * shapes drift, so every step type-checks before recursing.
+ */
+function extractThinkingFromAssistant(lastAssistant) {
+    if (!lastAssistant || typeof lastAssistant !== "object")
+        return undefined;
+    const content = lastAssistant.content;
+    if (!Array.isArray(content))
+        return undefined;
+    const parts = [];
+    for (const block of content) {
+        if (!block || typeof block !== "object")
+            continue;
+        const b = block;
+        if (b.type === "thinking" && typeof b.thinking === "string" && b.thinking.length > 0) {
+            parts.push(b.thinking);
+        }
+    }
+    return parts.length > 0 ? parts.join("\n\n") : undefined;
+}
+// ----- transport ----------------------------------------------------------
+class LuminClient {
+    host;
+    project;
+    timeoutMs;
+    failureLogged = false;
+    constructor(cfg) {
+        this.host = (cfg.host || process.env.LUMIN_HOST || DEFAULT_HOST).replace(/\/+$/, "");
+        this.project = cfg.project || DEFAULT_PROJECT;
+        this.timeoutMs = cfg.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    /**
+     * Fire-and-forget POST. Rule 7 generalized: a Lumin outage must
+     * never affect the agent. The first failure logs once; subsequent
+     * failures are silenced.
+     */
+    async send(span) {
+        const body = JSON.stringify({ spans: [span] });
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const resp = await fetch(`${this.host}/v1/spans`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-Lumin-Project": this.project,
+                },
+                body,
+                signal: ctrl.signal,
+            });
+            if (!resp.ok && !this.failureLogged) {
+                // eslint-disable-next-line no-console
+                console.warn(`[lumin-diagnostics] Lumin returned ${resp.status} ${resp.statusText} — further failures suppressed`);
+                this.failureLogged = true;
+            }
+        }
+        catch (err) {
+            if (!this.failureLogged) {
+                // eslint-disable-next-line no-console
+                console.warn(`[lumin-diagnostics] Could not reach Lumin at ${this.host}/v1/spans (${err.message}). Further failures suppressed.`);
+                this.failureLogged = true;
+            }
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+const PENDING_TTL_MS = 5 * 60 * 1000;
+class PendingLlmRegistry {
+    byRunId = new Map();
+    cleanupHandle;
+    set(runId, entry) {
+        this.byRunId.set(runId, entry);
+        this.scheduleSweep();
+    }
+    take(runId) {
+        const v = this.byRunId.get(runId);
+        if (v)
+            this.byRunId.delete(runId);
+        return v;
+    }
+    size() {
+        return this.byRunId.size;
+    }
+    scheduleSweep() {
+        if (this.cleanupHandle)
+            return;
+        this.cleanupHandle = setTimeout(() => {
+            this.cleanupHandle = undefined;
+            const now = Date.now();
+            for (const [k, v] of this.byRunId) {
+                if (now - v.startedAtMs > PENDING_TTL_MS)
+                    this.byRunId.delete(k);
+            }
+            if (this.byRunId.size > 0)
+                this.scheduleSweep();
+        }, PENDING_TTL_MS);
+        // unref so a sweeper doesn't keep the gateway process alive
+        if (typeof this.cleanupHandle === "object" && this.cleanupHandle && "unref" in this.cleanupHandle) {
+            this.cleanupHandle.unref?.();
+        }
+    }
+}
+// ----- per-event translators ---------------------------------------------
+function buildSpanFromPair(runId, pending, output, cfg, hookCtx) {
+    const maxLen = cfg.maxContentChars ?? DEFAULT_MAX_CONTENT_CHARS;
+    const trace = hookCtx?.trace || pending.trace;
+    const traceId = asUuid(trace?.traceId, runId);
+    const spanId = asUuid(trace?.spanId, `${runId}:llm`);
+    const parentId = trace?.parentSpanId
+        ? asUuid(trace.parentSpanId, runId)
+        : undefined;
+    const usage = output.usage || {};
+    const outputText = output.assistantTexts && output.assistantTexts.length
+        ? output.assistantTexts.join("\n")
+        : (output.lastAssistant !== undefined ? safeJsonStringify(output.lastAssistant) : undefined);
+    // Reasoning models (gpt-oss, claude-extended-thinking, o-series) emit
+    // ``{type: "thinking", thinking: "..."}`` blocks under
+    // ``lastAssistant.content`` BEFORE the visible text. ``assistantTexts``
+    // strips those out — fine for the operator-facing output, but we
+    // lose the reasoning trace entirely. Pull thinking out separately
+    // and surface it as a metadata field so operators can see WHY the
+    // model answered the way it did. Defensive parse: lastAssistant is
+    // typed as unknown by the public hook contract, so we check before
+    // walking it.
+    const thinkingText = extractThinkingFromAssistant(output.lastAssistant);
+    return {
+        id: spanId,
+        trace_id: traceId,
+        parent_span_id: parentId,
+        name: "openclaw.llm",
+        type: "llm",
+        started_at: pending.startedAt,
+        ended_at: nowIso(),
+        status: "ok",
+        model: output.model,
+        provider: output.provider,
+        tokens_input: usage.input,
+        tokens_output: usage.output,
+        input: pending.input,
+        output: outputText ? stringify(outputText, maxLen) : undefined,
+        session_id: output.sessionId || hookCtx?.sessionId,
+        metadata: {
+            "openclaw.runId": runId,
+            "openclaw.harnessId": output.harnessId,
+            "openclaw.resolvedRef": output.resolvedRef,
+            "openclaw.images_count": pending.imagesCount,
+            // Lightweight summary of what was replayed to the model, so an
+            // operator can see "this turn carried N prior messages and an
+            // M-character system prompt" without dragging the actual
+            // payload into the trace's input field.
+            "openclaw.history_message_count": pending.historyMessageCount,
+            "openclaw.system_prompt_chars": pending.systemPromptChars,
+            // Reasoning trace for models that emit thinking blocks. Always
+            // captured (no opt-in) because the whole point of an
+            // observability tool is to show WHY the agent answered the way
+            // it did — silently dropping the reasoning would defeat the
+            // purpose. Field is absent (not empty) when the model didn't
+            // emit thinking, so dashboard rendering can branch on
+            // presence rather than length.
+            ...(thinkingText !== undefined
+                ? {
+                    "openclaw.content.thinking": stringify(thinkingText, maxLen),
+                    "openclaw.thinking_chars": thinkingText.length,
+                }
+                : {}),
+            ...(cfg.captureSystemPrompt && pending.systemPrompt
+                ? { "openclaw.content.system_prompt": stringify(pending.systemPrompt, maxLen) }
+                : {}),
+        },
+    };
+}
+// ----- plugin entry -------------------------------------------------------
+export default definePluginEntry({
+    id: "lumin-diagnostics",
+    name: "@lumin-io/openclaw-diagnostics",
+    description: "Streams full-fidelity OpenClaw runs (prompts, responses, tool I/O, tokens) to a local Lumin instance via /v1/spans.",
+    configSchema: {
+        type: "object",
+        properties: {
+            host: { type: "string" },
+            project: { type: "string" },
+            captureSystemPrompt: { type: "boolean" },
+            maxContentChars: { type: "number" },
+            timeoutMs: { type: "number" },
+        },
+    },
+    register: (api) => {
+        const apiAny = api;
+        const cfg = apiAny.pluginConfig || {};
+        const client = new LuminClient(cfg);
+        const pending = new PendingLlmRegistry();
+        const log = apiAny.logger;
+        if (typeof apiAny.on !== "function") {
+            // Older OpenClaw runtimes without typed-hook support won't
+            // expose `api.on`. Silently degrade: register nothing.
+            log?.warn?.("lumin-diagnostics: this OpenClaw build doesn't expose api.on for typed hooks; content capture disabled. Upgrade OpenClaw to >= 2026.5.x.");
+            return;
+        }
+        apiAny.on("llm_input", (rawEvent, rawCtx) => {
+            try {
+                const event = rawEvent;
+                const ctx = rawCtx;
+                const maxLen = cfg.maxContentChars ?? DEFAULT_MAX_CONTENT_CHARS;
+                // The input is JUST the user prompt for this turn. We
+                // deliberately do NOT pack history / systemPrompt into the
+                // input field: a Lumin trace represents one LLM call, not
+                // a conversation. Embedding the full chat history every
+                // turn (a) bloats every trace by 10x+ as conversations
+                // grow, (b) makes the dashboard view feel like a chat log
+                // instead of an agent run, and (c) is redundant with
+                // sessions, which group turns under the same conversation
+                // already.
+                //
+                // Counts and lightweight summaries go into metadata so
+                // operators can still see "this turn replayed 9 prior
+                // history messages" without the full payload.
+                const historyCount = Array.isArray(event.historyMessages)
+                    ? event.historyMessages.length
+                    : 0;
+                pending.set(event.runId, {
+                    startedAt: nowIso(),
+                    startedAtMs: Date.now(),
+                    systemPrompt: event.systemPrompt,
+                    systemPromptChars: typeof event.systemPrompt === "string"
+                        ? event.systemPrompt.length
+                        : 0,
+                    historyMessageCount: historyCount,
+                    input: stringify(event.prompt, maxLen),
+                    imagesCount: event.imagesCount,
+                    trace: ctx?.trace,
+                });
+            }
+            catch (err) {
+                log?.warn?.(`lumin-diagnostics: llm_input handler failed: ${err.message}`);
+            }
+        });
+        apiAny.on("llm_output", (rawEvent, rawCtx) => {
+            try {
+                const event = rawEvent;
+                const ctx = rawCtx;
+                const entry = pending.take(event.runId);
+                if (!entry) {
+                    // No matching llm_input. Either the input hook dropped
+                    // (e.g. raw model run path) or this is a fresh restart
+                    // catching the tail of an in-flight run. Emit anyway —
+                    // the operator still gets the assistant output.
+                    const fallback = {
+                        startedAt: nowIso(),
+                        startedAtMs: Date.now(),
+                        trace: ctx?.trace,
+                    };
+                    const span = buildSpanFromPair(event.runId, fallback, event, cfg, ctx);
+                    void client.send(span).catch(() => { });
+                    return;
+                }
+                const span = buildSpanFromPair(event.runId, entry, event, cfg, ctx);
+                void client.send(span).catch(() => { });
+            }
+            catch (err) {
+                log?.warn?.(`lumin-diagnostics: llm_output handler failed: ${err.message}`);
+            }
+        });
+        log?.info?.(`lumin-diagnostics: subscribed to llm_input + llm_output → ${cfg.host || process.env.LUMIN_HOST || DEFAULT_HOST}/v1/spans (project=${cfg.project || DEFAULT_PROJECT})`);
+    },
+});
+//# 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/openclaw.plugin.json

@@ -0,0 +1,32 @@
+{
+  "id": "lumin-diagnostics",
+  "activation": {
+    "onStartup": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "host": {
+        "type": "string",
+        "description": "Lumin API base URL. Defaults to LUMIN_HOST env or http://localhost:8000."
+      },
+      "project": {
+        "type": "string",
+        "description": "Lumin project label sent as X-Lumin-Project. Defaults to 'openclaw'."
+      },
+      "captureSystemPrompt": {
+        "type": "boolean",
+        "description": "Whether to capture the system prompt text on each model.call. Default false (system prompts are usually large and rarely actionable)."
+      },
+      "maxContentChars": {
+        "type": "number",
+        "description": "Cap on per-attribute content size in characters. Defaults to 32768. Truncated values are tagged '...(truncated)'."
+      },
+      "timeoutMs": {
+        "type": "number",
+        "description": "HTTP timeout for POST /v1/spans, milliseconds. Default 5000."
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@lumin-io/openclaw-diagnostics",
+  "version": "0.1.0",
+  "description": "Full-fidelity Lumin observability for OpenClaw — captures prompts, responses, tool I/O via OpenClaw's DiagnosticEvent bus (no privacy filter).",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.4.25"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.1.9"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "install": {
+      "npmSpec": "@lumin-io/openclaw-diagnostics",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.4.25"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.4"
+    }
+  }
+}