oagi-core 0.10.1__py3-none-any.whl

oagi/types/models/image_config.py

@@ -0,0 +1,47 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+from typing import Literal
+
+from pydantic import BaseModel, Field, field_validator
+
+
+class ImageConfig(BaseModel):
+    """Configuration for image capture and processing."""
+
+    format: Literal["PNG", "JPEG"] = Field(
+        default="JPEG", description="Image format for encoding"
+    )
+    quality: int = Field(
+        default=85,
+        ge=1,
+        le=100,
+        description="JPEG quality (1-100, only applies to JPEG format)",
+    )
+    width: int | None = Field(
+        default=1260, description="Target width in pixels (will resize to exact size)"
+    )
+    height: int | None = Field(
+        default=700, description="Target height in pixels (will resize to exact size)"
+    )
+    optimize: bool = Field(
+        default=False,
+        description="Enable PNG optimization (only applies to PNG format)",
+    )
+    resample: Literal["NEAREST", "BILINEAR", "BICUBIC", "LANCZOS"] = Field(
+        default="LANCZOS", description="Resampling filter for resizing"
+    )
+
+    @field_validator("quality")
+    @classmethod
+    def validate_quality(cls, v: int, info) -> int:
+        """Validate quality parameter based on format."""
+        values = info.data
+        if values.get("format") == "PNG" and v != 85:
+            return 85
+        return v

oagi/types/models/step.py

@@ -0,0 +1,17 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+from pydantic import BaseModel
+
+from .action import Action
+
+
+class Step(BaseModel):
+    reason: str | None = None
+    actions: list[Action]
+    stop: bool = False

oagi/types/step_observer.py

@@ -0,0 +1,93 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+from datetime import datetime
+from typing import Literal, Protocol
+
+from pydantic import BaseModel, Field
+
+from .models import Action, Step
+
+
+class BaseEvent(BaseModel):
+    """Base class for all observer events with automatic timestamp."""
+
+    timestamp: datetime = Field(default_factory=datetime.now)
+
+
+class ImageEvent(BaseEvent):
+    """Event emitted when a screenshot is captured."""
+
+    type: Literal["image"] = "image"
+    step_num: int
+    image: bytes | str
+
+
+class StepEvent(BaseEvent):
+    """Event emitted when LLM returns a step decision."""
+
+    type: Literal["step"] = "step"
+    step_num: int
+    image: bytes | str
+    step: Step
+
+
+class ActionEvent(BaseEvent):
+    """Event emitted after actions are executed."""
+
+    type: Literal["action"] = "action"
+    step_num: int
+    actions: list[Action]
+    error: str | None = None
+
+
+class LogEvent(BaseEvent):
+    """Event for custom log messages."""
+
+    type: Literal["log"] = "log"
+    message: str
+
+
+class SplitEvent(BaseEvent):
+    """Event for visual separators in exported reports."""
+
+    type: Literal["split"] = "split"
+    label: str = ""
+
+
+class PlanEvent(BaseEvent):
+    """Event emitted for planner activities (planning, reflection, summary)."""
+
+    type: Literal["plan"] = "plan"
+    phase: Literal["initial", "reflection", "summary"]
+    image: bytes | str | None = None
+    reasoning: str
+    result: str | None = None
+
+
+ObserverEvent = ImageEvent | StepEvent | ActionEvent | LogEvent | SplitEvent | PlanEvent
+
+
+class AsyncObserver(Protocol):
+    """Protocol for observing agent execution events.
+
+    Observers receive events during agent execution, enabling
+    recording, tracking, logging, or other side effects.
+    """
+
+    async def on_event(self, event: ObserverEvent) -> None:
+        """Called when an agent execution event occurs.
+
+        Args:
+            event: The event that occurred during agent execution.
+        """
+        ...
+
+
+# Deprecated: Use AsyncObserver instead
+AsyncStepObserver = AsyncObserver

oagi/types/url.py

@@ -0,0 +1,3 @@
+from typing import NewType
+
+URL = NewType("URL", str)

oagi_core-0.10.1.dist-info/METADATA

