@agentplugged/claw 0.1.0

package/dist/observability/collector.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityCollector = void 0;
+const db_1 = require("./db");
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function todayDate() {
+    return new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+}
+// ─── Collector ────────────────────────────────────────────────────────────────
+/**
+ * ObservabilityCollector hooks into OpenClaw and the router to track
+ * every interaction for the dashboard.
+ *
+ * All methods are synchronous (SQLite writes are fast enough) so they
+ * can be called from lifecycle hooks without async overhead.
+ */
+class ObservabilityCollector {
+    db;
+    // In-memory accumulator for daily stats before flush
+    dailyAccumulator = new Map();
+    constructor(db) {
+        this.db = db;
+    }
+    // ── Session lifecycle ────────────────────────────────────────────────────────
+    /**
+     * Called when a new conversation starts (before_agent_start hook).
+     */
+    startSession(sessionId, channel) {
+        (0, db_1.createSession)(this.db, { id: sessionId, channel });
+        (0, db_1.logEvent)(this.db, {
+            sessionId,
+            type: "session_start",
+            data: { channel: channel ?? null },
+        });
+        this.accumulateDaily("sessions", 1);
+    }
+    /**
+     * Called when the conversation ends (agent_end hook).
+     */
+    endSession(sessionId) {
+        (0, db_1.endSession)(this.db, sessionId);
+        (0, db_1.logEvent)(this.db, { sessionId, type: "session_end" });
+    }
+    // ── Message tracking ─────────────────────────────────────────────────────────
+    /**
+     * Called for each message sent or received.
+     */
+    trackMessage(sessionId, role, tokens) {
+        (0, db_1.updateSessionStats)(this.db, sessionId, { messages: 1 });
+        (0, db_1.logEvent)(this.db, {
+            sessionId,
+            type: "message",
+            data: { role, tokens },
+        });
+        this.accumulateDaily("messages", 1);
+    }
+    // ── Tool call tracking ───────────────────────────────────────────────────────
+    /**
+     * Called for each tool invocation.
+     */
+    trackToolCall(sessionId, toolName, duration, success) {
+        (0, db_1.updateSessionStats)(this.db, sessionId, { toolCalls: 1 });
+        (0, db_1.logEvent)(this.db, {
+            sessionId,
+            type: "tool_call",
+            data: { tool: toolName, duration_ms: duration, success },
+        });
+        this.accumulateDaily("tool_calls", 1);
+        if (!success) {
+            this.accumulateDaily("errors", 1);
+        }
+    }
+    // ── LLM call tracking ────────────────────────────────────────────────────────
+    /**
+     * Called when an LLM request completes (from router logs).
+     */
+    trackLLMCall(sessionId, model, inputTokens, outputTokens, cost, latencyMs) {
+        (0, db_1.updateSessionStats)(this.db, sessionId, {
+            inputTokens,
+            outputTokens,
+            cost,
+        });
+        (0, db_1.logEvent)(this.db, {
+            sessionId,
+            type: "llm_call",
+            data: {
+                model,
+                input_tokens: inputTokens,
+                output_tokens: outputTokens,
+                cost,
+                latency_ms: latencyMs,
+            },
+        });
+        this.accumulateDaily("tokens_in", inputTokens);
+        this.accumulateDaily("tokens_out", outputTokens);
+        this.accumulateDaily("cost", cost);
+    }
+    // ── Daily stats flush ─────────────────────────────────────────────────────────
+    /**
+     * Flushes accumulated daily stats to the database.
+     * Should be called periodically (e.g. every minute) or at session end.
+     */
+    flushDailyStats() {
+        if (this.dailyAccumulator.size === 0)
+            return;
+        const date = todayDate();
+        for (const [metric, value] of this.dailyAccumulator.entries()) {
+            (0, db_1.updateDailyStat)(this.db, date, metric, value);
+        }
+        this.dailyAccumulator.clear();
+    }
+    // ── Private helpers ───────────────────────────────────────────────────────────
+    accumulateDaily(metric, value) {
+        const current = this.dailyAccumulator.get(metric) ?? 0;
+        this.dailyAccumulator.set(metric, current + value);
+    }
+}
+exports.ObservabilityCollector = ObservabilityCollector;
+//# sourceMappingURL=collector.js.map

package/dist/observability/collector.js.map

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

package/dist/observability/db.d.ts

