@diegoaltoworks/chatter 0.1.8 → 0.8.0

package/dist/mcp-server/conversation-id.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Conversation ID Generation
+ */
+/**
+ * Generate a unique conversation ID
+ *
+ * Format: conv_{timestamp}_{random}
+ * Example: conv_1710421200000_abc123xyz
+ *
+ * @returns Unique conversation ID string
+ */
+export declare function generateConversationId(): string;
+/**
+ * Get or generate conversation ID
+ *
+ * @param providedId - Optional conversation ID provided by client
+ * @returns The provided ID or a newly generated one
+ */
+export declare function getOrGenerateConversationId(providedId: string | undefined): string;
+/**
+ * Validate conversation ID format
+ *
+ * @param id - Conversation ID to validate
+ * @returns true if valid format, false otherwise
+ */
+export declare function isValidConversationId(id: string): boolean;
+//# sourceMappingURL=conversation-id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-id.d.ts","sourceRoot":"","sources":["../../src/mcp-server/conversation-id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGzD"}

package/dist/mcp-server/conversation-id.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation-id.test.d.ts.map

package/dist/mcp-server/conversation-id.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-id.test.d.ts","sourceRoot":"","sources":["../../src/mcp-server/conversation-id.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,36 @@
+/**
+ * Cost Tracking for OpenAI API Usage
+ */
+import type { CostInfo } 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
+ *
+ * @param usage - Token usage from OpenAI API response
+ * @returns Cost information including token counts and estimated USD cost
+ */
+export declare function calculateCost(usage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+}): CostInfo;
+/**
+ * Format cost as a human-readable string
+ *
+ * @param cost - Cost information
+ * @returns Formatted cost string (e.g., "$0.003670")
+ */
+export declare function formatCost(cost: CostInfo): string;
+/**
+ * Get cost summary for logging
+ *
+ * @param cost - Cost information
+ * @returns Object with formatted cost data
+ */
+export declare function getCostSummary(cost: CostInfo): {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    estimatedCostUSD: number;
+    formatted: string;
+};
+//# sourceMappingURL=cost-tracker.d.ts.map

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

