fleet-python 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

examples/dsl_example.py

@@ -0,0 +1,112 @@
+from fleet.verifiers import DatabaseSnapshot, IgnoreConfig
+
+async def validate_give_me_more_tasks(
+    before: DatabaseSnapshot,
+    after: DatabaseSnapshot,
+    transcript: str | None = None,
+) -> int:
+    """Validate that bugs are moved to sprint 3 and assigned correctly."""
+
+    # Get user IDs
+    raj_user = after.table("users").eq("name", "Raj Patel").first()
+    sarah_kim_user = after.table("users").eq("name", "Sarah Kim").first()
+
+    if not raj_user:
+        raise AssertionError("User 'Raj Patel' not found")
+    if not sarah_kim_user:
+        raise AssertionError("User 'Sarah Kim' not found")
+
+    raj_id = raj_user["id"]
+    sarah_kim_id = sarah_kim_user["id"]
+
+    # Verify SCRUM-555 (data pipeline bug) is assigned to Sarah Kim
+    after.table("issues").eq("id", "SCRUM-555").assert_eq("owner", sarah_kim_id)
+
+    # Verify other bugs are assigned to Raj Patel
+    other_bugs = [
+        "SCRUM-780",
+        "SCRUM-781",
+        "SCRUM-790",
+        "SCRUM-822",
+        "SCRUM-882",
+        "SCRUM-897",
+        "SCRUM-956",
+        "SCRUM-1331",
+        "SCRUM-1312",
+        "SCRUM-1210",
+        "SCRUM-1230",
+        "SCRUM-1282",
+    ]
+    for bug_id in other_bugs:
+        after.table("issues").eq("id", bug_id).assert_eq("owner", raj_id)
+
+    # Verify all bugs are in sprint_3
+    all_bugs = ["SCRUM-555"] + other_bugs
+    for bug_id in all_bugs:
+        after.table("sprint_issues").eq("issue_id", bug_id).assert_eq(
+            "sprint_id", "sprint_3"
+        )
+
+    # Configure ignore settings
+    ignore_config = IgnoreConfig(
+        tables={"activities", "pageviews", "sprint_issues"},
+        table_fields={
+            "issues": {"updated_at", "created_at", "rowid"},
+            "users": {"updated_at", "created_at", "rowid"},
+            "sprint_issues": {"updated_at", "created_at", "rowid"},
+        },
+    )
+
+    # Build expected changes
+    expected_changes: list[dict] = []
+
+    # Assignment changes
+    expected_changes.append(
+        {
+            "table": "issues",
+            "pk": "SCRUM-555",
+            "field": "owner",
+            "after": sarah_kim_id,
+        }
+    )
+    for bug_id in other_bugs:
+        expected_changes.append(
+            {
+                "table": "issues",
+                "pk": bug_id,
+                "field": "owner",
+                "after": raj_id,
+            }
+        )
+
+    # Sprint changes
+    for bug_id in all_bugs:
+        # Remove from previous sprint if present
+        before_assignment = (
+            before.table("sprint_issues").eq("issue_id", bug_id).first()
+        )
+        if before_assignment:
+            old_sprint = before_assignment.get("sprint_id")
+            expected_changes.append(
+                {
+                    "table": "sprint_issues",
+                    "pk": (old_sprint, bug_id),
+                    "field": None,
+                    "after": "__removed__",
+                }
+            )
+
+        # Add to sprint_3
+        expected_changes.append(
+            {
+                "table": "sprint_issues",
+                "pk": ("sprint_3", bug_id),
+                "field": None,
+                "after": "__added__",
+            }
+        )
+
+    # Enforce invariant
+    before.diff(after, ignore_config).expect_only(expected_changes)
+
+    return TASK_SUCCESSFUL_SCORE

examples/example.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+"""Example demonstrating browser control with Fleet Manager Client."""
+
+import asyncio
+import fleet as flt
+
+
+async def main():
+    environments = await flt.env.list_envs()
+    print("Environments:", len(environments))
+
+    # Create a new instance
+    env = await flt.env.make("hubspot:v1.2.7")
+    print("New Instance:", env.instance_id)
+
+    response = await env.reset(seed=42)
+    print("Reset response:", response)
+
+    print(await env.resources())
+
+    sqlite = env.db()
+    print("SQLite:", await sqlite.describe())
+
+    print("Query:", await sqlite.query("SELECT * FROM users"))
+
+    sqlite = await env.state("sqlite://current").describe()
+    print("SQLite:", sqlite)
+
+    browser = env.browser()
+    print("CDP URL:", await browser.cdp_url())
+    print("Devtools URL:", await browser.devtools_url())
+
+    # Delete the instance
+    await env.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/nova_act_example.py

