siclaw 0.1.1 → 0.1.2

package/dist/shared/diagnostic-events.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Diagnostic event bus — lightweight decoupling layer for observability.
+ *
+ * Business code emits events via emitDiagnostic(). Subscribers (e.g. metrics.ts)
+ * consume them without the emitter knowing or caring about prom-client / OTel / logs.
+ *
+ * Design choices:
+ * - Plain callback array (not EventEmitter) — try-catch protects callers from subscriber errors
+ * - Zero external dependencies — safe to import from any module
+ * - Synchronous dispatch — O(1) per subscriber, no event loop overhead
+ */
+import type { BrainSessionStats, BrainModelInfo } from "../core/brain-session.js";
+export type DiagnosticEvent = {
+    type: "prompt_complete";
+    sessionId: string;
+    prev: BrainSessionStats;
+    curr: BrainSessionStats;
+    model: BrainModelInfo | undefined;
+    durationMs: number;
+    outcome: "completed" | "error";
+    userId?: string;
+} | {
+    type: "session_created";
+    sessionId: string;
+} | {
+    type: "session_released";
+    sessionId: string;
+    stats: BrainSessionStats;
+    userId?: string;
+    model?: BrainModelInfo;
+    createdAt: number;
+} | {
+    type: "tool_call";
+    toolName: string;
+    outcome: "success" | "error";
+    durationMs: number;
+} | {
+    type: "ws_connected";
+} | {
+    type: "ws_disconnected";
+} | {
+    type: "context_usage";
+    provider: string;
+    model: string;
+    tokensUsed: number;
+    tokensLimit: number;
+} | {
+    type: "skill_call";
+    skillName: string;
+    scriptName: string;
+    scope: "builtin" | "team" | "personal";
+    outcome: "success" | "error";
+    durationMs: number;
+    sessionId?: string;
+} | {
+    type: "session_stuck";
+    sessionId: string;
+    idleMs: number;
+};
+type Listener = (event: DiagnosticEvent) => void;
+/**
+ * Emit a diagnostic event. All registered listeners are called synchronously.
+ * Listener exceptions are caught and logged — never propagated to the caller.
+ */
+export declare function emitDiagnostic(event: DiagnosticEvent): void;
+/**
+ * Subscribe to diagnostic events. Returns an unsubscribe function.
+ */
+export declare function onDiagnostic(fn: Listener): () => void;
+export {};

package/dist/shared/diagnostic-events.js

@@ -0,0 +1,38 @@
+/**
+ * Diagnostic event bus — lightweight decoupling layer for observability.
+ *
+ * Business code emits events via emitDiagnostic(). Subscribers (e.g. metrics.ts)
+ * consume them without the emitter knowing or caring about prom-client / OTel / logs.
+ *
+ * Design choices:
+ * - Plain callback array (not EventEmitter) — try-catch protects callers from subscriber errors
+ * - Zero external dependencies — safe to import from any module
+ * - Synchronous dispatch — O(1) per subscriber, no event loop overhead
+ */
+const listeners = [];
+/**
+ * Emit a diagnostic event. All registered listeners are called synchronously.
+ * Listener exceptions are caught and logged — never propagated to the caller.
+ */
+export function emitDiagnostic(event) {
+    for (const fn of listeners) {
+        try {
+            fn(event);
+        }
+        catch (err) {
+            console.warn("[diagnostic] listener error:", err);
+        }
+    }
+}
+/**
+ * Subscribe to diagnostic events. Returns an unsubscribe function.
+ */
+export function onDiagnostic(fn) {
+    listeners.push(fn);
+    return () => {
+        const idx = listeners.indexOf(fn);
+        if (idx >= 0)
+            listeners.splice(idx, 1);
+    };
+}
+//# sourceMappingURL=diagnostic-events.js.map

package/dist/shared/diagnostic-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-events.js","sourceRoot":"","sources":["../../src/shared/diagnostic-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8DH,MAAM,SAAS,GAAe,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAsB;IACnD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,EAAE,CAAC,KAAK,CAAC,CAAC;QACZ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAAY;IACvC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,GAAG,IAAI,CAAC;YAAE,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC;AACJ,CAAC"}

package/dist/shared/local-collector.d.ts

