@snap-agent/analytics-console 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 ViloTech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,195 @@
+# @snap-agent/analytics-console
+
+Console analytics plugin for SnapAgent SDK - Pretty-print metrics to terminal for debugging.
+
+## Features
+
+- **Pretty Console Output** - Color-coded, formatted logs
+- **Three Log Levels** - Minimal, standard, verbose
+- **Periodic Summaries** - Automatic stats output
+- **Colorful** - Easy to scan terminal output
+- **Perfect for Dev** - Quick debugging during development  
+
+## Installation
+
+```bash
+npm install @snap-agent/analytics-console @snap-agent/core
+```
+
+## Quick Start
+
+```typescript
+import { createClient, MemoryStorage } from '@snap-agent/core';
+import { ConsoleAnalytics } from '@snap-agent/analytics-console';
+
+const client = createClient({
+  storage: new MemoryStorage(),
+  providers: {
+    openai: { apiKey: process.env.OPENAI_API_KEY! },
+  },
+});
+
+const agent = await client.createAgent({
+  name: 'Debug Demo',
+  instructions: 'You are helpful.',
+  model: 'gpt-4o',
+  userId: 'user-123',
+  plugins: [
+    new ConsoleAnalytics({
+      level: 'verbose',
+    }),
+  ],
+});
+
+// Use the agent - see pretty logs!
+```
+
+## Output Examples
+
+### Standard Level
+```
+[14:32:15.123] [SnapAgent] -> Request agent:abc12345 thread:xyz98765
+[14:32:16.456] [SnapAgent] <- Response 1333ms 450 tokens agent:abc12345
+```
+
+### Verbose Level
+```
+[14:32:15.123] [SnapAgent] -> Request agent:abc12345 thread:xyz98765
+  Message: Hello, can you help me with...
+
+[14:32:16.456] [SnapAgent] <- Response 1333ms 450 tokens agent:abc12345
+  Response: Of course! I'd be happy to help you with...
+```
+
+### Error
+```
+[14:32:17.789] [SnapAgent] x Error rate_limit agent:abc12345
+  Message: Rate limit exceeded. Please retry after 60 seconds.
+```
+
+### Summary
+```
+[SnapAgent] Summary
+----------------------------------------
+  Requests:      25
+  Responses:     24
+  Errors:        1
+  Avg Latency:   892ms
+  Avg Tokens:    380
+  Total Tokens:  9120
+----------------------------------------
+```
+
+## Configuration
+
+```typescript
+new ConsoleAnalytics({
+  // Log level: 'minimal' | 'standard' | 'verbose'
+  level: 'standard',
+
+  // Enable colored output
+  colors: true,
+
+  // Show timestamps
+  timestamps: true,
+
+  // Custom prefix
+  prefix: '[SnapAgent]',
+
+  // What to log
+  logRequests: true,
+  logResponses: true,
+  logErrors: true,
+
+  // Print summary every N ms (0 = disabled)
+  summaryInterval: 60000, // Every minute
+});
+```
+
+## Log Levels
+
+### `minimal`
+Just counts, no details:
+```
+[SnapAgent] -> Request
+[SnapAgent] <- Response 450ms
+```
+
+### `standard` (default)
+Includes agent/thread IDs and tokens:
+```
+[SnapAgent] -> Request agent:abc12345 thread:xyz98765
+[SnapAgent] <- Response 450ms 380 tokens agent:abc12345
+```
+
+### `verbose`
+Full message content:
+```
+[SnapAgent] -> Request agent:abc12345 thread:xyz98765
+  Message: What is the weather like today?
+
+[SnapAgent] <- Response 450ms 380 tokens agent:abc12345
+  Response: I don't have access to real-time weather data...
+```
+
+## API
+
+### `printSummary()`
+Manually print the current summary:
+```typescript
+const analytics = new ConsoleAnalytics();
+// ... use agent ...
+analytics.printSummary();
+```
+
+### `reset()`
+Reset all counters:
+```typescript
+analytics.reset();
+```
+
+### `getStats()`
+Get current stats as object:
+```typescript
+const stats = analytics.getStats();
+// { requests: 25, responses: 24, errors: 1, avgLatency: 892, totalTokens: 9120 }
+```
+
+### `destroy()`
+Clean up (stops summary timer):
+```typescript
+analytics.destroy();
+```
+
+## Color Reference
+
+| Color | Meaning |
+|-------|---------|
+| Cyan | Requests |
+| Green | Successful responses, fast latency (<500ms) |
+| Yellow | Medium latency (500-2000ms) |
+| Red | Errors, slow latency (>2000ms) |
+| Dim | Metadata, IDs |
+
+## Disable Colors
+
+For CI/CD or piping to files:
+```typescript
+new ConsoleAnalytics({
+  colors: false,
+});
+```
+
+## Use Cases
+
+- **Local Development** - Quick visibility into agent behavior
+- **Debugging** - See what's happening in real-time
+- **Demos** - Show activity during presentations
+- **Learning** - Understand the request/response flow
+
+For production monitoring, use [@snap-agent/analytics](../core) instead.
+
+## License
+
+MIT © ViloTech
+