@@ -0,0 +1,180 @@
+"""
+Nova Act + Fleet SDK Integration Example
+
+This example demonstrates how to use Amazon Nova Act (an AI-powered browser automation SDK)
+with Fleet's browser instances. Nova Act can navigate websites, fill forms, and extract data
+using natural language commands.
+
+Requirements:
+1. Fleet SDK: pip install fleet-python
+2. Nova Act SDK: pip install nova-act
+3. Playwright Chrome: playwright install chrome
+4. Environment variables:
+   - FLEET_API_KEY: Your Fleet API key
+   - NOVA_ACT_API_KEY: Your Nova Act API key (get from https://nova.amazon.com/act)
+
+Note: Nova Act is currently only available in the US as a research preview.
+
+Usage:
+    export FLEET_API_KEY=your_fleet_key
+    export NOVA_ACT_API_KEY=your_nova_act_key
+    python examples/nova_act_example.py
+
+Important: Nova Act typically creates its own browser instance. Integration with
+Fleet's CDP endpoint may not be fully supported in the current version.
+"""
+
+import asyncio
+import fleet as flt
+import nova_act
+import os
+from concurrent.futures import ThreadPoolExecutor
+
+
+def test_nova_act_sync():
+    """Test Nova Act in a synchronous context (outside asyncio loop)."""
+    print("\n🧪 Testing Nova Act independently...")
+    try:
+        with nova_act.NovaAct(
+            headless=False,
+            starting_page="https://example.com"
+        ) as nova:
+            print("✅ Nova Act initialized successfully!")
+            result = nova.act("What is the main heading on this page?")
+            print(f"Test result: {result}")
+            return True
+    except Exception as e:
+        print(f"❌ Nova Act test failed: {type(e).__name__}: {str(e)}")
+        import traceback
+        traceback.print_exc()
+        return False
+
+
+def run_nova_act_with_fleet_data(fleet_app_url):
+    """Run Nova Act examples using Fleet's app URL."""
+    print("\n🤖 Starting Nova Act with Fleet app URL...")
+    
+    try:
+        with nova_act.NovaAct(
+            headless=False,
+            starting_page=fleet_app_url,
+            cdp_endpoint_url="wss://05bd8217.fleetai.com/cdp/devtools/browser/288477c8-2a6d-4e66-b8de-29bc3033c7a2"
+        ) as nova:
+            print("✅ Nova Act started successfully!")
+            run_nova_examples(nova)
+            
+    except Exception as e:
+        print(f"❌ Error during Nova Act operations: {type(e).__name__}: {str(e)}")
+        import traceback
+        traceback.print_exc()
+
+
+def run_nova_examples(nova):
+    """Run Nova Act examples in a separate function."""
+    # Example 1: Navigate and interact with a website
+    print("\n📝 Example 1: Basic navigation and interaction")
+    nova.act("Navigate to https://example.com")
+
+    # Extract page title
+    result = nova.act(
+        "What is the title of this page?",
+        schema={"type": "object", "properties": {"title": {"type": "string"}}},
+    )
+    if result.matches_schema:
+        print(f"Page title: {result.parsed_response.get('title')}")
+
+    # Example 2: More complex interaction
+    print("\n📝 Example 2: Search on a website")
+    nova.act("Navigate to https://www.python.org")
+    nova.act("Search for 'asyncio' in the search box")
+
+    # Example 3: Extract structured data
+    print("\n📝 Example 3: Extract structured information")
+    result = nova.act(
+        "Find the first 3 search results and return their titles",
+        schema={
+            "type": "object",
+            "properties": {
+                "results": {"type": "array", "items": {"type": "string"}}
+            },
+        },
+    )
+    if result.matches_schema:
+        results = result.parsed_response.get("results", [])
+        print("Search results:")
+        for i, title in enumerate(results, 1):
+            print(f"  {i}. {title}")
+
+    # Example 4: Fill out a form
+    print("\n📝 Example 4: Form interaction")
+    nova.act("Navigate to https://httpbin.org/forms/post")
+    nova.act("Fill the customer name field with 'John Doe'")
+    nova.act("Select 'Medium' for the size")
+    nova.act("Check the 'Bacon' topping")
+
+    # You can also use nova_act's ability to take screenshots
+    print("\n📸 Taking screenshot...")
+    nova.act("Take a screenshot of the current page")
+
+
+async def main():
+    """Main async function for Fleet operations."""
+    
+    # Check for Nova Act API key
+    nova_api_key = os.getenv("NOVA_ACT_API_KEY")
+    if not nova_api_key:
+        print("❌ NOVA_ACT_API_KEY environment variable not set!")
+        print("Please set it with: export NOVA_ACT_API_KEY=your_api_key")
+        return
+    else:
+        print(f"✅ Nova Act API key found: {nova_api_key[:8]}...{nova_api_key[-4:]}")
+
+    # Test Nova Act outside of asyncio loop
+    # with ThreadPoolExecutor() as executor:
+    #     nova_test_future = executor.submit(test_nova_act_sync)
+    #     nova_works = nova_test_future.result()
+        
+    # if not nova_works:
+    #     print("\nNova Act is not working properly. Please check:")
+    #     print("1. You have a valid NOVA_ACT_API_KEY")
+    #     print("2. You have installed nova-act: pip install nova-act")
+    #     print("3. You have playwright installed: playwright install chrome")
+    #     return
+
+    # Initialize Fleet client
+    fleet = flt.AsyncFleet()
+    print("\n🚀 Initializing Fleet client...")
+
+    instance = await fleet.instance("05bd8217")
+
+    try:
+        # Reset the environment to ensure clean state
+        # print("🔄 Resetting environment...")
+        # await instance.env.reset()
+
+        # Get browser resource from Fleet
+        browser = await instance.env.browser("cdp").describe()
+        print(f"🌐 CDP URL: {browser.url}")
+        print(f"🔧 DevTools URL: {browser.devtools_url}")
+
+        # Run Nova Act in a separate thread to avoid asyncio conflicts
+        with ThreadPoolExecutor() as executor:
+            nova_future = executor.submit(run_nova_act_with_fleet_data, instance.urls.app)
+            nova_future.result()  # Wait for Nova Act to complete
+
+    except Exception as e:
+        print(f"❌ Error in main flow: {type(e).__name__}: {str(e)}")
+        import traceback
+        traceback.print_exc()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\n\n⚠️  Script interrupted by user")
+        print("Nova Act browser may still be running in the background.")
+    except Exception as e:
+        print(f"\n❌ Unexpected error: {type(e).__name__}: {str(e)}")
+        import traceback
+        traceback.print_exc()