@mikoto_zero/minigame-open-mcp 1.2.0-beta.8 → 1.2.1

package/dist/features/h5Game/tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * H5 Game Tools
+ * MCP Tool definitions using unified format (ToolRegistration[])
+ *
+ * Note: Developer and app listing tools are provided by the app module.
+ * Use list_developers_and_apps and select_app from app module for those operations.
+ */
+import type { ToolRegistration } from '../../core/types/index.js';
+/**
+ * H5 Game Tools - Unified Format
+ * Each tool includes both definition and handler in a single object
+ */
+export declare const h5GameTools: ToolRegistration[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/features/h5Game/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/features/h5Game/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AASlE;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAgB,EA2KzC,CAAC"}

package/dist/features/h5Game/tools.js

@@ -0,0 +1,181 @@
+/**
+ * H5 Game Tools
+ * MCP Tool definitions using unified format (ToolRegistration[])
+ *
+ * Note: Developer and app listing tools are provided by the app module.
+ * Use list_developers_and_apps and select_app from app module for those operations.
+ */
+import { TOOL_DESCRIPTION } from './messages.js';
+import { handleGatherGameInfo, handleUploadGame, handleCreateApp, handleEditApp, } from './handlers.js';
+/**
+ * H5 Game Tools - Unified Format
+ * Each tool includes both definition and handler in a single object
+ */
+export const h5GameTools = [
+    // 1. 收集 H5 游戏信息
+    {
+        definition: {
+            name: 'h5_game_info_gatherer',
+            description: `
+        [H5 Game Upload Workflow - Step 1]
+        Use this tool when user wants to publish/upload/deploy H5 game ('发布', '上传', '部署').
+
+        This tool will:
+        1. Verify the game project directory (must contain index.html)
+        2. Auto-select developer/app if only one exists
+        3. Show developer/app list if multiple exist (user can provide developerId/appId to select)
+        4. Use cached selection if available
+
+        After gathering info, use h5_game_uploader to upload the game.
+
+        Note: For general app management (not H5 upload), use list_developers_and_apps and select_app instead.
+      `,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectPath: {
+                        type: 'string',
+                        description: 'The absolute path to the H5 game project directory (must contain index.html)',
+                    },
+                    genre: {
+                        type: 'string',
+                        description: TOOL_DESCRIPTION.GENRE_DESCRIPTION,
+                    },
+                    developerName: {
+                        type: 'string',
+                        description: 'The name of the developer, if not provided, can be empty',
+                    },
+                    developerId: {
+                        type: 'number',
+                        description: 'The developer id of the developer, if not provided, can be empty',
+                    },
+                    appId: {
+                        type: 'number',
+                        description: 'The app id of the game, if not provided, can be empty',
+                    },
+                },
+            },
+        },
+        handler: async (args) => {
+            return await handleGatherGameInfo(args);
+        },
+    },
+    // 2. 上传 H5 游戏
+    {
+        definition: {
+            name: 'h5_game_uploader',
+            description: `
+        When the user confirms the game information from h5_game_info_gatherer, or has previously confirmed it.
+        Please use this tool to upload the H5 game to TapTap platform.
+      `,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectPath: {
+                        type: 'string',
+                        description: 'The absolute path to the H5 game project directory (must contain index.html)',
+                    },
+                    genre: {
+                        type: 'string',
+                        description: TOOL_DESCRIPTION.GENRE_DESCRIPTION,
+                    },
+                    developerName: {
+                        type: 'string',
+                        description: 'The name of the developer, if not provided, can be empty',
+                    },
+                    developerId: {
+                        type: 'number',
+                        description: 'The developer id of the developer',
+                    },
+                    appId: {
+                        type: 'number',
+                        description: 'The app id of the game',
+                    },
+                    appName: {
+                        type: 'string',
+                        description: 'The name of the app, if not provided, can be empty',
+                    },
+                },
+            },
+        },
+        handler: async (args) => {
+            return await handleUploadGame(args);
+        },
+    },
+    // 3. 创建 H5 游戏
+    {
+        definition: {
+            name: 'h5_create_app',
+            description: 'User wants to create a new H5 game on TapTap platform',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    developerId: {
+                        type: 'number',
+                        description: 'The developer id of the app. Leave empty if the user has not specified a particular ID',
+                    },
+                    appName: {
+                        type: 'string',
+                        description: 'The name of the app',
+                    },
+                    genre: {
+                        type: 'string',
+                        description: TOOL_DESCRIPTION.GENRE_DESCRIPTION,
+                    },
+                },
+            },
+        },
+        handler: async (args) => {
+            return await handleCreateApp(args);
+        },
+    },
+    // 5. 编辑 H5 游戏
+    {
+        definition: {
+            name: 'h5_edit_app',
+            description: "User wants to edit the H5 game's name, genre, description, chatting_label, chatting_number, screen_orientation on TapTap platform",
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    developerId: {
+                        type: 'number',
+                        description: 'The developer id of the app',
+                    },
+                    appId: {
+                        type: 'number',
+                        description: 'The app id of the game',
+                    },
+                    appName: {
+                        type: 'string',
+                        description: 'The name of the app, if not provided, can be empty',
+                    },
+                    genre: {
+                        type: 'string',
+                        description: TOOL_DESCRIPTION.GENRE_DESCRIPTION,
+                    },
+                    description: {
+                        type: 'string',
+                        description: 'The description of the craft, if not provided, can be empty',
+                    },
+                    chattingLabel: {
+                        type: 'string',
+                        description: 'The name of the QQ group, if not provided, can be empty',
+                    },
+                    chattingNumber: {
+                        type: 'string',
+                        description: 'The number of the QQ group, if not provided, can be empty',
+                    },
+                    screenOrientation: {
+                        type: 'number',
+                        description: 'The screen orientation of the app, 1: vertical, 2: horizontal, if not provided, can be empty',
+                    },
+                },
+                required: ['developerId', 'appId'],
+            },
+        },
+        handler: async (args) => {
+            return await handleEditApp(args);
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/features/h5Game/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/features/h5Game/tools.ts"],"names":[],"mappings":"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"}

package/dist/features/h5Game/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Tap 开发者身份信息
+ */
+export interface TapDeveloperInfo {
+    /** 游戏列表 */
+    levels: TapAppItem[];
+    /** 开发者 ID */
+    developer_id: number;
+    /** 开发者名称 */
+    developer_name: string;
+    /** 是否已认证 */
+    is_certified: boolean;
+}
+/**
+ * H5 游戏信息
+ */
+export interface TapAppItem {
+    /** 游戏 ID */
+    app_id: number;
+    /** 分类 */
+    category: string;
+    /** 游戏标题 */
+    app_title: string;
+    /** 是否已发布 */
+    is_published: boolean;
+}
+/**
+ * 上传参数
+ */
+export interface UploadParams {
+    /** 上传包 ID */
+    h5_package_id: number;
+    /** 上传 URL */
+    url: string;
+    /** 上传方法 */
+    method: string;
+    /** 上传头 */
+    headers: Record<string, string>;
+}
+/**
+ * 创建开发者身份响应
+ */
+export interface CreateDeveloperResponse {
+    /** 开发者名称 */
+    developer_name: string;
+    /** 开发者 ID */
+    developer_id: number;
+}
+/**
+ * 创建游戏响应
+ */
+export interface CreateAppResponse {
+    /** 应用 ID */
+    app_id: number;
+    /** 应用标题 */
+    app_title: string;
+    /** 显示应用标题 */
+    display_app_title: string;
+}
+/**
+ * 编辑游戏响应
+ */
+export interface EditAppResponse {
+    /** 游戏标题 */
+    app_title?: string;
+    /** 显示应用标题 */
+    display_app_title?: string;
+}
+/**
+ * 游戏详情响应
+ */
+export interface AppDetailAPIResponse {
+    /** 游戏详情 */
+    level?: {
+        /** 显示应用标题 */
+        display_app_title?: string;
+        /** 开发者 ID */
+        developer_id?: number;
+        /** 开发者名称 */
+        developer_name?: string;
+    };
+    /** 上传游戏详情 */
+    upload_level?: {
+        /** 游戏 ID */
+        app_id: number;
+        /** 表单数据 */
+        form_data: {
+            /** 游戏信息 */
+            info: {
+                /** 游戏标题 */
+                title: string;
+            };
+        };
+    };
+}
+/**
+ * 游戏状态响应
+ */
+export interface AppStatusResponse {
+    /** 审核状态：0-未发布，1-审核中，2-审核失败，3-已上线 */
+    review_status: number;
+}
+/**
+ * App 详情
+ */
+export interface AppDetail {
+    appId: number;
+    appTitle: string;
+    displayAppTitle: string;
+    developerId: number;
+    developerName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/h5Game/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/h5Game/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY;IACZ,cAAc,EAAE,MAAM,CAAC;IAEvB,YAAY;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS;IACT,QAAQ,EAAE,MAAM,CAAC;IAEjB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;IAEtB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IAEZ,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IAEf,UAAU;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY;IACZ,cAAc,EAAE,MAAM,CAAC;IAEvB,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAElB,aAAa;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,aAAa;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW;IACX,KAAK,CAAC,EAAE;QACN,aAAa;QACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B,aAAa;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,YAAY;QACZ,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,aAAa;IACb,YAAY,CAAC,EAAE;QACb,YAAY;QACZ,MAAM,EAAE,MAAM,CAAC;QAEf,WAAW;QACX,SAAS,EAAE;YACT,WAAW;YACX,IAAI,EAAE;gBACJ,WAAW;gBACX,KAAK,EAAE,MAAM,CAAC;aACf,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/features/h5Game/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/h5Game/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/h5Game/types.ts"],"names":[],"mappings":""}

package/dist/{network/leaderboardApi.d.ts → features/leaderboard/api.d.ts}

@@ -2,7 +2,6 @@
  * TapTap Leaderboard Management API
  * Server-side leaderboard operations
  */
-import { AppCacheInfo } from '../utils/cache.js';
 /**
  * Period types for leaderboard
  * WARNING: 0 = UNSPECIFIED (invalid), do NOT use 0!
@@ -73,68 +72,6 @@ export interface CreateLeaderboardResponse {
  * @returns Created leaderboard information
  */
 export declare function createLeaderboard(params: CreateLeaderboardParams): Promise<CreateLeaderboardResponse>;
-/**
- * Craft/App item in developer list
- */
-export interface CraftItem {
-    app_id: number;
-    app_title: string;
-    miniapp_id?: string;
-    category?: string;
-    is_published?: boolean;
-}
-/**
- * Developer with levels/apps list
- */
-export interface DeveloperCraftList {
-    developer_id: number;
-    developer_name: string;
-    levels: CraftItem[];
-    crafts?: CraftItem[];
-}
-/**
- * Level list response
- */
-export interface LevelListResponse {
-    list: DeveloperCraftList[];
-}
-/**
- * Selection required error - thrown when multiple options exist
- */
-export declare class SelectionRequiredError extends Error {
-    readonly developers: DeveloperCraftList[];
-    constructor(message: string, developers: DeveloperCraftList[]);
-}
-/**
- * Get app/level list information for current user
- * Returns all developers and their apps/games
- * @param projectPath - Optional project path for cache lookup
- * @param autoSelect - If true, automatically selects first option. If false, throws SelectionRequiredError when multiple options exist
- * @returns App information including developer_id and app_id
- * @throws SelectionRequiredError when multiple developers/apps exist and autoSelect is false
- */
-export declare function getAppInfo(projectPath?: string, autoSelect?: boolean): Promise<AppCacheInfo>;
-/**
- * Get or fetch app information with automatic caching
- * @param projectPath - Optional project path
- * @param autoSelect - If true, automatically selects first option. If false, throws SelectionRequiredError when multiple options exist
- * @returns App information from cache or API
- * @throws SelectionRequiredError when multiple developers/apps exist and autoSelect is false
- */
-export declare function ensureAppInfo(projectPath?: string, autoSelect?: boolean): Promise<AppCacheInfo>;
-/**
- * Select and cache a specific developer and app
- * @param developerId - Developer ID to select
- * @param appId - App ID to select
- * @param projectPath - Optional project path for cache storage
- * @returns Selected app information
- */
-export declare function selectApp(developerId: number, appId: number, projectPath?: string): Promise<AppCacheInfo>;
-/**
- * Get all developers and apps for selection
- * @returns List of all developers and their apps
- */
-export declare function getAllDevelopersAndApps(): Promise<LevelListResponse>;
 /**
  * Leaderboard item in list
  */
@@ -216,4 +153,4 @@ export declare const EnumDescriptions: {
         3: string;
     };
 };
-//# sourceMappingURL=leaderboardApi.d.ts.map
+//# sourceMappingURL=api.d.ts.map

package/dist/features/leaderboard/api.d.ts.map

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

package/dist/{network/leaderboardApi.js → features/leaderboard/api.js}

@@ -2,8 +2,8 @@
  * TapTap Leaderboard Management API
  * Server-side leaderboard operations
  */
-import { HttpClient } from './httpClient.js';
-import { readAppCache, saveAppCache } from '../utils/cache.js';
+import { HttpClient } from '../../core/network/httpClient.js';
+import { ensureAppInfo } from '../app/api.js';
 /**
  * Period types for leaderboard
  * WARNING: 0 = UNSPECIFIED (invalid), do NOT use 0!
@@ -91,154 +91,6 @@ export async function createLeaderboard(params) {
         throw new Error(`Failed to create leaderboard: ${String(error)}`);
     }
 }
-/**
- * Selection required error - thrown when multiple options exist
- */
-export class SelectionRequiredError extends Error {
-    constructor(message, developers) {
-        super(message);
-        this.developers = developers;
-        this.name = 'SelectionRequiredError';
-    }
-}
-/**
- * Get app/level list information for current user
- * Returns all developers and their apps/games
- * @param projectPath - Optional project path for cache lookup
- * @param autoSelect - If true, automatically selects first option. If false, throws SelectionRequiredError when multiple options exist
- * @returns App information including developer_id and app_id
- * @throws SelectionRequiredError when multiple developers/apps exist and autoSelect is false
- */
-export async function getAppInfo(projectPath, autoSelect = true) {
-    const client = new HttpClient();
-    try {
-        const response = await client.get('/level/v1/list');
-        // Get first developer and first app by default
-        if (!response.list || response.list.length === 0) {
-            throw new Error('No developers or apps found for current user');
-        }
-        // Count total developers and apps
-        const totalDevelopers = response.list.length;
-        const totalApps = response.list.reduce((sum, dev) => sum + (dev.levels?.length || dev.crafts?.length || 0), 0);
-        // If multiple options exist and autoSelect is false, throw error for AI to decide
-        if (!autoSelect && (totalDevelopers > 1 || totalApps > 1)) {
-            let errorMsg = `Multiple options found:\n`;
-            errorMsg += `- ${totalDevelopers} developer(s)\n`;
-            errorMsg += `- ${totalApps} app(s) in total\n\n`;
-            errorMsg += `Please use 'list_developers_and_apps' tool to see all options and 'select_app' to make a selection.`;
-            throw new SelectionRequiredError(errorMsg, response.list);
-        }
-        const firstDeveloper = response.list[0];
-        // Support both 'levels' (actual API response) and 'crafts' (backward compatibility)
-        const apps = firstDeveloper.levels || firstDeveloper.crafts || [];
-        if (apps.length === 0) {
-            throw new Error(`Developer ${firstDeveloper.developer_name} has no apps/games`);
-        }
-        const firstApp = apps[0];
-        const appInfo = {
-            developer_id: firstDeveloper.developer_id,
-            developer_name: firstDeveloper.developer_name,
-            app_id: firstApp.app_id,
-            app_title: firstApp.app_title,
-            miniapp_id: firstApp.miniapp_id
-        };
-        // Save to cache
-        saveAppCache(appInfo, projectPath);
-        return appInfo;
-    }
-    catch (error) {
-        // Re-throw SelectionRequiredError
-        if (error instanceof SelectionRequiredError) {
-            throw error;
-        }
-        // If API fails, try to use cached data
-        const cached = readAppCache(projectPath);
-        if (cached?.developer_id && cached?.app_id) {
-            return cached;
-        }
-        if (error instanceof Error) {
-            throw new Error(`Failed to get app info: ${error.message}`);
-        }
-        throw new Error(`Failed to get app info: ${String(error)}`);
-    }
-}
-/**
- * Get or fetch app information with automatic caching
- * @param projectPath - Optional project path
- * @param autoSelect - If true, automatically selects first option. If false, throws SelectionRequiredError when multiple options exist
- * @returns App information from cache or API
- * @throws SelectionRequiredError when multiple developers/apps exist and autoSelect is false
- */
-export async function ensureAppInfo(projectPath, autoSelect = true) {
-    // Check cache first
-    const cached = readAppCache(projectPath);
-    if (cached?.developer_id && cached?.app_id) {
-        return cached;
-    }
-    // No cache, fetch from API
-    return await getAppInfo(projectPath, autoSelect);
-}
-/**
- * Select and cache a specific developer and app
- * @param developerId - Developer ID to select
- * @param appId - App ID to select
- * @param projectPath - Optional project path for cache storage
- * @returns Selected app information
- */
-export async function selectApp(developerId, appId, projectPath) {
-    const client = new HttpClient();
-    try {
-        // Fetch full list to validate selection
-        const response = await client.get('/level/v1/list');
-        if (!response.list || response.list.length === 0) {
-            throw new Error('No developers or apps found for current user');
-        }
-        // Find the selected developer and app
-        const developer = response.list.find(dev => dev.developer_id === developerId);
-        if (!developer) {
-            throw new Error(`Developer with ID ${developerId} not found`);
-        }
-        // Support both 'levels' (actual API response) and 'crafts' (backward compatibility)
-        const apps = developer.levels || developer.crafts || [];
-        const app = apps.find(craft => craft.app_id === appId);
-        if (!app) {
-            throw new Error(`App with ID ${appId} not found for developer ${developer.developer_name}`);
-        }
-        const appInfo = {
-            developer_id: developer.developer_id,
-            developer_name: developer.developer_name,
-            app_id: app.app_id,
-            app_title: app.app_title,
-            miniapp_id: app.miniapp_id
-        };
-        // Save to cache
-        saveAppCache(appInfo, projectPath);
-        return appInfo;
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            throw new Error(`Failed to select app: ${error.message}`);
-        }
-        throw new Error(`Failed to select app: ${String(error)}`);
-    }
-}
-/**
- * Get all developers and apps for selection
- * @returns List of all developers and their apps
- */
-export async function getAllDevelopersAndApps() {
-    const client = new HttpClient();
-    try {
-        const response = await client.get('/level/v1/list');
-        return response;
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            throw new Error(`Failed to get developers and apps list: ${error.message}`);
-        }
-        throw new Error(`Failed to get developers and apps list: ${String(error)}`);
-    }
-}
 /**
  * List all leaderboards for a specific app
  * @param params - Query parameters (developer_id and app_id will be auto-filled if not provided)
@@ -344,4 +196,4 @@ export const EnumDescriptions = {
         [CalcType.LATEST]: 'Latest/最新分 (keep latest score)'
     }
 };
-//# sourceMappingURL=leaderboardApi.js.map
+//# sourceMappingURL=api.js.map

package/dist/features/leaderboard/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/features/leaderboard/api.ts"],"names":[],"mappings":"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"}

package/dist/{tools/leaderboardTools.d.ts → features/leaderboard/docTools.d.ts}

@@ -49,6 +49,10 @@ declare function getQuickStartGuide(): Promise<string>;
  * Get current app information from cache
  */
 declare function getCurrentAppInfo(): Promise<string>;
