AutoMobile

Instructions

Implementation Reference

• src/server/environmentTools.ts:35-50 (handler)

  Main handler function for the 'installPlatformDependencies' tool. Dispatches to platform-specific installation functions based on the platform argument.

  const installPlatformDependenciesHandler = async (
    args: InstallPlatformDependenciesArgs,
    progress?: ProgressCallback
  ) => {
    try {
      if (args.platform === "android") {
        return await installAndroidDependencies(args, progress);
      } else if (args.platform === "ios") {
        return await installIOSDependencies(args, progress);
      } else {
        throw new ActionableError(`Unsupported platform: ${args.platform}`);
      }
    } catch (error) {
      throw new ActionableError(`Failed to install ${args.platform} dependencies: ${error}`);
    }
  };

• src/server/environmentTools.ts:14-17 (schema)

  Zod schema defining the input parameters for the tool: platform (android/ios) and optional update strategy.

  export const installPlatformDependenciesSchema = z.object({
    platform: z.enum(["android", "ios"]).describe("Target platform to install dependencies for"),
    update: z.enum(["force", "ifAvailable", "never"]).optional().default("ifAvailable").describe("Update behavior: force=always update, ifAvailable=update if detected but don't fail, never=don't update")
  });

• src/server/environmentTools.ts:68-74 (registration)

  Registration of the tool with ToolRegistry, including name, description, schema, handler, and progress support flag.

  ToolRegistry.register(
    "installPlatformDependencies",
    "Install required dependencies and tools for the specified platform",
    installPlatformDependenciesSchema,
    installPlatformDependenciesHandler,
    true // Supports progress notifications
  );

• src/server/environmentTools.ts:85-154 (helper)

  Core helper function implementing Android platform dependency installation, including setup, optional updates, progress reporting, and result formatting.

  async function installAndroidDependencies(
    args: InstallPlatformDependenciesArgs,
    progress?: ProgressCallback
  ): Promise<any> {
    logger.info(`Installing Android dependencies with update: ${args.update}`);
  
    if (progress) {
      await progress(10, 100, "Starting Android dependency installation...");
    }
  
    // Determine if we should force installation based on update parameter
    let shouldForce = false;
    if (args.update === "force") {
      shouldForce = true;
    } else if (args.update === "never") {
      shouldForce = false;
    }
    // For "ifAvailable", we'll handle updates separately
  
    // Always use comprehensive setup - AutoMobile is opinionated about providing complete environment
    const setupParams: CompleteSetupParams = {
      installJava: true,
      installXcodeTools: true,
      force: shouldForce
    };
  
    if (progress) {
      await progress(30, 100, "Setting up complete Android development environment...");
    }
  
    const result = await setupCompleteAndroidEnvironment(setupParams);
  
    // Handle updates if requested and installation was successful but not forced
    let updateResult = null;
    if (args.update === "ifAvailable" && result.success && !shouldForce) {
      if (progress) {
        await progress(60, 100, "Checking for available updates...");
      }
  
      try {
        // Attempt to update by forcing a reinstall
        const updateParams: CompleteSetupParams = {
          installJava: true,
          installXcodeTools: true,
          force: true
        };
        updateResult = await setupCompleteAndroidEnvironment(updateParams);
        logger.info(`Update attempt completed: ${updateResult.success ? "successful" : "failed"}`);
      } catch (error) {
        logger.warn(`Update attempt failed but continuing: ${error}`);
        // Don't fail the overall operation for update failures when using "ifAvailable"
      }
    }
  
    if (progress) {
      await progress(100, 100, "Complete Android environment setup finished");
    }
  
    return createJSONToolResponse({
      success: result.success,
      message: result.success ? "Complete Android development environment installed" : "Some components failed to install",
      platform: "android",
      updateMode: args.update,
      steps: result.steps,
      environmentVariables: result.environmentVariables,
      recommendations: result.recommendations,
      updateAttempted: args.update === "ifAvailable" && updateResult !== null,
      updateSuccessful: updateResult?.success || false
    });
  }

• src/server/environmentTools.ts:24-27 (schema)

  TypeScript interface defining the argument shape for type safety, matching the schema.

  export interface InstallPlatformDependenciesArgs {
    platform: SomePlatform;
    update?: "force" | "ifAvailable" | "never";
  }