Mobile App Testing

import { MobileClient } from '@morphllm/morphsdk/tools/mobile';

const mobile = new MobileClient({ apiKey: process.env.MORPH_API_KEY });

const result = await mobile.execute({
  task: "Tap the login button and verify the login form appears",
  app: "https://github.com/myorg/myapp/releases/download/v1.0/app.ipa",
  platform: "ios",
  device: "iPhone 16 Pro"
});

console.log(result.success ? 'Passed' : 'Failed');
console.log(result.trace_url); // GIF of the test execution

await mobile.execute({
  task: "Test the checkout flow",
  app: "https://github.com/myorg/myapp/releases/download/v1.2.3/MyApp.ipa",
  platform: "ios"
});

name: Mobile Tests
on: [push]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Build iOS App
        run: |
          # Your build command (Xcode, Fastlane, etc.)
          xcodebuild -scheme MyApp -sdk iphoneos -configuration Release

      - name: Upload to GitHub Release
        id: upload
        uses: softprops/action-gh-release@v1
        with:
          files: build/MyApp.ipa
          tag_name: build-${{ github.run_number }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Run Mobile Tests
        env:
          MORPH_API_KEY: ${{ secrets.MORPH_API_KEY }}
        run: |
          curl -X POST https://api.morphllm.com/v1/mobile-task \
            -H "Authorization: Bearer $MORPH_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{
              "task": "Test the login flow with test@example.com and password123",
              "app": "${{ steps.upload.outputs.assets[0].browser_download_url }}",
              "platform": "ios",
              "device": "iPhone 16 Pro",
              "external_id": "PR-${{ github.event.pull_request.number }}",
              "commit_id": "${{ github.sha }}"
            }'

import { S3Client, GetObjectCommand } from '@aws-sdk/client-s3';
import { getSignedUrl } from '@aws-sdk/s3-request-presigner';

const s3 = new S3Client({ region: 'us-east-1' });
const command = new GetObjectCommand({ Bucket: 'my-builds', Key: 'app.ipa' });
const appUrl = await getSignedUrl(s3, command, { expiresIn: 3600 });

await mobile.execute({
  task: "Verify onboarding flow",
  app: appUrl,
  platform: "ios"
});

# Fastfile
lane :test do
  build_app(scheme: "MyApp")

  # Upload to GitHub Release
  set_github_release(
    repository_name: "myorg/myapp",
    tag_name: "v#{get_version_number}",
    upload_assets: ["MyApp.ipa"]
  )
end

const result = await mobile.execute({
  // Required
  task: "Test the checkout flow",
  app: "https://github.com/myorg/myapp/releases/download/v1.0/app.ipa",

  // Optional
  platform: "ios",              // "ios" | "android" (default: "ios")
  device: "iPhone 16 Pro",      // Device name (default: "iPhone 16 Pro")
  os_version: "18",             // OS version (auto-detected if omitted)
  max_steps: 50,                // Max agent steps (default: 50)
  record_trace: true,           // Generate GIF trace (default: true)

  // CI/CD tracking
  external_id: "PR-123",
  repo_id: "myorg/myapp",
  commit_id: "abc123"
});

{
  success: boolean,
  result?: string,           // Test findings
  error?: string,            // Error if failed
  task_id?: string,
  steps_taken?: number,
  execution_time_ms?: number,
  trace_url?: string,        // GIF trace URL
  trace_status?: "PENDING" | "PROCESSING" | "COMPLETED" | "ERROR"
}

const task = await mobile.createTask({
  task: "Complete the onboarding flow",
  app: "https://github.com/myorg/myapp/releases/download/v1.0/app.ipa",
  device: "iPhone 16 Pro"
});

console.log('Task started:', task.task_id);

// Poll for completion
const result = await task.complete();
console.log('Result:', result.result);

const { devices } = await mobile.listDevices();

devices.forEach(d => {
  console.log(`${d.device_name} (${d.platform})`);
});

// Good
"Tap the login button, enter test@example.com in email, enter password123, and tap Sign In"

// Bad
"test login"

const result = await mobile.execute({
  task: "Navigate through settings",
  app: "https://...",
  record_trace: true
});

if (result.trace_url) {
  console.log('Watch the test:', result.trace_url);
}