@vainplex/openclaw-cortex 0.3.0 → 0.4.0

package/dist/src/trace-analyzer/chain-reconstructor.js

@@ -0,0 +1,190 @@
+// ============================================================
+// Trace Analyzer — Chain Reconstructor
+// ============================================================
+//
+// Reconstructs conversation chains from a stream of NormalizedEvents.
+// Groups by (session, agent), splits on lifecycle boundaries and
+// inactivity gaps, deduplicates across Schema A/B events, and
+// uses a sliding window for memory management.
+// ============================================================
+import { createHash } from "node:crypto";
+const DEFAULT_OPTS = {
+    gapMinutes: 30,
+    maxEventsPerChain: 1000,
+};
+/** Phase 1: Bucket events by (session, agent). */
+async function bucketEvents(events) {
+    const buckets = new Map();
+    for await (const event of events) {
+        const key = `${event.session}::${event.agent}`;
+        let bucket = buckets.get(key);
+        if (!bucket) {
+            bucket = [];
+            buckets.set(key, bucket);
+        }
+        bucket.push(event);
+    }
+    return buckets;
+}
+/** Convert a segment of events into a ConversationChain. */
+function segmentToChain(segment) {
+    const first = segment[0];
+    const last = segment[segment.length - 1];
+    const typeCounts = {};
+    for (const e of segment) {
+        typeCounts[e.type] = (typeCounts[e.type] ?? 0) + 1;
+    }
+    return {
+        id: computeChainId(first.session, first.agent, first.ts),
+        agent: first.agent,
+        session: first.session,
+        startTs: first.ts,
+        endTs: last.ts,
+        events: segment,
+        typeCounts,
+        boundaryType: determineBoundaryType(segment),
+    };
+}
+/**
+ * Reconstruct conversation chains from a stream of normalized events.
+ *
+ * Two-pass algorithm:
+ * 1. Accumulate events into (session, agent) buckets
+ * 2. Split each bucket into chains by boundaries, deduplicate, emit
+ */
+export async function reconstructChains(events, opts) {
+    const config = { ...DEFAULT_OPTS, ...opts };
+    const buckets = await bucketEvents(events);
+    const chains = [];
+    for (const bucket of buckets.values()) {
+        bucket.sort((a, b) => a.ts - b.ts);
+        const deduped = deduplicateEvents(bucket);
+        const segments = splitOnBoundaries(deduped, config);
+        for (const segment of segments) {
+            if (segment.length >= 2)
+                chains.push(segmentToChain(segment));
+        }
+    }
+    return chains;
+}
+/**
+ * Determine if a chain boundary should be inserted between prev and curr.
+ * Checks lifecycle events and inactivity gaps.
+ */
+function isBoundary(prev, curr, gapMs) {
+    if (curr.type === "session.start")
+        return true;
+    if (prev.type === "session.end")
+        return true;
+    if (prev.type === "run.end" && curr.type === "run.start" && curr.ts - prev.ts > 5 * 60 * 1000)
+        return true;
+    if (curr.ts - prev.ts > gapMs)
+        return true;
+    return false;
+}
+/**
+ * Split a sorted, deduplicated event list into chain segments based on
+ * lifecycle boundaries, inactivity gaps, and memory caps.
+ */
+function splitOnBoundaries(events, opts) {
+    if (events.length === 0)
+        return [];
+    const gapMs = opts.gapMinutes * 60 * 1000;
+    const chains = [];
+    let current = [events[0]];
+    for (let i = 1; i < events.length; i++) {
+        if (isBoundary(events[i - 1], events[i], gapMs)) {
+            if (current.length > 0)
+                chains.push(current);
+            current = [events[i]];
+        }
+        else {
+            current.push(events[i]);
+            if (current.length >= opts.maxEventsPerChain) {
+                chains.push(current);
+                current = [];
+            }
+        }
+    }
+    if (current.length > 0)
+        chains.push(current);
+    return chains;
+}
+/**
+ * Deduplicate events within a sorted event list.
+ * When two events share the same fingerprint (same type, agent, time window,
+ * and content/params), keep the one with the higher sequence number.
+ */
+export function deduplicateEvents(events) {
+    const seen = new Map();
+    for (const event of events) {
+        const fp = eventFingerprint(event);
+        const existing = seen.get(fp);
+        if (!existing) {
+            seen.set(fp, event);
+        }
+        else {
+            // Keep the event with the higher sequence number (prefer Schema A)
+            if (event.seq > existing.seq) {
+                seen.set(fp, event);
+            }
+        }
+    }
+    // Return in timestamp order
+    return [...seen.values()].sort((a, b) => a.ts - b.ts);
+}
+/**
+ * Compute a fingerprint for deduplication.
+ * Uses a 1-second time window to match events from both schemas
+ * that represent the same underlying action.
+ */
+export function eventFingerprint(event) {
+    const tsWindow = Math.floor(event.ts / 1000); // 1-second window
+    switch (event.type) {
+        case "msg.in":
+        case "msg.out": {
+            const contentHash = simpleHash(event.payload.content ?? "");
+            return `${event.type}:${event.agent}:${tsWindow}:${contentHash}`;
+        }
+        case "tool.call": {
+            const paramsHash = simpleHash(JSON.stringify(event.payload.toolParams ?? {}));
+            return `${event.type}:${event.agent}:${event.payload.toolName ?? ""}:${tsWindow}:${paramsHash}`;
+        }
+        case "tool.result": {
+            const toolName = event.payload.toolName ?? "";
+            return `tool.result:${event.agent}:${toolName}:${tsWindow}`;
+        }
+        default:
+            // Session/run lifecycle events — use exact type + timestamp
+            return `${event.type}:${event.agent}:${event.ts}`;
+    }
+}
+/** Fast non-crypto hash for dedup fingerprinting. */
+export function simpleHash(str) {
+    let hash = 5381;
+    for (let i = 0; i < Math.min(str.length, 200); i++) {
+        hash = ((hash << 5) + hash + str.charCodeAt(i)) | 0;
+    }
+    return hash >>> 0;
+}
+/** Compute a deterministic chain ID. */
+export function computeChainId(session, agent, firstTs) {
+    const input = `${session}:${agent}:${firstTs}`;
+    return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+/** Determine the boundary type of a chain segment based on its events. */
+function determineBoundaryType(events) {
+    if (events.length === 0)
+        return "gap";
+    const first = events[0];
+    const last = events[events.length - 1];
+    // If the chain starts with a lifecycle event, it's lifecycle-bounded
+    if (first.type === "session.start" ||
+        first.type === "run.start" ||
+        last.type === "session.end" ||
+        last.type === "run.end") {
+        return "lifecycle";
+    }
+    return "gap";
+}
+//# sourceMappingURL=chain-reconstructor.js.map

package/dist/src/trace-analyzer/chain-reconstructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-reconstructor.js","sourceRoot":"","sources":["../../../src/trace-analyzer/chain-reconstructor.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uCAAuC;AACvC,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,iEAAiE;AACjE,8DAA8D;AAC9D,+CAA+C;AAC/C,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA+BzC,MAAM,YAAY,GAA2B;IAC3C,UAAU,EAAE,EAAE;IACd,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEF,kDAAkD;AAClD,KAAK,UAAU,YAAY,CACzB,MAAsC;IAEtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/C,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;YAAC,MAAM,GAAG,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4DAA4D;AAC5D,SAAS,cAAc,CAAC,OAA0B;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,UAAU,GAA+C,EAAE,CAAC;IAClE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,OAAO;QACL,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QACxD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,KAAK,EAAE,IAAI,CAAC,EAAE;QACd,MAAM,EAAE,OAAO;QACf,UAAU;QACV,YAAY,EAAE,qBAAqB,CAAC,OAAO,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAsC,EACtC,IAAsC;IAEtC,MAAM,MAAM,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACpD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CACjB,IAAqB,EACrB,IAAqB,EACrB,KAAa;IAEb,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3G,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,KAAK;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CACxB,MAAyB,EACzB,IAA4B;IAE5B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,IAAI,OAAO,GAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;YAChD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE9B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,IAAI,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;gBAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,kBAAkB;IAEhE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC5D,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;QACnE,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9E,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClG,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC9C,OAAO,eAAe,KAAK,CAAC,KAAK,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAC9D,CAAC;QACD;YACE,4DAA4D;YAC5D,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,KAAa,EAAE,OAAe;IAC5E,MAAM,KAAK,GAAG,GAAG,OAAO,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,0EAA0E;AAC1E,SAAS,qBAAqB,CAAC,MAAyB;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEvC,qEAAqE;IACrE,IACE,KAAK,CAAC,IAAI,KAAK,eAAe;QAC9B,KAAK,CAAC,IAAI,KAAK,WAAW;QAC1B,IAAI,CAAC,IAAI,KAAK,aAAa;QAC3B,IAAI,CAAC,IAAI,KAAK,SAAS,EACvB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/trace-analyzer/classifier.d.ts

@@ -0,0 +1,28 @@
+import type { PluginLogger } from "../types.js";
+import type { LlmConfig } from "../llm-enhance.js";
+import type { TraceAnalyzerConfig } from "./config.js";
+import type { ConversationChain } from "./chain-reconstructor.js";
+import type { Finding } from "./signals/types.js";
+type ResolvedLlmConfig = {
+    enabled: boolean;
+    endpoint: string;
+    model: string;
+    apiKey: string;
+    timeoutMs: number;
+};
+/**
+ * Merge analyzer-specific LLM overrides with top-level config.
+ * Per-field merge, not full replace (R-031).
+ */
+export declare function resolveAnalyzerLlmConfig(topLevel: LlmConfig, override: TraceAnalyzerConfig["llm"]): ResolvedLlmConfig;
+export declare function formatChainAsTranscript(chain: ConversationChain): string;
+/**
+ * Classify findings using LLM analysis (Stage 2).
+ *
+ * If LLM is disabled, returns findings unchanged (classification=null).
+ * If triage model configured, filters false positives first.
+ * Graceful degradation: invalid JSON → classification=null, timeout → skip.
+ */
+export declare function classifyFindings(findings: Finding[], chains: Map<string, ConversationChain>, config: TraceAnalyzerConfig, topLevelLlm: LlmConfig, logger: PluginLogger): Promise<Finding[]>;
+export {};
+//# sourceMappingURL=classifier.d.ts.map

package/dist/src/trace-analyzer/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/trace-analyzer/classifier.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAyB,MAAM,oBAAoB,CAAC;AAMzE,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,GACnC,iBAAiB,CAWnB;AAoCD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAmCxE;AAoMD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACtC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,OAAO,EAAE,CAAC,CAgCpB"}

package/dist/src/trace-analyzer/classifier.js

@@ -0,0 +1,271 @@
+// ============================================================
+// Trace Analyzer — LLM Classifier (Stage 2)
+// ============================================================
+//
+// Takes Finding[] from signal detection, optionally triages them
+// with a fast/local model, then classifies remaining findings
+// with a capable analysis model. Implements R-015, R-017, R-018,
+// R-031, R-046, R-047.
+// ============================================================
+import { redactChain } from "./redactor.js";
+import { truncate } from "./util.js";
+/**
+ * Merge analyzer-specific LLM overrides with top-level config.
+ * Per-field merge, not full replace (R-031).
+ */
+export function resolveAnalyzerLlmConfig(topLevel, override) {
+    if (!override.enabled) {
+        return { enabled: false, endpoint: "", model: "", apiKey: "", timeoutMs: 15000 };
+    }
+    return {
+        enabled: true,
+        endpoint: override.endpoint ?? topLevel.endpoint,
+        model: override.model ?? topLevel.model,
+        apiKey: override.apiKey ?? topLevel.apiKey,
+        timeoutMs: override.timeoutMs ?? topLevel.timeoutMs,
+    };
+}
+// ---- Prompts ----
+const TRIAGE_SYSTEM_PROMPT = `You are a signal triage system. Given a failure detection summary, decide:
+1. Is this a TRUE positive (real failure) or FALSE positive (benign/expected behavior)?
+2. If true positive, what severity? (low/medium/high/critical)
+
+Respond ONLY with JSON: {"keep": true|false, "severity": "low|medium|high|critical", "reason": "one sentence"}
+
+Common false positives to watch for:
+- User saying "nein" to a question (not a correction)
+- Tool errors that the agent intentionally provoked for testing
+- Session endings due to timeout, not dissatisfaction
+- Tool calls to check status (no claim made, just checking)`;
+const DEEP_ANALYSIS_SYSTEM_PROMPT = `You are analyzing an agent failure trace. Given the full conversation chain and failure signal, produce:
+
+1. **rootCause**: Why did the failure happen? Be specific.
+2. **actionType**: What kind of fix prevents recurrence?
+   - "soul_rule": A behavioral directive for the agent's system prompt
+   - "governance_policy": A machine-enforced policy rule
+   - "cortex_pattern": A regex pattern for real-time detection
+   - "manual_review": Requires human judgment
+3. **actionText**: The specific rule/policy/pattern text. Be concrete.
+   - For soul_rule: "NIEMALS X — stattdessen Y. [Grund: Z]" or "NEVER X — instead Y. [Reason: Z]"
+   - For governance_policy: The condition and effect as a sentence.
+   - For cortex_pattern: A regex string.
+   - For manual_review: Describe what to investigate.
+4. **confidence**: How confident are you (0.0–1.0)?
+
+Respond ONLY with valid JSON:
+{"rootCause": "...", "actionType": "soul_rule|governance_policy|cortex_pattern|manual_review", "actionText": "...", "confidence": 0.85}`;
+// ---- Chain-to-Transcript Formatter ----
+export function formatChainAsTranscript(chain) {
+    const lines = [];
+    for (const event of chain.events) {
+        const ts = new Date(event.ts).toISOString();
+        switch (event.type) {
+            case "msg.in":
+                lines.push(`[${ts}] USER: ${truncate(event.payload.content ?? "", 500)}`);
+                break;
+            case "msg.out":
+                lines.push(`[${ts}] AGENT: ${truncate(event.payload.content ?? "", 500)}`);
+                break;
+            case "tool.call":
+                lines.push(`[${ts}] TOOL_CALL: ${event.payload.toolName ?? "unknown"}(${truncate(JSON.stringify(event.payload.toolParams ?? {}), 300)})`);
+                break;
+            case "tool.result":
+                if (event.payload.toolError) {
+                    lines.push(`[${ts}] TOOL_ERROR: ${event.payload.toolName ?? "unknown"} → ${truncate(String(event.payload.toolError), 300)}`);
+                }
+                else {
+                    const resultStr = typeof event.payload.toolResult === "object"
+                        ? JSON.stringify(event.payload.toolResult)
+                        : String(event.payload.toolResult ?? "");
+                    lines.push(`[${ts}] TOOL_OK: ${event.payload.toolName ?? "unknown"} → ${truncate(resultStr, 300)}`);
+                }
+                break;
+            case "session.start":
+                lines.push(`[${ts}] SESSION_START`);
+                break;
+            case "session.end":
+                lines.push(`[${ts}] SESSION_END`);
+                break;
+            default:
+                lines.push(`[${ts}] ${event.type.toUpperCase()}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ---- HTTP Call (uses node built-in fetch — Node 22) ----
+/** Resolve config fields that may come from ResolvedLlmConfig or TriageLlmConfig. */
+function resolveLlmCallConfig(config) {
+    return {
+        endpoint: "endpoint" in config ? config.endpoint : "",
+        model: "model" in config ? config.model : "",
+        apiKey: "apiKey" in config && config.apiKey ? config.apiKey : "",
+        timeoutMs: "timeoutMs" in config && config.timeoutMs ? config.timeoutMs : 15000,
+    };
+}
+/** Extract the assistant message content from an OpenAI-compatible response. */
+function parseLlmResponse(data) {
+    const choices = data.choices;
+    return choices?.[0]?.message?.content ?? null;
+}
+async function callLlmChat(config, messages, logger) {
+    const { endpoint, model, apiKey, timeoutMs } = resolveLlmCallConfig(config);
+    if (!endpoint || !model)
+        return null;
+    const url = `${endpoint}/chat/completions`;
+    const body = JSON.stringify({
+        model, messages, temperature: 0.1,
+        max_tokens: 1000, response_format: { type: "json_object" },
+    });
+    const headers = { "Content-Type": "application/json" };
+    if (apiKey)
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const response = await fetch(url, { method: "POST", headers, body, signal: controller.signal });
+        clearTimeout(timer);
+        if (!response.ok) {
+            logger.warn(`[trace-analyzer] LLM HTTP ${response.status}: ${response.statusText}`);
+            return null;
+        }
+        return parseLlmResponse(await response.json());
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+            logger.warn(`[trace-analyzer] LLM request timed out (${timeoutMs}ms)`);
+        }
+        else {
+            logger.warn(`[trace-analyzer] LLM request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return null;
+    }
+}
+// ---- Response Parsing (Graceful Degradation) ----
+const VALID_ACTION_TYPES = ["soul_rule", "governance_policy", "cortex_pattern", "manual_review"];
+function parseClassification(raw, model, logger) {
+    if (!raw)
+        return null;
+    try {
+        // Try to extract JSON from response (may have markdown fences)
+        let jsonStr = raw.trim();
+        const fenceMatch = jsonStr.match(/```(?:json)?\s*([\s\S]*?)```/);
+        if (fenceMatch) {
+            jsonStr = fenceMatch[1].trim();
+        }
+        const parsed = JSON.parse(jsonStr);
+        if (typeof parsed.rootCause !== "string" || typeof parsed.actionText !== "string") {
+            logger.warn("[trace-analyzer] LLM response missing required fields");
+            return null;
+        }
+        let actionType = String(parsed.actionType ?? "manual_review");
+        if (!VALID_ACTION_TYPES.includes(actionType)) {
+            logger.warn(`[trace-analyzer] LLM returned unknown actionType: ${actionType}`);
+            actionType = "manual_review";
+        }
+        return {
+            rootCause: parsed.rootCause,
+            actionType: actionType,
+            actionText: parsed.actionText,
+            confidence: typeof parsed.confidence === "number" ? parsed.confidence : 0.5,
+            model,
+        };
+    }
+    catch {
+        logger.warn("[trace-analyzer] Failed to parse LLM classification response as JSON");
+        return null;
+    }
+}
+function parseTriageResponse(raw, logger) {
+    if (!raw)
+        return null;
+    try {
+        let jsonStr = raw.trim();
+        const fenceMatch = jsonStr.match(/```(?:json)?\s*([\s\S]*?)```/);
+        if (fenceMatch) {
+            jsonStr = fenceMatch[1].trim();
+        }
+        const parsed = JSON.parse(jsonStr);
+        if (typeof parsed.keep !== "boolean")
+            return null;
+        return {
+            keep: parsed.keep,
+            severity: typeof parsed.severity === "string" ? parsed.severity : undefined,
+        };
+    }
+    catch {
+        logger.warn("[trace-analyzer] Failed to parse triage response");
+        return null;
+    }
+}
+async function triageFinding(finding, triageConfig, logger) {
+    const userPrompt = `Signal: ${finding.signal.signal}
+Detected severity: ${finding.signal.severity}
+Summary: ${finding.signal.summary}
+Agent: ${finding.agent}
+Evidence: ${JSON.stringify(finding.signal.evidence, null, 2)}`;
+    const raw = await callLlmChat(triageConfig, [
+        { role: "system", content: TRIAGE_SYSTEM_PROMPT },
+        { role: "user", content: userPrompt },
+    ], logger);
+    const result = parseTriageResponse(raw, logger);
+    if (!result)
+        return true; // On failure, keep the finding (conservative)
+    return result.keep;
+}
+// ---- Deep Analysis ----
+async function deepAnalyze(finding, chain, config, logger) {
+    const transcript = formatChainAsTranscript(chain);
+    const userPrompt = `## Failure Signal
+Type: ${finding.signal.signal}
+Severity: ${finding.signal.severity}
+Summary: ${finding.signal.summary}
+
+## Evidence
+${JSON.stringify(finding.signal.evidence, null, 2)}
+
+## Full Conversation Chain (${chain.events.length} events, ${chain.agent}@${chain.session})
+${transcript}`;
+    const raw = await callLlmChat(config, [
+        { role: "system", content: DEEP_ANALYSIS_SYSTEM_PROMPT },
+        { role: "user", content: userPrompt },
+    ], logger);
+    return parseClassification(raw, config.model, logger);
+}
+// ---- Main Classification Pipeline ----
+/**
+ * Classify findings using LLM analysis (Stage 2).
+ *
+ * If LLM is disabled, returns findings unchanged (classification=null).
+ * If triage model configured, filters false positives first.
+ * Graceful degradation: invalid JSON → classification=null, timeout → skip.
+ */
+export async function classifyFindings(findings, chains, config, topLevelLlm, logger) {
+    const llmConfig = resolveAnalyzerLlmConfig(topLevelLlm, config.llm);
+    if (!llmConfig.enabled)
+        return findings;
+    const result = [];
+    for (const finding of findings) {
+        // Step 1: Triage (optional)
+        if (config.llm.triage) {
+            const keep = await triageFinding(finding, config.llm.triage, logger);
+            if (!keep) {
+                logger.debug(`[trace-analyzer] Triage filtered finding ${finding.id}`);
+                continue;
+            }
+        }
+        // Step 2: Deep analysis
+        const chain = chains.get(finding.chainId);
+        if (!chain) {
+            result.push(finding); // No chain context — skip classification
+            continue;
+        }
+        const redactedChain = redactChain(chain, config.redactPatterns);
+        const classification = await deepAnalyze(finding, redactedChain, llmConfig, logger);
+        result.push({
+            ...finding,
+            classification,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=classifier.js.map

package/dist/src/trace-analyzer/classifier.js.map

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

package/dist/src/trace-analyzer/config.d.ts

@@ -0,0 +1,78 @@
+/** Signal identifiers for the failure signal taxonomy. */
+export type SignalId = "SIG-CORRECTION" | "SIG-TOOL-FAIL" | "SIG-DOOM-LOOP" | "SIG-DISSATISFIED" | "SIG-REPEAT-FAIL" | "SIG-HALLUCINATION" | "SIG-UNVERIFIED-CLAIM";
+/** Severity levels for failure signals. */
+export type Severity = "low" | "medium" | "high" | "critical";
+/** Triage LLM configuration (fast/local model for filtering). */
+export type TriageLlmConfig = {
+    endpoint: string;
+    model: string;
+    apiKey?: string;
+    timeoutMs?: number;
+};
+/** Trace analyzer configuration. */
+export type TraceAnalyzerConfig = {
+    /** Master switch. Default: false. */
+    enabled: boolean;
+    /** NATS connection for the trace source. */
+    nats: {
+        /** NATS server URL (e.g., "nats://localhost:4222"). */
+        url: string;
+        /** JetStream stream name (e.g., "openclaw-events"). */
+        stream: string;
+        /** NATS subject prefix (e.g., "openclaw.events"). */
+        subjectPrefix: string;
+        /** Optional credentials file path. */
+        credentials?: string;
+        /** Optional user. */
+        user?: string;
+        /** Optional password. */
+        password?: string;
+    };
+    /** Scheduled analysis runs. */
+    schedule: {
+        /** Enable scheduled runs. Default: false. */
+        enabled: boolean;
+        /** Hours between runs. Default: 24. */
+        intervalHours: number;
+    };
+    /** Inactivity gap in minutes for chain boundary detection. Default: 30. */
+    chainGapMinutes: number;
+    /** Per-signal toggles and severity overrides. */
+    signals: Partial<Record<SignalId, {
+        enabled: boolean;
+        severity?: Severity;
+    }>>;
+    /** LLM config overrides for trace analysis. */
+    llm: {
+        enabled: boolean;
+        endpoint?: string;
+        model?: string;
+        apiKey?: string;
+        timeoutMs?: number;
+        /** Optional triage model (fast, local). */
+        triage?: TriageLlmConfig;
+    };
+    /** Output configuration. */
+    output: {
+        /** Maximum findings in a single report. Default: 200. */
+        maxFindings: number;
+        /** Custom report output path. */
+        reportPath?: string;
+    };
+    /** Redaction patterns (regex strings) applied before LLM/disk writes. */
+    redactPatterns: string[];
+    /** Context window size for incremental processing. Default: 500. */
+    incrementalContextWindow: number;
+    /** NATS consumer batch size for fetching events. Default: 500. */
+    fetchBatchSize: number;
+    /** Maximum events to process per run. Default: 100000. */
+    maxEventsPerRun: number;
+};
+/** Default trace analyzer configuration. */
+export declare const TRACE_ANALYZER_DEFAULTS: TraceAnalyzerConfig;
+/**
+ * Resolve a raw config object into a fully-typed TraceAnalyzerConfig.
+ * Missing values are filled from TRACE_ANALYZER_DEFAULTS.
+ */
+export declare function resolveTraceAnalyzerConfig(raw?: Record<string, unknown>): TraceAnalyzerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/trace-analyzer/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/trace-analyzer/config.ts"],"names":[],"mappings":"AAQA,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,CAAC;AAE3B,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9D,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,mBAAmB,GAAG;IAChC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IAEjB,4CAA4C;IAC5C,IAAI,EAAE;QACJ,uDAAuD;QACvD,GAAG,EAAE,MAAM,CAAC;QACZ,uDAAuD;QACvD,MAAM,EAAE,MAAM,CAAC;QACf,qDAAqD;QACrD,aAAa,EAAE,MAAM,CAAC;QACtB,sCAAsC;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,qBAAqB;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,yBAAyB;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,+BAA+B;IAC/B,QAAQ,EAAE;QACR,6CAA6C;QAC7C,OAAO,EAAE,OAAO,CAAC;QACjB,uCAAuC;QACvC,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;IAExB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,CAAC;IAE9E,+CAA+C;IAC/C,GAAG,EAAE;QACH,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,2CAA2C;QAC3C,MAAM,CAAC,EAAE,eAAe,CAAC;KAC1B,CAAC;IAEF,4BAA4B;IAC5B,MAAM,EAAE;QACN,yDAAyD;QACzD,WAAW,EAAE,MAAM,CAAC;QACpB,iCAAiC;QACjC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,yEAAyE;IACzE,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,oEAAoE;IACpE,wBAAwB,EAAE,MAAM,CAAC;IAEjC,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IAEvB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,EAAE,mBA+BrC,CAAC;AA4GF;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,mBAAmB,CA4BrB"}