@muggleai/mcp 1.0.19 → 1.0.21

package/dist/qa/contracts/local-run-schemas.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+/**
+ * Local execution context schema for local-run upload.
+ */
+export declare const LocalExecutionContextInputSchema: z.ZodObject<{
+    originalUrl: z.ZodString;
+    productionUrl: z.ZodString;
+    runByUserId: z.ZodString;
+    machineHostname: z.ZodOptional<z.ZodString>;
+    osInfo: z.ZodOptional<z.ZodString>;
+    electronAppVersion: z.ZodOptional<z.ZodString>;
+    mcpServerVersion: z.ZodOptional<z.ZodString>;
+    localExecutionCompletedAt: z.ZodNumber;
+    uploadedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    productionUrl: string;
+    originalUrl: string;
+    runByUserId: string;
+    localExecutionCompletedAt: number;
+    electronAppVersion?: string | undefined;
+    osInfo?: string | undefined;
+    mcpServerVersion?: string | undefined;
+    machineHostname?: string | undefined;
+    uploadedAt?: number | undefined;
+}, {
+    productionUrl: string;
+    originalUrl: string;
+    runByUserId: string;
+    localExecutionCompletedAt: number;
+    electronAppVersion?: string | undefined;
+    osInfo?: string | undefined;
+    mcpServerVersion?: string | undefined;
+    machineHostname?: string | undefined;
+    uploadedAt?: number | undefined;
+}>;
+/**
+ * Input schema for remote local-run upload tool.
+ */
+export declare const LocalRunUploadInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    useCaseId: z.ZodString;
+    testCaseId: z.ZodString;
+    runType: z.ZodEnum<["generation", "replay"]>;
+    productionUrl: z.ZodString;
+    localExecutionContext: z.ZodObject<{
+        originalUrl: z.ZodString;
+        productionUrl: z.ZodString;
+        runByUserId: z.ZodString;
+        machineHostname: z.ZodOptional<z.ZodString>;
+        osInfo: z.ZodOptional<z.ZodString>;
+        electronAppVersion: z.ZodOptional<z.ZodString>;
+        mcpServerVersion: z.ZodOptional<z.ZodString>;
+        localExecutionCompletedAt: z.ZodNumber;
+        uploadedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        productionUrl: string;
+        originalUrl: string;
+        runByUserId: string;
+        localExecutionCompletedAt: number;
+        electronAppVersion?: string | undefined;
+        osInfo?: string | undefined;
+        mcpServerVersion?: string | undefined;
+        machineHostname?: string | undefined;
+        uploadedAt?: number | undefined;
+    }, {
+        productionUrl: string;
+        originalUrl: string;
+        runByUserId: string;
+        localExecutionCompletedAt: number;
+        electronAppVersion?: string | undefined;
+        osInfo?: string | undefined;
+        mcpServerVersion?: string | undefined;
+        machineHostname?: string | undefined;
+        uploadedAt?: number | undefined;
+    }>;
+    actionScript: z.ZodArray<z.ZodUnknown, "many">;
+    status: z.ZodEnum<["passed", "failed"]>;
+    executionTimeMs: z.ZodNumber;
+    errorMessage: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "failed" | "passed";
+    runType: "generation" | "replay";
+    projectId: string;
+    useCaseId: string;
+    productionUrl: string;
+    localExecutionContext: {
+        productionUrl: string;
+        originalUrl: string;
+        runByUserId: string;
+        localExecutionCompletedAt: number;
+        electronAppVersion?: string | undefined;
+        osInfo?: string | undefined;
+        mcpServerVersion?: string | undefined;
+        machineHostname?: string | undefined;
+        uploadedAt?: number | undefined;
+    };
+    executionTimeMs: number;
+    actionScript: unknown[];
+    testCaseId: string;
+    errorMessage?: string | undefined;
+}, {
+    status: "failed" | "passed";
+    runType: "generation" | "replay";
+    projectId: string;
+    useCaseId: string;
+    productionUrl: string;
+    localExecutionContext: {
+        productionUrl: string;
+        originalUrl: string;
+        runByUserId: string;
+        localExecutionCompletedAt: number;
+        electronAppVersion?: string | undefined;
+        osInfo?: string | undefined;
+        mcpServerVersion?: string | undefined;
+        machineHostname?: string | undefined;
+        uploadedAt?: number | undefined;
+    };
+    executionTimeMs: number;
+    actionScript: unknown[];
+    testCaseId: string;
+    errorMessage?: string | undefined;
+}>;
+//# sourceMappingURL=local-run-schemas.d.ts.map

