claude-brain 0.14.2 → 0.14.4

package/src/server/utils/request-context.ts

@@ -1,122 +1,122 @@
-/**
- * Request Context
- * Utilities for tracking request context and timing
- */
-
-import { randomUUID } from 'crypto'
-
-/**
- * RequestContext tracks information about a single request
- */
-export class RequestContext {
-  /** Unique identifier for this request */
-  readonly id: string
-
-  /** Timestamp when request started */
-  readonly startTime: number
-
-  /** Name of the tool being called (if applicable) */
-  readonly toolName?: string
-
-  /** Additional metadata for this request */
-  readonly metadata: Record<string, unknown>
-
-  /**
-   * Create a new RequestContext
-   * @param toolName - Optional tool name for this request
-   * @param metadata - Optional additional metadata
-   */
-  constructor(toolName?: string, metadata: Record<string, unknown> = {}) {
-    this.id = randomUUID()
-    this.startTime = Date.now()
-    this.toolName = toolName
-    this.metadata = metadata
-  }
-
-  /**
-   * Get the duration since request started
-   * @returns Duration in milliseconds
-   */
-  getDuration(): number {
-    return Date.now() - this.startTime
-  }
-
-  /**
-   * Get context information suitable for logging
-   * @returns Object with request context for logs
-   */
-  toLogContext(): Record<string, unknown> {
-    return {
-      requestId: this.id,
-      toolName: this.toolName,
-      durationMs: this.getDuration(),
-      ...this.metadata
-    }
-  }
-
-  /**
-   * Create a child context with additional metadata
-   * @param additionalMetadata - Additional metadata to include
-   * @returns New context object for logging
-   */
-  withMetadata(additionalMetadata: Record<string, unknown>): Record<string, unknown> {
-    return {
-      ...this.toLogContext(),
-      ...additionalMetadata
-    }
-  }
-}
-
-/**
- * Timer for measuring operation duration
- */
-export class Timer {
-  private readonly startTime: number
-  private endTime?: number
-
-  constructor() {
-    this.startTime = performance.now()
-  }
-
-  /**
-   * Stop the timer
-   * @returns Duration in milliseconds
-   */
-  stop(): number {
-    this.endTime = performance.now()
-    return this.getDuration()
-  }
-
-  /**
-   * Get current duration (without stopping)
-   * @returns Duration in milliseconds
-   */
-  getDuration(): number {
-    const end = this.endTime ?? performance.now()
-    return Math.round(end - this.startTime)
-  }
-
-  /**
-   * Check if timer has been stopped
-   * @returns true if stopped
-   */
-  isStopped(): boolean {
-    return this.endTime !== undefined
-  }
-}
-
-/**
- * Create a new timer
- * @returns Timer instance
- */
-export function createTimer(): Timer {
-  return new Timer()
-}
-
-/**
- * Generate a short request ID
- * @returns Short unique ID string
- */
-export function generateShortId(): string {
-  return `${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`
-}
+/**
+ * Request Context
+ * Utilities for tracking request context and timing
+ */
+
+import { randomUUID } from 'crypto'
+
+/**
+ * RequestContext tracks information about a single request
+ */
+export class RequestContext {
+  /** Unique identifier for this request */
+  readonly id: string
+
+  /** Timestamp when request started */
+  readonly startTime: number
+
+  /** Name of the tool being called (if applicable) */
+  readonly toolName?: string
+
+  /** Additional metadata for this request */
+  readonly metadata: Record<string, unknown>
+
+  /**
+   * Create a new RequestContext
+   * @param toolName - Optional tool name for this request
+   * @param metadata - Optional additional metadata
+   */
+  constructor(toolName?: string, metadata: Record<string, unknown> = {}) {
+    this.id = randomUUID()
+    this.startTime = Date.now()
+    this.toolName = toolName
+    this.metadata = metadata
+  }
+
+  /**
+   * Get the duration since request started
+   * @returns Duration in milliseconds
+   */
+  getDuration(): number {
+    return Date.now() - this.startTime
+  }
+
+  /**
+   * Get context information suitable for logging
+   * @returns Object with request context for logs
+   */
+  toLogContext(): Record<string, unknown> {
+    return {
+      requestId: this.id,
+      toolName: this.toolName,
+      durationMs: this.getDuration(),
+      ...this.metadata
+    }
+  }
+
+  /**
+   * Create a child context with additional metadata
+   * @param additionalMetadata - Additional metadata to include
+   * @returns New context object for logging
+   */
+  withMetadata(additionalMetadata: Record<string, unknown>): Record<string, unknown> {
+    return {
+      ...this.toLogContext(),
+      ...additionalMetadata
+    }
+  }
+}
+
+/**
+ * Timer for measuring operation duration
+ */
+export class Timer {
+  private readonly startTime: number
+  private endTime?: number
+
+  constructor() {
+    this.startTime = performance.now()
+  }
+
+  /**
+   * Stop the timer
+   * @returns Duration in milliseconds
+   */
+  stop(): number {
+    this.endTime = performance.now()
+    return this.getDuration()
+  }
+
+  /**
+   * Get current duration (without stopping)
+   * @returns Duration in milliseconds
+   */
+  getDuration(): number {
+    const end = this.endTime ?? performance.now()
+    return Math.round(end - this.startTime)
+  }
+
+  /**
+   * Check if timer has been stopped
+   * @returns true if stopped
+   */
+  isStopped(): boolean {
+    return this.endTime !== undefined
+  }
+}
+
+/**
+ * Create a new timer
+ * @returns Timer instance
+ */
+export function createTimer(): Timer {
+  return new Timer()
+}
+
+/**
+ * Generate a short request ID
+ * @returns Short unique ID string
+ */
+export function generateShortId(): string {
+  return `${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`
+}

