@diegoaltoworks/chatter 0.60.0 → 0.62.0

package/dist/mcp-server/index.d.ts

@@ -4,9 +4,9 @@
  * Modular implementation of the Model Context Protocol server
  */
 export { createMCPServer } from "../mcp-server";
-export * from "./conversation-id";
-export * from "./cost-tracker";
-export * from "./logger";
-export * from "./rate-limiter";
-export * from "./types";
+export { generateConversationId, getOrGenerateConversationId, isValidConversationId, } from "./conversation-id";
+export { calculateCost, formatCost, getCostSummary } from "./cost-tracker";
+export { createLogger, MCPLogger } from "./logger";
+export { createMcpRateLimiter, DEFAULT_WINDOW_MS, RateLimiter } from "./rate-limiter";
+export type { ChatMessage, CostInfo, MCPLogCallback, MCPServerOptions, MCPToolConfig, MCPTransportMode, PricingRates, ToolContext, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAElC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAE/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtF,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/mcp-server/logger.d.ts

@@ -5,12 +5,21 @@ import { type Logger } from "../core/logger";
 import type { ChatMessage, CostInfo, MCPLogCallback } from "./types";
 /**
  * Logger for MCP chat interactions
+ *
+ * What a tool call *said* and what it *cost* are separated on purpose. The
+ * console line is on by default, so it carries metadata only (tool, ids,
+ * sizes, timings, tokens) and never the conversation, the retrieved context
+ * or the answer. Content is emitted only when a host opts in with
+ * `logging.content`, and then at `debug`, so the default log level keeps it
+ * off even after the opt-in. Whatever does get emitted - console line or
+ * `onChat` callback - is scrubbed of credentials first.
  */
 export declare class MCPLogger {
     private enableConsole;
     private callback?;
     private logger;
-    constructor(enableConsole?: boolean, callback?: MCPLogCallback, logger?: Logger);
+    private logContent;
+    constructor(enableConsole?: boolean, callback?: MCPLogCallback, logger?: Logger, logContent?: boolean);
     /**
      * Log a chat interaction
      */
@@ -22,7 +31,8 @@ export declare class MCPLogger {
  * @param enableConsole - Enable console logging
  * @param callback - Custom logging callback
  * @param logger - Logger implementation. Default: a console logger writing to stderr.
+ * @param logContent - Also emit conversation content, at `debug`. Default: false.
  * @returns MCPLogger instance
  */
-export declare function createLogger(enableConsole?: boolean, callback?: MCPLogCallback, logger?: Logger): MCPLogger;
+export declare function createLogger(enableConsole?: boolean, callback?: MCPLogCallback, logger?: Logger, logContent?: boolean): MCPLogger;
 //# sourceMappingURL=logger.d.ts.map

package/dist/mcp-server/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/mcp-server/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,aAAa,UAAO,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,EAI3E;IAED;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,WAAW,EAAE,EACnC,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAkCf;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,aAAa,UAAO,EACpB,QAAQ,CAAC,EAAE,cAAc,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,SAAS,CAEX"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/mcp-server/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAU;IAE5B,YACE,aAAa,UAAO,EACpB,QAAQ,CAAC,EAAE,cAAc,EACzB,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,UAAQ,EAMnB;IAED;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,WAAW,EAAE,EACnC,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CA6Df;CACF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,aAAa,UAAO,EACpB,QAAQ,CAAC,EAAE,cAAc,EACzB,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,UAAQ,GACjB,SAAS,CAEX"}

package/dist/mcp-server/rate-limiter.d.ts

@@ -2,6 +2,8 @@
  * Rate Limiting for MCP Tools
  * Simple in-memory sliding window implementation
  */
+/** Default sliding-window size: 1 minute. */
+export declare const DEFAULT_WINDOW_MS = 60000;
 /**
  * Rate limiter using sliding window algorithm
  */
@@ -13,7 +15,7 @@ export declare class RateLimiter {
      * Create a new rate limiter
      *
      * @param limit - Maximum requests allowed in the time window
-     * @param windowMs - Time window in milliseconds (default: 60000 = 1 minute)
+     * @param windowMs - Time window in milliseconds (default: `DEFAULT_WINDOW_MS`)
      */
     constructor(limit: number, windowMs?: number);
     /**
@@ -49,11 +51,16 @@ export declare class RateLimiter {
     getTimeUntilReset(key: string): number;
 }
 /**
- * Create a rate limiter if limit is specified
+ * Create a rate limiter if limit is specified.
+ *
+ * Named `createMcpRateLimiter` (not `createRateLimiter`) so it doesn't
+ * collide with `middleware/ratelimit.ts`'s `createRateLimiter` - an
+ * unrelated HTTP rate limiter with a different signature and return type,
+ * easy to import the wrong one of by name alone.
  *
  * @param limit - Maximum requests per window, or undefined for no limit
  * @param windowMs - Time window in milliseconds
  * @returns RateLimiter instance or null if no limit specified
  */
-export declare function createRateLimiter(limit: number | undefined, windowMs?: number): RateLimiter | null;
+export declare function createMcpRateLimiter(limit: number | undefined, windowMs?: number): RateLimiter | null;
 //# sourceMappingURL=rate-limiter.d.ts.map

package/dist/mcp-server/rate-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/mcp-server/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;;;OAKG;IACH,YAAY,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAQ,EAI1C;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAoB1B;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5B;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED;;OAEG;IACH,QAAQ,IAAI,IAAI,CAEf;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASrC;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAQ,GAAG,WAAW,GAAG,IAAI,CAEjG"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/mcp-server/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;;;OAKG;IACH,YAAY,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAoB,EAItD;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAe1B;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5B;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED;;OAEG;IACH,QAAQ,IAAI,IAAI,CAEf;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASrC;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,SAAoB,GAC3B,WAAW,GAAG,IAAI,CAEpB"}

package/dist/mcp-server/types.d.ts

@@ -58,13 +58,28 @@ export interface MCPServerOptions extends ChatterConfig {
     /** Logging and observability */
     logging?: {
         /**
-         * Emit an `mcp_chat` event (via `logger`, at `info`) for every tool call.
-         * Default: true. Still subject to `logLevel`/`logger` — e.g. `logLevel:
-         * "warn"` silences these events the same way it silences startup
-         * banners, even with `console: true`.
+         * Emit an `mcp_chat` event (via `logger`, at `info`) for every tool call:
+         * tool name, conversation id, message/context counts, duration and token
+         * cost, never the conversation itself (see `content`). Default: true.
+         * Still subject to `logLevel`/`logger` - e.g. `logLevel: "warn"` silences
+         * these events the same way it silences startup banners, even with
+         * `console: true`.
          */
         console?: boolean;
-        /** Custom logging callback for external monitoring */
+        /**
+         * Also emit the conversation itself - user message, history, retrieved
+         * context, answer - as an `mcp_chat_content` event. Default: false, so
+         * the default log carries metadata only. Needs `console` left on, and
+         * lands at `debug`, so it also needs `logLevel: "debug"` (or a custom
+         * `logger` that keeps debug) to reach the log. Scrubbed of credentials
+         * first, like every other logged content.
+         */
+        content?: boolean;
+        /**
+         * Custom logging callback for external monitoring. Receives the full
+         * event, conversation content included, scrubbed of credentials. The
+         * host owns where that lands, so `console`/`content` do not gate it.
+         */
         onChat?: MCPLogCallback;
     };
     /** Rate limiting per tool (requests per minute). Default: no limit */

package/dist/mcp-server/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp-server/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5D,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,qCAAqC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,qCAAqC;QACrC,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,sCAAsC;QACtC,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,CAAC;IAEF,gCAAgC;IAChC,OAAO,CAAC,EAAE;QACR;;;;;WAKG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,sDAAsD;QACtD,MAAM,CAAC,EAAE,cAAc,CAAC;KACzB,CAAC;IAEF,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,WAAW,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp-server/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5D,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,qCAAqC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,qCAAqC;QACrC,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,sCAAsC;QACtC,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,CAAC;IAEF,gCAAgC;IAChC,OAAO,CAAC,EAAE;QACR;;;;;;;WAOG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB;;;;;;;WAOG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB;;;;WAIG;QACH,MAAM,CAAC,EAAE,cAAc,CAAC;KACzB,CAAC;IAEF,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,WAAW,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}