@diegoaltoworks/chatter 0.45.0 → 0.48.0

package/dist/mcp-server/cost-tracker.d.ts

@@ -1,23 +1,28 @@
 /**
  * Cost Tracking for OpenAI API Usage
  */
-import type { CostInfo } from "./types";
+import type { CostInfo, PricingRates } from "./types";
 /**
- * Calculate cost based on token usage
- * GPT-4o pricing as of 2024: $2.50 per 1M input tokens, $10.00 per 1M output tokens
+ * Calculate cost based on token usage.
+ *
+ * Pricing varies by model and changes over time, so this never guesses at
+ * it: without `rates` the token counts are still reported but
+ * `estimatedCost` is `null` rather than a number computed against a price
+ * that may not match whatever model actually answered.
  *
  * @param usage - Token usage from OpenAI API response
+ * @param rates - USD per 1M tokens, typically sourced from `config.openai.pricing`
  * @returns Cost information including token counts and estimated USD cost
  */
 export declare function calculateCost(usage: {
     prompt_tokens: number;
     completion_tokens: number;
-}): CostInfo;
+}, rates?: PricingRates): CostInfo;
 /**
  * Format cost as a human-readable string
  *
  * @param cost - Cost information
- * @returns Formatted cost string (e.g., "$0.003670")
+ * @returns Formatted cost string (e.g., "$0.003670"), or "tokens only" when no rates were configured
  */
 export declare function formatCost(cost: CostInfo): string;
 /**
@@ -30,7 +35,7 @@ export declare function getCostSummary(cost: CostInfo): {
     promptTokens: number;
     completionTokens: number;
     totalTokens: number;
-    estimatedCostUSD: number;
+    estimatedCostUSD: number | null;
     formatted: string;
 };
 //# sourceMappingURL=cost-tracker.d.ts.map

package/dist/mcp-server/cost-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/mcp-server/cost-tracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,QAAQ,CAgBX;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ;IAEzC,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,SAAS;EAEZ"}
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/mcp-server/cost-tracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,EAC3D,KAAK,CAAC,EAAE,YAAY,GACnB,QAAQ,CAgBV;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ;IAEzC,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,SAAS;EAEZ"}

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

@@ -1,6 +1,7 @@
 /**
  * Logging for MCP Server
  */
+import { type Logger } from "../core/logger";
 import type { ChatMessage, CostInfo, MCPLogCallback } from "./types";
 /**
  * Logger for MCP chat interactions
@@ -8,7 +9,8 @@ import type { ChatMessage, CostInfo, MCPLogCallback } from "./types";
 export declare class MCPLogger {
     private enableConsole;
     private callback?;
-    constructor(enableConsole?: boolean, callback?: MCPLogCallback);
+    private logger;
+    constructor(enableConsole?: boolean, callback?: MCPLogCallback, logger?: Logger);
     /**
      * Log a chat interaction
      */
@@ -19,7 +21,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.
  * @returns MCPLogger instance
  */
-export declare function createLogger(enableConsole?: boolean, callback?: MCPLogCallback): MCPLogger;
+export declare function createLogger(enableConsole?: boolean, callback?: MCPLogCallback, logger?: Logger): 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,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;IAElC,YAAY,aAAa,UAAO,EAAE,QAAQ,CAAC,EAAE,cAAc,EAG1D;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,CAiCf;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,aAAa,UAAO,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAEvF"}
+{"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"}

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