package/dist/qa/contracts/local-run-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-run-schemas.d.ts","sourceRoot":"","sources":["../../../src/qa/contracts/local-run-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWpC,CAAC"}

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

@@ -1 +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;AA6zCjF,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAanD,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"}
+{"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;AA+1CjF,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAanD,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/shared/auth.d.ts

@@ -42,10 +42,11 @@ export declare function createApiKeyWithToken(accessToken: string, keyName: stri
 }>;
 /**
  * Complete the full device code login flow.
- * Starts the flow, waits for user authorization, and creates credentials.
+ * Starts the flow, waits for user authorization, and stores credentials.
+ * API key creation is optional - only created when keyName is provided.
  *
- * @param keyName - Optional name for the API key.
- * @param keyExpiry - Expiry option for API key.
+ * @param keyName - Optional name for the API key. If provided, creates an API key.
+ * @param keyExpiry - Expiry option for API key (only used if keyName is provided).
  * @param timeoutMs - Maximum time to wait for authorization.
  * @returns Result of the login flow.
  */
@@ -56,15 +57,23 @@ export declare function performLogin(keyName?: string, keyExpiry?: "30d" | "90d"
     error?: string;
 }>;
 /**
- * Perform logout by clearing credentials.
+ * Perform logout by clearing all credentials (auth tokens and API keys).
  */
 export declare function performLogout(): void;
 /**
- * Get caller credentials for API requests.
- * Returns credentials from storage if available and valid.
+ * Get caller credentials for API requests (sync version).
+ * Checks for API key first, then falls back to access token.
+ * Does NOT auto-refresh - use getCallerCredentialsAsync() for that.
  * @returns Caller credentials or empty object.
  */
 export declare function getCallerCredentials(): ICallerCredentials;
+/**
+ * Get caller credentials for API requests (async version with auto-refresh).
+ * This is the preferred method - automatically refreshes expired access tokens.
+ * Priority: 1) API key (if explicitly set), 2) Access token (with auto-refresh)
+ * @returns Caller credentials or empty object.
+ */
+export declare function getCallerCredentialsAsync(): Promise<ICallerCredentials>;
 /**
  * Check if authentication is required for the given tool.
  * Local-only tools don't require auth.

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

@@ -1 +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,CAwD1D"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/shared/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,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;;;;;;;;;GASG;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,CA4FD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CASpC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAiBzD;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAiB7E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuD1D"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAEV,OAAO,EAGP,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAkIpB;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAsLD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAenC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAQD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAuB9C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,KAAK,GAAG,UAAU,GAAG,SAAS,CAqB5E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,sBAAsB,GAAG,SAAS,CAE5E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAEV,OAAO,EAGP,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAgKpB;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA8QD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAenC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAQD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAuB9C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,KAAK,GAAG,UAAU,GAAG,SAAS,CAqB5E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,sBAAsB,GAAG,SAAS,CAE5E;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

@@ -30,19 +30,28 @@ export declare function deleteCredentials(): void;
 export declare function isCredentialsExpired(credentials: IStoredCredentials): boolean;
 /**
  * Get valid credentials if available.
- * Returns null if no credentials or if expired.
+ * This is primarily used for API key storage.
+ * Access token authentication is handled by AuthService.
  * @returns Valid credentials or null.
  */
 export declare function getValidCredentials(): IStoredCredentials | null;
 /**
- * Get authentication status.
- * @returns Object with authentication status information.
+ * Check if an API key is stored.
+ * @returns True if API key exists.
  */
-export declare function getAuthStatus(): {
-    authenticated: boolean;
-    email?: string;
-    userId?: string;
-    expiresAt?: string;
-    hasApiKey: boolean;
-};
+export declare function hasApiKey(): boolean;
+/**
+ * Get stored API key if available.
+ * @returns API key or null.
+ */
+export declare function getApiKey(): string | null;
+/**
+ * Save API key to credentials.
+ * @param apiKey - The API key to save.
+ * @param apiKeyId - The API key ID.
+ */
+export declare function saveApiKey(params: {
+    apiKey: string;
+    apiKeyId: string;
+}): void;
 //# sourceMappingURL=credentials.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,GAAG,IAAI,CAa/D;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAGzC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwB7E"}

package/dist/shared/types.d.ts

@@ -24,6 +24,8 @@ export interface IMuggleConfig {
     downloadBaseUrl: string;
     /** SHA256 checksums for each platform binary. */
     checksums?: IMuggleConfigChecksums;
+    /** Default runtime target baked into the package at build/publish time. */
+    runtimeTargetDefault?: "production" | "dev";
 }
 /**
  * Auth0 configuration for device code flow.

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@muggleai/mcp",
-    "version": "1.0.19",
+    "version": "1.0.21",
     "description": "Unified MCP server for Muggle AI - Cloud QA and Local Testing tools",
     "type": "module",
     "main": "dist/index.js",
@@ -26,8 +26,9 @@
         "test:watch": "vitest"
     },
     "muggleConfig": {
-        "electronAppVersion": "1.0.6",
+        "electronAppVersion": "1.0.8",
         "downloadBaseUrl": "https://github.com/multiplex-ai/muggle-ai-mcp/releases/download",
+        "runtimeTargetDefault": "production",
         "checksums": {
             "darwin-arm64": "",
             "darwin-x64": "",

package/scripts/postinstall.mjs

@@ -7,12 +7,14 @@
 import { createHash } from "crypto";
 import { exec } from "child_process";
 import {
+  readFileSync,
   createReadStream,
   createWriteStream,
   existsSync,
   mkdirSync,
   readdirSync,
   rmSync,
+  writeFileSync,
 } from "fs";
 import { homedir, platform } from "os";
 import { join } from "path";
@@ -21,6 +23,86 @@ import { createRequire } from "module";
 
 const require = createRequire(import.meta.url);
 const VERSION_DIRECTORY_NAME_PATTERN = /^\d+\.\d+\.\d+(?:[-+][A-Za-z0-9.-]+)?$/;
+const CURSOR_SERVER_NAME = "muggle";
+const INSTALL_METADATA_FILE_NAME = ".install-metadata.json";
+
+/**
+ * Get the Cursor MCP config path.
+ * @returns {string} Path to ~/.cursor/mcp.json
+ */
+function getCursorMcpConfigPath() {
+  return join(homedir(), ".cursor", "mcp.json");
+}
+
+/**
+ * Build the default Cursor server configuration for this package.
+ * @returns {{command: string, args: string[]}} Server configuration
+ */
+function buildCursorServerConfig() {
+  const localCliPath = join(process.cwd(), "bin", "muggle-mcp.js");
+  return {
+    command: "node",
+    args: [localCliPath, "serve"],
+  };
+}
+
+/**
+ * Read and parse Cursor mcp.json.
+ * @param {string} configPath - Path to mcp.json
+ * @returns {Record<string, unknown>} Parsed config object
+ */
+function readCursorConfig(configPath) {
+  if (!existsSync(configPath)) {
+    return {};
+  }
+
+  const rawConfig = readFileSync(configPath, "utf-8");
+  const parsedConfig = JSON.parse(rawConfig);
+
+  if (typeof parsedConfig !== "object" || parsedConfig === null || Array.isArray(parsedConfig)) {
+    throw new Error(`Invalid JSON structure in ${configPath}: expected an object at root`);
+  }
+
+  return parsedConfig;
+}
+
+/**
+ * Update ~/.cursor/mcp.json with the muggle server entry.
+ * Existing server configurations are preserved.
+ */
+function updateCursorMcpConfig() {
+  const configPath = getCursorMcpConfigPath();
+  const cursorDir = join(homedir(), ".cursor");
+
+  try {
+    const parsedConfig = readCursorConfig(configPath);
+    const currentMcpServers = parsedConfig.mcpServers;
+    let normalizedMcpServers = {};
+
+    if (currentMcpServers !== undefined) {
+      if (typeof currentMcpServers !== "object" || currentMcpServers === null || Array.isArray(currentMcpServers)) {
+        throw new Error(`Invalid mcpServers in ${configPath}: expected an object`);
+      }
+      normalizedMcpServers = currentMcpServers;
+    }
+
+    normalizedMcpServers[CURSOR_SERVER_NAME] = buildCursorServerConfig();
+    parsedConfig.mcpServers = normalizedMcpServers;
+
+    mkdirSync(cursorDir, { recursive: true });
+    const prettyJson = `${JSON.stringify(parsedConfig, null, 2)}\n`;
+    writeFileSync(configPath, prettyJson, "utf-8");
+    console.log(`Updated Cursor MCP config: ${configPath}`);
+  } catch (error) {
+    console.error("\n========================================");
+    console.error("ERROR: Failed to update Cursor MCP config");
+    console.error("========================================\n");
+    console.error("Path:", configPath);
+    console.error("\nFull error details:");
+    console.error(error instanceof Error ? error.stack || error : error);
+    console.error("");
+  }
+}
 
 /**
  * Get the Muggle AI data directory.
@@ -180,6 +262,141 @@ function getBinaryName() {
   }
 }
 
+/**
+ * Get the expected extracted executable path for the current platform.
+ * @param {string} versionDir - Version directory path
+ * @returns {string} Expected executable path
+ */
+function getExpectedExecutablePath(versionDir) {
+  const os = platform();
+
+  switch (os) {
+    case "darwin":
+      return join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
+    case "win32":
+      return join(versionDir, "MuggleAI.exe");
+    case "linux":
+      return join(versionDir, "MuggleAI");
+    default:
+      throw new Error(`Unsupported platform: ${os}`);
+  }
+}
+
+/**
+ * Get the metadata file path for an installed version.
+ * @param {string} versionDir - Version directory path
+ * @returns {string} Metadata file path
+ */
+function getInstallMetadataPath(versionDir) {
+  return join(versionDir, INSTALL_METADATA_FILE_NAME);
+}
+
+/**
+ * Read install metadata from disk.
+ * @param {string} metadataPath - Metadata file path
+ * @returns {Record<string, unknown> | null} Parsed metadata, or null if missing/invalid
+ */
+function readInstallMetadata(metadataPath) {
+  if (!existsSync(metadataPath)) {
+    return null;
+  }
+
+  try {
+    const metadataContent = readFileSync(metadataPath, "utf-8");
+    const parsedMetadata = JSON.parse(metadataContent);
+    if (typeof parsedMetadata !== "object" || parsedMetadata === null || Array.isArray(parsedMetadata)) {
+      return null;
+    }
+    return parsedMetadata;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Persist install metadata to disk.
+ * @param {object} params - Metadata fields
+ * @param {string} params.metadataPath - Metadata file path
+ * @param {string} params.version - Installed version
+ * @param {string} params.binaryName - Archive filename
+ * @param {string} params.platformKey - Platform key
+ * @param {string} params.executableChecksum - Checksum of extracted executable
+ * @param {string} params.expectedArchiveChecksum - Configured archive checksum for platform
+ */
+function writeInstallMetadata({
+  metadataPath,
+  version,
+  binaryName,
+  platformKey,
+  executableChecksum,
+  expectedArchiveChecksum,
+}) {
+  const metadata = {
+    version: version,
+    binaryName: binaryName,
+    platformKey: platformKey,
+    executableChecksum: executableChecksum,
+    expectedArchiveChecksum: expectedArchiveChecksum,
+    updatedAt: new Date().toISOString(),
+  };
+
+  writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`, "utf-8");
+}
+
+/**
+ * Verify existing installed executable and metadata.
+ * @param {object} params - Verification params
+ * @param {string} params.versionDir - Installed version directory
+ * @param {string} params.executablePath - Expected executable path
+ * @param {string} params.version - Version string
+ * @param {string} params.binaryName - Archive filename
+ * @param {string} params.platformKey - Platform key
+ * @param {string} params.expectedArchiveChecksum - Configured checksum for downloaded archive
+ * @returns {Promise<{valid: boolean, reason: string}>} Verification result
+ */
+async function verifyExistingInstall({
+  versionDir,
+  executablePath,
+  version,
+  binaryName,
+  platformKey,
+  expectedArchiveChecksum,
+}) {
+  const metadataPath = getInstallMetadataPath(versionDir);
+  const metadata = readInstallMetadata(metadataPath);
+
+  if (!metadata) {
+    return { valid: false, reason: "install metadata is missing or invalid" };
+  }
+
+  if (metadata.version !== version) {
+    return { valid: false, reason: "installed metadata version does not match configured version" };
+  }
+
+  if (metadata.binaryName !== binaryName) {
+    return { valid: false, reason: "installed metadata binary name does not match current platform archive" };
+  }
+
+  if (metadata.platformKey !== platformKey) {
+    return { valid: false, reason: "installed metadata platform key does not match current platform" };
+  }
+
+  if ((metadata.expectedArchiveChecksum || "") !== expectedArchiveChecksum) {
+    return { valid: false, reason: "configured archive checksum changed since previous install" };
+  }
+
+  if (typeof metadata.executableChecksum !== "string" || metadata.executableChecksum === "") {
+    return { valid: false, reason: "installed metadata executable checksum is missing" };
+  }
+
+  const currentExecutableChecksum = await calculateFileChecksum(executablePath);
+  if (currentExecutableChecksum !== metadata.executableChecksum) {
+    return { valid: false, reason: "installed executable checksum does not match recorded checksum" };
+  }
+
+  return { valid: true, reason: "installed executable checksum is valid" };
+}
+
 /**
  * Download and extract the Electron app.
  */
@@ -192,16 +409,44 @@ async function downloadElectronApp() {
     const baseUrl = config.downloadBaseUrl || "https://github.com/multiplex-ai/muggle-ai-mcp/releases/download";
 
     const binaryName = getBinaryName();
+    const checksums = config.checksums || {};
+    const platformKey = getPlatformKey();
+    const expectedChecksum = checksums[platformKey] || "";
     const downloadUrl = `${baseUrl}/v${version}/${binaryName}`;
 
     const appDir = getElectronAppDir();
     const versionDir = join(appDir, version);
+    const metadataPath = getInstallMetadataPath(versionDir);
 
-    // Check if already downloaded
+    // Check if already downloaded and extracted correctly
+    const expectedExecutablePath = getExpectedExecutablePath(versionDir);
     if (existsSync(versionDir)) {
-      cleanupNonCurrentVersions({ appDir: appDir, currentVersion: version });
-      console.log(`Electron app v${version} already installed at ${versionDir}`);
-      return;
+      if (existsSync(expectedExecutablePath)) {
+        const existingInstallVerification = await verifyExistingInstall({
+          versionDir: versionDir,
+          executablePath: expectedExecutablePath,
+          version: version,
+          binaryName: binaryName,
+          platformKey: platformKey,
+          expectedArchiveChecksum: expectedChecksum,
+        });
+
+        if (existingInstallVerification.valid) {
+          cleanupNonCurrentVersions({ appDir: appDir, currentVersion: version });
+          console.log(`Electron app v${version} already installed at ${versionDir}`);
+          return;
+        }
+
+        console.log(
+          `Installed Electron app v${version} failed verification (${existingInstallVerification.reason}). Re-downloading...`,
+        );
+        rmSync(versionDir, { recursive: true, force: true });
+      } else {
+        console.log(
+          `Electron app v${version} directory exists but executable is missing. Re-downloading...`,
+        );
+        rmSync(versionDir, { recursive: true, force: true });
+      }
     }
 
     console.log(`Downloading Muggle Test Electron app v${version}...`);
@@ -229,11 +474,6 @@ async function downloadElectronApp() {
 
     console.log("Download complete, verifying checksum...");
 
-    // Get expected checksum from config
-    const checksums = config.checksums || {};
-    const platformKey = getPlatformKey();
-    const expectedChecksum = checksums[platformKey] || "";
-
     // Verify checksum
     const checksumResult = await verifyFileChecksum(tempFile, expectedChecksum);
 
@@ -265,6 +505,24 @@ async function downloadElectronApp() {
     // Clean up temp file
     rmSync(tempFile, { force: true });
 
+    if (!existsSync(expectedExecutablePath)) {
+      throw new Error(
+        `Extraction completed but executable was not found.\n` +
+        `Expected path: ${expectedExecutablePath}\n` +
+        `Version directory: ${versionDir}`,
+      );
+    }
+
+    const executableChecksum = await calculateFileChecksum(expectedExecutablePath);
+    writeInstallMetadata({
+      metadataPath: metadataPath,
+      version: version,
+      binaryName: binaryName,
+      platformKey: platformKey,
+      executableChecksum: executableChecksum,
+      expectedArchiveChecksum: expectedChecksum,
+    });
+
     cleanupNonCurrentVersions({ appDir: appDir, currentVersion: version });
 
     console.log(`Electron app installed to ${versionDir}`);
@@ -334,4 +592,5 @@ async function extractTarGz(tarPath, destDir) {
 }
 
 // Run postinstall
+updateCursorMcpConfig();
 downloadElectronApp().catch(console.error);