package/dist/index.d.mts

@@ -0,0 +1,111 @@
+import { AnalyticsPlugin } from '@snap-agent/core';
+
+type LogLevel = 'minimal' | 'standard' | 'verbose';
+interface ConsoleAnalyticsConfig {
+    /**
+     * Log level
+     * - minimal: Just request/response counts
+     * - standard: Include latency and tokens
+     * - verbose: Include all details
+     * @default 'standard'
+     */
+    level?: LogLevel;
+    /**
+     * Enable colored output
+     * @default true
+     */
+    colors?: boolean;
+    /**
+     * Show timestamps
+     * @default true
+     */
+    timestamps?: boolean;
+    /**
+     * Prefix for log messages
+     * @default '[SnapAgent]'
+     */
+    prefix?: string;
+    /**
+     * Log requests
+     * @default true
+     */
+    logRequests?: boolean;
+    /**
+     * Log responses
+     * @default true
+     */
+    logResponses?: boolean;
+    /**
+     * Log errors
+     * @default true
+     */
+    logErrors?: boolean;
+    /**
+     * Show periodic summaries (interval in ms, 0 = disabled)
+     * @default 0
+     */
+    summaryInterval?: number;
+}
+/**
+ * Console Analytics Plugin
+ *
+ * Simple plugin that pretty-prints analytics to the console.
+ * Perfect for development and debugging.
+ */
+declare class ConsoleAnalytics implements AnalyticsPlugin {
+    name: string;
+    type: "analytics";
+    private config;
+    private requestCount;
+    private responseCount;
+    private errorCount;
+    private totalLatency;
+    private totalTokens;
+    private summaryTimer?;
+    constructor(config?: ConsoleAnalyticsConfig);
+    trackRequest(data: {
+        agentId: string;
+        threadId?: string;
+        message: string;
+        timestamp: Date;
+    }): Promise<void>;
+    trackResponse(data: {
+        agentId: string;
+        threadId?: string;
+        response: string;
+        latency: number;
+        tokensUsed?: number;
+        timestamp: Date;
+    }): Promise<void>;
+    trackError(data: {
+        agentId: string;
+        threadId?: string;
+        timestamp: Date;
+        errorType: string;
+        errorMessage: string;
+    }): Promise<void>;
+    printSummary(): void;
+    /**
+     * Reset counters
+     */
+    reset(): void;
+    /**
+     * Get current stats
+     */
+    getStats(): Record<string, number>;
+    /**
+     * Stop summary timer
+     */
+    destroy(): void;
+    private formatTime;
+    private truncate;
+    private formatLatency;
+    private bold;
+    private dim;
+    private green;
+    private yellow;
+    private red;
+    private cyan;
+}
+
+export { ConsoleAnalytics, type ConsoleAnalyticsConfig, type LogLevel };

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+import { AnalyticsPlugin } from '@snap-agent/core';
+
+type LogLevel = 'minimal' | 'standard' | 'verbose';
+interface ConsoleAnalyticsConfig {
+    /**
+     * Log level
+     * - minimal: Just request/response counts
+     * - standard: Include latency and tokens
+     * - verbose: Include all details
+     * @default 'standard'
+     */
+    level?: LogLevel;
+    /**
+     * Enable colored output
+     * @default true
+     */
+    colors?: boolean;
+    /**
+     * Show timestamps
+     * @default true
+     */
+    timestamps?: boolean;
+    /**
+     * Prefix for log messages
+     * @default '[SnapAgent]'
+     */
+    prefix?: string;
+    /**
+     * Log requests
+     * @default true
+     */
+    logRequests?: boolean;
+    /**
+     * Log responses
+     * @default true
+     */
+    logResponses?: boolean;
+    /**
+     * Log errors
+     * @default true
+     */
+    logErrors?: boolean;
+    /**
+     * Show periodic summaries (interval in ms, 0 = disabled)
+     * @default 0
+     */
+    summaryInterval?: number;
+}
+/**
+ * Console Analytics Plugin
+ *
+ * Simple plugin that pretty-prints analytics to the console.
+ * Perfect for development and debugging.
+ */
+declare class ConsoleAnalytics implements AnalyticsPlugin {
+    name: string;
+    type: "analytics";
+    private config;
+    private requestCount;
+    private responseCount;
+    private errorCount;
+    private totalLatency;
+    private totalTokens;
+    private summaryTimer?;
+    constructor(config?: ConsoleAnalyticsConfig);
+    trackRequest(data: {
+        agentId: string;
+        threadId?: string;
+        message: string;
+        timestamp: Date;
+    }): Promise<void>;
+    trackResponse(data: {
+        agentId: string;
+        threadId?: string;
+        response: string;
+        latency: number;
+        tokensUsed?: number;
+        timestamp: Date;
+    }): Promise<void>;
+    trackError(data: {
+        agentId: string;
+        threadId?: string;
+        timestamp: Date;
+        errorType: string;
+        errorMessage: string;
+    }): Promise<void>;
+    printSummary(): void;
+    /**
+     * Reset counters
+     */
+    reset(): void;
+    /**
+     * Get current stats
+     */
+    getStats(): Record<string, number>;
+    /**
+     * Stop summary timer
+     */
+    destroy(): void;
+    private formatTime;
+    private truncate;
+    private formatLatency;
+    private bold;
+    private dim;
+    private green;
+    private yellow;
+    private red;
+    private cyan;
+}
+
+export { ConsoleAnalytics, type ConsoleAnalyticsConfig, type LogLevel };