+/**
+ * Get complete integration workflow guide
+ */
+declare function getIntegrationWorkflow(): Promise<string>;
 export declare const leaderboardTools: {
     getLeaderboardManager: typeof getLeaderboardManager;
     openLeaderboard: typeof openLeaderboard;
@@ -61,6 +65,7 @@ export declare const leaderboardTools: {
     getLeaderboardPatterns: typeof getLeaderboardPatterns;
     getQuickStartGuide: typeof getQuickStartGuide;
     getCurrentAppInfo: typeof getCurrentAppInfo;
+    getIntegrationWorkflow: typeof getIntegrationWorkflow;
 };
 export {};
-//# sourceMappingURL=leaderboardTools.d.ts.map
+//# sourceMappingURL=docTools.d.ts.map

package/dist/features/leaderboard/docTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docTools.d.ts","sourceRoot":"","sources":["../../../src/features/leaderboard/docTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,UAAU,QAAQ;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;GAEG;AACH,iBAAe,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED;;GAEG;AACH,iBAAe,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhD;AAED;;GAEG;AACH,iBAAe,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7C;AAED;;GAEG;AACH,iBAAe,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED;;GAEG;AACH,iBAAe,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEvD;AAED;;GAEG;AACH,iBAAe,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEzD;AA8BD;;GAEG;AACH,iBAAe,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE;AAED;;GAEG;AACH,iBAAe,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEvD;AAED;;GAEG;AACH,iBAAe,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEvD;AAED;;GAEG;AACH,iBAAe,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CA+InD;AAED;;GAEG;AACH,iBAAe,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CA4DlD;AAED;;GAEG;AACH,iBAAe,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgFvD;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAgB5B,CAAC"}