Credential Management

import asyncio
from mobilerun import MobileAgent, MobileConfig

async def main():
    # Define credentials directly
    credentials = {
        "MY_PASSWORD": "secret123",
        "API_KEY": "sk-1234567890"
    }

    config = MobileConfig()

    agent = MobileAgent(
        goal="Login to my app",
        config=config,
        credentials=credentials  # Pass directly
    )

    result = await agent.run()
    print(result.success)

asyncio.run(main())

# credentials.yaml
secrets:
  # Dict format (recommended)
  MY_PASSWORD:
    value: "your_password_here"
    enabled: true

  GMAIL_PASSWORD:
    value: "gmail_pass_123"
    enabled: true

  # Simple string format (auto-enabled)
  API_KEY: "sk-1234567890abcdef"

  # Disabled secret
  OLD_PASSWORD:
    value: "old_pass"
    enabled: false  # Not loaded

# config.yaml
credentials:
  enabled: true
  file_path: config/credentials.yaml

from mobilerun import MobileAgent, MobileConfig

# Config loads credentials from file
config = MobileConfig.from_yaml("config.yaml")

agent = MobileAgent(
    goal="Login to Gmail",
    config=config  # Credentials loaded automatically
)

{
  "action": "type_secret",
  "secret_id": "MY_PASSWORD",
  "index": 5
}

<function_calls>
<invoke name="type_secret">
<parameter name="secret_id">MY_PASSWORD</parameter>
<parameter name="index">5</parameter>
</invoke>
</function_calls>

import asyncio
from mobilerun import MobileAgent, MobileConfig

async def main():
    credentials = {
        "EMAIL_USER": "user@example.com",
        "EMAIL_PASS": "secret_password"
    }

    config = MobileConfig()

    agent = MobileAgent(
        goal="Open Gmail and login with my credentials",
        config=config,
        credentials=credentials
    )

    result = await agent.run()
    print(f"Success: {result.success}")

asyncio.run(main())

variables = {
    "target_email": "john@example.com",
    "subject_line": "Monthly Report"
}

agent = MobileAgent(
    goal="Compose email to {{target_email}}",
    config=config,
    variables=variables  # Non-sensitive
)

# config.yaml
credentials:
  enabled: true  # Must be true
  file_path: config/credentials.yaml

agent = MobileAgent(..., credentials={"PASSWORD": "secret"})

from mobilerun.credential_manager import FileCredentialManager

cm = FileCredentialManager("config/credentials.yaml")
print(await cm.get_keys())

secrets:
  X:
    value: "your_value"
    enabled: true  # Must be true

from mobilerun.credential_manager import CredentialManager

class MyCredentialManager(CredentialManager):
    def __init__(self, api_key):
        self.api_key = api_key

    async def resolve_key(self, key: str) -> str:
        # Implement your own credential retrieval logic
        return await fetch_from_service(key, self.api_key)

    async def get_keys(self) -> list[str]:
        # Return list of available credential keys
        return await fetch_available_keys(self.api_key)

# Use it
credentials = MyCredentialManager(api_key="...")
agent = MobileAgent(goal="Login", config=config, credentials=credentials)