@@ -0,0 +1,56 @@
+/**
+ * LocalCollector — per-process metrics collector for the Monitoring Dashboard.
+ *
+ * Subscribes to the diagnostic event bus and maintains:
+ * - Minute-level ring buffer (max 1440 buckets = 24h)
+ * - Per-tool call statistics (lifetime cumulative)
+ * - Per-session prompt/tool counters (for SessionStatsRecord generation)
+ * - Session stats queue (consumed by MetricsAggregator or exported via snapshot)
+ *
+ * Used directly in Local mode; in K8s mode, Gateway pulls via exportSnapshot().
+ * This class does NOT know which mode it runs in — the consumer decides.
+ */
+import { type MetricsBucket, type ToolCallStats, type SkillCallStats, type SessionStatsRecord, type MetricsSnapshot } from "./metrics-types.js";
+declare class LocalCollector {
+    private ringBuffer;
+    private toolCallMap;
+    private skillCallMap;
+    private perSessionCounters;
+    private sessionStatsQueue;
+    private currentSessions;
+    private currentWsConnections;
+    /** Tracks the newest timestamp that was exported via exportSnapshot() */
+    private lastExportedTs;
+    constructor();
+    private handle;
+    private getOrCreateBucket;
+    private evict;
+    /** Return buckets within the given time range, sorted ascending by timestamp */
+    query(range: "1h" | "6h" | "24h"): MetricsBucket[];
+    /** Return current instantaneous values */
+    snapshot(): {
+        activeSessions: number;
+        wsConnections: number;
+    };
+    /** Return tool call rankings, sorted by total descending, top N */
+    topTools(n: number): ToolCallStats[];
+    /** Return skill call rankings, sorted by total descending, top N */
+    topSkills(n: number): SkillCallStats[];
+    /**
+     * Drain the session stats queue — returns all pending records and clears the queue.
+     * Used by MetricsAggregator in Local mode to consume and write to DB.
+     */
+    drainSessionStats(): SessionStatsRecord[];
+    /**
+     * Export snapshot for Gateway pull (K8s mode).
+     *
+     * Returns only completed minute buckets (timestamp < current minute) that
+     * haven't been exported yet. This prevents the same bucket from being
+     * counted twice across consecutive pulls.
+     *
+     * Session stats queue is cleared after export (best-effort delivery).
+     */
+    exportSnapshot(): MetricsSnapshot;
+}
+export declare const localCollector: LocalCollector;
+export {};

package/dist/shared/local-collector.js