package/dist/index.js

@@ -0,0 +1,214 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ConsoleAnalytics: () => ConsoleAnalytics
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/ConsoleAnalytics.ts
+var ConsoleAnalytics = class {
+  constructor(config = {}) {
+    this.name = "console-analytics";
+    this.type = "analytics";
+    this.requestCount = 0;
+    this.responseCount = 0;
+    this.errorCount = 0;
+    this.totalLatency = 0;
+    this.totalTokens = 0;
+    this.config = {
+      level: config.level || "standard",
+      colors: config.colors !== false,
+      timestamps: config.timestamps !== false,
+      prefix: config.prefix || "[SnapAgent]",
+      logRequests: config.logRequests !== false,
+      logResponses: config.logResponses !== false,
+      logErrors: config.logErrors !== false,
+      summaryInterval: config.summaryInterval || 0
+    };
+    if (this.config.summaryInterval > 0) {
+      this.summaryTimer = setInterval(
+        () => this.printSummary(),
+        this.config.summaryInterval
+      );
+    }
+  }
+  // ============================================================================
+  // Plugin Interface
+  // ============================================================================
+  async trackRequest(data) {
+    this.requestCount++;
+    if (!this.config.logRequests) return;
+    const parts = [];
+    if (this.config.timestamps) {
+      parts.push(this.dim(`[${this.formatTime(data.timestamp)}]`));
+    }
+    parts.push(this.config.prefix);
+    parts.push(this.cyan("\u2192 Request"));
+    if (this.config.level !== "minimal") {
+      parts.push(this.dim(`agent:${data.agentId.slice(0, 8)}`));
+      if (data.threadId) {
+        parts.push(this.dim(`thread:${data.threadId.slice(0, 8)}`));
+      }
+    }
+    if (this.config.level === "verbose") {
+      parts.push(`
+  ${this.dim("Message:")} ${this.truncate(data.message, 100)}`);
+    }
+    console.log(parts.join(" "));
+  }
+  async trackResponse(data) {
+    this.responseCount++;
+    this.totalLatency += data.latency;
+    this.totalTokens += data.tokensUsed || 0;
+    if (!this.config.logResponses) return;
+    const parts = [];
+    if (this.config.timestamps) {
+      parts.push(this.dim(`[${this.formatTime(data.timestamp)}]`));
+    }
+    parts.push(this.config.prefix);
+    parts.push(this.green("\u2190 Response"));
+    const latencyColor = data.latency < 500 ? "green" : data.latency < 2e3 ? "yellow" : "red";
+    parts.push(this[latencyColor](`${data.latency}ms`));
+    if (this.config.level !== "minimal" && data.tokensUsed) {
+      parts.push(this.dim(`${data.tokensUsed} tokens`));
+    }
+    if (this.config.level !== "minimal") {
+      parts.push(this.dim(`agent:${data.agentId.slice(0, 8)}`));
+    }
+    if (this.config.level === "verbose") {
+      parts.push(`
+  ${this.dim("Response:")} ${this.truncate(data.response, 150)}`);
+    }
+    console.log(parts.join(" "));
+  }
+  // ============================================================================
+  // Extended Tracking (Optional)
+  // ============================================================================
+  async trackError(data) {
+    this.errorCount++;
+    if (!this.config.logErrors) return;
+    const parts = [];
+    if (this.config.timestamps) {
+      parts.push(this.dim(`[${this.formatTime(data.timestamp)}]`));
+    }
+    parts.push(this.config.prefix);
+    parts.push(this.red("x Error"));
+    parts.push(this.red(data.errorType));
+    if (this.config.level !== "minimal") {
+      parts.push(this.dim(`agent:${data.agentId.slice(0, 8)}`));
+    }
+    if (this.config.level === "verbose") {
+      parts.push(`
+  ${this.dim("Message:")} ${data.errorMessage}`);
+    }
+    console.log(parts.join(" "));
+  }
+  // ============================================================================
+  // Summary
+  // ============================================================================
+  printSummary() {
+    const avgLatency = this.responseCount > 0 ? Math.round(this.totalLatency / this.responseCount) : 0;
+    const avgTokens = this.responseCount > 0 ? Math.round(this.totalTokens / this.responseCount) : 0;
+    console.log("");
+    console.log(this.bold(`${this.config.prefix} Summary`));
+    console.log(this.dim("\u2500".repeat(40)));
+    console.log(`  Requests:      ${this.cyan(this.requestCount.toString())}`);
+    console.log(`  Responses:     ${this.green(this.responseCount.toString())}`);
+    console.log(`  Errors:        ${this.errorCount > 0 ? this.red(this.errorCount.toString()) : this.dim("0")}`);
+    console.log(`  Avg Latency:   ${this.formatLatency(avgLatency)}`);
+    console.log(`  Avg Tokens:    ${this.dim(avgTokens.toString())}`);
+    console.log(`  Total Tokens:  ${this.dim(this.totalTokens.toString())}`);
+    console.log(this.dim("\u2500".repeat(40)));
+    console.log("");
+  }
+  /**
+   * Reset counters
+   */
+  reset() {
+    this.requestCount = 0;
+    this.responseCount = 0;
+    this.errorCount = 0;
+    this.totalLatency = 0;
+    this.totalTokens = 0;
+  }
+  /**
+   * Get current stats
+   */
+  getStats() {
+    return {
+      requests: this.requestCount,
+      responses: this.responseCount,
+      errors: this.errorCount,
+      avgLatency: this.responseCount > 0 ? Math.round(this.totalLatency / this.responseCount) : 0,
+      totalTokens: this.totalTokens
+    };
+  }
+  /**
+   * Stop summary timer
+   */
+  destroy() {
+    if (this.summaryTimer) {
+      clearInterval(this.summaryTimer);
+    }
+  }
+  // ============================================================================
+  // Formatting Helpers
+  // ============================================================================
+  formatTime(date) {
+    return date.toISOString().slice(11, 23);
+  }
+  truncate(str, maxLen) {
+    const cleaned = str.replace(/\n/g, " ").trim();
+    if (cleaned.length <= maxLen) return cleaned;
+    return cleaned.slice(0, maxLen - 3) + "...";
+  }
+  formatLatency(ms) {
+    if (ms < 500) return this.green(`${ms}ms`);
+    if (ms < 2e3) return this.yellow(`${ms}ms`);
+    return this.red(`${ms}ms`);
+  }
+  // ============================================================================
+  // Color Helpers
+  // ============================================================================
+  bold(text) {
+    return this.config.colors ? `\x1B[1m${text}\x1B[0m` : text;
+  }
+  dim(text) {
+    return this.config.colors ? `\x1B[2m${text}\x1B[0m` : text;
+  }
+  green(text) {
+    return this.config.colors ? `\x1B[32m${text}\x1B[0m` : text;
+  }
+  yellow(text) {
+    return this.config.colors ? `\x1B[33m${text}\x1B[0m` : text;
+  }
+  red(text) {
+    return this.config.colors ? `\x1B[31m${text}\x1B[0m` : text;
+  }
+  cyan(text) {
+    return this.config.colors ? `\x1B[36m${text}\x1B[0m` : text;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConsoleAnalytics
+});