@@ -0,0 +1,23 @@
+/**
+ * The one place `./mcp` touches `@modelcontextprotocol/sdk` and `zod` at
+ * runtime. Both are OPTIONAL peer dependencies — `bun install` and every core
+ * import must work without them — so `mcp-server.ts` may not `import` either
+ * statically; it takes the MCP server constructor and the zod runtime as
+ * values loaded here, and reaches their types separately via a type-only
+ * import (erased at compile time, so it costs nothing at runtime).
+ *
+ * `loadMcpSdk()`/`loadZod()` are the single dynamic imports, called lazily
+ * when an MCP server actually starts, so a missing package fails with an
+ * actionable message instead of a raw "Cannot find module" — or, worse, at
+ * unrelated core imports that never touch MCP at all.
+ */
+type McpSdkModule = typeof import("@modelcontextprotocol/sdk/server/mcp.js");
+type ZodModule = typeof import("zod");
+export type McpServerCtor = McpSdkModule["McpServer"];
+export type Zod = ZodModule["z"];
+/** Wraps a failed dynamic import of an optional MCP peer in an actionable message. Exported separately so the message content is unit-testable without simulating a real missing module. */
+export declare function wrapMissingMcpPeerError(packageName: string, cause: unknown): Error;
+export declare function loadMcpSdk(): Promise<McpServerCtor>;
+export declare function loadZod(): Promise<Zod>;
+export {};
+//# sourceMappingURL=sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/mcp-server/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,KAAK,YAAY,GAAG,cAAc,yCAAyC,CAAC,CAAC;AAC7E,KAAK,SAAS,GAAG,cAAc,KAAK,CAAC,CAAC;AAEtC,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;AAEjC,4LAA4L;AAC5L,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAOlF;AAID,wBAAgB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAanD;AAID,wBAAgB,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAatC"}

package/dist/mcp-server/tool-input.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared input parsing for MCP chat tools — both `chat_public` and
+ * `chat_private` accept the same "single message or conversation" shape.
+ */
+import type { ChatMessage } from "./types";
+/**
+ * Resolve a tool's `message`/`messages` args into a conversation.
+ *
+ * @throws if neither is provided
+ */
+export declare function resolveConversationMessages(message: string | undefined, messages: ChatMessage[] | undefined): ChatMessage[];
+//# sourceMappingURL=tool-input.d.ts.map

package/dist/mcp-server/tool-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-input.d.ts","sourceRoot":"","sources":["../../src/mcp-server/tool-input.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,GAClC,WAAW,EAAE,CAIf"}

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

@@ -1,7 +1,8 @@
 /**
  * MCP Server Type Definitions
  */
-import type { ChatterConfig } from "../types";
+import type { ChatterConfig, PricingRates } from "../types";
+export type { PricingRates };
 /**
  * MCP Server transport options
  */
@@ -13,7 +14,8 @@ export interface CostInfo {
     promptTokens: number;
     completionTokens: number;
     totalTokens: number;
-    estimatedCost: number;
+    /** USD, or `null` when no `openai.pricing` was configured (token-only) */
+    estimatedCost: number | null;
 }
 /**
  * Logging callback for observability
@@ -55,7 +57,12 @@ export interface MCPServerOptions extends ChatterConfig {
     };
     /** Logging and observability */
     logging?: {
-        /** Enable console logging. Default: true */
+        /**
+         * 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`.
+         */
         console?: boolean;
         /** Custom logging callback for external monitoring */
         onChat?: MCPLogCallback;

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,MAAM,UAAU,CAAC;AAE9C;;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,aAAa,EAAE,MAAM,CAAC;CACvB;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,4CAA4C;QAC5C,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;;;;;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"}

package/dist/mcp-server.d.ts

@@ -5,7 +5,6 @@
  * AI chat capabilities as MCP tools for use with Claude Desktop,
  * VS Code extensions, and other MCP-compatible clients.
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export type { ChatMessage, CostInfo, MCPLogCallback, MCPServerOptions, MCPToolConfig, MCPTransportMode, } from "./mcp-server/types";
 import type { MCPServerOptions } from "./mcp-server/types";
 /**
@@ -32,5 +31,5 @@ import type { MCPServerOptions } from "./mcp-server/types";
  * await server.connect(transport);
  * ```
  */
-export declare function createMCPServer(config: MCPServerOptions): Promise<McpServer>;
+export declare function createMCPServer(config: MCPServerOptions): Promise<import("@modelcontextprotocol/sdk/server/mcp").McpServer>;
 //# sourceMappingURL=mcp-server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,sBAkT7D"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,qEAwS7D"}