@@ -0,0 +1,245 @@
+Metadata-Version: 2.3
+Name: oagi-core
+Version: 0.10.1
+Summary: Official API of OpenAGI Foundation
+Project-URL: Homepage, https://github.com/agiopen-org/oagi
+Author-email: OpenAGI Foundation <contact@agiopen.org>
+License: MIT License
+        
+        Copyright (c) 2025 OpenAGI Foundation
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: desktop
+Requires-Dist: pillow>=11.3.0; extra == 'desktop'
+Requires-Dist: pyautogui>=0.9.54; extra == 'desktop'
+Requires-Dist: pyobjc-framework-applicationservices>=9.0; (sys_platform == 'darwin') and extra == 'desktop'
+Requires-Dist: pyobjc-framework-quartz>=9.0; (sys_platform == 'darwin') and extra == 'desktop'
+Provides-Extra: server
+Requires-Dist: fastapi[standard]>=0.115.0; extra == 'server'
+Requires-Dist: pydantic-settings>=2.0.0; extra == 'server'
+Requires-Dist: python-socketio>=5.11.0; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.32.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# OAGI Python SDK
+
+Python SDK for the OAGI API - vision-based task automation.
+
+## Installation
+
+```bash
+# Recommended: All features (desktop automation + server)
+pip install oagi
+
+# Or install core only (minimal dependencies)
+pip install oagi-core
+
+# Or install with specific features
+pip install oagi-core[desktop]  # Desktop automation support
+pip install oagi-core[server]   # Server support
+```
+
+**Requires Python >= 3.10**
+
+### Installation Options
+
+- **`oagi`** (Recommended): Metapackage that includes all features (desktop + server). Equivalent to `oagi-core[desktop,server]`.
+- **`oagi-core`**: Core SDK with minimal dependencies (httpx, pydantic). Suitable for server deployments or custom automation setups.
+- **`oagi-core[desktop]`**: Adds `pyautogui` and `pillow` for desktop automation features like screenshot capture and GUI control.
+- **`oagi-core[server]`**: Adds FastAPI and Socket.IO dependencies for running the real-time server for browser extensions.
+
+**Note**: Features requiring desktop dependencies (like `PILImage.from_screenshot()`, `PyautoguiActionHandler`, `ScreenshotMaker`) will show helpful error messages if you try to use them without installing the `desktop` extra.
+
+## Quick Start
+
+Set your API credentials:
+```bash
+export OAGI_API_KEY="your-api-key" # get your API key from https://developer.openagi.org/
+# export OAGI_BASE_URL="https://api.agiopen.org/", # optional, defaults to production endpoint
+```
+
+### Automated Task Execution
+
+Run tasks automatically with screenshot capture and action execution:
+
+```python
+import asyncio
+from oagi import AsyncDefaultAgent, AsyncPyautoguiActionHandler, AsyncScreenshotMaker
+
+async def main():
+    agent = AsyncDefaultAgent(max_steps=10)
+    completed = await agent.execute(
+        "Search weather on Google",
+        action_handler=AsyncPyautoguiActionHandler(),  # Executes mouse/keyboard actions
+        image_provider=AsyncScreenshotMaker(),         # Captures screenshots
+    )
+    return completed
+
+asyncio.run(main())
+```
+
+Configure PyAutoGUI behavior with custom settings:
+
+```python
+from oagi import AsyncPyautoguiActionHandler, PyautoguiConfig
+
+# Customize action behavior
+config = PyautoguiConfig(
+    drag_duration=1.0,      # Slower drags for precision (default: 0.5)
+    scroll_amount=50,       # Larger scroll steps (default: 30)
+    wait_duration=2.0,      # Longer waits (default: 1.0)
+    action_pause=0.2,       # More pause between actions (default: 0.1)
+    hotkey_interval=0.1,    # Interval between keys in hotkey combinations (default: 0.1)
+    capslock_mode="session" # Caps lock mode: 'session' or 'system' (default: 'session')
+)
+
+action_handler = AsyncPyautoguiActionHandler(config=config)
+```
+
+### Image Processing
+
+Process and optimize images before sending to API:
+
+```python
+from oagi import PILImage, ImageConfig
+
+# Load and compress an image
+image = PILImage.from_file("large_screenshot.png")
+config = ImageConfig(
+    format="JPEG",
+    quality=85,
+    width=1260,
+    height=700
+)
+compressed = image.transform(config)
+```
+
+### Manual Control with Actor
+
+For step-by-step control over task execution:
+
+```python
+import asyncio
+from oagi import AsyncActor, AsyncPyautoguiActionHandler, AsyncScreenshotMaker
+
+async def main():
+    async with AsyncActor() as actor:
+        await actor.init_task("Complete the form")
+        image_provider = AsyncScreenshotMaker()
+        action_handler = AsyncPyautoguiActionHandler()
+
+        for _ in range(10):
+            image = await image_provider()
+            step = await actor.step(image)
+
+            if step.stop:
+                break
+
+            await action_handler(step.actions)
+
+asyncio.run(main())
+```
+
+## Examples
+
+See the [`examples/`](examples/) directory for more usage patterns:
+- `execute_task_auto.py` - Automated task execution with `AsyncDefaultAgent`
+- `execute_task_manual.py` - Manual step-by-step control with `Actor`
+- `continued_session.py` - Continuing tasks across sessions
+- `screenshot_with_config.py` - Image compression and optimization
+- `socketio_server_basic.py` - Socket.IO server example
+- `socketio_client_example.py` - Socket.IO client implementation
+
+## Socket.IO Server (Optional)
+
+The SDK includes an optional Socket.IO server for real-time bidirectional communication with browser extensions or custom clients.
+
+### Installation
+
+```bash
+# Install with server support
+pip install oagi  # Includes server features
+# Or
+pip install oagi-core[server]  # Core + server only
+```
+
+### Running the Server
+
+```python
+import uvicorn
+from oagi.server import create_app, ServerConfig
+
+# Create FastAPI app with Socket.IO
+app = create_app()
+
+# Run server
+uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+Or use the example script:
+```bash
+export OAGI_API_KEY="your-api-key"
+python examples/socketio_server_basic.py
+```
+
+### Server Features
+
+- **Dynamic namespaces**: Each session gets its own namespace (`/session/{session_id}`)
+- **Simplified events**: Single `init` event from client with instruction
+- **Action execution**: Emit individual actions (click, type, scroll, etc.) to client
+- **S3 integration**: Server sends presigned URLs for direct screenshot uploads
+- **Session management**: In-memory session storage with timeout cleanup
+- **REST API**: Health checks and session management endpoints
+
+### Client Integration
+
+Clients connect to a session namespace and handle action events:
+
+```python
+import socketio
+
+sio = socketio.AsyncClient()
+namespace = "/session/my_session_id"
+
+@sio.on("request_screenshot", namespace=namespace)
+async def on_screenshot(data):
+    # Upload screenshot to S3 using presigned URL
+    return {"success": True}
+
+@sio.on("click", namespace=namespace)
+async def on_click(data):
+    # Execute click at coordinates
+    return {"success": True}
+
+await sio.connect("http://localhost:8000", namespaces=[namespace])
+await sio.emit("init", {"instruction": "Click the button"}, namespace=namespace)
+```
+
+See [`examples/socketio_client_example.py`](examples/socketio_client_example.py) for a complete implementation.
+
+## Documentation
+
+
+## License
+
+MIT

oagi_core-0.10.1.dist-info/RECORD

@@ -0,0 +1,68 @@
+oagi/__init__.py,sha256=xI--F3inDKuNQ2caI4Xx0rdFuUxO24cEeAX6WoGi170,4836
+oagi/exceptions.py,sha256=Rco37GQTPYUfc2vRO3hozxPF_s8mKFDpFvBg2UKWo3Y,3066
+oagi/logging.py,sha256=YT3KCMFj5fzO98R9xlDDgfSotUuz1xRD6OZeYM2rKoo,1760
+oagi/agent/__init__.py,sha256=KTVLUMhbjgpTJoOWMUZkkiqwhgumvbOZV2tJ9XCLfao,901
+oagi/agent/default.py,sha256=VaDiYISM0Y3l_xhSvWcIZQDiUj_ebHg9tgWLnr-OWuY,4116
+oagi/agent/factories.py,sha256=WP4ONu9JBDaJYmK18OuFihAX7YKCeOKgOh981lYguXo,2113
+oagi/agent/protocol.py,sha256=IQJGiMN4yZIacrh5e9JQsoM9TyHb8wJRQR4LAk8dSA0,1615
+oagi/agent/registry.py,sha256=7bMA2-pH3xQ9ZavrHB_mnc2fOGSMeICPbOGtHoM7It0,4851
+oagi/agent/observer/__init__.py,sha256=YZ4qvR22pFB0mSDMX6iKKLbBA1dB-nqC7HZVvdMIVGw,909
+oagi/agent/observer/agent_observer.py,sha256=fBs4X2_YKhYVThJocjMM-65JAHQSCLJPvzy8OXMt5pY,2864
+oagi/agent/observer/events.py,sha256=xc3Z1UGpX69BqhO9cQiGmnRhDZbMYya1kuXm6bXtjWI,625
+oagi/agent/observer/exporters.py,sha256=im1aK8UkGfWbRnVIYdsoCKVX_JYrcEvzRMDD2CK3gcM,15245
+oagi/agent/observer/protocol.py,sha256=jyRXoCG4CdvaPaDASar1rSbwc7vdpkar39KkGpwf8jw,411
+oagi/agent/tasker/__init__.py,sha256=1iTEFe7lzcqh96TL9R0QADPpLJLrUP0shtZ4DlZSv_8,764
+oagi/agent/tasker/memory.py,sha256=NR13l5yxRA8GUE-oupAP4W1n80ZNG0SxpUfxsNltkUY,5033
+oagi/agent/tasker/models.py,sha256=sMQgwIMKhT1tvVF2yoc1hh8GwEiJ6i6qPMy9WoiA8JM,2137
+oagi/agent/tasker/planner.py,sha256=1NJQ2279GlGLMTB6JUhgnJtN46iiEGy2O_czaxRQwsE,14437
+oagi/agent/tasker/taskee_agent.py,sha256=b2oHkHrZak3S5gMVffjht7ra8et8xDAADoDlfZFy_os,16731
+oagi/agent/tasker/tasker_agent.py,sha256=ZZXJpT1tHpYJB8nQpz3LSNrW21DxkWBk-g5bY0gWxRk,10732
+oagi/cli/__init__.py,sha256=aDnJViTseShpo5fdGPTj-ELysZhmdvB6Z8mEj2D-_N4,359
+oagi/cli/agent.py,sha256=tXn53MKKLs446gRXZf-22Yj1b3cTZh7qfsiFKq4xsRY,9447
+oagi/cli/display.py,sha256=rkAxuHa40ZtKdmvwARev1rgyfsNyVvQ-J6RdjOZIPwc,1729
+oagi/cli/main.py,sha256=faHns0HaQCGyylDn2YZLpjQESuEiMYjoQVoMkt8FsH4,2292
+oagi/cli/server.py,sha256=Z1ic8r55yaeQBFRCsMNZStC1jRiJdnDGqe9On9LmFzQ,3031
+oagi/cli/tracking.py,sha256=TdrAcNq_-OjgXltFCoFc8NsO_k6yHbdzHnMn3vAAvKA,1707
+oagi/cli/utils.py,sha256=BI6C7WvC51NBsXEsjDONjSNwqdD4i0nHA_rsfpyLwmA,2986
+oagi/client/__init__.py,sha256=F9DShPUdb6vZYmN1fpM1VYzp4MWqUao_e_R1KYmM4Q4,410
+oagi/client/async_.py,sha256=iEOQun2kxW1iQ4h_TsSKqj-w3LviKLDxddXrteY61Fk,10894
+oagi/client/base.py,sha256=lczoKI1FqlqJbfAB6lAuXH2oDCVT-F0_LBVu6OS1pDo,16739
+oagi/client/sync.py,sha256=LPCG136BVzzL9yQOW7QdBiEXCDwRzzqL3GXnJHA6ui8,10730
+oagi/handler/__init__.py,sha256=Ha11L42K33K3L9S4lQ10UC0DnD5g6egtQUsJpS_tKgg,835
+oagi/handler/_macos.py,sha256=aHkp-xGzvWL_SBjuS690i9jf93OITFJfGHzHeYCK65I,1957
+oagi/handler/async_pyautogui_action_handler.py,sha256=hQzseR1yBD0QMpgsEVNsUmuApGVAIIyGYD06BXd82Dc,1615
+oagi/handler/async_screenshot_maker.py,sha256=8QCtUV59ozpOpvkqhUMb8QDI2qje2gsoFT1qB60tfJM,1689
+oagi/handler/pil_image.py,sha256=yUcAoGBL-aZ0PCjSaAmQsDwtyzjldXHqXQp_OYRk6e4,4080
+oagi/handler/pyautogui_action_handler.py,sha256=SwoKOUw6SJuDA2dAqSXk3iMyvqpzTYnPxNi3L06JZV4,10847
+oagi/handler/screenshot_maker.py,sha256=j1jTW-awx3vAnb1N5_FIMBC0Z-rNVQbiBP-S6Gh5dlE,1284
+oagi/server/__init__.py,sha256=uZx8u3vJUb87kkNzwmmVrgAgbqRu0WxyMIQCLSx56kk,452
+oagi/server/agent_wrappers.py,sha256=j8va0A7u80bzOM82nndAplK1uaO_T3kufHWScK6kfWM,3263
+oagi/server/config.py,sha256=2gJ-pDpYAxNUubwSsGKOieGcOtNX9b5YGuSqtf6g2P0,1607
+oagi/server/main.py,sha256=jnTxk7Prc5CzlsUnkBNJp4MOoYN-7HN_Be_m1d3COa8,4829
+oagi/server/models.py,sha256=7zsmjvnIZ0JUcCpE8F2A1OqX4_kGJydraRkbvPHnvn8,2593
+oagi/server/session_store.py,sha256=922Sz00_Ao-9fA0dhA1lrzs7yd6wo7xpdYJH4hZmEaI,3634
+oagi/server/socketio_server.py,sha256=NFw5Zu7yCFLW-gOu9OX8k6mNFaCN2jtX1Tob_9w5YM0,14344
+oagi/task/__init__.py,sha256=g_8_7ZLDLKuCGzyrB42OzY3gSOjd_SxzkJW3_pf-PXs,662
+oagi/task/async_.py,sha256=ev1jnuOQIYahjjMlSCFwtaeyOliePZCpEVt3ocsZXAI,3124
+oagi/task/async_short.py,sha256=VMIBKcTQMjadWXPHiJXWlYZqr5v4MeGVYnuKOs7dS3Y,2752
+oagi/task/base.py,sha256=D4e4N1cWoObMzaGcXyXGBPKyNbzmxABIjxbHiVrK548,5664
+oagi/task/short.py,sha256=xSR5_9BX35UMfITXtCgKXRLU92f4vnqa06c-HSjUO0A,2561
+oagi/task/sync.py,sha256=ciDkQYJQZkQyp8buNIKXU9Oy6kD7WIezCh2L0trLDDc,2958
+oagi/types/__init__.py,sha256=TCdHA8zPJAzpo-jgkfcWTWmbrWglOpShGQFcLoxV_xw,1187
+oagi/types/action_handler.py,sha256=NH8E-m5qpGqWcXzTSWfF7W0Xdp8SkzJsbhCmQ0B96cg,1075
+oagi/types/async_action_handler.py,sha256=k1AaqSkFcXlxwW8sn-w0WFHGsIqHFLbcOPrkknmSVug,1116
+oagi/types/async_image_provider.py,sha256=UwDl7VOCA3tiSP5k1fnxK86iEa84Yr57MVaoBSa3hOE,1203
+oagi/types/image.py,sha256=KgPCCTJ6D5vHIaGZdbTE7eQEa1WlT6G9tf59ZuUCV2U,537
+oagi/types/image_provider.py,sha256=IhKEnwCGZ5l_rO3AvJ6xv5RZMTmTDmqsFRynI9h0R_M,1145
+oagi/types/step_observer.py,sha256=wXuChzsof7Rh4azvDTIQ22gAwZAYjMAOVIuL8ZGtw-M,2315
+oagi/types/url.py,sha256=Q-1jf5L_4rad4dxyLTg4MXadGgpkH3w4dcoVrVupW-A,54
+oagi/types/models/__init__.py,sha256=I86Z2moM8hCog_1K1FG_uATcBmWFv_UFetLAjzPzWAY,742
+oagi/types/models/action.py,sha256=hh6mRRSSWgrW4jpZo71zGMCOcZpV5_COu4148uG6G48,967
+oagi/types/models/client.py,sha256=1xIKBgLSheHfqYbcyRKMDOLQJaKijaKQ5l-COc6e7_k,1471
+oagi/types/models/image_config.py,sha256=tl6abVg_-IAPLwpaWprgknXu7wRWriMg-AEVyUX73v0,1567
+oagi/types/models/step.py,sha256=RSI4H_2rrUBq_xyCoWKaq7JHdJWNobtQppaKC1l0aWU,471
+oagi_core-0.10.1.dist-info/METADATA,sha256=o1zoJQaVrlJwL_a8KBwYJeTpmo7ktC_kE4NPVsNfXB0,8269
+oagi_core-0.10.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+oagi_core-0.10.1.dist-info/entry_points.txt,sha256=zzgsOSWX6aN3KUB0Z1it8DMxFFBJBqmZVqMVAJRjYuw,44
+oagi_core-0.10.1.dist-info/licenses/LICENSE,sha256=sy5DLA2M29jFT4UfWsuBF9BAr3FnRkYtnAu6oDZiIf8,1075
+oagi_core-0.10.1.dist-info/RECORD,,

oagi_core-0.10.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.26.3
+Root-Is-Purelib: true
+Tag: py3-none-any

oagi_core-0.10.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+oagi = oagi.cli.main:main

oagi_core-0.10.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenAGI Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.