@@ -0,0 +1,60 @@
+import Database from "better-sqlite3";
+export interface Session {
+    id: string;
+    channel: string | null;
+    started_at: string;
+    ended_at: string | null;
+    message_count: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    total_cost: number;
+    tool_calls: number;
+    status: string;
+}
+export interface Event {
+    id: number;
+    session_id: string | null;
+    type: string;
+    data: string | null;
+    timestamp: string;
+}
+/**
+ * Opens (or creates) the metrics SQLite database.
+ * Stored at <dataDir>/observability/metrics.db.
+ * WAL mode is enabled for concurrent reads.
+ */
+export declare function openMetricsDatabase(dataDir: string): Database.Database;
+/**
+ * Creates a new session record.
+ */
+export declare function createSession(db: Database.Database, opts: {
+    id: string;
+    channel?: string;
+}): void;
+/**
+ * Marks a session as completed and sets ended_at.
+ */
+export declare function endSession(db: Database.Database, id: string): void;
+/**
+ * Inserts a generic event record linked to an optional session.
+ */
+export declare function logEvent(db: Database.Database, event: {
+    sessionId?: string;
+    type: string;
+    data?: unknown;
+}): void;
+/**
+ * Increments session counters atomically.
+ */
+export declare function updateSessionStats(db: Database.Database, sessionId: string, stats: {
+    messages?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    cost?: number;
+    toolCalls?: number;
+}): void;
+/**
+ * Upserts a daily stat value (additive).
+ */
+export declare function updateDailyStat(db: Database.Database, date: string, metric: string, value: number): void;
+//# sourceMappingURL=db.d.ts.map

package/dist/observability/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/observability/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA4CtC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CActE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAMlE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IACL,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,IAAI,CAgCN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CAWN"}

package/dist/observability/db.js

