@muggleai/mcp 1.0.0

package/dist/qa/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/qa/contracts/index.ts"],"names":[],"mappings":"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"}

package/dist/qa/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * QA Gateway tools module.
+ * Cloud-based QA tools that require authentication.
+ */
+import type { IMcpTool } from "../shared/types.js";
+export * from "./contracts/index.js";
+export * from "./tools/index.js";
+export * from "./types.js";
+export * from "./upstream-client.js";
+/**
+ * Convert QA tool definitions to IMcpTool format.
+ * @returns Array of IMcpTool definitions.
+ */
+export declare function getQaTools(): IMcpTool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/qa/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qa/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AAErC;;;GAGG;AACH,wBAAgB,UAAU,IAAI,QAAQ,EAAE,CAUvC"}

package/dist/qa/tools/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * QA tools module exports.
+ */
+export * from "./tool-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/qa/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/qa/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC"}

package/dist/qa/tools/tool-registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * QA Tool registry - maps tool names to their implementations.
+ */
+import type { IMcpToolResult } from "../../shared/types.js";
+import { IQaToolDefinition } from "../types.js";
+/** All QA tool definitions. */
+export declare const allQaToolDefinitions: IQaToolDefinition[];
+/**
+ * Get a QA tool definition by name.
+ * @param name - Tool name.
+ * @returns Tool definition or undefined.
+ */
+export declare function getQaToolByName(name: string): IQaToolDefinition | undefined;
+/**
+ * Execute a QA tool.
+ * @param toolName - Tool name.
+ * @param input - Tool input.
+ * @param correlationId - Correlation ID.
+ * @returns Tool result.
+ */
+export declare function executeQaTool(toolName: string, input: unknown, correlationId: string): Promise<IMcpToolResult>;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/qa/tools/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/qa/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAgB,iBAAiB,EAAqB,MAAM,aAAa,CAAC;AA0hCjF,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAWnD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE3E;AAWD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,CAAC,CAyEzB"}

package/dist/qa/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Type definitions for QA Gateway tools.
+ */
+import type { ZodSchema } from "zod";
+/**
+ * MCP error codes.
+ */
+export declare enum McpErrorCode {
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    NOT_FOUND = "NOT_FOUND",
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+    UPSTREAM_ERROR = "UPSTREAM_ERROR",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+/**
+ * Gateway error with MCP error code.
+ */
+export declare class GatewayError extends Error {
+    /** MCP error code. */
+    readonly code: McpErrorCode;
+    /** HTTP status code (if applicable). */
+    readonly statusCode?: number;
+    /** Additional error details. */
+    readonly details?: Record<string, unknown>;
+    constructor(params: {
+        code: McpErrorCode;
+        message: string;
+        statusCode?: number;
+        details?: Record<string, unknown>;
+    });
+}
+/**
+ * Mapped upstream HTTP call specification.
+ */
+export interface IUpstreamCall {
+    /** HTTP method. */
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    /** Path relative to prompt-service base URL. */
+    path: string;
+    /** Query parameters. */
+    queryParams?: Record<string, string | number | boolean | undefined>;
+    /** Request body (for POST/PUT/PATCH). */
+    body?: unknown;
+    /** Optional multipart form-data upload. */
+    multipartFormData?: {
+        /** Field name for the uploaded file (e.g., "file"). */
+        fileFieldName: string;
+        /** File name to provide to upstream. */
+        fileName: string;
+        /** MIME type for the uploaded file. */
+        contentType: string;
+        /** Base64-encoded file bytes. */
+        fileBase64: string;
+    };
+    /** Timeout in milliseconds (overrides default). */
+    timeoutMs?: number;
+}
+/**
+ * Upstream response.
+ */
+export interface IUpstreamResponse<T = unknown> {
+    /** HTTP status code. */
+    statusCode: number;
+    /** Response data. */
+    data: T;
+    /** Response headers. */
+    headers: Record<string, string>;
+}
+/**
+ * Caller credentials for API requests.
+ */
+export interface ICallerCredentials {
+    /** Bearer token (from device code flow or config). */
+    bearerToken?: string;
+    /** API key (from device code flow or config). */
+    apiKey?: string;
+}
+/**
+ * QA tool definition with schema, description, and implementation.
+ */
+export interface IQaToolDefinition {
+    /** Tool name (used in MCP). */
+    name: string;
+    /** Tool description (shown to LLM). */
+    description: string;
+    /** Input schema (Zod). */
+    inputSchema: ZodSchema;
+    /** Whether this tool requires authentication (default: true). */
+    requiresAuth?: boolean;
+    /** Map validated input to upstream call. */
+    mapToUpstream: (input: unknown) => IUpstreamCall;
+    /** Map upstream response to tool output. */
+    mapFromUpstream?: (response: IUpstreamResponse, input?: unknown) => unknown;
+    /**
+     * Local handler for tools that don't make upstream calls.
+     * Used for auth tools and recommendation tools.
+     */
+    localHandler?: (input: unknown) => Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/qa/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/qa/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;GAEG;AACH,oBAAY,YAAY;IACtB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,sBAAsB;IACtB,SAAgB,IAAI,EAAE,YAAY,CAAC;IAEnC,wCAAwC;IACxC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC,gCAAgC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,MAAM,EAAE;QAClB,IAAI,EAAE,YAAY,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAOF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEpD,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAEpE,yCAAyC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE;QAClB,uDAAuD;QACvD,aAAa,EAAE,MAAM,CAAC;QACtB,wCAAwC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,uCAAuC;QACvC,WAAW,EAAE,MAAM,CAAC;QACpB,iCAAiC;QACjC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,WAAW,EAAE,SAAS,CAAC;IAEvB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,4CAA4C;IAC5C,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,aAAa,CAAC;IAEjD,4CAA4C;IAC5C,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAE5E;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD"}

package/dist/qa/upstream-client.d.ts

@@ -0,0 +1,60 @@
+/**
+ * HTTP client for forwarding requests to prompt-service.
+ */
+import { ICallerCredentials, IUpstreamCall, IUpstreamResponse } from "./types.js";
+/**
+ * Client for forwarding requests to prompt-service with auth passthrough.
+ */
+export declare class PromptServiceClient {
+    private readonly httpClient;
+    private readonly baseUrl;
+    private readonly requestTimeoutMs;
+    constructor();
+    /**
+     * Validate that the upstream path is within the allowed prefix.
+     * @param path - Path to validate.
+     * @throws GatewayError if path is not allowed.
+     */
+    private validatePath;
+    /**
+     * Build headers for upstream request with credential forwarding.
+     * @param credentials - Caller credentials to forward.
+     * @param correlationId - Request correlation ID.
+     * @returns Headers object.
+     */
+    private buildHeaders;
+    /**
+     * Build query string from parameters.
+     * @param params - Query parameters.
+     * @returns Query string (without leading '?').
+     */
+    private buildQueryString;
+    /**
+     * Map HTTP status code to MCP error code.
+     * @param statusCode - HTTP status code.
+     * @returns MCP error code.
+     */
+    private mapStatusToErrorCode;
+    /**
+     * Format upstream error response into a user-friendly message.
+     * @param statusCode - HTTP status code.
+     * @param data - Response data from upstream.
+     * @returns User-friendly error message.
+     */
+    private formatUpstreamErrorMessage;
+    /**
+     * Execute an upstream call to prompt-service.
+     * @param call - Upstream call specification.
+     * @param credentials - Caller credentials to forward.
+     * @param correlationId - Request correlation ID.
+     * @returns Upstream response.
+     * @throws GatewayError on validation or upstream errors.
+     */
+    execute<T = unknown>(call: IUpstreamCall, credentials: ICallerCredentials, correlationId: string): Promise<IUpstreamResponse<T>>;
+}
+/**
+ * Get the PromptServiceClient instance (singleton).
+ * @returns PromptServiceClient instance.
+ */
+export declare function getPromptServiceClient(): PromptServiceClient;
+//# sourceMappingURL=upstream-client.d.ts.map

package/dist/qa/upstream-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-client.d.ts","sourceRoot":"","sources":["../../src/qa/upstream-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAEL,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EAElB,MAAM,YAAY,CAAC;AASpB;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;;IAc1C;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAgBpB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAqBpB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAiDlC;;;;;;;OAOG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,kBAAkB,EAC/B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CA4HjC;AAKD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D"}

package/dist/server/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Server module exports for @muggleai/mcp.
+ */
+export * from "./mcp-server.js";
+export * from "./stdio-server.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Unified MCP server implementation for @muggleai/mcp.
+ * Combines QA Gateway and Local QA tools into a single server.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { IMcpTool } from "../shared/types.js";
+/** Options for creating the unified MCP server. */
+export interface IUnifiedMcpServerOptions {
+    /** Enable Cloud QA tools. */
+    enableQaTools: boolean;
+    /** Enable Local QA tools. */
+    enableLocalTools: boolean;
+}
+/**
+ * Register tools with the server.
+ * @param tools - Tools to register.
+ */
+export declare function registerTools(tools: IMcpTool[]): void;
+/**
+ * Get all registered tools.
+ * @returns Array of registered tools.
+ */
+export declare function getAllTools(): IMcpTool[];
+/**
+ * Clear all registered tools (for testing).
+ */
+export declare function clearTools(): void;
+/**
+ * Create and configure the unified MCP server.
+ * @param options - Server options.
+ * @returns Configured MCP Server instance.
+ */
+export declare function createUnifiedMcpServer(options: IUnifiedMcpServerOptions): Server;
+//# sourceMappingURL=mcp-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAanE,OAAO,KAAK,EAAsB,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEvE,mDAAmD;AACnD,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,6BAA6B;IAC7B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,EAAE,CAExC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AA+KD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAoLhF"}

package/dist/server/stdio-server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stdio server implementation for @muggleai/mcp.
+ * Runs the MCP server using stdin/stdout transport.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * Start the MCP server using stdio transport.
+ * @param server - Configured MCP Server instance.
+ */
+export declare function startStdioServer(server: Server): Promise<void>;
+//# sourceMappingURL=stdio-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../../src/server/stdio-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOnE;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpE"}

package/dist/shared/auth.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Authentication module for @muggleai/mcp.
+ * Implements device code flow for user authentication.
+ */
+import type { IAuth0Config, ICallerCredentials, IDeviceCodePollResponse, IDeviceCodeResponse, IStoredCredentials } from "./types.js";
+/**
+ * Start the device code authorization flow.
+ * Returns a device code and verification URL for the user.
+ *
+ * @param config - Auth0 configuration.
+ * @returns Device code response with URLs and codes.
+ * @throws Error if the device code request fails.
+ */
+export declare function startDeviceCodeFlow(config: IAuth0Config): Promise<IDeviceCodeResponse>;
+/**
+ * Poll for device code authorization completion.
+ * Should be called at the interval specified in startDeviceCodeFlow response.
+ *
+ * @param config - Auth0 configuration.
+ * @param deviceCode - The device code from startDeviceCodeFlow.
+ * @returns Poll response with status and optionally access token.
+ */
+export declare function pollDeviceCode(config: IAuth0Config, deviceCode: string): Promise<IDeviceCodePollResponse>;
+/**
+ * Create an API key using an access token.
+ * Calls the prompt service API to create a new API key.
+ *
+ * @param accessToken - Auth0 access token.
+ * @param keyName - Optional name for the API key.
+ * @param expiry - Expiry option ('30d', '90d', '1y', 'never').
+ * @returns Created API key details.
+ */
+export declare function createApiKeyWithToken(accessToken: string, keyName: string | undefined, expiry?: "30d" | "90d" | "1y" | "never"): Promise<{
+    id: string;
+    key: string;
+    name: string | null;
+    status: string;
+    prefix: string;
+    lastFour: string;
+    createdAt: number;
+    expiresAt: number | null;
+}>;
+/**
+ * Complete the full device code login flow.
+ * Starts the flow, waits for user authorization, and creates credentials.
+ *
+ * @param keyName - Optional name for the API key.
+ * @param keyExpiry - Expiry option for API key.
+ * @param timeoutMs - Maximum time to wait for authorization.
+ * @returns Result of the login flow.
+ */
+export declare function performLogin(keyName?: string, keyExpiry?: "30d" | "90d" | "1y" | "never", timeoutMs?: number): Promise<{
+    success: boolean;
+    deviceCodeResponse?: IDeviceCodeResponse;
+    credentials?: IStoredCredentials;
+    error?: string;
+}>;
+/**
+ * Perform logout by clearing credentials.
+ */
+export declare function performLogout(): void;
+/**
+ * Get caller credentials for API requests.
+ * Returns credentials from storage if available and valid.
+ * @returns Caller credentials or empty object.
+ */
+export declare function getCallerCredentials(): ICallerCredentials;
+/**
+ * Check if authentication is required for the given tool.
+ * Local-only tools don't require auth.
+ * @param toolName - Name of the tool.
+ * @returns True if tool requires authentication.
+ */
+export declare function toolRequiresAuth(toolName: string): boolean;
+//# sourceMappingURL=auth.d.ts.map

package/dist/shared/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/shared/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkE5F;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC,CA2ElC;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,GAAE,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,OAAe,GAC7C,OAAO,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC,CAyCD;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,GAAE,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,OAAe,EACjD,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAiFD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAczD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuD1D"}

package/dist/shared/config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Configuration management for @muggleai/mcp.
+ * Unified configuration for both QA Gateway and Local QA.
+ */
+import type { IConfig } from "./types.js";
+/**
+ * Get the Muggle AI data directory path.
+ * @returns Path to ~/.muggle-ai
+ */
+export declare function getDataDir(): string;
+/**
+ * Get the unified application configuration.
+ * @returns The application configuration.
+ */
+export declare function getConfig(): IConfig;
+/**
+ * Reset the configuration (for testing).
+ */
+export declare function resetConfig(): void;
+/**
+ * Get the expected electron-app version from package.json.
+ * @returns The electron-app version string.
+ */
+export declare function getElectronAppVersion(): string;
+/**
+ * Get the download base URL for electron-app binaries.
+ * @returns The base URL for downloads.
+ */
+export declare function getDownloadBaseUrl(): string;
+/**
+ * Check if the electron-app binary is installed for the expected version.
+ * @returns True if the binary is installed and accessible.
+ */
+export declare function isElectronAppInstalled(): boolean;
+/**
+ * Get the electron-app directory path for a specific version.
+ * @param version - Version string (defaults to configured version).
+ * @returns Path to the electron-app version directory.
+ */
+export declare function getElectronAppDir(version?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/shared/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAgB,OAAO,EAA6B,MAAM,YAAY,CAAC;AAyFnF;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAsLD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAenC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D"}

package/dist/shared/credentials.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Credentials storage for @muggleai/mcp.
+ * Manages persistent storage of authentication credentials.
+ */
+import type { IStoredCredentials } from "./types.js";
+/**
+ * Get the path to the credentials file.
+ * @returns Path to credentials.json
+ */
+export declare function getCredentialsFilePath(): string;
+/**
+ * Load stored credentials from disk.
+ * @returns Stored credentials, or null if not found or invalid.
+ */
+export declare function loadCredentials(): IStoredCredentials | null;
+/**
+ * Save credentials to disk.
+ * @param credentials - Credentials to save.
+ */
+export declare function saveCredentials(credentials: IStoredCredentials): void;
+/**
+ * Delete stored credentials.
+ */
+export declare function deleteCredentials(): void;
+/**
+ * Check if credentials are expired.
+ * @param credentials - Credentials to check.
+ * @returns True if expired.
+ */
+export declare function isCredentialsExpired(credentials: IStoredCredentials): boolean;
+/**
+ * Get valid credentials if available.
+ * Returns null if no credentials or if expired.
+ * @returns Valid credentials or null.
+ */
+export declare function getValidCredentials(): IStoredCredentials | null;
+/**
+ * Get authentication status.
+ * @returns Object with authentication status information.
+ */
+export declare function getAuthStatus(): {
+    authenticated: boolean;
+    email?: string;
+    userId?: string;
+    expiresAt?: string;
+    hasApiKey: boolean;
+};
+//# sourceMappingURL=credentials.d.ts.map

package/dist/shared/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/shared/credentials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAYD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,GAAG,IAAI,CA0B3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAiBrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAcxC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,GAAG,IAAI,CAa/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,CAmBA"}

package/dist/shared/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared module exports for @muggleai/mcp.
+ */
+export * from "./auth.js";
+export * from "./config.js";
+export * from "./credentials.js";
+export * from "./logger.js";
+export * from "./open-browser.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/shared/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Logger module for @muggleai/mcp.
+ * Provides structured logging using Winston.
+ */
+import winston from "winston";
+/**
+ * Get the logger instance (singleton).
+ * @returns Winston logger.
+ */
+export declare function getLogger(): winston.Logger;
+/**
+ * Create a child logger with additional context.
+ * @param correlationId - Request correlation ID.
+ * @returns Child logger with correlation context.
+ */
+export declare function createChildLogger(correlationId: string): winston.Logger;
+/**
+ * Reset the logger (for testing).
+ */
+export declare function resetLogger(): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/shared/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAoC9B;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,CAK1C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/shared/open-browser.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Browser opening utility for @muggleai/mcp.
+ * Opens URLs in the user's default browser.
+ */
+/**
+ * Result of attempting to open a browser.
+ */
+export interface IBrowserOpenResult {
+    /** Whether the browser was successfully opened. */
+    opened: boolean;
+    /** Error message if failed to open. */
+    error?: string;
+}
+/**
+ * Options for opening a browser.
+ */
+export interface IBrowserOpenOptions {
+    /** URL to open. */
+    url: string;
+}
+/**
+ * Open a URL in the user's default browser.
+ * @param options - Options containing the URL to open.
+ * @returns Result indicating success or failure.
+ */
+export declare function openBrowserUrl(options: IBrowserOpenOptions): Promise<IBrowserOpenResult>;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/shared/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../src/shared/open-browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAsBD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkC9F"}