package/src/server/utils/response-formatter.ts

@@ -1,124 +1,129 @@
-/**
- * Response Formatter
- * Utilities for formatting MCP tool responses
- */
-
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
-import type { ToolResponse } from '@/tools/types'
-
-/**
- * ResponseFormatter provides methods for creating properly formatted MCP responses
- */
-export class ResponseFormatter {
-  /**
-   * Format text content for MCP response
-   * @param content - Text content to include in response
-   * @returns Properly formatted ToolResponse
-   */
-  static text(content: string): ToolResponse {
-    return {
-      content: [{
-        type: 'text',
-        text: content
-      }]
-    }
-  }
-
-  /**
-   * Format multiple text blocks for MCP response
-   * @param contents - Array of text content
-   * @returns Properly formatted ToolResponse with multiple content blocks
-   */
-  static multiText(contents: string[]): ToolResponse {
-    return {
-      content: contents.map(text => ({
-        type: 'text' as const,
-        text
-      }))
-    }
-  }
-
-  /**
-   * Format error as MCP error (throws)
-   * @param message - Error message
-   * @param code - MCP error code
-   * @throws McpError
-   */
-  static error(message: string, code: ErrorCode = ErrorCode.InternalError): never {
-    throw new McpError(code, message)
-  }
-
-  /**
-   * Format error response (returns response with isError flag)
-   * @param message - Error message
-   * @returns ToolResponse with error flag
-   */
-  static errorResponse(message: string): ToolResponse {
-    return {
-      content: [{
-        type: 'text',
-        text: `Error: ${message}`
-      }],
-      isError: true
-    }
-  }
-
-  /**
-   * Format structured data as formatted text
-   * @param data - Object to format
-   * @returns Properly formatted ToolResponse
-   */
-  static structured(data: Record<string, unknown>): ToolResponse {
-    const formatted = Object.entries(data)
-      .map(([key, value]) => {
-        const formattedValue = typeof value === 'object'
-          ? JSON.stringify(value, null, 2)
-          : String(value)
-        return `${key}: ${formattedValue}`
-      })
-      .join('\n\n')
-
-    return this.text(formatted)
-  }
-
-  /**
-   * Format JSON data as pretty-printed text
-   * @param data - Data to serialize as JSON
-   * @param label - Optional label to prefix the JSON
-   * @returns Properly formatted ToolResponse
-   */
-  static json(data: unknown, label?: string): ToolResponse {
-    const jsonStr = JSON.stringify(data, null, 2)
-    const content = label ? `${label}:\n${jsonStr}` : jsonStr
-    return this.text(content)
-  }
-
-  /**
-   * Format a list of items
-   * @param items - Array of items to format
-   * @param title - Optional title for the list
-   * @returns Properly formatted ToolResponse
-   */
-  static list(items: string[], title?: string): ToolResponse {
-    const listContent = items.map((item, i) => `${i + 1}. ${item}`).join('\n')
-    const content = title ? `${title}:\n${listContent}` : listContent
-    return this.text(content)
-  }
-
-  /**
-   * Format a success message
-   * @param message - Success message
-   * @param details - Optional additional details
-   * @returns Properly formatted ToolResponse
-   */
-  static success(message: string, details?: Record<string, unknown>): ToolResponse {
-    let content = `✓ ${message}`
-    if (details) {
-      const detailsStr = Object.entries(details)
-        .map(([k, v]) => `  ${k}: ${v}`)
-        .join('\n')
-      content += `\n\nDetails:\n${detailsStr}`
-    }
-    return this.text(content)
-  }
-}
+/**
+ * Response Formatter
+ * Utilities for formatting MCP tool responses
+ */
+
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
+import type { ToolResponse } from '@/tools/types'
+
+/**
+ * ResponseFormatter provides methods for creating properly formatted MCP responses
+ */
+export class ResponseFormatter {
+  /**
+   * Format text content for MCP response
+   * @param content - Text content to include in response
+   * @returns Properly formatted ToolResponse
+   */
+  static text(content: string): ToolResponse {
+    return {
+      content: [{
+        type: 'text',
+        text: content
+      }]
+    }
+  }
+
+  /**
+   * Format multiple text blocks for MCP response
+   * @param contents - Array of text content
+   * @returns Properly formatted ToolResponse with multiple content blocks
+   */
+  static multiText(contents: string[]): ToolResponse {
+    return {
+      content: contents.map(text => ({
+        type: 'text' as const,
+        text
+      }))
+    }
+  }
+
+  /**
+   * Format error as MCP error (throws)
+   * @param message - Error message
+   * @param code - MCP error code
+   * @throws McpError
+   */
+  static error(message: string, code: ErrorCode = ErrorCode.InternalError): never {
+    throw new McpError(code, message)
+  }
+
+  /**
+   * Format error response (returns response with isError flag)
+   * @param message - Error message
+   * @returns ToolResponse with error flag
+   */
+  static errorResponse(message: string): ToolResponse {
+    return {
+      content: [{
+        type: 'text',
+        text: `Error: ${message}`
+      }],
+      isError: true
+    }
+  }
+
+  /**
+   * Format structured data as formatted text
+   * @param data - Object to format
+   * @returns Properly formatted ToolResponse
+   */
+  static structured(data: Record<string, unknown>): ToolResponse {
+    const formatted = Object.entries(data)
+      .map(([key, value]) => {
+        const formattedValue = typeof value === 'object'
+          ? JSON.stringify(value, null, 2)
+          : String(value)
+        return `${key}: ${formattedValue}`
+      })
+      .join('\n\n')
+
+    return this.text(formatted)
+  }
+
+  /**
+   * Format JSON data as pretty-printed text
+   * @param data - Data to serialize as JSON
+   * @param label - Optional label to prefix the JSON
+   * @returns Properly formatted ToolResponse
+   */
+  static json(data: unknown, label?: string): ToolResponse {
+    const jsonStr = JSON.stringify(data, null, 2)
+    const content = label ? `${label}:\n${jsonStr}` : jsonStr
+    return this.text(content)
+  }
+
+  /**
+   * Format a list of items
+   * @param items - Array of items to format
+   * @param title - Optional title for the list
+   * @returns Properly formatted ToolResponse
+   */
+  static list(items: string[], title?: string): ToolResponse {
+    const listContent = items.map((item, i) => `${i + 1}. ${item}`).join('\n')
+    const content = title ? `${title}:\n${listContent}` : listContent
+    return this.text(content)
+  }
+
+  /**
+   * Format a success message
+   * @param message - Success message
+   * @param details - Optional additional details
+   * @returns Properly formatted ToolResponse
+   */
+  static success(message: string, details?: Record<string, unknown>): ToolResponse {
+    let content = `✓ ${message}`
+    if (details) {
+      const detailsStr = Object.entries(details)
+        .map(([k, v]) => {
+          const formatted = (v !== null && typeof v === 'object')
+            ? JSON.stringify(v)
+            : String(v ?? '')
+          return `  ${k}: ${formatted}`
+        })
+        .join('\n')
+      content += `\n\nDetails:\n${detailsStr}`
+    }
+    return this.text(content)
+  }
+}