@hardlydifficult/logger 1.0.6 → 1.0.8

package/README.md

@@ -11,15 +11,15 @@ npm install @hardlydifficult/logger
 ## Quick Start
 
 ```typescript
-import { Logger, ConsolePlugin, FilePlugin, DiscordPlugin } from "@hardlydifficult/logger";
+import { Logger, ConsolePlugin, FilePlugin } from "@hardlydifficult/logger";
 
 const logger = new Logger("info")
   .use(new ConsolePlugin())
   .use(new FilePlugin("./app.log"));
 
 logger.info("Server started", { port: 3000 });
-logger.warn("High memory usage", { usage: "85%" });
-logger.error("Request failed", { url: "/api/data", status: 500 });
+// Output to console: [2025-01-15T10:30:00.000Z] INFO: Server started {"port":3000}
+// Output to file: {"level":"info","message":"Server started","timestamp":"2025-01-15T10:30:00.000Z","context":{"port":3000}}
 ```
 
 ## Core Logger
@@ -79,9 +79,8 @@ The `formatEntry` function is also exported for custom formatting:
 
 ```typescript
 import { formatEntry } from "@hardlydifficult/logger";
-import type { LogEntry } from "@hardlydifficult/logger";
 
-const entry: LogEntry = {
+const entry = {
   level: "warn",
   message: "High memory",
   timestamp: "2025-01-15T10:30:00.000Z",
@@ -132,11 +131,13 @@ logger.notify("Deployment complete");
 
 ### Behavior
 
-- Only `warn` and `error` log entries are sent (debug/info are filtered)
-- Warn entries use ⚠️ emoji; error entries use 🚨 emoji
-- Context is formatted as a JSON code block when present
-- `notify()` sends messages directly without level filtering
-- If `setSender` is not called, entries are silently dropped
+| Behavior | Description |
+|----------|-------------|
+| Only `warn` and `error` log entries are sent (debug/info are filtered) | |
+| Warn entries use ⚠️ emoji; error entries use 🚨 emoji | |
+| Context is formatted as a JSON code block when present | |
+| `notify()` sends messages directly without level filtering | |
+| If `setSender` is not called, entries are silently dropped | |
 
 ## Custom Plugins
 

package/dist/SessionTracker.d.ts

@@ -0,0 +1,38 @@
+import type { SessionEntry, SessionEntryType, SessionInfo } from "./types.js";
+export interface SessionTrackerOptions {
+    /** Directory to store session JSONL files. */
+    stateDirectory: string;
+    /** Subdirectory within stateDirectory (default: "sessions"). */
+    subdirectory?: string;
+    /** Max age of session files before cleanup, in ms (default: 7 days). */
+    maxAgeMs?: number;
+}
+/**
+ * Append-only session logger that writes structured entries to per-session JSONL files.
+ *
+ * Each session is stored as `{stateDirectory}/{subdirectory}/{sessionId}.jsonl`
+ * with one JSON object per line. Designed for debug/analysis — capture full
+ * AI interactions (prompts, responses, tool calls) and download via API.
+ */
+export declare class SessionTracker {
+    private readonly directory;
+    private readonly maxAgeMs;
+    constructor(options: SessionTrackerOptions);
+    /** Append an entry to a session's JSONL file. Creates the file if needed. */
+    append(sessionId: string, entry: {
+        type: SessionEntryType;
+        data: Record<string, unknown>;
+    }): void;
+    /** Read all entries for a session. Returns empty array if session doesn't exist. */
+    read(sessionId: string): SessionEntry[];
+    /** List all tracked sessions with metadata, sorted by lastModifiedAt descending. */
+    list(): SessionInfo[];
+    /** Check if a session file exists. */
+    has(sessionId: string): boolean;
+    /** Delete a specific session file. Returns true if deleted. */
+    delete(sessionId: string): boolean;
+    /** Delete session files older than maxAgeMs. Returns count of deleted files. */
+    cleanup(): number;
+    private filePath;
+}
+//# sourceMappingURL=SessionTracker.d.ts.map

package/dist/SessionTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTracker.d.ts","sourceRoot":"","sources":["../src/SessionTracker.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,qBAAqB;IAc1C,6EAA6E;IAC7E,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC/D,IAAI;IAcP,oFAAoF;IACpF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAgBvC,oFAAoF;IACpF,IAAI,IAAI,WAAW,EAAE;IAkDrB,sCAAsC;IACtC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,+DAA+D;IAC/D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAalC,gFAAgF;IAChF,OAAO,IAAI,MAAM;IA4BjB,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/SessionTracker.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionTracker = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const DEFAULT_SUBDIRECTORY = "sessions";
+const DEFAULT_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const JSONL_EXTENSION = ".jsonl";
+/**
+ * Append-only session logger that writes structured entries to per-session JSONL files.
+ *
+ * Each session is stored as `{stateDirectory}/{subdirectory}/{sessionId}.jsonl`
+ * with one JSON object per line. Designed for debug/analysis — capture full
+ * AI interactions (prompts, responses, tool calls) and download via API.
+ */
+class SessionTracker {
+    directory;
+    maxAgeMs;
+    constructor(options) {
+        this.directory = (0, node_path_1.join)(options.stateDirectory, options.subdirectory ?? DEFAULT_SUBDIRECTORY);
+        this.maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
+        try {
+            (0, node_fs_1.mkdirSync)(this.directory, { recursive: true });
+        }
+        catch {
+            /* swallow — directory may already exist or be unwritable */
+        }
+    }
+    /** Append an entry to a session's JSONL file. Creates the file if needed. */
+    append(sessionId, entry) {
+        const fullEntry = {
+            type: entry.type,
+            timestamp: new Date().toISOString(),
+            data: entry.data,
+        };
+        const line = `${JSON.stringify(fullEntry)}\n`;
+        try {
+            (0, node_fs_1.appendFileSync)(this.filePath(sessionId), line);
+        }
+        catch {
+            /* swallow — same as FilePlugin */
+        }
+    }
+    /** Read all entries for a session. Returns empty array if session doesn't exist. */
+    read(sessionId) {
+        const fp = this.filePath(sessionId);
+        if (!(0, node_fs_1.existsSync)(fp)) {
+            return [];
+        }
+        try {
+            const content = (0, node_fs_1.readFileSync)(fp, "utf-8");
+            return content
+                .split("\n")
+                .filter((line) => line.length > 0)
+                .map((line) => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** List all tracked sessions with metadata, sorted by lastModifiedAt descending. */
+    list() {
+        if (!(0, node_fs_1.existsSync)(this.directory)) {
+            return [];
+        }
+        try {
+            const files = (0, node_fs_1.readdirSync)(this.directory).filter((f) => f.endsWith(JSONL_EXTENSION));
+            const sessions = [];
+            for (const file of files) {
+                const fp = (0, node_path_1.join)(this.directory, file);
+                try {
+                    const stat = (0, node_fs_1.statSync)(fp);
+                    const content = (0, node_fs_1.readFileSync)(fp, "utf-8");
+                    const lines = content.split("\n").filter((l) => l.length > 0);
+                    let startedAt = stat.birthtime.toISOString();
+                    if (lines.length > 0) {
+                        try {
+                            const first = JSON.parse(lines[0]);
+                            startedAt = first.timestamp;
+                        }
+                        catch {
+                            /* use birthtime */
+                        }
+                    }
+                    sessions.push({
+                        sessionId: file.slice(0, -JSONL_EXTENSION.length),
+                        sizeBytes: stat.size,
+                        startedAt,
+                        lastModifiedAt: stat.mtime.toISOString(),
+                        entryCount: lines.length,
+                    });
+                }
+                catch {
+                    /* skip unreadable files */
+                }
+            }
+            sessions.sort((a, b) => new Date(b.lastModifiedAt).getTime() -
+                new Date(a.lastModifiedAt).getTime());
+            return sessions;
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Check if a session file exists. */
+    has(sessionId) {
+        return (0, node_fs_1.existsSync)(this.filePath(sessionId));
+    }
+    /** Delete a specific session file. Returns true if deleted. */
+    delete(sessionId) {
+        const fp = this.filePath(sessionId);
+        if (!(0, node_fs_1.existsSync)(fp)) {
+            return false;
+        }
+        try {
+            (0, node_fs_1.unlinkSync)(fp);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Delete session files older than maxAgeMs. Returns count of deleted files. */
+    cleanup() {
+        if (!(0, node_fs_1.existsSync)(this.directory)) {
+            return 0;
+        }
+        let deleted = 0;
+        const cutoff = Date.now() - this.maxAgeMs;
+        try {
+            const files = (0, node_fs_1.readdirSync)(this.directory).filter((f) => f.endsWith(JSONL_EXTENSION));
+            for (const file of files) {
+                const fp = (0, node_path_1.join)(this.directory, file);
+                try {
+                    const stat = (0, node_fs_1.statSync)(fp);
+                    if (stat.mtime.getTime() < cutoff) {
+                        (0, node_fs_1.unlinkSync)(fp);
+                        deleted++;
+                    }
+                }
+                catch {
+                    /* skip */
+                }
+            }
+        }
+        catch {
+            /* swallow */
+        }
+        return deleted;
+    }
+    filePath(sessionId) {
+        return (0, node_path_1.join)(this.directory, `${sessionId}${JSONL_EXTENSION}`);
+    }
+}
+exports.SessionTracker = SessionTracker;
+//# sourceMappingURL=SessionTracker.js.map

package/dist/SessionTracker.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-/** Structured logging with pluggable outputs. */
+/** Structured logging with pluggable outputs and session tracking. */
 export { Logger } from "./Logger.js";
 export { ConsolePlugin, formatEntry } from "./plugins/ConsolePlugin.js";
 export { DiscordPlugin, type DiscordSender } from "./plugins/DiscordPlugin.js";
 export { FilePlugin } from "./plugins/FilePlugin.js";
+export { SessionTracker } from "./SessionTracker.js";
 export type { LogLevel, LogEntry, LoggerPlugin } from "./types.js";
+export type { SessionEntry, SessionEntryType, SessionInfo } from "./types.js";
+export type { SessionTrackerOptions } from "./SessionTracker.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FilePlugin = exports.DiscordPlugin = exports.formatEntry = exports.ConsolePlugin = exports.Logger = void 0;
-/** Structured logging with pluggable outputs. */
+exports.SessionTracker = exports.FilePlugin = exports.DiscordPlugin = exports.formatEntry = exports.ConsolePlugin = exports.Logger = void 0;
+/** Structured logging with pluggable outputs and session tracking. */
 var Logger_js_1 = require("./Logger.js");
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_js_1.Logger; } });
 var ConsolePlugin_js_1 = require("./plugins/ConsolePlugin.js");
@@ -11,4 +11,6 @@ var DiscordPlugin_js_1 = require("./plugins/DiscordPlugin.js");
 Object.defineProperty(exports, "DiscordPlugin", { enumerable: true, get: function () { return DiscordPlugin_js_1.DiscordPlugin; } });
 var FilePlugin_js_1 = require("./plugins/FilePlugin.js");
 Object.defineProperty(exports, "FilePlugin", { enumerable: true, get: function () { return FilePlugin_js_1.FilePlugin; } });
+var SessionTracker_js_1 = require("./SessionTracker.js");
+Object.defineProperty(exports, "SessionTracker", { enumerable: true, get: function () { return SessionTracker_js_1.SessionTracker; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,+DAAwE;AAA/D,iHAAA,aAAa,OAAA;AAAE,+GAAA,WAAW,OAAA;AACnC,+DAA+E;AAAtE,iHAAA,aAAa,OAAA;AACtB,yDAAqD;AAA5C,2GAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,sEAAsE;AACtE,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,+DAAwE;AAA/D,iHAAA,aAAa,OAAA;AAAE,+GAAA,WAAW,OAAA;AACnC,+DAA+E;AAAtE,iHAAA,aAAa,OAAA;AACtB,yDAAqD;AAA5C,2GAAA,UAAU,OAAA;AACnB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA"}

package/dist/types.d.ts

@@ -11,4 +11,20 @@ export interface LoggerPlugin {
     /** Called for notify() — out-of-band notifications. Optional. */
     notify?(message: string): void;
 }
+/** Entry type discriminator for session log entries. */
+export type SessionEntryType = "session_start" | "ai_request" | "ai_response" | "tool_call" | "tool_result" | "error" | "session_end" | "metadata";
+/** A single entry in a debug session log (persisted as one JSONL line). */
+export interface SessionEntry {
+    readonly type: SessionEntryType;
+    readonly timestamp: string;
+    readonly data: Record<string, unknown>;
+}
+/** Summary info about a persisted session file. */
+export interface SessionInfo {
+    readonly sessionId: string;
+    readonly sizeBytes: number;
+    readonly startedAt: string;
+    readonly lastModifiedAt: string;
+    readonly entryCount: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAMD,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,YAAY,GACZ,aAAa,GACb,WAAW,GACX,aAAa,GACb,OAAO,GACP,aAAa,GACb,UAAU,CAAC;AAEf,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/logger",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [