fleet-python 0.2.29__py3-none-any.whl → 0.2.34__py3-none-any.whl

examples/diff_example.py

@@ -1,5 +1,5 @@
 import asyncio
-import fleet as flt
+import fleet
 from fleet.verifiers import IgnoreConfig
 from dotenv import load_dotenv
 
@@ -9,7 +9,7 @@ load_dotenv()
 async def main():
     # Create a new instance
     print("Creating new Hubspot instance...")
-    env = await flt.env.make_async("hubspot:v1.2.7")
+    env = await fleet.env.make_async("hubspot:v1.2.7")
     print(f"New Instance: {env.instance_id}")
 
     try:
@@ -24,14 +24,14 @@ async def main():
         print("\n=== Taking Initial Snapshot ===")
         snapshot1 = await db.snapshot("initial_state")
         print(f"Snapshot created: {snapshot1.name}")
-        
+
         # Show current entries
         entries_count = await db.table("entries").count()
         print(f"Initial entry count: {entries_count}")
 
         # Make some changes
         print("\n=== Making Database Changes ===")
-        
+
         # 1. Insert a new deal
         print("\n1. Inserting new deal...")
         await db.exec("""
@@ -48,7 +48,7 @@ async def main():
                 '{}'
             )
         """)
-        
+
         # 2. Update an existing entry
         print("2. Updating existing entry...")
         await db.exec("""
@@ -56,7 +56,7 @@ async def main():
             SET name = 'Updated Contact Name'
             WHERE id = 1
         """)
-        
+
         # 3. Insert another entry
         print("3. Inserting another deal...")
         await db.exec("""
@@ -78,21 +78,26 @@ async def main():
         print("\n=== Taking Second Snapshot ===")
         snapshot2 = await db.snapshot("after_changes")
         print(f"Snapshot created: {snapshot2.name}")
-        
+
         new_entries_count = await db.table("entries").count()
         print(f"New entry count: {new_entries_count}")
 
         # Compare snapshots
         print("\n=== Comparing Snapshots ===")
-        
+
         # Configure what to ignore in diff
         ignore_config = IgnoreConfig(
             tables={"pageviews"},  # Ignore entire pageviews table
-            fields={"createdDate", "lastModifiedDate", "createdAt", "updatedAt"},  # Ignore timestamp fields
+            fields={
+                "createdDate",
+                "lastModifiedDate",
+                "createdAt",
+                "updatedAt",
+            },  # Ignore timestamp fields
         )
-        
+
         diff = await snapshot1.diff(snapshot2, ignore_config)
-        
+
         # Test 1: Validate all expected changes
         print("\nTest 1: Validating expected changes...")
         expected_changes = [
@@ -100,9 +105,14 @@ async def main():
             {"table": "entries", "pk": 99001, "field": None, "after": "__added__"},
             {"table": "entries", "pk": 99002, "field": None, "after": "__added__"},
             # Name updated
-            {"table": "entries", "pk": 1, "field": "name", "after": "Updated Contact Name"},
+            {
+                "table": "entries",
+                "pk": 1,
+                "field": "name",
+                "after": "Updated Contact Name",
+            },
         ]
-        
+
         try:
             await diff.expect_only(expected_changes)
             print("✓ All changes validated successfully!")
@@ -115,7 +125,7 @@ async def main():
             {"table": "entries", "pk": 99001, "field": None, "after": "__added__"},
             # Missing the second insert and the update
         ]
-        
+
         try:
             await diff.expect_only(incorrect_changes)
             print("✗ This should have failed!")
@@ -125,29 +135,29 @@ async def main():
 
         # Test 3: Query snapshot data directly
         print("\n=== Querying Snapshot Data ===")
-        
+
         # Query from first snapshot
         print("\nQuerying from initial snapshot:")
         initial_entry = await snapshot1.table("entries").eq("id", 1).first()
         if initial_entry:
             print(f"Entry 1 name in snapshot1: {initial_entry['name']}")
-        
+
         # Query from second snapshot
         print("\nQuerying from second snapshot:")
         updated_entry = await snapshot2.table("entries").eq("id", 1).first()
         if updated_entry:
             print(f"Entry 1 name in snapshot2: {updated_entry['name']}")
-        
+
         # Count deals in each snapshot
         deals_before = await snapshot1.table("entries").eq("type", "deal").all()
         deals_after = await snapshot2.table("entries").eq("type", "deal").all()
         print(f"\nDeals in snapshot1: {len(deals_before)}")
         print(f"Deals in snapshot2: {len(deals_after)}")
-        
+
         # Show new deals
         print("\nNew deals added:")
         for deal in deals_after:
-            if deal['id'] in [99001, 99002]:
+            if deal["id"] in [99001, 99002]:
                 print(f"  - {deal['name']} (id: {deal['id']})")
 
     finally:
@@ -158,4 +168,4 @@ async def main():
 
 
 if __name__ == "__main__":
-    asyncio.run(main()) 
+    asyncio.run(main())

examples/dsl_example.py

@@ -1,5 +1,5 @@
 import asyncio
-import fleet as flt
+import fleet
 from fleet.verifiers import DatabaseSnapshot, IgnoreConfig, TASK_SUCCESSFUL_SCORE
 from dotenv import load_dotenv
 
@@ -68,7 +68,7 @@ def validate_new_deal_creation(
 async def main():
     # Create a new instance
     print("Creating new Hubspot instance...")
-    env = await flt.env.make_async("hubspot")
+    env = await fleet.env.make_async("hubspot")
     print(f"New Instance: {env.instance_id}")
 
     try:
@@ -87,7 +87,7 @@ async def main():
         # Get the database resource
         await env.instance.load()
         db = env.db()
-        
+
         # Take a snapshot before insertion
         print("\nTaking snapshot before insertion...")
         snapshot_before = await db.snapshot("before_insertion")
@@ -139,12 +139,17 @@ async def main():
         ignore_config = IgnoreConfig(
             tables={"pageviews"},
             table_fields={
-                "entries": {"createdDate", "lastModifiedDate", "createdAt", "updatedAt"},
+                "entries": {
+                    "createdDate",
+                    "lastModifiedDate",
+                    "createdAt",
+                    "updatedAt",
+                },
             },
         )
-        
+
         diff = await snapshot_before.diff(snapshot_after, ignore_config)
-        
+
         # Check diff results
         print("\nDiff validation:")
         expected_changes = [
@@ -155,7 +160,7 @@ async def main():
                 "after": "__added__",
             }
         ]
-        
+
         try:
             await diff.expect_only(expected_changes)
             print("✓ Diff validation passed - only expected changes detected")

examples/example.py

@@ -2,21 +2,21 @@
 """Example demonstrating browser control with Fleet Manager Client."""
 
 import asyncio
-import fleet as flt
+import fleet
 from dotenv import load_dotenv
 
 load_dotenv()
 
 
 async def main():
-    regions = await flt.env.list_regions_async()
+    regions = await fleet.env.list_regions_async()
     print("Regions:", regions)
 
-    environments = await flt.env.list_envs_async()
+    environments = await fleet.env.list_envs_async()
     print("Environments:", len(environments))
 
     # Create a new instance
-    env = await flt.env.make_async("hubspot")
+    env = await fleet.env.make_async("hubspot")
     print(f"New Instance: {env.instance_id} ({env.region})")
 
     response = await env.reset(seed=42)

examples/exampleResume.py

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+"""
+Interactive Browser Snapshot/Resume Example
+
+This script:
+1. Creates an environment and browser
+2. Lets you interact with it manually
+3. Takes a snapshot when you type 'close'
+4. Resumes from the snapshot with a new environment
+"""
+
+import json
+import os
+import sys
+from datetime import datetime
+
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
+
+from fleet import Fleet
+
+def main():
+    # Initialize Fleet client
+    api_key = os.getenv("FLEET_API_KEY")
+    if not api_key:
+        print("Error: FLEET_API_KEY environment variable not set")
+        sys.exit(1)
+    
+    fleet = Fleet(api_key=api_key)
+    
+    # Initialize environment variables
+    env = None
+    new_env = None
+    
+    try:
+        # Step 1: Create environment and browser
+        print("🚀 Creating new environment...")
+        env_key = "fira:v1.3.2"  
+        
+        env = fleet.make(env_key)
+        print(f"✅ Environment created: {env.instance_id}")
+        print(f"📝 Session ID: {env.session_id}")
+        
+        # Start browser
+        print("\n🌐 Starting browser...")
+        browser = env.browser()
+        browser.start(width=1920, height=1080)
+        
+        # Get browser URLs with session ID for automatic logging
+        cdp_page_url = browser.cdp_page_url()
+        cdp_browser_url = browser.cdp_browser_url()
+        devtools_url = browser.devtools_url()
+        
+        print(f"✅ Browser started!")
+        print(f"🔗 CDP Page URL: {cdp_page_url}")
+        print(f"🔗 CDP Browser URL: {cdp_browser_url}")
+        print(f"🔗 DevTools URL: {devtools_url}")
+        
+        # Show connection info for debugging
+        conn_info = browser.get_connection_info()
+        print(f"📊 Logging enabled: {conn_info['logging_enabled']}")
+        if conn_info['logging_enabled']:
+            print(f"📝 All CDP actions will be automatically logged to session: {env.session_id}")
+        
+        # Step 2: Wait for user interaction
+        print("\n" + "="*60)
+        print("🎮 INTERACTIVE MODE")
+        print("="*60)
+        print("You can now interact with the browser manually.")
+        print("Open the DevTools URL in Chrome to see and control the browser.")
+        print("\nType 'close' and press Enter when you're done to save a snapshot.")
+        print("="*60 + "\n")
+        
+        while True:
+            user_input = input(">>> ").strip().lower()
+            
+            if user_input == "close":
+                break
+            elif user_input == "status":
+                print(f"Environment: {env.instance_id}")
+                print(f"Session: {env.session_id}")
+            else:
+                print("Type 'close' to save snapshot and exit, or 'status' to see current info")
+        
+        # Step 3: Take snapshot
+        print("\n📸 Taking snapshot...")
+        snapshot = env.get_snapshot(browser)
+        
+        # Save snapshot to file
+        snapshot_file = f"snapshot_{env.session_id}_{int(datetime.now().timestamp())}.json"
+        with open(snapshot_file, "w") as f:
+            json.dump(snapshot.model_dump(), f, indent=2)
+        
+        print(f"✅ Snapshot saved to: {snapshot_file}")
+        print(f"   - Tool logs: {len(snapshot.tool_logs)} entries")
+        print(f"   - Action logs: {len(snapshot.action_logs)} entries")
+        print(f"   - Page URL: {snapshot.page_url}")
+        print(f"   - Viewport: {snapshot.viewport_size}")
+        
+        # Close original environment
+        print("\n🏁 Closing original environment...")
+        env.close()
+        env = None  # Mark as closed
+        
+        # Step 4: Resume from snapshot
+        print("\n" + "="*60)
+        print("🔄 RESUMING FROM SNAPSHOT")
+        print("="*60)
+        
+        input("\nPress Enter to resume from snapshot...")
+        
+        print("\n🚀 Creating new environment from snapshot...")
+        new_env, validation = fleet.resume(
+            snapshot,
+            validate=True,
+            playback_speed=2.0  # Replay at 2x speed
+        )
+        
+        print(f"✅ Environment resumed: {new_env.instance_id}")
+        print(f"📝 New session ID: {new_env.session_id}")
+        
+        # Show validation results
+        print(f"\n📊 Validation Results:")
+        print(f"   - Success: {validation.success}")
+        print(f"   - Page match: {validation.page_match}")
+        print(f"   - Action log match: {validation.action_log_match}")
+        
+        if validation.discrepancies:
+            print(f"   - Discrepancies ({len(validation.discrepancies)}):")
+            for disc in validation.discrepancies[:5]:  # Show first 5
+                print(f"     • {disc}")
+            if len(validation.discrepancies) > 5:
+                print(f"     • ... and {len(validation.discrepancies) - 5} more")
+        
+        # Get new browser reference
+        new_browser = new_env.browser()
+        print(f"\n🌐 New browser ready!")
+        print(f"🔗 CDP Page URL: {new_browser.cdp_page_url()}")
+        print(f"🔗 DevTools URL: {new_browser.devtools_url()}")
+        print(f"📝 Resume session logging to: {new_env.session_id}")
+        
+        # Step 5: Keep new environment open for inspection
+        print("\n" + "="*60)
+        print("🎮 RESUMED ENVIRONMENT READY")
+        print("="*60)
+        print("The resumed environment is now ready. You can inspect it to verify")
+        print("it matches your original state.")
+        print("\nType 'done' when finished to close the resumed environment.")
+        print("="*60 + "\n")
+        
+        while True:
+            user_input = input(">>> ").strip().lower()
+            
+            if user_input == "done":
+                break
+            elif user_input == "status":
+                print(f"Environment: {new_env.instance_id}")
+                print(f"Session: {new_env.session_id}")
+            else:
+                print("Type 'done' to close the environment, or 'status' to see current info")
+        
+        # Clean up
+        print("\n🏁 Closing resumed environment...")
+        new_env.close()
+        new_env = None  # Mark as closed
+        print("✅ All done!")
+        
+    except KeyboardInterrupt:
+        print("\n\n⚠️  Interrupted by user")
+    except Exception as e:
+        print(f"\n❌ Error: {e}")
+    finally:
+        # Always clean up environments
+        if env is not None:
+            try:
+                print("\n🧹 Cleaning up original environment...")
+                env.close()
+                print("✅ Original environment closed")
+            except Exception as e:
+                print(f"⚠️  Failed to close original environment: {e}")
+        
+        if new_env is not None:
+            try:
+                print("\n🧹 Cleaning up resumed environment...")
+                new_env.close()
+                print("✅ Resumed environment closed")
+            except Exception as e:
+                print(f"⚠️  Failed to close resumed environment: {e}")
+
+
+if __name__ == "__main__":
+    main()

examples/example_account.py

@@ -0,0 +1,8 @@
+import fleet
+
+account = fleet.env.account()
+
+print(f"Team ID: {account.team_id}")
+print(f"Team Name: {account.team_name}")
+print(f"Instance Limit: {account.instance_limit}")
+print(f"Instance Count: {account.instance_count}")

examples/example_action_log.py

@@ -2,7 +2,7 @@
 """Example demonstrating browser control with Fleet Manager Client."""
 
 import asyncio
-import fleet as flt
+import fleet
 from dotenv import load_dotenv
 
 load_dotenv()
@@ -10,7 +10,7 @@ load_dotenv()
 
 async def main():
     # Create a new instance
-    env = await flt.env.make_async("fira:v1.3.2")
+    env = await fleet.env.make_async("fira:v1.3.2")
     print(f"New Instance: {env.instance_id} ({env.region})")
     print("URL:", env.urls.app)
 

examples/example_client.py

@@ -2,14 +2,14 @@
 """Example demonstrating browser control with Fleet Manager Client."""
 
 import asyncio
-import fleet as flt
+import fleet
 from dotenv import load_dotenv
 
 load_dotenv()
 
 
 async def main():
-    fleet = flt.AsyncFleet()
+    fleet = fleet.AsyncFleet()
 
     environments = await fleet.list_envs()
     print("Environments:", len(environments))

examples/example_mcp_anthropic.py

@@ -1,5 +1,5 @@
 import asyncio
-import fleet as flt
+import fleet
 from anthropic import AsyncAnthropic
 from mcp import ClientSession
 from mcp.client.streamable_http import streamablehttp_client
@@ -11,12 +11,14 @@ client = AsyncAnthropic()
 
 
 async def main():
-    env = flt.env.make("fira:v1.3.3")
+    env = fleet.env.make("fira")
     print("Created environment:", env.urls.app)
     print("MCP URL:", env.mcp.url)
 
     async with streamablehttp_client(url=env.mcp.url) as streams:
-        async with ClientSession(read_stream=streams[0], write_stream=streams[1]) as session:
+        async with ClientSession(
+            read_stream=streams[0], write_stream=streams[1]
+        ) as session:
             await session.initialize()
 
             list_tools = await session.list_tools()
@@ -29,7 +31,6 @@ async def main():
                 for tool in list_tools.tools
             ]
 
-
             messages = [
                 {
                     "role": "user",
@@ -54,7 +55,9 @@ async def main():
 
                     result = await session.call_tool(tool_name, tool_args)
                     tool_results.append({"call": tool_name, "result": result})
-                    output_text.append(f"[Calling tool {tool_name} with args {tool_args}]")
+                    output_text.append(
+                        f"[Calling tool {tool_name} with args {tool_args}]"
+                    )
 
                     if hasattr(content, "text") and content.text:
                         messages.append({"role": "assistant", "content": content.text})

examples/example_mcp_openai.py

@@ -1,4 +1,4 @@
-import fleet as flt
+import fleet
 from openai import OpenAI
 from dotenv import load_dotenv
 
@@ -8,7 +8,7 @@ client = OpenAI()
 
 
 def main():
-    env = flt.env.make("fira:v1.3.3")
+    env = fleet.env.make("fira")
     print("Created environment:", env.urls.app)
     print("MCP URL:", env.mcp.url)
 

examples/example_sync.py

@@ -1,21 +1,21 @@
 #!/usr/bin/env python3
 """Example demonstrating browser control with Fleet Manager Client."""
 
-import fleet as flt
+import fleet
 from dotenv import load_dotenv
 
 load_dotenv()
 
 
 def main():
-    environments = flt.env.list_envs()
+    environments = fleet.env.list_envs()
     print("Environments:", len(environments))
 
-    instances = flt.env.list_instances(status="running")
+    instances = fleet.env.list_instances(status="running")
     print("Instances:", len(instances))
 
     # Create a new instance
-    env = flt.env.make("hubspot")
+    env = fleet.env.make("hubspot")
     print("New Instance:", env.instance_id)
 
     response = env.reset(seed=42)

examples/example_task.py

@@ -26,13 +26,13 @@ def create_bug_issue_sync(
     env, project_key: str = "SCRUM", issue_title: str = "Sample Bug"
 ) -> float:
     """Synchronous verifier for remote execution.
-    
+
     Note: This is designed for remote execution where env.db() returns sync resources.
     """
     # Define constants locally for remote execution
     TASK_SUCCESSFUL_SCORE = 1.0
     TASK_FAILED_SCORE = 0.0
-    
+
     try:
         # Get the database resource
         db = env.db()
@@ -96,7 +96,9 @@ async def create_bug_issue_async(
 async def main():
     """Run the task example."""
     print("=== Fleet Task Example with Jira ===\n")
-    print("Note: Both sync and async verifiers are now supported for remote execution.\n")
+    print(
+        "Note: Both sync and async verifiers are now supported for remote execution.\n"
+    )
 
     # Create task using the async verifier for local execution
     task = Task(
@@ -111,7 +113,9 @@ async def main():
     print(f"  Key: {task.key}")
     print(f"  Prompt: {task.prompt}")
     print(f"  Environment: {task.env_id}")
-    print(f"  Verifier: {task.verifier.key if hasattr(task.verifier, 'key') else 'create_bug_issue'}")
+    print(
+        f"  Verifier: {task.verifier.key if hasattr(task.verifier, 'key') else 'create_bug_issue'}"
+    )
     print(f"  Created at: {task.created_at}")
     print(f"  Metadata: {task.metadata}")
     print()
@@ -153,13 +157,16 @@ async def main():
         # Test async verifier remote execution
         print("Testing remote execution with async verifier...")
         try:
-            result = await create_bug_issue_async.remote(env, project_key="SCRUM", issue_title="Login button not working")
+            result = await create_bug_issue_async.remote(
+                env, project_key="SCRUM", issue_title="Login button not working"
+            )
             print(f"  ✓ Async remote check result: {result}")
         except NotImplementedError as e:
             print(f"  ✓ Expected error: {e}")
         except Exception as e:
             print(f"  ✗ Unexpected error: {e}")
             import traceback
+
             traceback.print_exc()
         print()
 
@@ -185,7 +192,9 @@ async def main():
             env, project_key="SCRUM", issue_title="Login button not working"
         )
         print(f"  Final check result: {result}")
-        print(f"  Task {'completed successfully' if result == TASK_SUCCESSFUL_SCORE else 'failed'}!")
+        print(
+            f"  Task {'completed successfully' if result == TASK_SUCCESSFUL_SCORE else 'failed'}!"
+        )
         print()
 
         # Clean up
@@ -196,6 +205,7 @@ async def main():
     except Exception as e:
         print(f"✗ Error: {e}")
         import traceback
+
         traceback.print_exc()
 
 

examples/example_tasks.py

@@ -1,16 +1,13 @@
-import fleet as flt
+import fleet
 from dotenv import load_dotenv
 
 load_dotenv()
 
 
-client = flt.Fleet()
-
-
 def main():
-    env = flt.env.make("fira")
+    env = fleet.env.make("fira")
 
-    tasks = client.load_tasks(env_key="fira")
+    tasks = fleet.load_tasks(env_key="fira")
     print(f"Loaded {len(tasks)} tasks")
 
     for i, task in enumerate(tasks):