@@ -0,0 +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;;;;;;EAQ5C"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cost-tracker.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.test.d.ts","sourceRoot":"","sources":["../../src/mcp-server/cost-tracker.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,12 @@
+/**
+ * MCP Server Modules
+ *
+ * Modular implementation of the Model Context Protocol server
+ */
+export * from "./types";
+export * from "./cost-tracker";
+export * from "./rate-limiter";
+export * from "./conversation-id";
+export * from "./logger";
+export { createMCPServer } from "../mcp-server";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Logging for MCP Server
+ */
+import type { ChatMessage, CostInfo, MCPLogCallback } from "./types";
+/**
+ * Logger for MCP chat interactions
+ */
+export declare class MCPLogger {
+    private enableConsole;
+    private callback?;
+    constructor(enableConsole?: boolean, callback?: MCPLogCallback);
+    /**
+     * Log a chat interaction
+     */
+    logChatInteraction(toolName: string, conversationId: string, conversationMessages: ChatMessage[], ragContext: string[], response: string, duration: number, cost: CostInfo): Promise<void>;
+}
+/**
+ * Create a logger instance
+ *
+ * @param enableConsole - Enable console logging
+ * @param callback - Custom logging callback
+ * @returns MCPLogger instance
+ */
+export declare function createLogger(enableConsole?: boolean, callback?: MCPLogCallback): MCPLogger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +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;gBAEtB,aAAa,UAAO,EAAE,QAAQ,CAAC,EAAE,cAAc;IAK3D;;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;CAkCjB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,aAAa,UAAO,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAEvF"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../src/mcp-server/logger.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,59 @@
+/**
+ * Rate Limiting for MCP Tools
+ * Simple in-memory sliding window implementation
+ */
+/**
+ * Rate limiter using sliding window algorithm
+ */
+export declare class RateLimiter {
+    private requestMap;
+    private readonly limit;
+    private readonly windowMs;
+    /**
+     * Create a new rate limiter
+     *
+     * @param limit - Maximum requests allowed in the time window
+     * @param windowMs - Time window in milliseconds (default: 60000 = 1 minute)
+     */
+    constructor(limit: number, windowMs?: number);
+    /**
+     * Check if a request should be allowed
+     *
+     * @param key - Unique identifier for the rate limit (e.g., tool name)
+     * @returns true if request is allowed, false if rate limit exceeded
+     */
+    check(key: string): boolean;
+    /**
+     * Get current request count for a key
+     *
+     * @param key - Unique identifier
+     * @returns Current number of requests in the window
+     */
+    getCount(key: string): number;
+    /**
+     * Reset rate limit for a specific key
+     *
+     * @param key - Unique identifier to reset
+     */
+    reset(key: string): void;
+    /**
+     * Reset all rate limits
+     */
+    resetAll(): void;
+    /**
+     * Get time until rate limit resets (in ms)
+     *
+     * @param key - Unique identifier
+     * @returns Milliseconds until the oldest request falls out of the window
+     */
+    getTimeUntilReset(key: string): number;
+}
+/**
+ * Create a rate limiter if limit is specified
+ *
+ * @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;
+//# sourceMappingURL=rate-limiter.d.ts.map

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

@@ -0,0 +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;gBACS,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAQ;IAM3C;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAsB3B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAO7B;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAUvC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAQ,GAAG,WAAW,GAAG,IAAI,CAEjG"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rate-limiter.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.test.d.ts","sourceRoot":"","sources":["../../src/mcp-server/rate-limiter.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,82 @@
+/**
+ * MCP Server Type Definitions
+ */
+import type { ChatterConfig } from "../types";
+/**
+ * MCP Server transport options
+ */
+export type MCPTransportMode = "stdio";
+/**
+ * Cost information for API usage
+ */
+export interface CostInfo {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    estimatedCost: number;
+}
+/**
+ * Logging callback for observability
+ */
+export type MCPLogCallback = (event: {
+    timestamp: string;
+    toolName: string;
+    conversationId: string;
+    userMessage: string;
+    conversationHistory: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    ragContext: string[];
+    response: string;
+    duration: number;
+    cost: CostInfo;
+}) => void | Promise<void>;
+/**
+ * Configuration for individual MCP tools
+ */
+export interface MCPToolConfig {
+    /** Enable this tool. Default: true */
+    enabled?: boolean;
+    /** Tool name override. Defaults to chat_public/chat_private */
+    name?: string;
+    /** Tool description override */
+    description?: string;
+}
+export interface MCPServerOptions extends ChatterConfig {
+    /** Transport mode. Default: stdio */
+    transport?: MCPTransportMode;
+    /** Configuration for MCP tools */
+    tools?: {
+        /** Public chat tool configuration */
+        public?: MCPToolConfig;
+        /** Private chat tool configuration */
+        private?: MCPToolConfig;
+    };
+    /** Logging and observability */
+    logging?: {
+        /** Enable console logging. Default: true */
+        console?: boolean;
+        /** Custom logging callback for external monitoring */
+        onChat?: MCPLogCallback;
+    };
+    /** Rate limiting per tool (requests per minute). Default: no limit */
+    toolRateLimit?: number;
+}
+/**
+ * Chat message structure
+ */
+export interface ChatMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+/**
+ * Tool execution context
+ */
+export interface ToolContext {
+    conversationId: string;
+    conversationMessages: ChatMessage[];
+    ragContext: string[];
+    startTime: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Chatter MCP Server
+ *
+ * Model Context Protocol server implementation that exposes Chatter's
+ * 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";
+/**
+ * Create and configure an MCP server instance
+ *
+ * @param config - Chatter configuration with optional MCP transport settings
+ * @returns Configured MCP server ready to connect
+ *
+ * @example
+ * ```typescript
+ * import { createMCPServer } from '@diegoaltoworks/chatter/mcp';
+ *
+ * const server = await createMCPServer({
+ *   bot: { name: 'MyBot', personName: 'Your Name' },
+ *   openai: { apiKey: process.env.OPENAI_API_KEY },
+ *   database: { url: process.env.TURSO_URL, authToken: process.env.TURSO_AUTH_TOKEN },
+ *   knowledgeDir: './knowledge',
+ *   promptsDir: './prompts',
+ *   transport: 'stdio' // Default
+ * });
+ *
+ * // Connect with STDIO transport
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+export declare function createMCPServer(config: MCPServerOptions): Promise<McpServer>;
+//# sourceMappingURL=mcp-server.d.ts.map

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

@@ -0,0 +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;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,sBAiT7D"}