@@ -0,0 +1,284 @@
+/**
+ * LocalCollector — per-process metrics collector for the Monitoring Dashboard.
+ *
+ * Subscribes to the diagnostic event bus and maintains:
+ * - Minute-level ring buffer (max 1440 buckets = 24h)
+ * - Per-tool call statistics (lifetime cumulative)
+ * - Per-session prompt/tool counters (for SessionStatsRecord generation)
+ * - Session stats queue (consumed by MetricsAggregator or exported via snapshot)
+ *
+ * Used directly in Local mode; in K8s mode, Gateway pulls via exportSnapshot().
+ * This class does NOT know which mode it runs in — the consumer decides.
+ */
+import { onDiagnostic } from "./diagnostic-events.js";
+import { createEmptyBucket, } from "./metrics-types.js";
+const MAX_BUCKETS = 1440; // 24 hours of minute-level data
+function minuteTs(now) {
+    return Math.floor((now ?? Date.now()) / 60_000) * 60_000;
+}
+class LocalCollector {
+    ringBuffer = new Map();
+    toolCallMap = new Map();
+    skillCallMap = new Map();
+    perSessionCounters = new Map();
+    sessionStatsQueue = [];
+    currentSessions = 0;
+    currentWsConnections = 0;
+    /** Tracks the newest timestamp that was exported via exportSnapshot() */
+    lastExportedTs = 0;
+    constructor() {
+        onDiagnostic((event) => this.handle(event));
+    }
+    // ── Event handler ──
+    handle(event) {
+        switch (event.type) {
+            case "prompt_complete": {
+                const bucket = this.getOrCreateBucket();
+                const deltaInput = event.curr.tokens.input - event.prev.tokens.input;
+                const deltaOutput = event.curr.tokens.output - event.prev.tokens.output;
+                const deltaCacheRead = event.curr.tokens.cacheRead - event.prev.tokens.cacheRead;
+                const deltaCacheWrite = event.curr.tokens.cacheWrite - event.prev.tokens.cacheWrite;
+                bucket.tokensInput += deltaInput;
+                bucket.tokensOutput += deltaOutput;
+                bucket.tokensCacheRead += deltaCacheRead;
+                bucket.tokensCacheWrite += deltaCacheWrite;
+                bucket.promptDurationSum += event.durationMs;
+                bucket.promptDurationMax = Math.max(bucket.promptDurationMax, event.durationMs);
+                if (event.outcome === "error") {
+                    bucket.promptErrors++;
+                }
+                else {
+                    bucket.promptCount++;
+                }
+                // Per-session counter
+                const sc = this.perSessionCounters.get(event.sessionId);
+                if (sc)
+                    sc.prompts++;
+                break;
+            }
+            case "session_created": {
+                this.currentSessions++;
+                const bucket = this.getOrCreateBucket();
+                bucket.activeSessions = this.currentSessions;
+                this.perSessionCounters.set(event.sessionId, { prompts: 0, tools: 0, skills: 0 });
+                break;
+            }
+            case "session_released": {
+                this.currentSessions = Math.max(0, this.currentSessions - 1);
+                const bucket = this.getOrCreateBucket();
+                bucket.activeSessions = this.currentSessions;
+                // Generate SessionStatsRecord
+                const counters = this.perSessionCounters.get(event.sessionId);
+                this.perSessionCounters.delete(event.sessionId);
+                const record = {
+                    sessionId: event.sessionId,
+                    userId: event.userId ?? "unknown",
+                    provider: event.model?.provider ?? null,
+                    model: event.model?.id ?? event.model?.name ?? null,
+                    inputTokens: event.stats.tokens.input,
+                    outputTokens: event.stats.tokens.output,
+                    cacheReadTokens: event.stats.tokens.cacheRead,
+                    cacheWriteTokens: event.stats.tokens.cacheWrite,
+                    durationMs: Date.now() - event.createdAt,
+                    promptCount: counters?.prompts ?? 0,
+                    toolCallCount: counters?.tools ?? 0,
+                    skillCallCount: counters?.skills ?? 0,
+                    createdAt: event.createdAt,
+                };
+                this.sessionStatsQueue.push(record);
+                break;
+            }
+            case "tool_call": {
+                const bucket = this.getOrCreateBucket();
+                if (event.outcome === "error") {
+                    bucket.toolErrors++;
+                }
+                else {
+                    bucket.toolCalls++;
+                }
+                // Per-tool cumulative
+                let entry = this.toolCallMap.get(event.toolName);
+                if (!entry) {
+                    entry = { success: 0, error: 0 };
+                    this.toolCallMap.set(event.toolName, entry);
+                }
+                if (event.outcome === "error") {
+                    entry.error++;
+                }
+                else {
+                    entry.success++;
+                }
+                // Per-session counter (best-effort — tool_call has no sessionId)
+                // Increments the first session in Map iteration order (insertion order).
+                // In practice each AgentBox has one active session at a time.
+                for (const sc of this.perSessionCounters.values()) {
+                    sc.tools++;
+                    break; // increment first (most recent) only
+                }
+                break;
+            }
+            case "skill_call": {
+                const bucket = this.getOrCreateBucket();
+                if (event.outcome === "error") {
+                    bucket.skillErrors++;
+                }
+                else {
+                    bucket.skillSuccesses++;
+                }
+                // Per-skill cumulative
+                const key = event.skillName;
+                let skillEntry = this.skillCallMap.get(key);
+                if (!skillEntry) {
+                    skillEntry = { scope: event.scope, success: 0, error: 0, totalDurationMs: 0 };
+                    this.skillCallMap.set(key, skillEntry);
+                }
+                if (event.outcome === "error") {
+                    skillEntry.error++;
+                }
+                else {
+                    skillEntry.success++;
+                }
+                skillEntry.totalDurationMs += event.durationMs;
+                // Per-session counter (skill_call carries sessionId for precise matching)
+                if (event.sessionId) {
+                    const sc = this.perSessionCounters.get(event.sessionId);
+                    if (sc)
+                        sc.skills++;
+                }
+                break;
+            }
+            case "ws_connected": {
+                this.currentWsConnections++;
+                const bucket = this.getOrCreateBucket();
+                bucket.wsConnections = this.currentWsConnections;
+                break;
+            }
+            case "ws_disconnected": {
+                this.currentWsConnections = Math.max(0, this.currentWsConnections - 1);
+                const bucket = this.getOrCreateBucket();
+                bucket.wsConnections = this.currentWsConnections;
+                break;
+            }
+            // context_usage, session_stuck — not handled in v1
+        }
+    }
+    // ── Bucket management ──
+    getOrCreateBucket(now) {
+        const ts = minuteTs(now);
+        let bucket = this.ringBuffer.get(ts);
+        if (!bucket) {
+            bucket = createEmptyBucket(ts);
+            bucket.activeSessions = this.currentSessions;
+            bucket.wsConnections = this.currentWsConnections;
+            this.ringBuffer.set(ts, bucket);
+            this.evict();
+        }
+        return bucket;
+    }
+    evict() {
+        if (this.ringBuffer.size <= MAX_BUCKETS)
+            return;
+        // Remove oldest buckets
+        const sorted = [...this.ringBuffer.keys()].sort((a, b) => a - b);
+        const excess = sorted.length - MAX_BUCKETS;
+        for (let i = 0; i < excess; i++) {
+            this.ringBuffer.delete(sorted[i]);
+        }
+    }
+    // ── Public query API ──
+    /** Return buckets within the given time range, sorted ascending by timestamp */
+    query(range) {
+        const rangeMs = range === "1h" ? 3_600_000 : range === "6h" ? 21_600_000 : 86_400_000;
+        const cutoff = minuteTs() - rangeMs;
+        const result = [];
+        for (const [ts, bucket] of this.ringBuffer) {
+            if (ts >= cutoff)
+                result.push(bucket);
+        }
+        return result.sort((a, b) => a.timestamp - b.timestamp);
+    }
+    /** Return current instantaneous values */
+    snapshot() {
+        return {
+            activeSessions: this.currentSessions,
+            wsConnections: this.currentWsConnections,
+        };
+    }
+    /** Return tool call rankings, sorted by total descending, top N */
+    topTools(n) {
+        const result = [];
+        for (const [toolName, entry] of this.toolCallMap) {
+            result.push({
+                toolName,
+                success: entry.success,
+                error: entry.error,
+                total: entry.success + entry.error,
+            });
+        }
+        result.sort((a, b) => b.total - a.total);
+        return result.slice(0, n);
+    }
+    /** Return skill call rankings, sorted by total descending, top N */
+    topSkills(n) {
+        return [...this.skillCallMap.entries()]
+            .map(([skillName, v]) => {
+            const total = v.success + v.error;
+            return {
+                skillName,
+                scope: v.scope,
+                success: v.success,
+                error: v.error,
+                total,
+                avgDurationMs: total > 0 ? Math.round(v.totalDurationMs / total) : 0,
+            };
+        })
+            .sort((a, b) => b.total - a.total)
+            .slice(0, n);
+    }
+    /**
+     * Drain the session stats queue — returns all pending records and clears the queue.
+     * Used by MetricsAggregator in Local mode to consume and write to DB.
+     */
+    drainSessionStats() {
+        const records = this.sessionStatsQueue.splice(0);
+        return records;
+    }
+    /**
+     * Export snapshot for Gateway pull (K8s mode).
+     *
+     * Returns only completed minute buckets (timestamp < current minute) that
+     * haven't been exported yet. This prevents the same bucket from being
+     * counted twice across consecutive pulls.
+     *
+     * Session stats queue is cleared after export (best-effort delivery).
+     */
+    exportSnapshot() {
+        const currentMin = minuteTs();
+        const buckets = [];
+        for (const [ts, bucket] of this.ringBuffer) {
+            if (ts < currentMin && ts > this.lastExportedTs) {
+                buckets.push(bucket);
+            }
+        }
+        buckets.sort((a, b) => a.timestamp - b.timestamp);
+        if (buckets.length > 0) {
+            this.lastExportedTs = buckets[buckets.length - 1].timestamp;
+        }
+        // Tool call deltas: export current totals, then reset for next interval
+        const toolCallDeltas = this.topTools(Infinity);
+        this.toolCallMap.clear();
+        // Skill call deltas: export current totals, then reset for next interval
+        const skillCallDeltas = this.topSkills(Infinity);
+        this.skillCallMap.clear();
+        const sessionStats = this.sessionStatsQueue.splice(0);
+        return {
+            buckets,
+            activeSessions: this.currentSessions,
+            sessionStats,
+            toolCallDeltas,
+            skillCallDeltas,
+        };
+    }
+}
+export const localCollector = new LocalCollector();
+//# sourceMappingURL=local-collector.js.map

