alepha 0.15.3 → 0.15.5

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/mcp/helpers/jsonrpc.ts","../../src/mcp/errors/McpError.ts","../../src/mcp/providers/McpServerProvider.ts","../../src/mcp/primitives/$prompt.ts","../../src/mcp/primitives/$resource.ts","../../src/mcp/primitives/$tool.ts","../../src/mcp/transports/SseMcpTransport.ts","../../src/mcp/transports/StdioMcpTransport.ts","../../src/mcp/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"../interfaces/McpTypes.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const JSONRPC_VERSION = \"2.0\" as const;\n\nexport const MCP_PROTOCOL_VERSION = \"2024-11-05\" as const;\n\nexport const JsonRpcErrorCodes = {\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n} as const;\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Response Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createResponse(\n  id: string | number,\n  result: unknown,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    result,\n  };\n}\n\nexport function createErrorResponse(\n  id: string | number,\n  error: JsonRpcError,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    error,\n  };\n}\n\nexport function createNotification(\n  method: string,\n  params?: Record<string, unknown>,\n): JsonRpcNotification {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    method,\n    params,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Error Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createParseError(message = \"Parse error\"): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.PARSE_ERROR,\n    message,\n  };\n}\n\nexport function createInvalidRequestError(\n  message = \"Invalid request\",\n): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_REQUEST,\n    message,\n  };\n}\n\nexport function createMethodNotFoundError(method: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.METHOD_NOT_FOUND,\n    message: `Method not found: ${method}`,\n  };\n}\n\nexport function createInvalidParamsError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_PARAMS,\n    message,\n  };\n}\n\nexport function createInternalError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INTERNAL_ERROR,\n    message,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Message Parsing\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function parseMessage(data: string): JsonRpcRequest {\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(data);\n  } catch {\n    throw new JsonRpcParseError(\"Invalid JSON\");\n  }\n\n  if (!isValidJsonRpcRequest(parsed)) {\n    throw new JsonRpcParseError(\"Invalid JSON-RPC request\");\n  }\n\n  return parsed;\n}\n\nexport function isValidJsonRpcRequest(value: unknown): value is JsonRpcRequest {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (obj.jsonrpc !== JSONRPC_VERSION) {\n    return false;\n  }\n\n  if (typeof obj.method !== \"string\") {\n    return false;\n  }\n\n  if (\n    obj.id !== undefined &&\n    typeof obj.id !== \"string\" &&\n    typeof obj.id !== \"number\"\n  ) {\n    return false;\n  }\n\n  if (obj.params !== undefined && typeof obj.params !== \"object\") {\n    return false;\n  }\n\n  return true;\n}\n\nexport function isNotification(request: JsonRpcRequest): boolean {\n  return request.id === undefined;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class JsonRpcParseError extends AlephaError {\n  name = \"JsonRpcParseError\";\n}\n","import { JsonRpcErrorCodes } from \"../helpers/jsonrpc.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * MCP-specific error codes (application-specific codes in the -32000 to -32099 range).\n */\nexport const McpErrorCodes = {\n  UNAUTHORIZED: -32001,\n  FORBIDDEN: -32003,\n} as const;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpError extends Error {\n  name = \"McpError\";\n  code: number;\n\n  constructor(\n    message: string,\n    code: number = JsonRpcErrorCodes.INTERNAL_ERROR,\n  ) {\n    super(message);\n    this.code = code;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpMethodNotFoundError extends McpError {\n  name = \"McpMethodNotFoundError\";\n\n  constructor(method: string) {\n    super(`Method not found: ${method}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpToolNotFoundError extends McpError {\n  name = \"McpToolNotFoundError\";\n  tool: string;\n\n  constructor(tool: string) {\n    super(`Tool not found: ${tool}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.tool = tool;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpResourceNotFoundError extends McpError {\n  name = \"McpResourceNotFoundError\";\n  uri: string;\n\n  constructor(uri: string) {\n    super(`Resource not found: ${uri}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.uri = uri;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpPromptNotFoundError extends McpError {\n  name = \"McpPromptNotFoundError\";\n  prompt: string;\n\n  constructor(prompt: string) {\n    super(`Prompt not found: ${prompt}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.prompt = prompt;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpInvalidParamsError extends McpError {\n  name = \"McpInvalidParamsError\";\n\n  constructor(message: string) {\n    super(message, JsonRpcErrorCodes.INVALID_PARAMS);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpUnauthorizedError extends McpError {\n  name = \"McpUnauthorizedError\";\n\n  constructor(message = \"Unauthorized\") {\n    super(message, McpErrorCodes.UNAUTHORIZED);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpForbiddenError extends McpError {\n  name = \"McpForbiddenError\";\n\n  constructor(message = \"Forbidden\") {\n    super(message, McpErrorCodes.FORBIDDEN);\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  McpError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n} from \"../errors/McpError.ts\";\nimport {\n  createErrorResponse,\n  createInternalError,\n  createResponse,\n  MCP_PROTOCOL_VERSION,\n} from \"../helpers/jsonrpc.ts\";\nimport type {\n  JsonRpcRequest,\n  JsonRpcResponse,\n  McpCapabilities,\n  McpContent,\n  McpContext,\n  McpInitializeResult,\n  McpPromptDescriptor,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  McpResourceDescriptor,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallResult,\n  McpToolDescriptor,\n} from \"../interfaces/McpTypes.ts\";\nimport type { PromptPrimitive } from \"../primitives/$prompt.ts\";\nimport type { ResourcePrimitive } from \"../primitives/$resource.ts\";\nimport type { ToolPrimitive } from \"../primitives/$tool.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Core MCP server provider that handles protocol messages.\n *\n * This provider maintains registries of tools, resources, and prompts,\n * and routes incoming JSON-RPC requests to the appropriate handlers.\n *\n * It is transport-agnostic - actual communication is handled by\n * transport providers like StdioMcpTransport or SseMcpTransport.\n */\nexport class McpServerProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n\n  protected readonly tools = new Map<string, ToolPrimitive<any>>();\n  protected readonly resources = new Map<string, ResourcePrimitive>();\n  protected readonly prompts = new Map<string, PromptPrimitive<any>>();\n\n  protected initialized = false;\n\n  protected serverInfo: McpServerInfo = {\n    name: \"alepha-mcp\",\n    version: \"1.0.0\",\n  };\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Registration Methods\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Register a tool with the MCP server.\n   */\n  public registerTool(tool: ToolPrimitive<any>): void {\n    this.log.trace(`Registering MCP tool: ${tool.name}`);\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * Register a resource with the MCP server.\n   */\n  public registerResource(resource: ResourcePrimitive): void {\n    this.log.trace(`Registering MCP resource: ${resource.uri}`);\n    this.resources.set(resource.uri, resource);\n  }\n\n  /**\n   * Register a prompt with the MCP server.\n   */\n  public registerPrompt(prompt: PromptPrimitive<any>): void {\n    this.log.trace(`Registering MCP prompt: ${prompt.name}`);\n    this.prompts.set(prompt.name, prompt);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Getters\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Get the server capabilities based on registered primitives.\n   */\n  public getCapabilities(): McpCapabilities {\n    return {\n      tools: this.tools.size > 0 ? {} : undefined,\n      resources: this.resources.size > 0 ? {} : undefined,\n      prompts: this.prompts.size > 0 ? {} : undefined,\n    };\n  }\n\n  /**\n   * Get all registered tools.\n   */\n  public getTools(): ToolPrimitive<any>[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get all registered resources.\n   */\n  public getResources(): ResourcePrimitive[] {\n    return Array.from(this.resources.values());\n  }\n\n  /**\n   * Get all registered prompts.\n   */\n  public getPrompts(): PromptPrimitive<any>[] {\n    return Array.from(this.prompts.values());\n  }\n\n  /**\n   * Get a tool by name.\n   */\n  public getTool(name: string): ToolPrimitive<any> | undefined {\n    return this.tools.get(name);\n  }\n\n  /**\n   * Get a resource by URI.\n   */\n  public getResource(uri: string): ResourcePrimitive | undefined {\n    return this.resources.get(uri);\n  }\n\n  /**\n   * Get a prompt by name.\n   */\n  public getPrompt(name: string): PromptPrimitive<any> | undefined {\n    return this.prompts.get(name);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Message Handling\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Handle an incoming JSON-RPC request.\n   *\n   * @param request - The parsed JSON-RPC request\n   * @param context - Optional context from the transport layer (headers, auth, etc.)\n   * @returns The JSON-RPC response, or null for notifications\n   */\n  public async handleMessage(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<JsonRpcResponse | null> {\n    const id = request.id;\n\n    // Notifications have no id and expect no response\n    if (id === undefined) {\n      await this.handleNotification(request);\n      return null;\n    }\n\n    try {\n      const result = await this.handleRequest(request, context);\n      return createResponse(id, result);\n    } catch (error) {\n      this.log.error(\"MCP request failed\", error);\n      // Preserve error code from McpError instances\n      if (error instanceof McpError) {\n        return createErrorResponse(id, {\n          code: error.code,\n          message: error.message,\n        });\n      }\n      return createErrorResponse(\n        id,\n        createInternalError((error as Error).message),\n      );\n    }\n  }\n\n  /**\n   * Handle a JSON-RPC request that expects a response.\n   */\n  protected async handleRequest(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<unknown> {\n    const { method, params = {} } = request;\n\n    switch (method) {\n      case \"initialize\":\n        return this.handleInitialize(params);\n      case \"ping\":\n        return this.handlePing();\n      case \"tools/list\":\n        return this.handleToolsList();\n      case \"tools/call\":\n        return this.handleToolsCall(params, context);\n      case \"resources/list\":\n        return this.handleResourcesList();\n      case \"resources/read\":\n        return this.handleResourcesRead(params, context);\n      case \"prompts/list\":\n        return this.handlePromptsList();\n      case \"prompts/get\":\n        return this.handlePromptsGet(params, context);\n      default:\n        throw new McpMethodNotFoundError(method);\n    }\n  }\n\n  /**\n   * Handle a notification (no response expected).\n   */\n  protected async handleNotification(request: JsonRpcRequest): Promise<void> {\n    const { method } = request;\n\n    switch (method) {\n      case \"notifications/initialized\":\n        this.log.debug(\"MCP client initialized\");\n        break;\n      case \"notifications/cancelled\":\n        this.log.debug(\"MCP request cancelled\", request.params);\n        break;\n      default:\n        this.log.debug(`Unknown MCP notification: ${method}`);\n    }\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Protocol Handlers\n  // -----------------------------------------------------------------------------------------------------------------\n\n  protected handleInitialize(\n    params: Record<string, unknown>,\n  ): McpInitializeResult {\n    this.log.info(\"MCP client initializing\", {\n      clientInfo: params.clientInfo,\n      protocolVersion: params.protocolVersion,\n    });\n\n    this.initialized = true;\n\n    return {\n      protocolVersion: MCP_PROTOCOL_VERSION,\n      capabilities: this.getCapabilities(),\n      serverInfo: this.serverInfo,\n    };\n  }\n\n  protected handlePing(): Record<string, never> {\n    return {};\n  }\n\n  protected handleToolsList(): { tools: McpToolDescriptor[] } {\n    return {\n      tools: Array.from(this.tools.values()).map((t) => t.toDescriptor()),\n    };\n  }\n\n  protected async handleToolsCall(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpToolCallResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, unknown>;\n\n    const tool = this.tools.get(name);\n    if (!tool) {\n      throw new McpToolNotFoundError(name);\n    }\n\n    try {\n      const result = await tool.execute(args, context);\n\n      const content: McpContent[] = [\n        {\n          type: \"text\",\n          text:\n            typeof result === \"string\"\n              ? result\n              : JSON.stringify(result ?? null),\n        },\n      ];\n\n      return { content };\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: `Error: ${(error as Error).message}`,\n          },\n        ],\n        isError: true,\n      };\n    }\n  }\n\n  protected handleResourcesList(): { resources: McpResourceDescriptor[] } {\n    return {\n      resources: Array.from(this.resources.values()).map((r) =>\n        r.toDescriptor(),\n      ),\n    };\n  }\n\n  protected async handleResourcesRead(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpResourceReadResult> {\n    const uri = params.uri as string;\n\n    const resource = this.resources.get(uri);\n    if (!resource) {\n      throw new McpResourceNotFoundError(uri);\n    }\n\n    const content = await resource.read(context);\n\n    const resourceContent: McpResourceContent = {\n      uri,\n      mimeType: resource.mimeType,\n    };\n\n    if (content.text !== undefined) {\n      resourceContent.text = content.text;\n    }\n\n    if (content.blob !== undefined) {\n      // Convert binary to base64 for transport\n      resourceContent.blob = Buffer.from(content.blob).toString(\"base64\");\n    }\n\n    return {\n      contents: [resourceContent],\n    };\n  }\n\n  protected handlePromptsList(): { prompts: McpPromptDescriptor[] } {\n    return {\n      prompts: Array.from(this.prompts.values()).map((p) => p.toDescriptor()),\n    };\n  }\n\n  protected async handlePromptsGet(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpPromptGetResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, string>;\n\n    const prompt = this.prompts.get(name);\n    if (!prompt) {\n      throw new McpPromptNotFoundError(name);\n    }\n\n    const messages = await prompt.get(args, context);\n\n    const mcpMessages: McpPromptMessage[] = messages.map((msg) => ({\n      role: msg.role,\n      content: {\n        type: \"text\" as const,\n        text: msg.content,\n      },\n    }));\n\n    return {\n      description: prompt.description,\n      messages: mcpMessages,\n    };\n  }\n}\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type TObject,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpPromptArgument,\n  McpPromptDescriptor,\n  PromptHandlerArgs,\n  PromptMessage,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP prompt primitive for defining reusable prompt templates.\n *\n * Prompts allow you to define templated messages that can be filled in\n * with arguments at runtime. They're useful for creating consistent\n * interaction patterns.\n *\n * @example\n * ```ts\n * class Prompts {\n *   greeting = $prompt({\n *     description: \"Generate a personalized greeting\",\n *     args: t.object({\n *       name: t.text({ description: \"Name of the person to greet\" }),\n *       style: t.optional(t.enum([\"formal\", \"casual\"])),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: args.style === \"formal\"\n *           ? `Please greet ${args.name} in a formal manner.`\n *           : `Say hi to ${args.name}!`,\n *       },\n *     ],\n *   });\n *\n *   codeReview = $prompt({\n *     description: \"Request a code review\",\n *     args: t.object({\n *       code: t.text({ description: \"The code to review\" }),\n *       language: t.text({ description: \"Programming language\" }),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: `Please review this ${args.language} code:\\n\\n${args.code}`,\n *       },\n *     ],\n *   });\n * }\n * ```\n */\nexport const $prompt = <T extends TObject>(\n  options: PromptPrimitiveOptions<T>,\n): PromptPrimitive<T> => {\n  return createPrimitive(PromptPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface PromptPrimitiveOptions<T extends TObject> {\n  /**\n   * The name of the prompt.\n   *\n   * If not provided, defaults to the property key where the prompt is declared.\n   *\n   * @example \"greeting\"\n   * @example \"code-review\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this prompt does.\n   *\n   * Helps users understand the purpose of the prompt.\n   *\n   * @example \"Generate a personalized greeting message\"\n   */\n  description?: string;\n\n  /**\n   * TypeBox schema defining the prompt arguments.\n   *\n   * Each property in the schema becomes an argument that can be\n   * filled in when the prompt is used.\n   */\n  args?: T;\n\n  /**\n   * Handler function that generates the prompt messages.\n   *\n   * Receives the validated arguments and returns an array of messages.\n   *\n   * @param args - Object containing validated arguments\n   * @returns Array of prompt messages\n   */\n  handler: (args: PromptHandlerArgs<T>) => Async<PromptMessage[]>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class PromptPrimitive<T extends TObject> extends Primitive<\n  PromptPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the prompt.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the prompt.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerPrompt(this);\n  }\n\n  /**\n   * Get the prompt messages with the given arguments.\n   *\n   * @param rawArgs - Raw arguments to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns Array of prompt messages\n   */\n  public async get(\n    rawArgs: unknown,\n    context?: McpContext,\n  ): Promise<PromptMessage[]> {\n    let args = (rawArgs ?? {}) as Static<T>;\n\n    if (this.options.args) {\n      args = this.alepha.codec.decode(this.options.args, rawArgs ?? {});\n    }\n\n    return this.options.handler({ args, context });\n  }\n\n  /**\n   * Convert the prompt to an MCP prompt descriptor for protocol messages.\n   */\n  public toDescriptor(): McpPromptDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      arguments: this.options.args\n        ? this.schemaToArguments(this.options.args)\n        : [],\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to an array of prompt arguments.\n   */\n  protected schemaToArguments(schema: TObject): McpPromptArgument[] {\n    const args: McpPromptArgument[] = [];\n\n    for (const [name, propSchema] of Object.entries(schema.properties)) {\n      const prop = propSchema as Record<string, unknown>;\n      args.push({\n        name,\n        description: prop.description as string | undefined,\n        required: !t.schema.isOptional(propSchema),\n      });\n    }\n\n    return args;\n  }\n}\n\n$prompt[KIND] = PromptPrimitive;\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type {\n  McpContext,\n  McpResourceDescriptor,\n  ResourceContent,\n  ResourceHandler,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP resource primitive for exposing read-only data.\n *\n * Resources represent any kind of data that an LLM might want to read,\n * such as files, database records, API responses, or computed data.\n *\n * **Key Features**\n * - URI-based identification for resources\n * - Support for text and binary content\n * - MIME type specification\n * - Lazy loading via handler function\n *\n * @example\n * ```ts\n * class ProjectResources {\n *   readme = $resource({\n *     uri: \"file:///readme\",\n *     description: \"Project README file\",\n *     mimeType: \"text/markdown\",\n *     handler: async () => ({\n *       text: await fs.readFile(\"README.md\", \"utf-8\"),\n *     }),\n *   });\n *\n *   config = $resource({\n *     uri: \"config://app\",\n *     name: \"Application Configuration\",\n *     mimeType: \"application/json\",\n *     handler: async () => ({\n *       text: JSON.stringify(this.configService.getConfig()),\n *     }),\n *   });\n * }\n * ```\n */\nexport const $resource = (\n  options: ResourcePrimitiveOptions,\n): ResourcePrimitive => {\n  return createPrimitive(ResourcePrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ResourcePrimitiveOptions {\n  /**\n   * The URI that identifies this resource.\n   *\n   * URIs should follow a consistent scheme for your application.\n   * Common patterns:\n   * - `file:///path/to/file` - File system resources\n   * - `db://table/id` - Database records\n   * - `api://endpoint` - API responses\n   * - `config://name` - Configuration values\n   *\n   * @example \"file:///readme.md\"\n   * @example \"db://users/123\"\n   */\n  uri: string;\n\n  /**\n   * Human-readable name for the resource.\n   *\n   * If not provided, defaults to the property key where the resource is declared.\n   *\n   * @example \"Project README\"\n   * @example \"User Profile\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this resource contains.\n   *\n   * Helps the LLM understand the purpose and content of the resource.\n   *\n   * @example \"The main README file for the project\"\n   */\n  description?: string;\n\n  /**\n   * MIME type of the resource content.\n   *\n   * Helps clients understand how to interpret the content.\n   *\n   * @default \"text/plain\"\n   * @example \"text/markdown\"\n   * @example \"application/json\"\n   */\n  mimeType?: string;\n\n  /**\n   * Handler function that returns the resource content.\n   *\n   * Called when the resource is read. Can return text or binary content.\n   *\n   * @returns Resource content with either `text` or `blob` property\n   */\n  handler: ResourceHandler;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the resource.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the URI of the resource.\n   */\n  public get uri(): string {\n    return this.options.uri;\n  }\n\n  /**\n   * Returns the description of the resource.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  /**\n   * Returns the MIME type of the resource.\n   */\n  public get mimeType(): string {\n    return this.options.mimeType ?? \"text/plain\";\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerResource(this);\n  }\n\n  /**\n   * Read the resource content.\n   *\n   * @param context - Optional context from the transport layer\n   * @returns The resource content\n   */\n  public async read(context?: McpContext): Promise<ResourceContent> {\n    return this.options.handler({ context });\n  }\n\n  /**\n   * Convert the resource to an MCP resource descriptor for protocol messages.\n   */\n  public toDescriptor(): McpResourceDescriptor {\n    return {\n      uri: this.uri,\n      name: this.name,\n      description: this.description,\n      mimeType: this.mimeType,\n    };\n  }\n}\n\n$resource[KIND] = ResourcePrimitive;\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpJsonSchema,\n  McpToolDescriptor,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  ToolPrimitiveSchema,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP tool primitive for defining callable functions.\n *\n * Tools are the primary way for LLMs to interact with external systems through MCP.\n * Each tool has a name, description, typed parameters, and a handler function.\n *\n * **Key Features**\n * - Full TypeScript inference for parameters and results\n * - Automatic schema validation using TypeBox\n * - JSON Schema generation for MCP protocol\n * - Integration with MCP server provider\n *\n * @example\n * ```ts\n * class CalculatorTools {\n *   add = $tool({\n *     description: \"Add two numbers together\",\n *     schema: {\n *       params: t.object({\n *         a: t.number(),\n *         b: t.number(),\n *       }),\n *       result: t.number(),\n *     },\n *     handler: async ({ params }) => {\n *       return params.a + params.b;\n *     },\n *   });\n *\n *   greet = $tool({\n *     description: \"Generate a greeting message\",\n *     schema: {\n *       params: t.object({\n *         name: t.text(),\n *       }),\n *       result: t.text(),\n *     },\n *     handler: async ({ params }) => {\n *       return `Hello, ${params.name}!`;\n *     },\n *   });\n * }\n * ```\n */\nexport const $tool = <T extends ToolPrimitiveSchema>(\n  options: ToolPrimitiveOptions<T>,\n): ToolPrimitive<T> => {\n  return createPrimitive(ToolPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ToolPrimitiveOptions<T extends ToolPrimitiveSchema> {\n  /**\n   * The name of the tool.\n   *\n   * If not provided, defaults to the property key where the tool is declared.\n   * Names should be descriptive and use kebab-case or snake_case.\n   *\n   * @example \"calculate-sum\"\n   * @example \"get_weather\"\n   */\n  name?: string;\n\n  /**\n   * A human-readable description of what the tool does.\n   *\n   * This description is sent to the LLM to help it understand\n   * when and how to use the tool. Be clear and specific.\n   *\n   * @example \"Calculate the sum of two numbers\"\n   * @example \"Retrieve current weather data for a given location\"\n   */\n  description: string;\n\n  /**\n   * TypeBox schema defining the tool's parameters and result type.\n   *\n   * - **params**: TObject schema for input parameters (optional)\n   * - **result**: TSchema for the return value (optional)\n   *\n   * Schemas provide:\n   * - Type inference for handler function\n   * - Runtime validation of inputs\n   * - JSON Schema generation for MCP protocol\n   */\n  schema?: T;\n\n  /**\n   * The handler function that executes when the tool is called.\n   *\n   * Receives validated parameters and returns the result.\n   * Errors thrown here are caught and returned as MCP errors.\n   *\n   * @param args - Object containing validated params\n   * @returns The tool result (can be async)\n   */\n  handler: (args: ToolHandlerArgs<T>) => Async<ToolHandlerResult<T>>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ToolPrimitive<T extends ToolPrimitiveSchema> extends Primitive<\n  ToolPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the tool.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the tool.\n   */\n  public get description(): string {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerTool(this);\n  }\n\n  /**\n   * Execute the tool with the given parameters.\n   *\n   * @param params - Raw parameters to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns The tool result\n   */\n  public async execute(\n    params: unknown,\n    context?: McpContext,\n  ): Promise<ToolHandlerResult<T>> {\n    let validatedParams: any = params ?? {};\n\n    // Validate params using alepha.codec if schema provided\n    if (this.options.schema?.params) {\n      validatedParams = this.alepha.codec.decode(\n        this.options.schema.params,\n        validatedParams,\n      );\n    }\n\n    const result = await this.options.handler({\n      params: validatedParams,\n      context,\n    });\n\n    // Validate and encode result if schema provided\n    if (this.options.schema?.result && result !== undefined) {\n      return this.alepha.codec.encode(\n        this.options.schema.result,\n        result,\n      ) as ToolHandlerResult<T>;\n    }\n\n    return result as ToolHandlerResult<T>;\n  }\n\n  /**\n   * Convert the tool to an MCP tool descriptor for protocol messages.\n   */\n  public toDescriptor(): McpToolDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      inputSchema: this.options.schema?.params\n        ? this.schemaToJsonSchema(this.options.schema.params)\n        : { type: \"object\", properties: {}, required: [] },\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to JSON Schema format.\n   */\n  protected schemaToJsonSchema(schema: TObject): McpJsonSchema {\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      properties[key] = this.propertyToJsonSchema(propSchema as TSchema);\n\n      // Check if property is required (not optional)\n      if (!t.schema.isOptional(propSchema as TSchema)) {\n        required.push(key);\n      }\n    }\n\n    return {\n      type: \"object\",\n      properties,\n      required,\n    };\n  }\n\n  /**\n   * Convert a single property schema to JSON Schema format.\n   */\n  protected propertyToJsonSchema(schema: TSchema): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    // Check for description on all types\n    if (\"description\" in schema) {\n      result.description = schema.description;\n    }\n\n    if (t.schema.isString(schema)) {\n      result.type = \"string\";\n      if (\"minLength\" in schema) result.minLength = schema.minLength;\n      if (\"maxLength\" in schema) result.maxLength = schema.maxLength;\n      if (\"pattern\" in schema) result.pattern = schema.pattern;\n      if (\"enum\" in schema) result.enum = schema.enum;\n    } else if (t.schema.isNumber(schema)) {\n      result.type = \"number\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isInteger(schema)) {\n      result.type = \"integer\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isBoolean(schema)) {\n      result.type = \"boolean\";\n    } else if (t.schema.isArray(schema)) {\n      result.type = \"array\";\n      if (\"items\" in schema) {\n        result.items = this.propertyToJsonSchema(schema.items as TSchema);\n      }\n    } else if (t.schema.isObject(schema)) {\n      Object.assign(result, this.schemaToJsonSchema(schema));\n    } else if (t.schema.isUnsafe(schema) || t.schema.isOptional(schema)) {\n      // Handle Unsafe types (like t.enum) and optional wrappers by checking the underlying type property\n      const schemaAny = schema as { type?: string; enum?: unknown[] };\n      if (schemaAny.type === \"string\") {\n        result.type = \"string\";\n        if (\"enum\" in schema) result.enum = schema.enum;\n        if (\"pattern\" in schema) result.pattern = schema.pattern;\n      } else if (schemaAny.type === \"number\") {\n        result.type = \"number\";\n      } else if (schemaAny.type === \"integer\") {\n        result.type = \"integer\";\n      } else if (schemaAny.type === \"boolean\") {\n        result.type = \"boolean\";\n      } else if (schemaAny.type === \"array\") {\n        result.type = \"array\";\n      } else if (schemaAny.type === \"object\") {\n        result.type = \"object\";\n      } else {\n        // Fallback\n        result.type = \"string\";\n      }\n    } else {\n      // Fallback for other types\n      result.type = \"string\";\n    }\n\n    return result;\n  }\n}\n\n$tool[KIND] = ToolPrimitive;\n","import { $env, $inject, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $route } from \"alepha/server\";\nimport {\n  createErrorResponse,\n  createNotification,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport type { McpContext } from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  MCP_SSE_PATH: t.text({\n    description: \"Path for MCP SSE endpoint\",\n    default: \"/mcp\",\n  }),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SSE (Server-Sent Events) transport for MCP communication.\n *\n * This transport uses HTTP with SSE for server-to-client messages\n * and POST requests for client-to-server messages.\n *\n * Endpoints:\n * - GET /mcp - SSE stream for server events\n * - POST /mcp - JSON-RPC request endpoint\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaServer } from \"alepha/server\";\n * import { AlephaMcp, AlephaMcpSse } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaServer)\n *     .with(AlephaMcp)\n *     .with(AlephaMcpSse)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class SseMcpTransport {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * SSE endpoint for server-to-client messages.\n   *\n   * Returns a text/event-stream response with server capabilities\n   * and keeps the connection open for notifications.\n   */\n  sse = $route({\n    method: \"GET\",\n    path: this.env.MCP_SSE_PATH,\n    handler: async (request) => {\n      this.log.debug(\"MCP SSE connection established\");\n\n      const encoder = new TextEncoder();\n\n      // Create SSE stream\n      const stream = new ReadableStream({\n        start: (controller) => {\n          // Send initial endpoint info\n          const endpointEvent = this.formatSseEvent(\n            \"endpoint\",\n            `${this.env.MCP_SSE_PATH}`,\n          );\n          controller.enqueue(encoder.encode(endpointEvent));\n\n          // Send capabilities notification\n          const capabilitiesNotification = createNotification(\n            \"notifications/capabilities\",\n            { capabilities: this.mcpServer.getCapabilities() },\n          );\n          const capabilitiesEvent = this.formatSseEvent(\n            \"message\",\n            JSON.stringify(capabilitiesNotification),\n          );\n          controller.enqueue(encoder.encode(capabilitiesEvent));\n        },\n        cancel: () => {\n          this.log.debug(\"MCP SSE connection closed\");\n        },\n      });\n\n      request.reply.status = 200;\n      request.reply.headers = {\n        \"content-type\": \"text/event-stream\",\n        \"cache-control\": \"no-cache\",\n        connection: \"keep-alive\",\n      };\n      request.reply.body = stream;\n    },\n  });\n\n  /**\n   * POST endpoint for client-to-server JSON-RPC messages.\n   */\n  message = $route({\n    method: \"POST\",\n    path: this.env.MCP_SSE_PATH,\n    schema: {\n      body: t.json(),\n    },\n    handler: async (request) => {\n      try {\n        const body =\n          typeof request.body === \"string\"\n            ? request.body\n            : JSON.stringify(request.body);\n\n        this.log.debug(\"MCP request body\", {\n          body,\n          bodyType: typeof request.body,\n        });\n\n        const rpcRequest = parseMessage(body);\n\n        // Build context from request headers\n        const headers = { ...request.headers } as Record<\n          string,\n          string | string[] | undefined\n        >;\n\n        const context: McpContext = { headers };\n\n        const response = await this.mcpServer.handleMessage(\n          rpcRequest,\n          context,\n        );\n\n        request.reply.headers[\"content-type\"] = \"application/json\";\n        request.reply.body = response ? JSON.stringify(response) : \"\";\n      } catch (error) {\n        if (error instanceof JsonRpcParseError) {\n          request.reply.status = 400;\n          request.reply.headers[\"content-type\"] = \"application/json\";\n          request.reply.body = JSON.stringify(\n            createErrorResponse(0, createParseError(error.message)),\n          );\n        } else {\n          this.log.error(\"Failed to process MCP message\", error);\n          request.reply.status = 500;\n          request.reply.body = JSON.stringify({\n            error: (error as Error).message,\n          });\n        }\n      }\n    },\n  });\n\n  /**\n   * Format a message as an SSE event.\n   */\n  protected formatSseEvent(event: string, data: string): string {\n    return `event: ${event}\\ndata: ${data}\\n\\n`;\n  }\n}\n","import * as readline from \"node:readline\";\nimport { $hook, $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  createErrorResponse,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Stdio transport for MCP communication.\n *\n * This transport uses stdin/stdout for JSON-RPC message exchange,\n * which is the standard transport for local MCP servers.\n *\n * Messages are newline-delimited JSON objects.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaMcp, AlephaMcpStdio } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaMcp)\n *     .with(AlephaMcpStdio)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class StdioMcpTransport {\n  protected readonly log = $logger();\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  protected rl?: readline.Interface;\n  protected started = false;\n\n  onStart = $hook({\n    on: \"start\",\n    handler: () => this.start(),\n  });\n\n  onStop = $hook({\n    on: \"stop\",\n    handler: () => this.stop(),\n  });\n\n  /**\n   * Start the stdio transport.\n   */\n  protected start(): void {\n    if (this.started) return;\n    this.started = true;\n\n    this.rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout,\n      terminal: false,\n    });\n\n    this.rl.on(\"line\", (line) => this.handleLine(line));\n    this.rl.on(\"close\", () => this.handleClose());\n\n    this.log.info(\"MCP stdio transport started\");\n  }\n\n  /**\n   * Stop the stdio transport.\n   */\n  protected stop(): void {\n    if (!this.started) return;\n    this.started = false;\n\n    this.rl?.close();\n    this.rl = undefined;\n\n    this.log.info(\"MCP stdio transport stopped\");\n  }\n\n  /**\n   * Handle an incoming line from stdin.\n   */\n  protected async handleLine(line: string): Promise<void> {\n    // Skip empty lines\n    if (!line.trim()) return;\n\n    try {\n      const request = parseMessage(line);\n      const response = await this.mcpServer.handleMessage(request);\n\n      if (response) {\n        this.send(response);\n      }\n    } catch (error) {\n      if (error instanceof JsonRpcParseError) {\n        // Send parse error response\n        this.send(createErrorResponse(0, createParseError(error.message)));\n      } else {\n        this.log.error(\"Failed to process MCP message\", error);\n      }\n    }\n  }\n\n  /**\n   * Handle stdin close event.\n   */\n  protected handleClose(): void {\n    this.log.debug(\"MCP stdio input closed\");\n  }\n\n  /**\n   * Send a message to stdout.\n   */\n  protected send(message: object): void {\n    const json = JSON.stringify(message);\n    process.stdout.write(`${json}\\n`);\n  }\n}\n","import { $module } from \"alepha\";\nimport { $prompt } from \"./primitives/$prompt.ts\";\nimport { $resource } from \"./primitives/$resource.ts\";\nimport { $tool } from \"./primitives/$tool.ts\";\nimport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nimport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nimport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport {\n  McpError,\n  McpErrorCodes,\n  McpForbiddenError,\n  McpInvalidParamsError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n  McpUnauthorizedError,\n} from \"./errors/McpError.ts\";\nexport {\n  createErrorResponse,\n  createInternalError,\n  createInvalidParamsError,\n  createInvalidRequestError,\n  createMethodNotFoundError,\n  createNotification,\n  createParseError,\n  createResponse,\n  isNotification,\n  isValidJsonRpcRequest,\n  JSONRPC_VERSION,\n  JsonRpcErrorCodes,\n  JsonRpcParseError,\n  MCP_PROTOCOL_VERSION,\n  parseMessage,\n} from \"./helpers/jsonrpc.ts\";\nexport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  // JSON-RPC types\n  JsonRpcRequest,\n  JsonRpcResponse,\n  // MCP protocol types\n  McpCapabilities,\n  McpClientInfo,\n  McpContent,\n  // Context type for auth/headers\n  McpContext,\n  McpInitializeParams,\n  McpInitializeResult,\n  McpJsonSchema,\n  McpPromptArgument,\n  McpPromptContent,\n  // Prompt types\n  McpPromptDescriptor,\n  McpPromptGetParams,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  // Resource types\n  McpResourceDescriptor,\n  McpResourceReadParams,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallParams,\n  McpToolCallResult,\n  // Tool types\n  McpToolDescriptor,\n  PromptHandler,\n  PromptHandlerArgs,\n  PromptMessage,\n  ResourceContent,\n  ResourceHandler,\n  ResourceHandlerArgs,\n  ToolHandler,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  // Handler types\n  ToolPrimitiveSchema,\n} from \"./interfaces/McpTypes.ts\";\nexport type { PromptPrimitiveOptions } from \"./primitives/$prompt.ts\";\nexport { $prompt, PromptPrimitive } from \"./primitives/$prompt.ts\";\nexport type { ResourcePrimitiveOptions } from \"./primitives/$resource.ts\";\nexport { $resource, ResourcePrimitive } from \"./primitives/$resource.ts\";\nexport type { ToolPrimitiveOptions } from \"./primitives/$tool.ts\";\nexport { $tool, ToolPrimitive } from \"./primitives/$tool.ts\";\nexport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nexport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nexport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | backend | standard | stable |\n *\n * Model Context Protocol for AI tool integration.\n *\n * **Features:**\n * - MCP resource definitions\n * - MCP tool definitions\n * - MCP prompt definitions\n * - JSON-RPC protocol\n * - SSE and Stdio transports\n *\n * @module alepha.mcp\n */\nexport const AlephaMcp = $module({\n  name: \"alepha.mcp\",\n  primitives: [$tool, $resource, $prompt],\n  services: [McpServerProvider, SseMcpTransport, StdioMcpTransport],\n  register: (alepha) => {\n    alepha.with(McpServerProvider);\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/mcp/helpers/jsonrpc.ts","../../src/mcp/errors/McpError.ts","../../src/mcp/providers/McpServerProvider.ts","../../src/mcp/primitives/$prompt.ts","../../src/mcp/primitives/$resource.ts","../../src/mcp/primitives/$tool.ts","../../src/mcp/transports/SseMcpTransport.ts","../../src/mcp/transports/StdioMcpTransport.ts","../../src/mcp/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"../interfaces/McpTypes.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const JSONRPC_VERSION = \"2.0\" as const;\n\nexport const MCP_PROTOCOL_VERSION = \"2024-11-05\" as const;\n\nexport const JsonRpcErrorCodes = {\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n} as const;\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Response Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createResponse(\n  id: string | number,\n  result: unknown,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    result,\n  };\n}\n\nexport function createErrorResponse(\n  id: string | number,\n  error: JsonRpcError,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    error,\n  };\n}\n\nexport function createNotification(\n  method: string,\n  params?: Record<string, unknown>,\n): JsonRpcNotification {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    method,\n    params,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Error Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createParseError(message = \"Parse error\"): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.PARSE_ERROR,\n    message,\n  };\n}\n\nexport function createInvalidRequestError(\n  message = \"Invalid request\",\n): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_REQUEST,\n    message,\n  };\n}\n\nexport function createMethodNotFoundError(method: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.METHOD_NOT_FOUND,\n    message: `Method not found: ${method}`,\n  };\n}\n\nexport function createInvalidParamsError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_PARAMS,\n    message,\n  };\n}\n\nexport function createInternalError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INTERNAL_ERROR,\n    message,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Message Parsing\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function parseMessage(data: string): JsonRpcRequest {\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(data);\n  } catch {\n    throw new JsonRpcParseError(\"Invalid JSON\");\n  }\n\n  if (!isValidJsonRpcRequest(parsed)) {\n    throw new JsonRpcParseError(\"Invalid JSON-RPC request\");\n  }\n\n  return parsed;\n}\n\nexport function isValidJsonRpcRequest(value: unknown): value is JsonRpcRequest {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (obj.jsonrpc !== JSONRPC_VERSION) {\n    return false;\n  }\n\n  if (typeof obj.method !== \"string\") {\n    return false;\n  }\n\n  if (\n    obj.id !== undefined &&\n    typeof obj.id !== \"string\" &&\n    typeof obj.id !== \"number\"\n  ) {\n    return false;\n  }\n\n  if (obj.params !== undefined && typeof obj.params !== \"object\") {\n    return false;\n  }\n\n  return true;\n}\n\nexport function isNotification(request: JsonRpcRequest): boolean {\n  return request.id === undefined;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class JsonRpcParseError extends AlephaError {\n  name = \"JsonRpcParseError\";\n}\n","import { JsonRpcErrorCodes } from \"../helpers/jsonrpc.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * MCP-specific error codes (application-specific codes in the -32000 to -32099 range).\n */\nexport const McpErrorCodes = {\n  UNAUTHORIZED: -32001,\n  FORBIDDEN: -32003,\n} as const;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpError extends Error {\n  name = \"McpError\";\n  code: number;\n\n  constructor(\n    message: string,\n    code: number = JsonRpcErrorCodes.INTERNAL_ERROR,\n  ) {\n    super(message);\n    this.code = code;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpMethodNotFoundError extends McpError {\n  name = \"McpMethodNotFoundError\";\n\n  constructor(method: string) {\n    super(`Method not found: ${method}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpToolNotFoundError extends McpError {\n  name = \"McpToolNotFoundError\";\n  tool: string;\n\n  constructor(tool: string) {\n    super(`Tool not found: ${tool}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.tool = tool;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpResourceNotFoundError extends McpError {\n  name = \"McpResourceNotFoundError\";\n  uri: string;\n\n  constructor(uri: string) {\n    super(`Resource not found: ${uri}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.uri = uri;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpPromptNotFoundError extends McpError {\n  name = \"McpPromptNotFoundError\";\n  prompt: string;\n\n  constructor(prompt: string) {\n    super(`Prompt not found: ${prompt}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.prompt = prompt;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpInvalidParamsError extends McpError {\n  name = \"McpInvalidParamsError\";\n\n  constructor(message: string) {\n    super(message, JsonRpcErrorCodes.INVALID_PARAMS);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpUnauthorizedError extends McpError {\n  name = \"McpUnauthorizedError\";\n\n  constructor(message = \"Unauthorized\") {\n    super(message, McpErrorCodes.UNAUTHORIZED);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpForbiddenError extends McpError {\n  name = \"McpForbiddenError\";\n\n  constructor(message = \"Forbidden\") {\n    super(message, McpErrorCodes.FORBIDDEN);\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  McpError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n} from \"../errors/McpError.ts\";\nimport {\n  createErrorResponse,\n  createInternalError,\n  createResponse,\n  MCP_PROTOCOL_VERSION,\n} from \"../helpers/jsonrpc.ts\";\nimport type {\n  JsonRpcRequest,\n  JsonRpcResponse,\n  McpCapabilities,\n  McpContent,\n  McpContext,\n  McpInitializeResult,\n  McpPromptDescriptor,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  McpResourceDescriptor,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallResult,\n  McpToolDescriptor,\n} from \"../interfaces/McpTypes.ts\";\nimport type { PromptPrimitive } from \"../primitives/$prompt.ts\";\nimport type { ResourcePrimitive } from \"../primitives/$resource.ts\";\nimport type { ToolPrimitive } from \"../primitives/$tool.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Core MCP server provider that handles protocol messages.\n *\n * This provider maintains registries of tools, resources, and prompts,\n * and routes incoming JSON-RPC requests to the appropriate handlers.\n *\n * It is transport-agnostic - actual communication is handled by\n * transport providers like StdioMcpTransport or SseMcpTransport.\n */\nexport class McpServerProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n\n  protected readonly tools = new Map<string, ToolPrimitive<any>>();\n  protected readonly resources = new Map<string, ResourcePrimitive>();\n  protected readonly prompts = new Map<string, PromptPrimitive<any>>();\n\n  protected initialized = false;\n\n  protected serverInfo: McpServerInfo = {\n    name: \"alepha-mcp\",\n    version: \"1.0.0\",\n  };\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Registration Methods\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Register a tool with the MCP server.\n   */\n  public registerTool(tool: ToolPrimitive<any>): void {\n    this.log.trace(`Registering MCP tool: ${tool.name}`);\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * Register a resource with the MCP server.\n   */\n  public registerResource(resource: ResourcePrimitive): void {\n    this.log.trace(`Registering MCP resource: ${resource.uri}`);\n    this.resources.set(resource.uri, resource);\n  }\n\n  /**\n   * Register a prompt with the MCP server.\n   */\n  public registerPrompt(prompt: PromptPrimitive<any>): void {\n    this.log.trace(`Registering MCP prompt: ${prompt.name}`);\n    this.prompts.set(prompt.name, prompt);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Getters\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Get the server capabilities based on registered primitives.\n   */\n  public getCapabilities(): McpCapabilities {\n    return {\n      tools: this.tools.size > 0 ? {} : undefined,\n      resources: this.resources.size > 0 ? {} : undefined,\n      prompts: this.prompts.size > 0 ? {} : undefined,\n    };\n  }\n\n  /**\n   * Get all registered tools.\n   */\n  public getTools(): ToolPrimitive<any>[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get all registered resources.\n   */\n  public getResources(): ResourcePrimitive[] {\n    return Array.from(this.resources.values());\n  }\n\n  /**\n   * Get all registered prompts.\n   */\n  public getPrompts(): PromptPrimitive<any>[] {\n    return Array.from(this.prompts.values());\n  }\n\n  /**\n   * Get a tool by name.\n   */\n  public getTool(name: string): ToolPrimitive<any> | undefined {\n    return this.tools.get(name);\n  }\n\n  /**\n   * Get a resource by URI.\n   */\n  public getResource(uri: string): ResourcePrimitive | undefined {\n    return this.resources.get(uri);\n  }\n\n  /**\n   * Get a prompt by name.\n   */\n  public getPrompt(name: string): PromptPrimitive<any> | undefined {\n    return this.prompts.get(name);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Message Handling\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Handle an incoming JSON-RPC request.\n   *\n   * @param request - The parsed JSON-RPC request\n   * @param context - Optional context from the transport layer (headers, auth, etc.)\n   * @returns The JSON-RPC response, or null for notifications\n   */\n  public async handleMessage(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<JsonRpcResponse | null> {\n    const id = request.id;\n\n    // Notifications have no id and expect no response\n    if (id === undefined) {\n      await this.handleNotification(request);\n      return null;\n    }\n\n    try {\n      const result = await this.handleRequest(request, context);\n      return createResponse(id, result);\n    } catch (error) {\n      this.log.error(\"MCP request failed\", error);\n      // Preserve error code from McpError instances\n      if (error instanceof McpError) {\n        return createErrorResponse(id, {\n          code: error.code,\n          message: error.message,\n        });\n      }\n      return createErrorResponse(\n        id,\n        createInternalError((error as Error).message),\n      );\n    }\n  }\n\n  /**\n   * Handle a JSON-RPC request that expects a response.\n   */\n  protected async handleRequest(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<unknown> {\n    const { method, params = {} } = request;\n\n    switch (method) {\n      case \"initialize\":\n        return this.handleInitialize(params);\n      case \"ping\":\n        return this.handlePing();\n      case \"tools/list\":\n        return this.handleToolsList();\n      case \"tools/call\":\n        return this.handleToolsCall(params, context);\n      case \"resources/list\":\n        return this.handleResourcesList();\n      case \"resources/read\":\n        return this.handleResourcesRead(params, context);\n      case \"prompts/list\":\n        return this.handlePromptsList();\n      case \"prompts/get\":\n        return this.handlePromptsGet(params, context);\n      default:\n        throw new McpMethodNotFoundError(method);\n    }\n  }\n\n  /**\n   * Handle a notification (no response expected).\n   */\n  protected async handleNotification(request: JsonRpcRequest): Promise<void> {\n    const { method } = request;\n\n    switch (method) {\n      case \"notifications/initialized\":\n        this.log.debug(\"MCP client initialized\");\n        break;\n      case \"notifications/cancelled\":\n        this.log.debug(\"MCP request cancelled\", request.params);\n        break;\n      default:\n        this.log.debug(`Unknown MCP notification: ${method}`);\n    }\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Protocol Handlers\n  // -----------------------------------------------------------------------------------------------------------------\n\n  protected handleInitialize(\n    params: Record<string, unknown>,\n  ): McpInitializeResult {\n    this.log.info(\"MCP client initializing\", {\n      clientInfo: params.clientInfo,\n      protocolVersion: params.protocolVersion,\n    });\n\n    this.initialized = true;\n\n    return {\n      protocolVersion: MCP_PROTOCOL_VERSION,\n      capabilities: this.getCapabilities(),\n      serverInfo: this.serverInfo,\n    };\n  }\n\n  protected handlePing(): Record<string, never> {\n    return {};\n  }\n\n  protected handleToolsList(): { tools: McpToolDescriptor[] } {\n    return {\n      tools: Array.from(this.tools.values()).map((t) => t.toDescriptor()),\n    };\n  }\n\n  protected async handleToolsCall(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpToolCallResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, unknown>;\n\n    const tool = this.tools.get(name);\n    if (!tool) {\n      throw new McpToolNotFoundError(name);\n    }\n\n    try {\n      const result = await tool.execute(args, context);\n\n      const content: McpContent[] = [\n        {\n          type: \"text\",\n          text:\n            typeof result === \"string\"\n              ? result\n              : JSON.stringify(result ?? null),\n        },\n      ];\n\n      return { content };\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: `Error: ${(error as Error).message}`,\n          },\n        ],\n        isError: true,\n      };\n    }\n  }\n\n  protected handleResourcesList(): { resources: McpResourceDescriptor[] } {\n    return {\n      resources: Array.from(this.resources.values()).map((r) =>\n        r.toDescriptor(),\n      ),\n    };\n  }\n\n  protected async handleResourcesRead(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpResourceReadResult> {\n    const uri = params.uri as string;\n\n    const resource = this.resources.get(uri);\n    if (!resource) {\n      throw new McpResourceNotFoundError(uri);\n    }\n\n    const content = await resource.read(context);\n\n    const resourceContent: McpResourceContent = {\n      uri,\n      mimeType: resource.mimeType,\n    };\n\n    if (content.text !== undefined) {\n      resourceContent.text = content.text;\n    }\n\n    if (content.blob !== undefined) {\n      // Convert binary to base64 for transport\n      resourceContent.blob = Buffer.from(content.blob).toString(\"base64\");\n    }\n\n    return {\n      contents: [resourceContent],\n    };\n  }\n\n  protected handlePromptsList(): { prompts: McpPromptDescriptor[] } {\n    return {\n      prompts: Array.from(this.prompts.values()).map((p) => p.toDescriptor()),\n    };\n  }\n\n  protected async handlePromptsGet(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpPromptGetResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, string>;\n\n    const prompt = this.prompts.get(name);\n    if (!prompt) {\n      throw new McpPromptNotFoundError(name);\n    }\n\n    const messages = await prompt.get(args, context);\n\n    const mcpMessages: McpPromptMessage[] = messages.map((msg) => ({\n      role: msg.role,\n      content: {\n        type: \"text\" as const,\n        text: msg.content,\n      },\n    }));\n\n    return {\n      description: prompt.description,\n      messages: mcpMessages,\n    };\n  }\n}\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type TObject,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpPromptArgument,\n  McpPromptDescriptor,\n  PromptHandlerArgs,\n  PromptMessage,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP prompt primitive for defining reusable prompt templates.\n *\n * Prompts allow you to define templated messages that can be filled in\n * with arguments at runtime. They're useful for creating consistent\n * interaction patterns.\n *\n * @example\n * ```ts\n * class Prompts {\n *   greeting = $prompt({\n *     description: \"Generate a personalized greeting\",\n *     args: t.object({\n *       name: t.text({ description: \"Name of the person to greet\" }),\n *       style: t.optional(t.enum([\"formal\", \"casual\"])),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: args.style === \"formal\"\n *           ? `Please greet ${args.name} in a formal manner.`\n *           : `Say hi to ${args.name}!`,\n *       },\n *     ],\n *   });\n *\n *   codeReview = $prompt({\n *     description: \"Request a code review\",\n *     args: t.object({\n *       code: t.text({ description: \"The code to review\" }),\n *       language: t.text({ description: \"Programming language\" }),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: `Please review this ${args.language} code:\\n\\n${args.code}`,\n *       },\n *     ],\n *   });\n * }\n * ```\n */\nexport const $prompt = <T extends TObject>(\n  options: PromptPrimitiveOptions<T>,\n): PromptPrimitive<T> => {\n  return createPrimitive(PromptPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface PromptPrimitiveOptions<T extends TObject> {\n  /**\n   * The name of the prompt.\n   *\n   * If not provided, defaults to the property key where the prompt is declared.\n   *\n   * @example \"greeting\"\n   * @example \"code-review\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this prompt does.\n   *\n   * Helps users understand the purpose of the prompt.\n   *\n   * @example \"Generate a personalized greeting message\"\n   */\n  description?: string;\n\n  /**\n   * TypeBox schema defining the prompt arguments.\n   *\n   * Each property in the schema becomes an argument that can be\n   * filled in when the prompt is used.\n   */\n  args?: T;\n\n  /**\n   * Handler function that generates the prompt messages.\n   *\n   * Receives the validated arguments and returns an array of messages.\n   *\n   * @param args - Object containing validated arguments\n   * @returns Array of prompt messages\n   */\n  handler: (args: PromptHandlerArgs<T>) => Async<PromptMessage[]>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class PromptPrimitive<T extends TObject> extends Primitive<\n  PromptPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the prompt.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the prompt.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerPrompt(this);\n  }\n\n  /**\n   * Get the prompt messages with the given arguments.\n   *\n   * @param rawArgs - Raw arguments to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns Array of prompt messages\n   */\n  public async get(\n    rawArgs: unknown,\n    context?: McpContext,\n  ): Promise<PromptMessage[]> {\n    let args = (rawArgs ?? {}) as Static<T>;\n\n    if (this.options.args) {\n      args = this.alepha.codec.decode(this.options.args, rawArgs ?? {});\n    }\n\n    return this.options.handler({ args, context });\n  }\n\n  /**\n   * Convert the prompt to an MCP prompt descriptor for protocol messages.\n   */\n  public toDescriptor(): McpPromptDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      arguments: this.options.args\n        ? this.schemaToArguments(this.options.args)\n        : [],\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to an array of prompt arguments.\n   */\n  protected schemaToArguments(schema: TObject): McpPromptArgument[] {\n    const args: McpPromptArgument[] = [];\n\n    for (const [name, propSchema] of Object.entries(schema.properties)) {\n      const prop = propSchema as Record<string, unknown>;\n      args.push({\n        name,\n        description: prop.description as string | undefined,\n        required: !t.schema.isOptional(propSchema),\n      });\n    }\n\n    return args;\n  }\n}\n\n$prompt[KIND] = PromptPrimitive;\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type {\n  McpContext,\n  McpResourceDescriptor,\n  ResourceContent,\n  ResourceHandler,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP resource primitive for exposing read-only data.\n *\n * Resources represent any kind of data that an LLM might want to read,\n * such as files, database records, API responses, or computed data.\n *\n * **Key Features**\n * - URI-based identification for resources\n * - Support for text and binary content\n * - MIME type specification\n * - Lazy loading via handler function\n *\n * @example\n * ```ts\n * class ProjectResources {\n *   readme = $resource({\n *     uri: \"file:///readme\",\n *     description: \"Project README file\",\n *     mimeType: \"text/markdown\",\n *     handler: async () => ({\n *       text: await fs.readFile(\"README.md\", \"utf-8\"),\n *     }),\n *   });\n *\n *   config = $resource({\n *     uri: \"config://app\",\n *     name: \"Application Configuration\",\n *     mimeType: \"application/json\",\n *     handler: async () => ({\n *       text: JSON.stringify(this.configService.getConfig()),\n *     }),\n *   });\n * }\n * ```\n */\nexport const $resource = (\n  options: ResourcePrimitiveOptions,\n): ResourcePrimitive => {\n  return createPrimitive(ResourcePrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ResourcePrimitiveOptions {\n  /**\n   * The URI that identifies this resource.\n   *\n   * URIs should follow a consistent scheme for your application.\n   * Common patterns:\n   * - `file:///path/to/file` - File system resources\n   * - `db://table/id` - Database records\n   * - `api://endpoint` - API responses\n   * - `config://name` - Configuration values\n   *\n   * @example \"file:///readme.md\"\n   * @example \"db://users/123\"\n   */\n  uri: string;\n\n  /**\n   * Human-readable name for the resource.\n   *\n   * If not provided, defaults to the property key where the resource is declared.\n   *\n   * @example \"Project README\"\n   * @example \"User Profile\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this resource contains.\n   *\n   * Helps the LLM understand the purpose and content of the resource.\n   *\n   * @example \"The main README file for the project\"\n   */\n  description?: string;\n\n  /**\n   * MIME type of the resource content.\n   *\n   * Helps clients understand how to interpret the content.\n   *\n   * @default \"text/plain\"\n   * @example \"text/markdown\"\n   * @example \"application/json\"\n   */\n  mimeType?: string;\n\n  /**\n   * Handler function that returns the resource content.\n   *\n   * Called when the resource is read. Can return text or binary content.\n   *\n   * @returns Resource content with either `text` or `blob` property\n   */\n  handler: ResourceHandler;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the resource.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the URI of the resource.\n   */\n  public get uri(): string {\n    return this.options.uri;\n  }\n\n  /**\n   * Returns the description of the resource.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  /**\n   * Returns the MIME type of the resource.\n   */\n  public get mimeType(): string {\n    return this.options.mimeType ?? \"text/plain\";\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerResource(this);\n  }\n\n  /**\n   * Read the resource content.\n   *\n   * @param context - Optional context from the transport layer\n   * @returns The resource content\n   */\n  public async read(context?: McpContext): Promise<ResourceContent> {\n    return this.options.handler({ context });\n  }\n\n  /**\n   * Convert the resource to an MCP resource descriptor for protocol messages.\n   */\n  public toDescriptor(): McpResourceDescriptor {\n    return {\n      uri: this.uri,\n      name: this.name,\n      description: this.description,\n      mimeType: this.mimeType,\n    };\n  }\n}\n\n$resource[KIND] = ResourcePrimitive;\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpJsonSchema,\n  McpToolDescriptor,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  ToolPrimitiveSchema,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP tool primitive for defining callable functions.\n *\n * Tools are the primary way for LLMs to interact with external systems through MCP.\n * Each tool has a name, description, typed parameters, and a handler function.\n *\n * **Key Features**\n * - Full TypeScript inference for parameters and results\n * - Automatic schema validation using TypeBox\n * - JSON Schema generation for MCP protocol\n * - Integration with MCP server provider\n *\n * @example\n * ```ts\n * class CalculatorTools {\n *   add = $tool({\n *     description: \"Add two numbers together\",\n *     schema: {\n *       params: t.object({\n *         a: t.number(),\n *         b: t.number(),\n *       }),\n *       result: t.number(),\n *     },\n *     handler: async ({ params }) => {\n *       return params.a + params.b;\n *     },\n *   });\n *\n *   greet = $tool({\n *     description: \"Generate a greeting message\",\n *     schema: {\n *       params: t.object({\n *         name: t.text(),\n *       }),\n *       result: t.text(),\n *     },\n *     handler: async ({ params }) => {\n *       return `Hello, ${params.name}!`;\n *     },\n *   });\n * }\n * ```\n */\nexport const $tool = <T extends ToolPrimitiveSchema>(\n  options: ToolPrimitiveOptions<T>,\n): ToolPrimitive<T> => {\n  return createPrimitive(ToolPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ToolPrimitiveOptions<T extends ToolPrimitiveSchema> {\n  /**\n   * The name of the tool.\n   *\n   * If not provided, defaults to the property key where the tool is declared.\n   * Names should be descriptive and use kebab-case or snake_case.\n   *\n   * @example \"calculate-sum\"\n   * @example \"get_weather\"\n   */\n  name?: string;\n\n  /**\n   * A human-readable description of what the tool does.\n   *\n   * This description is sent to the LLM to help it understand\n   * when and how to use the tool. Be clear and specific.\n   *\n   * @example \"Calculate the sum of two numbers\"\n   * @example \"Retrieve current weather data for a given location\"\n   */\n  description: string;\n\n  /**\n   * TypeBox schema defining the tool's parameters and result type.\n   *\n   * - **params**: TObject schema for input parameters (optional)\n   * - **result**: TSchema for the return value (optional)\n   *\n   * Schemas provide:\n   * - Type inference for handler function\n   * - Runtime validation of inputs\n   * - JSON Schema generation for MCP protocol\n   */\n  schema?: T;\n\n  /**\n   * The handler function that executes when the tool is called.\n   *\n   * Receives validated parameters and returns the result.\n   * Errors thrown here are caught and returned as MCP errors.\n   *\n   * @param args - Object containing validated params\n   * @returns The tool result (can be async)\n   */\n  handler: (args: ToolHandlerArgs<T>) => Async<ToolHandlerResult<T>>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ToolPrimitive<T extends ToolPrimitiveSchema> extends Primitive<\n  ToolPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the tool.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the tool.\n   */\n  public get description(): string {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerTool(this);\n  }\n\n  /**\n   * Execute the tool with the given parameters.\n   *\n   * @param params - Raw parameters to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns The tool result\n   */\n  public async execute(\n    params: unknown,\n    context?: McpContext,\n  ): Promise<ToolHandlerResult<T>> {\n    let validatedParams: any = params ?? {};\n\n    // Validate params using alepha.codec if schema provided\n    if (this.options.schema?.params) {\n      validatedParams = this.alepha.codec.decode(\n        this.options.schema.params,\n        validatedParams,\n      );\n    }\n\n    const result = await this.options.handler({\n      params: validatedParams,\n      context,\n    });\n\n    // Validate and encode result if schema provided\n    if (this.options.schema?.result && result !== undefined) {\n      return this.alepha.codec.encode(\n        this.options.schema.result,\n        result,\n      ) as ToolHandlerResult<T>;\n    }\n\n    return result as ToolHandlerResult<T>;\n  }\n\n  /**\n   * Convert the tool to an MCP tool descriptor for protocol messages.\n   */\n  public toDescriptor(): McpToolDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      inputSchema: this.options.schema?.params\n        ? this.schemaToJsonSchema(this.options.schema.params)\n        : { type: \"object\", properties: {}, required: [] },\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to JSON Schema format.\n   */\n  protected schemaToJsonSchema(schema: TObject): McpJsonSchema {\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      properties[key] = this.propertyToJsonSchema(propSchema as TSchema);\n\n      // Check if property is required (not optional)\n      if (!t.schema.isOptional(propSchema as TSchema)) {\n        required.push(key);\n      }\n    }\n\n    return {\n      type: \"object\",\n      properties,\n      required,\n    };\n  }\n\n  /**\n   * Convert a single property schema to JSON Schema format.\n   */\n  protected propertyToJsonSchema(schema: TSchema): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    // Check for description on all types\n    if (\"description\" in schema) {\n      result.description = schema.description;\n    }\n\n    if (t.schema.isString(schema)) {\n      result.type = \"string\";\n      if (\"minLength\" in schema) result.minLength = schema.minLength;\n      if (\"maxLength\" in schema) result.maxLength = schema.maxLength;\n      if (\"pattern\" in schema) result.pattern = schema.pattern;\n      if (\"enum\" in schema) result.enum = schema.enum;\n    } else if (t.schema.isNumber(schema)) {\n      result.type = \"number\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isInteger(schema)) {\n      result.type = \"integer\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isBoolean(schema)) {\n      result.type = \"boolean\";\n    } else if (t.schema.isArray(schema)) {\n      result.type = \"array\";\n      if (\"items\" in schema) {\n        result.items = this.propertyToJsonSchema(schema.items as TSchema);\n      }\n    } else if (t.schema.isObject(schema)) {\n      Object.assign(result, this.schemaToJsonSchema(schema));\n    } else if (t.schema.isUnsafe(schema) || t.schema.isOptional(schema)) {\n      // Handle Unsafe types (like t.enum) and optional wrappers by checking the underlying type property\n      const schemaAny = schema as { type?: string; enum?: unknown[] };\n      if (schemaAny.type === \"string\") {\n        result.type = \"string\";\n        if (\"enum\" in schema) result.enum = schema.enum;\n        if (\"pattern\" in schema) result.pattern = schema.pattern;\n      } else if (schemaAny.type === \"number\") {\n        result.type = \"number\";\n      } else if (schemaAny.type === \"integer\") {\n        result.type = \"integer\";\n      } else if (schemaAny.type === \"boolean\") {\n        result.type = \"boolean\";\n      } else if (schemaAny.type === \"array\") {\n        result.type = \"array\";\n      } else if (schemaAny.type === \"object\") {\n        result.type = \"object\";\n      } else {\n        // Fallback\n        result.type = \"string\";\n      }\n    } else {\n      // Fallback for other types\n      result.type = \"string\";\n    }\n\n    return result;\n  }\n}\n\n$tool[KIND] = ToolPrimitive;\n","import { $env, $inject, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $route } from \"alepha/server\";\nimport {\n  createErrorResponse,\n  createNotification,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport type { McpContext } from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  MCP_SSE_PATH: t.text({\n    description: \"Path for MCP SSE endpoint\",\n    default: \"/mcp\",\n  }),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SSE (Server-Sent Events) transport for MCP communication.\n *\n * This transport uses HTTP with SSE for server-to-client messages\n * and POST requests for client-to-server messages.\n *\n * Endpoints:\n * - GET /mcp - SSE stream for server events\n * - POST /mcp - JSON-RPC request endpoint\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaServer } from \"alepha/server\";\n * import { AlephaMcp, AlephaMcpSse } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaServer)\n *     .with(AlephaMcp)\n *     .with(AlephaMcpSse)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class SseMcpTransport {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * SSE endpoint for server-to-client messages.\n   *\n   * Returns a text/event-stream response with server capabilities\n   * and keeps the connection open for notifications.\n   */\n  sse = $route({\n    method: \"GET\",\n    path: this.env.MCP_SSE_PATH,\n    handler: async (request) => {\n      this.log.debug(\"MCP SSE connection established\");\n\n      const encoder = new TextEncoder();\n\n      // Create SSE stream\n      const stream = new ReadableStream({\n        start: (controller) => {\n          // Send initial endpoint info\n          const endpointEvent = this.formatSseEvent(\n            \"endpoint\",\n            `${this.env.MCP_SSE_PATH}`,\n          );\n          controller.enqueue(encoder.encode(endpointEvent));\n\n          // Send capabilities notification\n          const capabilitiesNotification = createNotification(\n            \"notifications/capabilities\",\n            { capabilities: this.mcpServer.getCapabilities() },\n          );\n          const capabilitiesEvent = this.formatSseEvent(\n            \"message\",\n            JSON.stringify(capabilitiesNotification),\n          );\n          controller.enqueue(encoder.encode(capabilitiesEvent));\n        },\n        cancel: () => {\n          this.log.debug(\"MCP SSE connection closed\");\n        },\n      });\n\n      request.reply.status = 200;\n      request.reply.headers = {\n        \"content-type\": \"text/event-stream\",\n        \"cache-control\": \"no-cache\",\n        connection: \"keep-alive\",\n      };\n      request.reply.body = stream;\n    },\n  });\n\n  /**\n   * POST endpoint for client-to-server JSON-RPC messages.\n   */\n  message = $route({\n    method: \"POST\",\n    path: this.env.MCP_SSE_PATH,\n    schema: {\n      body: t.json(),\n    },\n    handler: async (request) => {\n      try {\n        const body =\n          typeof request.body === \"string\"\n            ? request.body\n            : JSON.stringify(request.body);\n\n        this.log.debug(\"MCP request body\", {\n          body,\n          bodyType: typeof request.body,\n        });\n\n        const rpcRequest = parseMessage(body);\n\n        // Build context from request headers\n        const headers = { ...request.headers } as Record<\n          string,\n          string | string[] | undefined\n        >;\n\n        const context: McpContext = { headers };\n\n        const response = await this.mcpServer.handleMessage(\n          rpcRequest,\n          context,\n        );\n\n        request.reply.headers[\"content-type\"] = \"application/json\";\n        request.reply.body = response ? JSON.stringify(response) : \"\";\n      } catch (error) {\n        if (error instanceof JsonRpcParseError) {\n          request.reply.status = 400;\n          request.reply.headers[\"content-type\"] = \"application/json\";\n          request.reply.body = JSON.stringify(\n            createErrorResponse(0, createParseError(error.message)),\n          );\n        } else {\n          this.log.error(\"Failed to process MCP message\", error);\n          request.reply.status = 500;\n          request.reply.body = JSON.stringify({\n            error: (error as Error).message,\n          });\n        }\n      }\n    },\n  });\n\n  /**\n   * Format a message as an SSE event.\n   */\n  protected formatSseEvent(event: string, data: string): string {\n    return `event: ${event}\\ndata: ${data}\\n\\n`;\n  }\n}\n","import * as readline from \"node:readline\";\nimport { $hook, $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  createErrorResponse,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Stdio transport for MCP communication.\n *\n * This transport uses stdin/stdout for JSON-RPC message exchange,\n * which is the standard transport for local MCP servers.\n *\n * Messages are newline-delimited JSON objects.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaMcp, AlephaMcpStdio } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaMcp)\n *     .with(AlephaMcpStdio)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class StdioMcpTransport {\n  protected readonly log = $logger();\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  protected rl?: readline.Interface;\n  protected started = false;\n\n  onStart = $hook({\n    on: \"start\",\n    handler: () => this.start(),\n  });\n\n  onStop = $hook({\n    on: \"stop\",\n    handler: () => this.stop(),\n  });\n\n  /**\n   * Start the stdio transport.\n   */\n  protected start(): void {\n    if (this.started) return;\n    this.started = true;\n\n    this.rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout,\n      terminal: false,\n    });\n\n    this.rl.on(\"line\", (line) => this.handleLine(line));\n    this.rl.on(\"close\", () => this.handleClose());\n\n    this.log.info(\"MCP stdio transport started\");\n  }\n\n  /**\n   * Stop the stdio transport.\n   */\n  protected stop(): void {\n    if (!this.started) return;\n    this.started = false;\n\n    this.rl?.close();\n    this.rl = undefined;\n\n    this.log.info(\"MCP stdio transport stopped\");\n  }\n\n  /**\n   * Handle an incoming line from stdin.\n   */\n  protected async handleLine(line: string): Promise<void> {\n    // Skip empty lines\n    if (!line.trim()) return;\n\n    try {\n      const request = parseMessage(line);\n      const response = await this.mcpServer.handleMessage(request);\n\n      if (response) {\n        this.send(response);\n      }\n    } catch (error) {\n      if (error instanceof JsonRpcParseError) {\n        // Send parse error response\n        this.send(createErrorResponse(0, createParseError(error.message)));\n      } else {\n        this.log.error(\"Failed to process MCP message\", error);\n      }\n    }\n  }\n\n  /**\n   * Handle stdin close event.\n   */\n  protected handleClose(): void {\n    this.log.debug(\"MCP stdio input closed\");\n  }\n\n  /**\n   * Send a message to stdout.\n   */\n  protected send(message: object): void {\n    const json = JSON.stringify(message);\n    process.stdout.write(`${json}\\n`);\n  }\n}\n","import { $module } from \"alepha\";\nimport { $prompt } from \"./primitives/$prompt.ts\";\nimport { $resource } from \"./primitives/$resource.ts\";\nimport { $tool } from \"./primitives/$tool.ts\";\nimport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nimport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nimport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport {\n  McpError,\n  McpErrorCodes,\n  McpForbiddenError,\n  McpInvalidParamsError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n  McpUnauthorizedError,\n} from \"./errors/McpError.ts\";\nexport {\n  createErrorResponse,\n  createInternalError,\n  createInvalidParamsError,\n  createInvalidRequestError,\n  createMethodNotFoundError,\n  createNotification,\n  createParseError,\n  createResponse,\n  isNotification,\n  isValidJsonRpcRequest,\n  JSONRPC_VERSION,\n  JsonRpcErrorCodes,\n  JsonRpcParseError,\n  MCP_PROTOCOL_VERSION,\n  parseMessage,\n} from \"./helpers/jsonrpc.ts\";\nexport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  // JSON-RPC types\n  JsonRpcRequest,\n  JsonRpcResponse,\n  // MCP protocol types\n  McpCapabilities,\n  McpClientInfo,\n  McpContent,\n  // Context type for auth/headers\n  McpContext,\n  McpInitializeParams,\n  McpInitializeResult,\n  McpJsonSchema,\n  McpPromptArgument,\n  McpPromptContent,\n  // Prompt types\n  McpPromptDescriptor,\n  McpPromptGetParams,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  // Resource types\n  McpResourceDescriptor,\n  McpResourceReadParams,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallParams,\n  McpToolCallResult,\n  // Tool types\n  McpToolDescriptor,\n  PromptHandler,\n  PromptHandlerArgs,\n  PromptMessage,\n  ResourceContent,\n  ResourceHandler,\n  ResourceHandlerArgs,\n  ToolHandler,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  // Handler types\n  ToolPrimitiveSchema,\n} from \"./interfaces/McpTypes.ts\";\nexport type { PromptPrimitiveOptions } from \"./primitives/$prompt.ts\";\nexport { $prompt, PromptPrimitive } from \"./primitives/$prompt.ts\";\nexport type { ResourcePrimitiveOptions } from \"./primitives/$resource.ts\";\nexport { $resource, ResourcePrimitive } from \"./primitives/$resource.ts\";\nexport type { ToolPrimitiveOptions } from \"./primitives/$tool.ts\";\nexport { $tool, ToolPrimitive } from \"./primitives/$tool.ts\";\nexport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nexport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nexport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | Stability | Since | Runtime |\n * |-----------|-------|---------|\n * | 3 - stable | 0.18.0 | node, bun|\n *\n * Model Context Protocol for AI tool integration.\n *\n * **Features:**\n * - MCP resource definitions\n * - MCP tool definitions\n * - MCP prompt definitions\n * - JSON-RPC protocol\n * - SSE and Stdio transports\n *\n * @module alepha.mcp\n */\nexport const AlephaMcp = $module({\n  name: \"alepha.mcp\",\n  primitives: [$tool, $resource, $prompt],\n  services: [McpServerProvider, SseMcpTransport, StdioMcpTransport],\n  register: (alepha) => {\n    alepha.with(McpServerProvider);\n  },\n});\n"],"mappings":"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"}

