@mce-bt/microagents-observability 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createLogger, LogBuffer, type LoggerConfig, type LogEntry } from './logger.js';
+export { TokenTracker, BudgetExceededError, type TokenRecord, type CostSummary } from './token-tracker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createLogger, LogBuffer } from './logger.js';
+export { TokenTracker, BudgetExceededError } from './token-tracker.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAoC,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAsC,MAAM,oBAAoB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,30 @@
+import pino from 'pino';
+export interface LoggerConfig {
+    level?: string;
+    pretty?: boolean;
+    agentId?: string;
+    agentName?: string;
+}
+/**
+ * Create a structured Pino logger with agent context bindings.
+ */
+export declare function createLogger(config?: LoggerConfig): pino.Logger;
+export interface LogEntry {
+    level: string;
+    msg: string;
+    time: number;
+    [key: string]: unknown;
+}
+/**
+ * In-memory ring buffer that captures log entries for the dashboard.
+ * Wraps an existing logger interface to intercept calls.
+ */
+export declare class LogBuffer {
+    private entries;
+    private maxSize;
+    constructor(maxSize?: number);
+    write(entry: LogEntry): void;
+    getEntries(limit?: number): LogEntry[];
+    clear(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB,GAAG,IAAI,CAAC,MAAM,CAoBnE;AAID,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,SAAM;IAIzB,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAO5B,UAAU,CAAC,KAAK,SAAM,GAAG,QAAQ,EAAE;IAInC,KAAK,IAAI,IAAI;CAGd"}

package/dist/logger.js

@@ -0,0 +1,48 @@
+import pino from 'pino';
+/**
+ * Create a structured Pino logger with agent context bindings.
+ */
+export function createLogger(config = {}) {
+    const transport = config.pretty
+        ? {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                translateTime: 'SYS:standard',
+                ignore: 'pid,hostname',
+            },
+        }
+        : undefined;
+    return pino({
+        level: config.level ?? 'info',
+        ...(transport ? { transport } : {}),
+        base: {
+            ...(config.agentId ? { agentId: config.agentId } : {}),
+            ...(config.agentName ? { agentName: config.agentName } : {}),
+        },
+    });
+}
+/**
+ * In-memory ring buffer that captures log entries for the dashboard.
+ * Wraps an existing logger interface to intercept calls.
+ */
+export class LogBuffer {
+    entries = [];
+    maxSize;
+    constructor(maxSize = 500) {
+        this.maxSize = maxSize;
+    }
+    write(entry) {
+        this.entries.push(entry);
+        if (this.entries.length > this.maxSize) {
+            this.entries.shift();
+        }
+    }
+    getEntries(limit = 100) {
+        return this.entries.slice(-limit);
+    }
+    clear() {
+        this.entries = [];
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAuB,EAAE;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM;QAC7B,CAAC,CAAC;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,cAAc;gBAC7B,MAAM,EAAE,cAAc;aACvB;SACF;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,IAAI,CAAC;QACV,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM;QAC7B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,IAAI,EAAE;YACJ,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D;KACF,CAAC,CAAC;AACL,CAAC;AAWD;;;GAGG;AACH,MAAM,OAAO,SAAS;IACZ,OAAO,GAAe,EAAE,CAAC;IACzB,OAAO,CAAS;IAExB,YAAY,OAAO,GAAG,GAAG;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAe;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,UAAU,CAAC,KAAK,GAAG,GAAG;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/token-tracker.d.ts

@@ -0,0 +1,69 @@
+export interface TokenRecord {
+    timestamp: Date;
+    agentId: string;
+    sessionId?: string;
+    tier: string;
+    model: string;
+    provider: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    /** Estimated cost in USD (if pricing is configured) */
+    estimatedCostUsd?: number;
+    correlationId?: string;
+}
+export interface CostSummary {
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    totalTokens: number;
+    totalEstimatedCostUsd: number;
+    callCount: number;
+    byModel: Map<string, {
+        tokens: number;
+        calls: number;
+        costUsd: number;
+    }>;
+    byTier: Map<string, {
+        tokens: number;
+        calls: number;
+        costUsd: number;
+    }>;
+}
+/**
+ * Token and cost accounting tracker.
+ * Records every LLM call's token usage for auditing and budget control.
+ */
+export declare class TokenTracker {
+    private records;
+    private budgetLimit;
+    private totalSpent;
+    /**
+     * Set a budget limit in USD. Throws when exceeded.
+     */
+    setBudgetLimit(limitUsd: number): void;
+    /**
+     * Record a completion call's token usage.
+     */
+    record(entry: Omit<TokenRecord, 'timestamp'>): void;
+    /**
+     * Get a summary of all recorded usage.
+     */
+    getSummary(options?: {
+        agentId?: string;
+        sessionId?: string;
+    }): CostSummary;
+    /**
+     * Get all raw records.
+     */
+    getRecords(): readonly TokenRecord[];
+    /**
+     * Clear all records.
+     */
+    clear(): void;
+}
+export declare class BudgetExceededError extends Error {
+    readonly spent: number;
+    readonly limit: number;
+    constructor(message: string, spent: number, limit: number);
+}
+//# sourceMappingURL=token-tracker.d.ts.map

package/dist/token-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-tracker.d.ts","sourceRoot":"","sources":["../src/token-tracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,UAAU,CAAa;IAE/B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,IAAI;IAkBnD;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAkD3E;;OAEG;IACH,UAAU,IAAI,SAAS,WAAW,EAAE;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAM1D"}

package/dist/token-tracker.js

@@ -0,0 +1,98 @@
+/**
+ * Token and cost accounting tracker.
+ * Records every LLM call's token usage for auditing and budget control.
+ */
+export class TokenTracker {
+    records = [];
+    budgetLimit = null;
+    totalSpent = 0;
+    /**
+     * Set a budget limit in USD. Throws when exceeded.
+     */
+    setBudgetLimit(limitUsd) {
+        this.budgetLimit = limitUsd;
+    }
+    /**
+     * Record a completion call's token usage.
+     */
+    record(entry) {
+        const record = {
+            ...entry,
+            timestamp: new Date(),
+        };
+        this.records.push(record);
+        this.totalSpent += record.estimatedCostUsd ?? 0;
+        if (this.budgetLimit !== null && this.totalSpent > this.budgetLimit) {
+            throw new BudgetExceededError(`Budget limit exceeded: $${this.totalSpent.toFixed(4)} > $${this.budgetLimit.toFixed(4)}`, this.totalSpent, this.budgetLimit);
+        }
+    }
+    /**
+     * Get a summary of all recorded usage.
+     */
+    getSummary(options) {
+        let filtered = this.records;
+        if (options?.agentId) {
+            filtered = filtered.filter((r) => r.agentId === options.agentId);
+        }
+        if (options?.sessionId) {
+            filtered = filtered.filter((r) => r.sessionId === options.sessionId);
+        }
+        const byModel = new Map();
+        const byTier = new Map();
+        let totalPromptTokens = 0;
+        let totalCompletionTokens = 0;
+        let totalTokens = 0;
+        let totalEstimatedCostUsd = 0;
+        for (const record of filtered) {
+            totalPromptTokens += record.promptTokens;
+            totalCompletionTokens += record.completionTokens;
+            totalTokens += record.totalTokens;
+            totalEstimatedCostUsd += record.estimatedCostUsd ?? 0;
+            // By model
+            const modelEntry = byModel.get(record.model) ?? { tokens: 0, calls: 0, costUsd: 0 };
+            modelEntry.tokens += record.totalTokens;
+            modelEntry.calls += 1;
+            modelEntry.costUsd += record.estimatedCostUsd ?? 0;
+            byModel.set(record.model, modelEntry);
+            // By tier
+            const tierEntry = byTier.get(record.tier) ?? { tokens: 0, calls: 0, costUsd: 0 };
+            tierEntry.tokens += record.totalTokens;
+            tierEntry.calls += 1;
+            tierEntry.costUsd += record.estimatedCostUsd ?? 0;
+            byTier.set(record.tier, tierEntry);
+        }
+        return {
+            totalPromptTokens,
+            totalCompletionTokens,
+            totalTokens,
+            totalEstimatedCostUsd,
+            callCount: filtered.length,
+            byModel,
+            byTier,
+        };
+    }
+    /**
+     * Get all raw records.
+     */
+    getRecords() {
+        return this.records;
+    }
+    /**
+     * Clear all records.
+     */
+    clear() {
+        this.records = [];
+        this.totalSpent = 0;
+    }
+}
+export class BudgetExceededError extends Error {
+    spent;
+    limit;
+    constructor(message, spent, limit) {
+        super(message);
+        this.name = 'BudgetExceededError';
+        this.spent = spent;
+        this.limit = limit;
+    }
+}
+//# sourceMappingURL=token-tracker.js.map

package/dist/token-tracker.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mce-bt/microagents-observability",
+  "version": "0.1.0",
+  "description": "Structured logging, tracing, and token/cost accounting",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "pino": "^9.5.0",
+    "pino-pretty": "^13.0.0"
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cavillo/microagents.git",
+    "directory": "packages/observability"
+  },
+  "homepage": "https://github.com/cavillo/microagents#readme",
+  "bugs": {
+    "url": "https://github.com/cavillo/microagents/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}