package/dist/shared/local-collector.js.map

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

package/dist/shared/metrics-types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shared data types for the Monitoring Dashboard.
+ *
+ * Used by both LocalCollector (AgentBox side) and MetricsAggregator (Gateway side).
+ */
+/** Minute-level aggregation bucket */
+export interface MetricsBucket {
+    timestamp: number;
+    tokensInput: number;
+    tokensOutput: number;
+    tokensCacheRead: number;
+    tokensCacheWrite: number;
+    promptCount: number;
+    promptErrors: number;
+    promptDurationSum: number;
+    promptDurationMax: number;
+    activeSessions: number;
+    wsConnections: number;
+    toolCalls: number;
+    toolErrors: number;
+    skillSuccesses: number;
+    skillErrors: number;
+}
+/** Tool call ranking entry */
+export interface ToolCallStats {
+    toolName: string;
+    success: number;
+    error: number;
+    total: number;
+}
+/** Skill call ranking entry */
+export interface SkillCallStats {
+    skillName: string;
+    scope: "builtin" | "team" | "personal";
+    success: number;
+    error: number;
+    total: number;
+    avgDurationMs: number;
+}
+/** Session stats record — written to Gateway DB when a session is released */
+export interface SessionStatsRecord {
+    sessionId: string;
+    userId: string;
+    provider: string | null;
+    model: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    durationMs: number;
+    promptCount: number;
+    toolCallCount: number;
+    skillCallCount: number;
+    createdAt: number;
+}
+/** Snapshot exported by LocalCollector for Gateway pull (K8s mode) */
+export interface MetricsSnapshot {
+    buckets: MetricsBucket[];
+    activeSessions: number;
+    sessionStats: SessionStatsRecord[];
+    toolCallDeltas: ToolCallStats[];
+    skillCallDeltas: SkillCallStats[];
+}
+export declare function createEmptyBucket(timestamp: number): MetricsBucket;