package/dist/index.mjs

@@ -0,0 +1,187 @@
+// src/ConsoleAnalytics.ts
+var ConsoleAnalytics = class {
+  constructor(config = {}) {
+    this.name = "console-analytics";
+    this.type = "analytics";
+    this.requestCount = 0;
+    this.responseCount = 0;
+    this.errorCount = 0;
+    this.totalLatency = 0;
+    this.totalTokens = 0;
+    this.config = {
+      level: config.level || "standard",
+      colors: config.colors !== false,
+      timestamps: config.timestamps !== false,
+      prefix: config.prefix || "[SnapAgent]",
+      logRequests: config.logRequests !== false,
+      logResponses: config.logResponses !== false,
+      logErrors: config.logErrors !== false,
+      summaryInterval: config.summaryInterval || 0
+    };
+    if (this.config.summaryInterval > 0) {
+      this.summaryTimer = setInterval(
+        () => this.printSummary(),
+        this.config.summaryInterval
+      );
+    }
+  }
+  // ============================================================================
+  // Plugin Interface
+  // ============================================================================
+  async trackRequest(data) {
+    this.requestCount++;
+    if (!this.config.logRequests) return;
+    const parts = [];
+    if (this.config.timestamps) {
+      parts.push(this.dim(`[${this.formatTime(data.timestamp)}]`));
+    }
+    parts.push(this.config.prefix);
+    parts.push(this.cyan("\u2192 Request"));
+    if (this.config.level !== "minimal") {
+      parts.push(this.dim(`agent:${data.agentId.slice(0, 8)}`));
+      if (data.threadId) {
+        parts.push(this.dim(`thread:${data.threadId.slice(0, 8)}`));
+      }
+    }
+    if (this.config.level === "verbose") {
+      parts.push(`
+  ${this.dim("Message:")} ${this.truncate(data.message, 100)}`);
+    }
+    console.log(parts.join(" "));
+  }
+  async trackResponse(data) {
+    this.responseCount++;
+    this.totalLatency += data.latency;
+    this.totalTokens += data.tokensUsed || 0;
+    if (!this.config.logResponses) return;
+    const parts = [];
+    if (this.config.timestamps) {
+      parts.push(this.dim(`[${this.formatTime(data.timestamp)}]`));
+    }
+    parts.push(this.config.prefix);
+    parts.push(this.green("\u2190 Response"));
+    const latencyColor = data.latency < 500 ? "green" : data.latency < 2e3 ? "yellow" : "red";
+    parts.push(this[latencyColor](`${data.latency}ms`));
+    if (this.config.level !== "minimal" && data.tokensUsed) {
+      parts.push(this.dim(`${data.tokensUsed} tokens`));
+    }
+    if (this.config.level !== "minimal") {
+      parts.push(this.dim(`agent:${data.agentId.slice(0, 8)}`));
+    }
+    if (this.config.level === "verbose") {
+      parts.push(`
+  ${this.dim("Response:")} ${this.truncate(data.response, 150)}`);
+    }
+    console.log(parts.join(" "));
+  }
+  // ============================================================================
+  // Extended Tracking (Optional)
+  // ============================================================================
+  async trackError(data) {
+    this.errorCount++;
+    if (!this.config.logErrors) return;
+    const parts = [];
+    if (this.config.timestamps) {
+      parts.push(this.dim(`[${this.formatTime(data.timestamp)}]`));
+    }
+    parts.push(this.config.prefix);
+    parts.push(this.red("x Error"));
+    parts.push(this.red(data.errorType));
+    if (this.config.level !== "minimal") {
+      parts.push(this.dim(`agent:${data.agentId.slice(0, 8)}`));
+    }
+    if (this.config.level === "verbose") {
+      parts.push(`
+  ${this.dim("Message:")} ${data.errorMessage}`);
+    }
+    console.log(parts.join(" "));
+  }
+  // ============================================================================
+  // Summary
+  // ============================================================================
+  printSummary() {
+    const avgLatency = this.responseCount > 0 ? Math.round(this.totalLatency / this.responseCount) : 0;
+    const avgTokens = this.responseCount > 0 ? Math.round(this.totalTokens / this.responseCount) : 0;
+    console.log("");
+    console.log(this.bold(`${this.config.prefix} Summary`));
+    console.log(this.dim("\u2500".repeat(40)));
+    console.log(`  Requests:      ${this.cyan(this.requestCount.toString())}`);
+    console.log(`  Responses:     ${this.green(this.responseCount.toString())}`);
+    console.log(`  Errors:        ${this.errorCount > 0 ? this.red(this.errorCount.toString()) : this.dim("0")}`);
+    console.log(`  Avg Latency:   ${this.formatLatency(avgLatency)}`);
+    console.log(`  Avg Tokens:    ${this.dim(avgTokens.toString())}`);
+    console.log(`  Total Tokens:  ${this.dim(this.totalTokens.toString())}`);
+    console.log(this.dim("\u2500".repeat(40)));
+    console.log("");
+  }
+  /**
+   * Reset counters
+   */
+  reset() {
+    this.requestCount = 0;
+    this.responseCount = 0;
+    this.errorCount = 0;
+    this.totalLatency = 0;
+    this.totalTokens = 0;
+  }
+  /**
+   * Get current stats
+   */
+  getStats() {
+    return {
+      requests: this.requestCount,
+      responses: this.responseCount,
+      errors: this.errorCount,
+      avgLatency: this.responseCount > 0 ? Math.round(this.totalLatency / this.responseCount) : 0,
+      totalTokens: this.totalTokens
+    };
+  }
+  /**
+   * Stop summary timer
+   */
+  destroy() {
+    if (this.summaryTimer) {
+      clearInterval(this.summaryTimer);
+    }
+  }
+  // ============================================================================
+  // Formatting Helpers
+  // ============================================================================
+  formatTime(date) {
+    return date.toISOString().slice(11, 23);
+  }
+  truncate(str, maxLen) {
+    const cleaned = str.replace(/\n/g, " ").trim();
+    if (cleaned.length <= maxLen) return cleaned;
+    return cleaned.slice(0, maxLen - 3) + "...";
+  }
+  formatLatency(ms) {
+    if (ms < 500) return this.green(`${ms}ms`);
+    if (ms < 2e3) return this.yellow(`${ms}ms`);
+    return this.red(`${ms}ms`);
+  }
+  // ============================================================================
+  // Color Helpers
+  // ============================================================================
+  bold(text) {
+    return this.config.colors ? `\x1B[1m${text}\x1B[0m` : text;
+  }
+  dim(text) {
+    return this.config.colors ? `\x1B[2m${text}\x1B[0m` : text;
+  }
+  green(text) {
+    return this.config.colors ? `\x1B[32m${text}\x1B[0m` : text;
+  }
+  yellow(text) {
+    return this.config.colors ? `\x1B[33m${text}\x1B[0m` : text;
+  }
+  red(text) {
+    return this.config.colors ? `\x1B[31m${text}\x1B[0m` : text;
+  }
+  cyan(text) {
+    return this.config.colors ? `\x1B[36m${text}\x1B[0m` : text;
+  }
+};
+export {
+  ConsoleAnalytics
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@snap-agent/analytics-console",
+  "version": "0.1.0",
+  "description": "Console analytics plugin for SnapAgent SDK - Pretty-print metrics to terminal for debugging",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "snap-agent",
+    "analytics",
+    "console",
+    "debugging",
+    "logging",
+    "metrics"
+  ],
+  "author": "ViloTech",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@snap-agent/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vilo-hq/snap-agent.git",
+    "directory": "plugins/analytics/console"
+  },
+  "homepage": "https://github.com/vilo-hq/snap-agent/tree/main/plugins/analytics/console",
+  "bugs": {
+    "url": "https://github.com/vilo-hq/snap-agent/issues"
+  }
+}
+