@@ -0,0 +1,189 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openMetricsDatabase = openMetricsDatabase;
+exports.createSession = createSession;
+exports.endSession = endSession;
+exports.logEvent = logEvent;
+exports.updateSessionStats = updateSessionStats;
+exports.updateDailyStat = updateDailyStat;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ─── Schema ──────────────────────────────────────────────────────────────────
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,
+  channel TEXT,
+  started_at TEXT NOT NULL DEFAULT (datetime('now')),
+  ended_at TEXT,
+  message_count INTEGER NOT NULL DEFAULT 0,
+  total_input_tokens INTEGER NOT NULL DEFAULT 0,
+  total_output_tokens INTEGER NOT NULL DEFAULT 0,
+  total_cost REAL NOT NULL DEFAULT 0,
+  tool_calls INTEGER NOT NULL DEFAULT 0,
+  status TEXT NOT NULL DEFAULT 'active'
+);
+
+CREATE TABLE IF NOT EXISTS events (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT,
+  type TEXT NOT NULL,
+  data TEXT,
+  timestamp TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (session_id) REFERENCES sessions(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_events_session ON events(session_id);
+CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_sessions_started ON sessions(started_at);
+
+CREATE TABLE IF NOT EXISTS daily_stats (
+  date TEXT NOT NULL,
+  metric TEXT NOT NULL,
+  value REAL NOT NULL DEFAULT 0,
+  PRIMARY KEY (date, metric)
+);
+`;
+// ─── Functions ────────────────────────────────────────────────────────────────
+/**
+ * Opens (or creates) the metrics SQLite database.
+ * Stored at <dataDir>/observability/metrics.db.
+ * WAL mode is enabled for concurrent reads.
+ */
+function openMetricsDatabase(dataDir) {
+    const obsDir = path.join(dataDir, "observability");
+    if (!fs.existsSync(obsDir)) {
+        fs.mkdirSync(obsDir, { recursive: true });
+    }
+    const dbPath = path.join(obsDir, "metrics.db");
+    const db = new better_sqlite3_1.default(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.exec(SCHEMA_SQL);
+    return db;
+}
+/**
+ * Creates a new session record.
+ */
+function createSession(db, opts) {
+    db.prepare(`
+    INSERT OR IGNORE INTO sessions (id, channel, status)
+    VALUES (@id, @channel, 'active')
+  `).run({ id: opts.id, channel: opts.channel ?? null });
+}
+/**
+ * Marks a session as completed and sets ended_at.
+ */
+function endSession(db, id) {
+    db.prepare(`
+    UPDATE sessions
+    SET ended_at = datetime('now'), status = 'completed'
+    WHERE id = @id AND status = 'active'
+  `).run({ id });
+}
+/**
+ * Inserts a generic event record linked to an optional session.
+ */
+function logEvent(db, event) {
+    try {
+        db.prepare(`
+      INSERT INTO events (session_id, type, data)
+      VALUES (@sessionId, @type, @data)
+    `).run({
+            sessionId: event.sessionId ?? null,
+            type: event.type,
+            data: event.data !== undefined ? JSON.stringify(event.data) : null,
+        });
+    }
+    catch (err) {
+        // Observability must never crash the system
+        console.error("[observability/db] Failed to log event:", err);
+    }
+}
+/**
+ * Increments session counters atomically.
+ */
+function updateSessionStats(db, sessionId, stats) {
+    const setClauses = [];
+    const params = { id: sessionId };
+    if (stats.messages !== undefined) {
+        setClauses.push("message_count = message_count + @messages");
+        params["messages"] = stats.messages;
+    }
+    if (stats.inputTokens !== undefined) {
+        setClauses.push("total_input_tokens = total_input_tokens + @inputTokens");
+        params["inputTokens"] = stats.inputTokens;
+    }
+    if (stats.outputTokens !== undefined) {
+        setClauses.push("total_output_tokens = total_output_tokens + @outputTokens");
+        params["outputTokens"] = stats.outputTokens;
+    }
+    if (stats.cost !== undefined) {
+        setClauses.push("total_cost = total_cost + @cost");
+        params["cost"] = stats.cost;
+    }
+    if (stats.toolCalls !== undefined) {
+        setClauses.push("tool_calls = tool_calls + @toolCalls");
+        params["toolCalls"] = stats.toolCalls;
+    }
+    if (setClauses.length === 0)
+        return;
+    db.prepare(`
+    UPDATE sessions
+    SET ${setClauses.join(", ")}
+    WHERE id = @id
+  `).run(params);
+}
+/**
+ * Upserts a daily stat value (additive).
+ */
+function updateDailyStat(db, date, metric, value) {
+    try {
+        db.prepare(`
+      INSERT INTO daily_stats (date, metric, value)
+      VALUES (@date, @metric, @value)
+      ON CONFLICT(date, metric)
+      DO UPDATE SET value = value + @value
+    `).run({ date, metric, value });
+    }
+    catch (err) {
+        console.error("[observability/db] Failed to update daily stat:", err);
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/observability/db.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,7 @@
+export { openMetricsDatabase, createSession, endSession, logEvent, updateSessionStats, updateDailyStat, } from "./db";
+export type { Session, Event } from "./db";
+export { ObservabilityCollector } from "./collector";
+export { getTodayStats, getWeeklyStats, getMonthlyStats, getActiveSessions, getRecentSessions, getSessionEvents, getTopSkillsByCost, getModelDistribution, } from "./queries";
+export type { DayStats } from "./queries";
+export declare const OBSERVABILITY_SKILL_MD = "---\nname: agentplugged-observability\ndescription: Usage tracking and metrics collection\nalways: true\nhidden: true\n---\n\n# Observability\n\nThis agent is monitored by AgentPlugged ClawMetry. All interactions, tool calls, and token usage are tracked for the dashboard.\n\nThis skill is invisible to users and requires no interaction.\n";
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,MAAM,CAAC;AACd,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,eAAO,MAAM,sBAAsB,wVAYlC,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBSERVABILITY_SKILL_MD = exports.getModelDistribution = exports.getTopSkillsByCost = exports.getSessionEvents = exports.getRecentSessions = exports.getActiveSessions = exports.getMonthlyStats = exports.getWeeklyStats = exports.getTodayStats = exports.ObservabilityCollector = exports.updateDailyStat = exports.updateSessionStats = exports.logEvent = exports.endSession = exports.createSession = exports.openMetricsDatabase = void 0;
+var db_1 = require("./db");
+Object.defineProperty(exports, "openMetricsDatabase", { enumerable: true, get: function () { return db_1.openMetricsDatabase; } });
+Object.defineProperty(exports, "createSession", { enumerable: true, get: function () { return db_1.createSession; } });
+Object.defineProperty(exports, "endSession", { enumerable: true, get: function () { return db_1.endSession; } });
+Object.defineProperty(exports, "logEvent", { enumerable: true, get: function () { return db_1.logEvent; } });
+Object.defineProperty(exports, "updateSessionStats", { enumerable: true, get: function () { return db_1.updateSessionStats; } });
+Object.defineProperty(exports, "updateDailyStat", { enumerable: true, get: function () { return db_1.updateDailyStat; } });
+var collector_1 = require("./collector");
+Object.defineProperty(exports, "ObservabilityCollector", { enumerable: true, get: function () { return collector_1.ObservabilityCollector; } });
+var queries_1 = require("./queries");
+Object.defineProperty(exports, "getTodayStats", { enumerable: true, get: function () { return queries_1.getTodayStats; } });
+Object.defineProperty(exports, "getWeeklyStats", { enumerable: true, get: function () { return queries_1.getWeeklyStats; } });
+Object.defineProperty(exports, "getMonthlyStats", { enumerable: true, get: function () { return queries_1.getMonthlyStats; } });
+Object.defineProperty(exports, "getActiveSessions", { enumerable: true, get: function () { return queries_1.getActiveSessions; } });
+Object.defineProperty(exports, "getRecentSessions", { enumerable: true, get: function () { return queries_1.getRecentSessions; } });
+Object.defineProperty(exports, "getSessionEvents", { enumerable: true, get: function () { return queries_1.getSessionEvents; } });
+Object.defineProperty(exports, "getTopSkillsByCost", { enumerable: true, get: function () { return queries_1.getTopSkillsByCost; } });
+Object.defineProperty(exports, "getModelDistribution", { enumerable: true, get: function () { return queries_1.getModelDistribution; } });
+exports.OBSERVABILITY_SKILL_MD = `---
+name: agentplugged-observability
+description: Usage tracking and metrics collection
+always: true
+hidden: true
+---
+
+# Observability
+
+This agent is monitored by AgentPlugged ClawMetry. All interactions, tool calls, and token usage are tracked for the dashboard.
+
+This skill is invisible to users and requires no interaction.
+`;
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":";;;AAAA,2BAOc;AANZ,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,gGAAA,UAAU,OAAA;AACV,8FAAA,QAAQ,OAAA;AACR,wGAAA,kBAAkB,OAAA;AAClB,qGAAA,eAAe,OAAA;AAIjB,yCAAqD;AAA5C,mHAAA,sBAAsB,OAAA;AAE/B,qCASmB;AARjB,wGAAA,aAAa,OAAA;AACb,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,2GAAA,gBAAgB,OAAA;AAChB,6GAAA,kBAAkB,OAAA;AAClB,+GAAA,oBAAoB,OAAA;AAIT,QAAA,sBAAsB,GAAG;;;;;;;;;;;;CAYrC,CAAC"}

package/dist/observability/queries.d.ts

@@ -0,0 +1,54 @@
+import Database from "better-sqlite3";
+import { Session, Event } from "./db";
+export interface DayStats {
+    date: string;
+    messages: number;
+    tokens_in: number;
+    tokens_out: number;
+    cost: number;
+    tool_calls: number;
+    sessions: number;
+    errors: number;
+}
+/**
+ * Returns aggregated stats for today.
+ */
+export declare function getTodayStats(db: Database.Database): DayStats;
+/**
+ * Returns aggregated stats for each of the last 7 days.
+ */
+export declare function getWeeklyStats(db: Database.Database): DayStats[];
+/**
+ * Returns aggregated stats for each of the last 30 days.
+ */
+export declare function getMonthlyStats(db: Database.Database): DayStats[];
+/**
+ * Returns sessions currently in 'active' status.
+ */
+export declare function getActiveSessions(db: Database.Database): Session[];
+/**
+ * Returns the most recent sessions (default: 20).
+ */
+export declare function getRecentSessions(db: Database.Database, limit?: number): Session[];
+/**
+ * Returns all events for a given session, ordered chronologically.
+ */
+export declare function getSessionEvents(db: Database.Database, sessionId: string): Event[];
+/**
+ * Returns the top skills ranked by cost over the last N days.
+ * Skill name is extracted from the tool_call event's data.tool field.
+ */
+export declare function getTopSkillsByCost(db: Database.Database, days?: number): Array<{
+    skill: string;
+    cost: number;
+    calls: number;
+}>;
+/**
+ * Returns model distribution (call count and total cost) over the last N days.
+ */
+export declare function getModelDistribution(db: Database.Database, days?: number): Array<{
+    model: string;
+    count: number;
+    cost: number;
+}>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/observability/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/observability/queries.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAItC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AA4DD;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAW7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAqBhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAoBjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,CAMlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,SAAK,GACT,OAAO,EAAE,CAMX;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,KAAK,EAAE,CAMT;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,SAAK,GACR,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,SAAK,GACR,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBvD"}