package/dist/shared/metrics-types.js

@@ -0,0 +1,25 @@
+/**
+ * Shared data types for the Monitoring Dashboard.
+ *
+ * Used by both LocalCollector (AgentBox side) and MetricsAggregator (Gateway side).
+ */
+export function createEmptyBucket(timestamp) {
+    return {
+        timestamp,
+        tokensInput: 0,
+        tokensOutput: 0,
+        tokensCacheRead: 0,
+        tokensCacheWrite: 0,
+        promptCount: 0,
+        promptErrors: 0,
+        promptDurationSum: 0,
+        promptDurationMax: 0,
+        activeSessions: 0,
+        wsConnections: 0,
+        toolCalls: 0,
+        toolErrors: 0,
+        skillSuccesses: 0,
+        skillErrors: 0,
+    };
+}
+//# sourceMappingURL=metrics-types.js.map

package/dist/shared/metrics-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-types.js","sourceRoot":"","sources":["../../src/shared/metrics-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiEH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO;QACL,SAAS;QACT,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,eAAe,EAAE,CAAC;QAClB,gBAAgB,EAAE,CAAC;QACnB,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,cAAc,EAAE,CAAC;QACjB,WAAW,EAAE,CAAC;KACf,CAAC;AACJ,CAAC"}

package/dist/shared/metrics.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Prometheus metrics subscriber — the ONLY file that depends on prom-client.
+ *
+ * Subscribes to the diagnostic event bus and maps events to Prometheus metrics.
+ * Business code never imports this module directly — it only calls emitDiagnostic().
+ *
+ * Importing this module (side-effect import) registers the subscriber automatically.
+ */
+import http from "node:http";
+import { Registry } from "prom-client";
+/**
+ * Check bearer token authentication for /metrics endpoints.
+ * Returns true if the request is authorized (or no token is configured).
+ * Returns false and sends 401 response if unauthorized.
+ */
+export declare function checkMetricsAuth(req: http.IncomingMessage, res: http.ServerResponse, configuredToken?: string): boolean;
+export declare const metricsRegistry: Registry<"text/plain; version=0.0.4; charset=utf-8">;
+/** Update the includeUserId flag at runtime (called by Gateway when DB config changes) */
+export declare function setIncludeUserId(value: boolean): void;