@vainplex/openclaw-cortex 0.3.1 → 0.4.1

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

@@ -0,0 +1,161 @@
+// ============================================================
+// Trace Analyzer — Configuration
+// ============================================================
+//
+// TraceAnalyzerConfig type, defaults, and resolver.
+// Follows the same pattern as the existing src/config.ts.
+// ============================================================
+/** Default trace analyzer configuration. */
+export const TRACE_ANALYZER_DEFAULTS = {
+    enabled: false,
+    nats: {
+        url: "nats://localhost:4222",
+        stream: "openclaw-events",
+        subjectPrefix: "openclaw.events",
+    },
+    schedule: {
+        enabled: false,
+        intervalHours: 24,
+    },
+    chainGapMinutes: 30,
+    signals: {
+        "SIG-CORRECTION": { enabled: true },
+        "SIG-TOOL-FAIL": { enabled: true },
+        "SIG-DOOM-LOOP": { enabled: true },
+        "SIG-DISSATISFIED": { enabled: true },
+        "SIG-REPEAT-FAIL": { enabled: true },
+        "SIG-HALLUCINATION": { enabled: true },
+        "SIG-UNVERIFIED-CLAIM": { enabled: false },
+    },
+    llm: {
+        enabled: false,
+    },
+    output: {
+        maxFindings: 200,
+    },
+    redactPatterns: [],
+    incrementalContextWindow: 500,
+    fetchBatchSize: 500,
+    maxEventsPerRun: 100_000,
+};
+// ---- Typed extractors (same pattern as src/config.ts) ----
+function bool(v, d) {
+    return typeof v === "boolean" ? v : d;
+}
+function int(v, d) {
+    return typeof v === "number" && Number.isFinite(v) ? Math.round(v) : d;
+}
+function str(v, d) {
+    return typeof v === "string" ? v : d;
+}
+function optStr(v) {
+    return typeof v === "string" ? v : undefined;
+}
+function optInt(v) {
+    return typeof v === "number" && Number.isFinite(v) ? Math.round(v) : undefined;
+}
+function strArr(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    return v.filter((s) => typeof s === "string");
+}
+const VALID_SIGNAL_IDS = [
+    "SIG-CORRECTION",
+    "SIG-TOOL-FAIL",
+    "SIG-DOOM-LOOP",
+    "SIG-DISSATISFIED",
+    "SIG-REPEAT-FAIL",
+    "SIG-HALLUCINATION",
+    "SIG-UNVERIFIED-CLAIM",
+];
+const VALID_SEVERITIES = ["low", "medium", "high", "critical"];
+function isValidSignalId(v) {
+    return VALID_SIGNAL_IDS.includes(v);
+}
+function isValidSeverity(v) {
+    return typeof v === "string" && VALID_SEVERITIES.includes(v);
+}
+function resolveSignalConfig(raw) {
+    const result = {};
+    // Start with defaults
+    for (const [id, config] of Object.entries(TRACE_ANALYZER_DEFAULTS.signals)) {
+        if (config) {
+            result[id] = { ...config };
+        }
+    }
+    // Apply overrides
+    for (const [key, value] of Object.entries(raw)) {
+        if (!isValidSignalId(key))
+            continue;
+        if (typeof value !== "object" || value === null)
+            continue;
+        const sig = value;
+        const existing = result[key] ?? { enabled: true };
+        result[key] = {
+            enabled: bool(sig.enabled, existing.enabled),
+            severity: isValidSeverity(sig.severity) ? sig.severity : existing.severity,
+        };
+    }
+    return result;
+}
+/** Resolve NATS sub-config from raw input. */
+function resolveNatsConfig(natsRaw) {
+    return {
+        url: str(natsRaw.url, TRACE_ANALYZER_DEFAULTS.nats.url),
+        stream: str(natsRaw.stream, TRACE_ANALYZER_DEFAULTS.nats.stream),
+        subjectPrefix: str(natsRaw.subjectPrefix, TRACE_ANALYZER_DEFAULTS.nats.subjectPrefix),
+        credentials: optStr(natsRaw.credentials),
+        user: optStr(natsRaw.user),
+        password: optStr(natsRaw.password),
+    };
+}
+/** Resolve LLM sub-config from raw input. */
+function resolveLlmConfig(llmRaw) {
+    const triageRaw = (llmRaw.triage ?? undefined);
+    return {
+        enabled: bool(llmRaw.enabled, TRACE_ANALYZER_DEFAULTS.llm.enabled),
+        endpoint: optStr(llmRaw.endpoint),
+        model: optStr(llmRaw.model),
+        apiKey: optStr(llmRaw.apiKey),
+        timeoutMs: optInt(llmRaw.timeoutMs),
+        triage: triageRaw ? {
+            endpoint: str(triageRaw.endpoint, ""),
+            model: str(triageRaw.model, ""),
+            apiKey: optStr(triageRaw.apiKey),
+            timeoutMs: optInt(triageRaw.timeoutMs),
+        } : undefined,
+    };
+}
+/**
+ * Resolve a raw config object into a fully-typed TraceAnalyzerConfig.
+ * Missing values are filled from TRACE_ANALYZER_DEFAULTS.
+ */
+export function resolveTraceAnalyzerConfig(raw) {
+    if (!raw)
+        return { ...TRACE_ANALYZER_DEFAULTS };
+    const natsRaw = (raw.nats ?? {});
+    const schedRaw = (raw.schedule ?? {});
+    const llmRaw = (raw.llm ?? {});
+    const outRaw = (raw.output ?? {});
+    const signalsRaw = (raw.signals ?? {});
+    return {
+        enabled: bool(raw.enabled, TRACE_ANALYZER_DEFAULTS.enabled),
+        nats: resolveNatsConfig(natsRaw),
+        schedule: {
+            enabled: bool(schedRaw.enabled, TRACE_ANALYZER_DEFAULTS.schedule.enabled),
+            intervalHours: int(schedRaw.intervalHours, TRACE_ANALYZER_DEFAULTS.schedule.intervalHours),
+        },
+        chainGapMinutes: int(raw.chainGapMinutes, TRACE_ANALYZER_DEFAULTS.chainGapMinutes),
+        signals: resolveSignalConfig(signalsRaw),
+        llm: resolveLlmConfig(llmRaw),
+        output: {
+            maxFindings: int(outRaw.maxFindings, TRACE_ANALYZER_DEFAULTS.output.maxFindings),
+            reportPath: optStr(outRaw.reportPath),
+        },
+        redactPatterns: strArr(raw.redactPatterns) ?? [],
+        incrementalContextWindow: int(raw.incrementalContextWindow, TRACE_ANALYZER_DEFAULTS.incrementalContextWindow),
+        fetchBatchSize: int(raw.fetchBatchSize, TRACE_ANALYZER_DEFAULTS.fetchBatchSize),
+        maxEventsPerRun: int(raw.maxEventsPerRun, TRACE_ANALYZER_DEFAULTS.maxEventsPerRun),
+    };
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,70 @@
+/** Canonical event types understood by the analyzer. */
+export type AnalyzerEventType = "msg.in" | "msg.out" | "tool.call" | "tool.result" | "session.start" | "session.end" | "run.start" | "run.end" | "run.error";
+/**
+ * Normalized event — all source schemas are converted to this shape
+ * before entering the analysis pipeline.
+ */
+export type NormalizedEvent = {
+    /** Original event ID. */
+    id: string;
+    /** Timestamp in ms since epoch (extracted from `ts` or `timestamp`). */
+    ts: number;
+    /** Agent ID (e.g., "main", "forge", "viola"). */
+    agent: string;
+    /** Session identifier (normalized — "agent:main:uuid" → "uuid"). */
+    session: string;
+    /** Canonical event type. */
+    type: AnalyzerEventType;
+    /** Normalized payload. */
+    payload: NormalizedPayload;
+    /** NATS stream sequence number (for incremental tracking). */
+    seq: number;
+};
+/**
+ * Unified payload — consistent field names regardless of source schema.
+ * Detectors access ONLY these fields, never raw payloads.
+ */
+export type NormalizedPayload = {
+    content?: string;
+    role?: "user" | "assistant";
+    from?: string;
+    to?: string;
+    channel?: string;
+    success?: boolean;
+    toolName?: string;
+    toolParams?: Record<string, unknown>;
+    toolResult?: unknown;
+    toolError?: string;
+    toolDurationMs?: number;
+    toolIsError?: boolean;
+    sessionId?: string;
+    prompt?: string;
+    durationMs?: number;
+    error?: string;
+};
+/** Map a raw event type string to a canonical AnalyzerEventType. */
+export declare function mapEventType(raw: string): AnalyzerEventType | null;
+/**
+ * Detect which schema a raw event belongs to.
+ * - "A" = nats-eventstore (has `ts` as number, standard types)
+ * - "B" = session-sync (has `timestamp`, `conversation.*` types, `meta.source`)
+ * - null = unknown/unparseable
+ */
+export declare function detectSchema(raw: Record<string, unknown>): "A" | "B" | null;
+/**
+ * Normalize a session string.
+ * Schema B uses "agent:main:uuid" format → extract the UUID portion.
+ * Schema A uses direct session keys ("main", "unknown", etc.).
+ */
+export declare function normalizeSession(raw: string): string;
+/**
+ * Normalize a raw payload into the unified NormalizedPayload shape.
+ * Handles both Schema A and Schema B payload structures.
+ */
+export declare function normalizePayload(type: AnalyzerEventType, rawPayload: Record<string, unknown>, rawType: string): NormalizedPayload;
+/**
+ * Normalize a raw event object (from any schema) into a NormalizedEvent.
+ * Returns null if the event cannot be normalized (unknown type, missing timestamp).
+ */
+export declare function normalizeEvent(raw: Record<string, unknown>, seq: number): NormalizedEvent | null;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/trace-analyzer/events.ts"],"names":[],"mappings":"AAUA,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,aAAa,GACb,eAAe,GACf,aAAa,GACb,WAAW,GACX,SAAS,GACT,WAAW,CAAC;AAEhB;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAE9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAwBF,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAuB3E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMpD;AAqHD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,MAAM,GACd,iBAAiB,CAoBnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA6BhG"}

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

@@ -0,0 +1,228 @@
+// ============================================================
+// Trace Analyzer — Normalized Event Types
+// ============================================================
+//
+// LOCAL event types for the trace analyzer.
+// These are NOT imported from nats-eventstore — the analyzer
+// normalizes both Schema A (nats-eventstore) and Schema B
+// (session-sync) events into this unified shape.
+// ============================================================
+/**
+ * Map from raw event type strings (both schemas) to canonical types.
+ * Returns null for unknown/unhandled event types.
+ */
+const EVENT_TYPE_MAP = {
+    // Schema A (nats-eventstore hook events)
+    "msg.in": "msg.in",
+    "msg.out": "msg.out",
+    "tool.call": "tool.call",
+    "tool.result": "tool.result",
+    "session.start": "session.start",
+    "session.end": "session.end",
+    "run.start": "run.start",
+    "run.end": "run.end",
+    "run.error": "run.error",
+    // Schema B (session-sync conversation events)
+    "conversation.message.in": "msg.in",
+    "conversation.message.out": "msg.out",
+    "conversation.tool_call": "tool.call",
+    "conversation.tool_result": "tool.result",
+};
+/** Map a raw event type string to a canonical AnalyzerEventType. */
+export function mapEventType(raw) {
+    return EVENT_TYPE_MAP[raw] ?? null;
+}
+/**
+ * Detect which schema a raw event belongs to.
+ * - "A" = nats-eventstore (has `ts` as number, standard types)
+ * - "B" = session-sync (has `timestamp`, `conversation.*` types, `meta.source`)
+ * - null = unknown/unparseable
+ */
+export function detectSchema(raw) {
+    if (typeof raw.type !== "string")
+        return null;
+    const rawType = raw.type;
+    // Schema B: conversation.* types OR meta.source === "session-sync"
+    if (rawType.startsWith("conversation."))
+        return "B";
+    const meta = raw.meta;
+    if (meta && typeof meta === "object" && meta.source === "session-sync") {
+        return "B";
+    }
+    // Schema A: has `ts` as number and standard event types
+    if (typeof raw.ts === "number" && EVENT_TYPE_MAP[rawType])
+        return "A";
+    // Schema B also uses `timestamp` instead of `ts`
+    if (typeof raw.timestamp === "number")
+        return "B";
+    // Fallback: if type is a known canonical type, assume A
+    if (EVENT_TYPE_MAP[rawType])
+        return "A";
+    return null;
+}
+/**
+ * Normalize a session string.
+ * Schema B uses "agent:main:uuid" format → extract the UUID portion.
+ * Schema A uses direct session keys ("main", "unknown", etc.).
+ */
+export function normalizeSession(raw) {
+    if (raw.startsWith("agent:")) {
+        const parts = raw.split(":");
+        return parts[2] ?? parts[1] ?? raw;
+    }
+    return raw;
+}
+/** Extract optional string field. */
+function optStr(raw, key) {
+    return typeof raw[key] === "string" ? raw[key] : undefined;
+}
+/** Normalize msg.in/msg.out payload — Schema B (conversation.*). */
+function normalizeMessagePayloadB(rawPayload, role) {
+    const textPreview = rawPayload.text_preview;
+    let content;
+    if (Array.isArray(textPreview) && textPreview.length > 0) {
+        const first = textPreview[0];
+        if (first && typeof first.text === "string")
+            content = first.text;
+    }
+    return { content, role, sessionId: optStr(rawPayload, "sessionId") };
+}
+/** Normalize msg.in/msg.out payload — Schema A. */
+function normalizeMessagePayloadA(rawPayload, role) {
+    return {
+        content: optStr(rawPayload, "content"),
+        role,
+        from: optStr(rawPayload, "from"),
+        to: optStr(rawPayload, "to"),
+        channel: optStr(rawPayload, "channel"),
+        success: typeof rawPayload.success === "boolean" ? rawPayload.success : undefined,
+    };
+}
+/** Normalize tool.call payload. */
+function normalizeToolCallPayload(rawPayload, isSchemaB) {
+    if (isSchemaB) {
+        const data = rawPayload.data;
+        return {
+            toolName: data && typeof data.name === "string" ? data.name : undefined,
+            toolParams: data && typeof data.args === "object" && data.args !== null
+                ? data.args : undefined,
+        };
+    }
+    return {
+        toolName: optStr(rawPayload, "toolName"),
+        toolParams: typeof rawPayload.params === "object" && rawPayload.params !== null
+            ? rawPayload.params : undefined,
+    };
+}
+/** Normalize tool.result payload — Schema B. */
+function normalizeToolResultPayloadB(rawPayload) {
+    const data = rawPayload.data;
+    let toolResult;
+    let toolError;
+    let toolIsError = false;
+    if (data) {
+        toolResult = data.result;
+        toolIsError = data.isError === true;
+        if (toolIsError && typeof data.result === "string")
+            toolError = data.result;
+    }
+    return {
+        toolName: data && typeof data.name === "string" ? data.name : undefined,
+        toolResult, toolError, toolIsError,
+    };
+}
+/** Normalize tool.result payload — Schema A. */
+function normalizeToolResultPayloadA(rawPayload) {
+    return {
+        toolName: optStr(rawPayload, "toolName"),
+        toolParams: typeof rawPayload.params === "object" && rawPayload.params !== null
+            ? rawPayload.params : undefined,
+        toolResult: rawPayload.result,
+        toolError: optStr(rawPayload, "error"),
+        toolIsError: typeof rawPayload.error === "string" ? true : undefined,
+        toolDurationMs: typeof rawPayload.durationMs === "number" ? rawPayload.durationMs : undefined,
+    };
+}
+/** Normalize lifecycle events (session.*, run.*). */
+function normalizeLifecyclePayload(type, rawPayload) {
+    switch (type) {
+        case "session.start":
+            return { sessionId: optStr(rawPayload, "sessionId") };
+        case "session.end":
+            return {
+                sessionId: optStr(rawPayload, "sessionId"),
+                durationMs: typeof rawPayload.durationMs === "number" ? rawPayload.durationMs : undefined,
+            };
+        case "run.start":
+            return { prompt: optStr(rawPayload, "prompt") };
+        case "run.end":
+            return {
+                success: typeof rawPayload.success === "boolean" ? rawPayload.success : undefined,
+                error: optStr(rawPayload, "error"),
+                durationMs: typeof rawPayload.durationMs === "number" ? rawPayload.durationMs : undefined,
+            };
+        case "run.error":
+            return {
+                error: optStr(rawPayload, "error"),
+                durationMs: typeof rawPayload.durationMs === "number" ? rawPayload.durationMs : undefined,
+            };
+        default:
+            return {};
+    }
+}
+/**
+ * Normalize a raw payload into the unified NormalizedPayload shape.
+ * Handles both Schema A and Schema B payload structures.
+ */
+export function normalizePayload(type, rawPayload, rawType) {
+    const isSchemaB = rawType.startsWith("conversation.");
+    switch (type) {
+        case "msg.in":
+        case "msg.out": {
+            const role = type === "msg.in" ? "user" : "assistant";
+            return isSchemaB
+                ? normalizeMessagePayloadB(rawPayload, role)
+                : normalizeMessagePayloadA(rawPayload, role);
+        }
+        case "tool.call":
+            return normalizeToolCallPayload(rawPayload, isSchemaB);
+        case "tool.result":
+            return isSchemaB
+                ? normalizeToolResultPayloadB(rawPayload)
+                : normalizeToolResultPayloadA(rawPayload);
+        default:
+            return normalizeLifecyclePayload(type, rawPayload);
+    }
+}
+/**
+ * Normalize a raw event object (from any schema) into a NormalizedEvent.
+ * Returns null if the event cannot be normalized (unknown type, missing timestamp).
+ */
+export function normalizeEvent(raw, seq) {
+    const rawType = typeof raw.type === "string" ? raw.type : "";
+    const ts = typeof raw.ts === "number" ? raw.ts
+        : typeof raw.timestamp === "number" ? raw.timestamp
+            : 0;
+    if (ts === 0)
+        return null;
+    const type = mapEventType(rawType);
+    if (!type)
+        return null;
+    const agent = typeof raw.agent === "string" ? raw.agent : "unknown";
+    const rawSession = typeof raw.session === "string" ? raw.session : "unknown";
+    const session = normalizeSession(rawSession);
+    const rawPayload = (typeof raw.payload === "object" && raw.payload !== null)
+        ? raw.payload
+        : {};
+    const payload = normalizePayload(type, rawPayload, rawType);
+    return {
+        id: typeof raw.id === "string" ? raw.id : "",
+        ts,
+        agent,
+        session,
+        type,
+        payload,
+        seq,
+    };
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/trace-analyzer/events.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,0CAA0C;AAC1C,+DAA+D;AAC/D,EAAE;AACF,4CAA4C;AAC5C,6DAA6D;AAC7D,0DAA0D;AAC1D,iDAAiD;AACjD,+DAA+D;AAiE/D;;;GAGG;AACH,MAAM,cAAc,GAAsC;IACxD,yCAAyC;IACzC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,aAAa;IAC5B,eAAe,EAAE,eAAe;IAChC,aAAa,EAAE,aAAa;IAC5B,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,WAAW;IACxB,8CAA8C;IAC9C,yBAAyB,EAAE,QAAQ;IACnC,0BAA0B,EAAE,SAAS;IACrC,wBAAwB,EAAE,WAAW;IACrC,0BAA0B,EAAE,aAAa;CAC1C,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAA4B;IACvD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;IAEzB,mEAAmE;IACnE,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,GAAG,CAAC;IAEpD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAK,IAAgC,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACpG,OAAO,GAAG,CAAC;IACb,CAAC;IAED,wDAAwD;IACxD,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,CAAC;IAEtE,iDAAiD;IACjD,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAElD,wDAAwD;IACxD,IAAI,cAAc,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,CAAC;IAExC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qCAAqC;AACrC,SAAS,MAAM,CAAC,GAA4B,EAAE,GAAW;IACvD,OAAO,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,oEAAoE;AACpE,SAAS,wBAAwB,CAC/B,UAAmC,EACnC,IAA0B;IAE1B,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,CAAC;IAC5C,IAAI,OAA2B,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAwC,CAAC;QACpE,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,mDAAmD;AACnD,SAAS,wBAAwB,CAC/B,UAAmC,EACnC,IAA0B;IAE1B,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;QACtC,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC;QAChC,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;QACtC,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAClF,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,SAAS,wBAAwB,CAC/B,UAAmC,EACnC,SAAkB;IAElB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,UAAU,CAAC,IAA2C,CAAC;QACpE,OAAO;YACL,QAAQ,EAAE,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACvE,UAAU,EAAE,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;gBACrE,CAAC,CAAC,IAAI,CAAC,IAA+B,CAAC,CAAC,CAAC,SAAS;SACrD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC;QACxC,UAAU,EAAE,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,IAAI;YAC7E,CAAC,CAAC,UAAU,CAAC,MAAiC,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,SAAS,2BAA2B,CAAC,UAAmC;IACtE,MAAM,IAAI,GAAG,UAAU,CAAC,IAA2C,CAAC;IACpE,IAAI,UAAmB,CAAC;IACxB,IAAI,SAA6B,CAAC;IAClC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,IAAI,EAAE,CAAC;QACT,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,WAAW,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;QACpC,IAAI,WAAW,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9E,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvE,UAAU,EAAE,SAAS,EAAE,WAAW;KACnC,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,SAAS,2BAA2B,CAAC,UAAmC;IACtE,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC;QACxC,UAAU,EAAE,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,IAAI;YAC7E,CAAC,CAAC,UAAU,CAAC,MAAiC,CAAC,CAAC,CAAC,SAAS;QAC5D,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC;QACtC,WAAW,EAAE,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACpE,cAAc,EAAE,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;KAC9F,CAAC;AACJ,CAAC;AAED,qDAAqD;AACrD,SAAS,yBAAyB,CAChC,IAAuB,EACvB,UAAmC;IAEnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe;YAClB,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;QACxD,KAAK,aAAa;YAChB,OAAO;gBACL,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC;gBAC1C,UAAU,EAAE,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC1F,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;QAClD,KAAK,SAAS;YACZ,OAAO;gBACL,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACjF,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC;gBAClC,UAAU,EAAE,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC1F,CAAC;QACJ,KAAK,WAAW;YACd,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC;gBAClC,UAAU,EAAE,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC1F,CAAC;QACJ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAuB,EACvB,UAAmC,EACnC,OAAe;IAEf,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAEtD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAyB,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;YAC5E,OAAO,SAAS;gBACd,CAAC,CAAC,wBAAwB,CAAC,UAAU,EAAE,IAAI,CAAC;gBAC5C,CAAC,CAAC,wBAAwB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,WAAW;YACd,OAAO,wBAAwB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACzD,KAAK,aAAa;YAChB,OAAO,SAAS;gBACd,CAAC,CAAC,2BAA2B,CAAC,UAAU,CAAC;gBACzC,CAAC,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC;QAC9C;YACE,OAAO,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAA4B,EAAE,GAAW;IACtE,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;QAC5C,CAAC,CAAC,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS;YACnD,CAAC,CAAC,CAAC,CAAC;IACN,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC;QAC1E,CAAC,CAAC,GAAG,CAAC,OAAkC;QACxC,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAE5D,OAAO;QACL,EAAE,EAAE,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC5C,EAAE;QACF,KAAK;QACL,OAAO;QACP,IAAI;QACJ,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { OpenClawPluginApi, CortexConfig } from "../types.js";
+import { TraceAnalyzer } from "./analyzer.js";
+/** State shared across hook registrations for cleanup. */
+export type TraceAnalyzerHookState = {
+    /** Scheduled analysis timer (if any). */
+    timer: ReturnType<typeof setInterval> | null;
+    /** The analyzer instance (lazy, created on first command/schedule run). */
+    analyzer: TraceAnalyzer | null;
+};
+/**
+ * Register trace analyzer hooks (commands + optional scheduled runs).
+ *
+ * Called from the main `registerCortexHooks()` when
+ * `config.traceAnalyzer.enabled` is true.
+ */
+export declare function registerTraceAnalyzerHooks(api: OpenClawPluginApi, config: CortexConfig, state: TraceAnalyzerHookState): void;
+/**
+ * Clean up trace analyzer resources.
+ * Called when the plugin stops.
+ */
+export declare function cleanupTraceAnalyzerHooks(state: TraceAnalyzerHookState): void;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/trace-analyzer/hooks.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAgB,MAAM,aAAa,CAAC;AAGjF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK9C,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAAG;IACnC,yCAAyC;IACzC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC;IAC7C,2EAA2E;IAC3E,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC,CAAC;AAsIF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,sBAAsB,GAC5B,IAAI,CAsBN;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAM7E"}

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

@@ -0,0 +1,151 @@
+// ============================================================
+// Trace Analyzer — Hook Registration
+// ============================================================
+//
+// Registers trace analyzer commands and scheduled runs with
+// the OpenClaw plugin API. Called from src/hooks.ts when
+// config.traceAnalyzer.enabled is true.
+//
+// Implements R-010 (batch only, not in hook path) and R-013
+// (graceful deactivation when no TraceSource is available).
+// ============================================================
+import { resolveWorkspace } from "../config.js";
+import { TraceAnalyzer } from "./analyzer.js";
+import { createNatsTraceSource } from "./nats-trace-source.js";
+import { SignalPatternRegistry } from "./signals/lang/index.js";
+/**
+ * Create a TraceAnalyzer instance from config.
+ */
+/**
+ * Resolve language codes from CortexConfig patterns.language.
+ * Mirrors the resolveLanguageCodes logic from src/patterns.ts.
+ */
+function resolveLanguageCodes(language) {
+    if (language === "both")
+        return ["en", "de"];
+    if (language === "all")
+        return ["en", "de", "fr", "es", "pt", "it", "zh", "ja", "ko", "ru"];
+    if (typeof language === "string")
+        return [language];
+    if (Array.isArray(language))
+        return language;
+    return ["en", "de"];
+}
+async function createAnalyzer(config, workspace, logger) {
+    // Load signal patterns for configured languages
+    const langCodes = resolveLanguageCodes(config.patterns.language);
+    const signalRegistry = new SignalPatternRegistry();
+    await signalRegistry.load(langCodes);
+    const signalPatterns = signalRegistry.getPatterns();
+    logger.info(`[trace-analyzer] Loaded signal patterns for: ${signalRegistry.getLoadedLanguages().join(", ")}`);
+    return new TraceAnalyzer({
+        config: config.traceAnalyzer,
+        logger,
+        workspace,
+        topLevelLlm: config.llm,
+        createSource: () => createNatsTraceSource(config.traceAnalyzer.nats, logger),
+        signalPatterns,
+    });
+}
+/**
+ * Ensure the analyzer is initialized. Lazy to avoid work if never called.
+ */
+async function ensureAnalyzer(state, config, workspace, logger) {
+    if (!state.analyzer) {
+        state.analyzer = await createAnalyzer(config, workspace, logger);
+    }
+    return state.analyzer;
+}
+/** Handle the /trace-analyze command. */
+async function handleTraceAnalyze(api, state, config, workspace, args) {
+    const logger = api.logger;
+    const full = args?.full === true || args?.full === "true";
+    try {
+        const analyzer = await ensureAnalyzer(state, config, workspace, logger);
+        const report = await analyzer.run({ full });
+        return {
+            text: [
+                `Trace analysis complete.`,
+                `Events: ${report.stats.eventsProcessed}`,
+                `Chains: ${report.stats.chainsReconstructed}`,
+                `Findings: ${report.stats.findingsDetected}`,
+                `Classified: ${report.stats.findingsClassified}`,
+                `Outputs: ${report.stats.outputsGenerated}`,
+            ].join(" | "),
+        };
+    }
+    catch (err) {
+        logger.warn(`[trace-analyzer] Command error: ${err instanceof Error ? err.message : String(err)}`);
+        return { text: `Trace analysis failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+/** Handle the /trace-status command. */
+async function handleTraceStatus(api, state, config, workspace) {
+    const logger = api.logger;
+    try {
+        const analyzer = await ensureAnalyzer(state, config, workspace, logger);
+        const status = await analyzer.getStatus();
+        return {
+            text: [
+                `Trace Analyzer Status`,
+                `Last run: ${status.lastRun ?? "never"}`,
+                `Total findings: ${status.findings}`,
+                `Events processed: ${status.state.totalEventsProcessed ?? 0}`,
+            ].join(" | "),
+        };
+    }
+    catch (err) {
+        return { text: `Failed to get status: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+/** Set up the scheduled analysis interval timer. */
+function setupSchedule(api, state, config, workspace) {
+    const intervalMs = config.traceAnalyzer.schedule.intervalHours * 60 * 60 * 1000;
+    const timer = setInterval(() => {
+        const logger = api.logger;
+        logger.info("[trace-analyzer] Running scheduled analysis...");
+        ensureAnalyzer(state, config, workspace, logger)
+            .then(analyzer => analyzer.run())
+            .catch(err => {
+            logger.warn(`[trace-analyzer] Scheduled analysis failed: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }, intervalMs);
+    timer.unref();
+    state.timer = timer;
+    api.logger.info(`[trace-analyzer] Scheduled analysis every ${config.traceAnalyzer.schedule.intervalHours}h`);
+}
+/**
+ * Register trace analyzer hooks (commands + optional scheduled runs).
+ *
+ * Called from the main `registerCortexHooks()` when
+ * `config.traceAnalyzer.enabled` is true.
+ */
+export function registerTraceAnalyzerHooks(api, config, state) {
+    const workspace = resolveWorkspace(config);
+    api.registerCommand({
+        name: "trace-analyze",
+        description: "Run the trace analyzer pipeline (batch analysis of agent event traces)",
+        handler: (args) => handleTraceAnalyze(api, state, config, workspace, args),
+    });
+    api.registerCommand({
+        name: "trace-status",
+        description: "Show trace analyzer status (last run, findings count, processing state)",
+        handler: () => handleTraceStatus(api, state, config, workspace),
+    });
+    if (config.traceAnalyzer.schedule.enabled) {
+        setupSchedule(api, state, config, workspace);
+    }
+    api.logger.info(`[trace-analyzer] Hooks registered — schedule:${config.traceAnalyzer.schedule.enabled} llm:${config.traceAnalyzer.llm.enabled}`);
+}
+/**
+ * Clean up trace analyzer resources.
+ * Called when the plugin stops.
+ */
+export function cleanupTraceAnalyzerHooks(state) {
+    if (state.timer) {
+        clearInterval(state.timer);
+        state.timer = null;
+    }
+    state.analyzer = null;
+}
+//# sourceMappingURL=hooks.js.map