package/dist/orm/index.d.ts

@@ -6,7 +6,7 @@ import * as drizzle_orm_pg_core0 from "drizzle-orm/pg-core";
 import { LockConfig, LockStrength, PgColumn, PgColumnBuilderBase, PgDatabase, PgInsertValue, PgSchema, PgSelectBase, PgSequenceOptions, PgTableExtraConfigValue, PgTableWithColumns, PgTransaction, UpdateDeleteAction } from "drizzle-orm/pg-core";
 import * as drizzle_orm0 from "drizzle-orm";
 import { BuildColumns, BuildExtraConfigColumns, SQL, SQLWrapper, sql } from "drizzle-orm";
-import * as alepha_logger4 from "alepha/logger";
+import * as alepha_logger3 from "alepha/logger";
 import * as alepha_lock0 from "alepha/lock";
 import * as pg$1 from "drizzle-orm/sqlite-core";
 import { SQLiteColumnBuilderBase } from "drizzle-orm/sqlite-core";
@@ -326,7 +326,7 @@ declare abstract class ModelBuilder {
 //#endregion
 //#region ../../src/orm/providers/DrizzleKitProvider.d.ts
 declare class DrizzleKitProvider {
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected readonly alepha: Alepha;
   /**
    * Synchronize database with current schema definitions.
@@ -374,7 +374,7 @@ type DevMigrations = Static<typeof devMigrationsSchema>;
 type SQLLike = SQLWrapper | string;
 declare abstract class DatabaseProvider {
   protected readonly alepha: Alepha;
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected abstract readonly builder: ModelBuilder;
   protected abstract readonly kit: DrizzleKitProvider;
   abstract readonly db: PgDatabase<any>;
@@ -630,7 +630,7 @@ declare module "alepha" {
  */
 declare class NodeSqliteProvider extends DatabaseProvider {
   protected readonly kit: DrizzleKitProvider;
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected readonly env: {
     DATABASE_URL?: string | undefined;
   };
@@ -1532,7 +1532,7 @@ declare class PgRelationManager {
 declare abstract class Repository<T extends TObject> {
   readonly entity: EntityPrimitive<T>;
   readonly provider: DatabaseProvider;
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected readonly relationManager: PgRelationManager;
   protected readonly queryManager: QueryManager;
   protected readonly dateTimeProvider: DateTimeProvider;
@@ -1982,7 +1982,7 @@ interface D1ExecResult {
  */
 declare class CloudflareD1Provider extends DatabaseProvider {
   protected readonly kit: DrizzleKitProvider;
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected readonly builder: SqliteModelBuilder;
   protected readonly env: {
     DATABASE_URL: string;
@@ -2103,7 +2103,7 @@ declare const envSchema$1: alepha26.TObject<{
  * ```
  */
 declare class BunPostgresProvider extends DatabaseProvider {
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected readonly env: {
     DATABASE_URL?: string | undefined;
     POSTGRES_SCHEMA?: string | undefined;
@@ -2178,7 +2178,7 @@ declare module "alepha" {
  */
 declare class BunSqliteProvider extends DatabaseProvider {
   protected readonly kit: DrizzleKitProvider;
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected readonly env: {
     DATABASE_URL?: string | undefined;
   };
@@ -2220,7 +2220,7 @@ declare const envSchema: alepha26.TObject<{
 }>;
 declare class NodePostgresProvider extends DatabaseProvider {
   static readonly SSL_MODES: readonly ["require", "allow", "prefer", "verify-full"];
-  protected readonly log: alepha_logger4.Logger;
+  protected readonly log: alepha_logger3.Logger;
   protected readonly env: {
     DATABASE_URL?: string | undefined;
     POSTGRES_SCHEMA?: string | undefined;
@@ -2331,9 +2331,9 @@ declare module "alepha" {
 }
 declare const SqliteProvider: typeof NodeSqliteProvider;
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | backend | epic | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.1.0 | node, bun, workerd|
  *
  * Full-featured database abstraction built on Drizzle ORM with complete type safety.
  *

package/dist/orm/index.js

@@ -1366,7 +1366,7 @@ var NodeSqliteProvider = class extends DatabaseProvider {
 			}
 			this.sqlite = new DatabaseSync(filepath);
 			if (!this.alepha.isServerless()) await this.migrate();
-			this.log.info(`Using SQLite database at ${filepath}`);
+			this.log.info(`SQLite database OK`, { at: filepath });
 		}
 	});
 	async executeMigrations(migrationsFolder) {
@@ -2975,9 +2975,9 @@ var orm_exports = /* @__PURE__ */ __exportAll({
 });
 const SqliteProvider = NodeSqliteProvider;
 /**
-* | type | quality | stability |
-* |------|---------|-----------|
-* | backend | epic | stable |
+* | Stability | Since | Runtime |
+* |-----------|-------|---------|
+* | 3 - stable | 0.1.0 | node, bun, workerd|
 *
 * Full-featured database abstraction built on Drizzle ORM with complete type safety.
 *