axpilot 0.1.0a1__tar.gz

axpilot-0.1.0a1/.gitignore

@@ -0,0 +1,229 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+*.lcov
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# uv
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi/*
+!.pixi/config.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule*
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs/Zensical documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore that
+#   can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, you
+#   could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# --- macOS / AXPilot ---
+.DS_Store
+*.xcuserstate
+xcuserdata/
+DerivedData/
+launcher/build/
+spikes/**/results/*
+!spikes/**/results/.gitkeep

axpilot-0.1.0a1/CHANGELOG.md

@@ -0,0 +1,229 @@
+# Changelog
+
+All notable changes to AXPilot are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Tool names, parameters,
+output schemas and error codes are public API: breaking changes to them are called out under
+**Changed** or **Removed** with a migration note. The launcher (`AXPilot.app`) has its own version
+line; a new launcher version requires a one-time permission re-grant, which is always flagged here.
+
+## [Unreleased]
+
+## [0.1.0a1] - 2026-10-21
+
+The first alpha, for early testers: AXPilot on PyPI for macOS 14 or later. It is verified on
+macOS 26 on Apple silicon; macOS 14 and 15 and Intel Macs are not tested yet. Expect breaking
+changes until 1.0. The wheel embeds launcher 1.0.0 (`launcher-v1`, pinned in `launcher/CDHASH.md`):
+the `AXPilot.app` you grant Accessibility and Screen Recording to once.
+
+### Added
+
+- Locators for automation scripts. `locate` turns an element ref into a *locator*: a small JSON
+  object that names the element by its AXIdentifier, role and name, its containers or its
+  position, and still works in later sessions (refs only last for one). It returns a few
+  candidates, best first, each checked against a fresh capture of the window so that it names only
+  that element, graded `high` (an identifier), `medium` (role and name, which change with the app's
+  language) or `low` (a position), with warnings such as a missing identifier or a toolbar that can
+  overflow; it can also write the locator as an AXPilot SDK snippet. `locate(locator=…)` checks a
+  locator against the live window, and `locate(refs=[…])` locates every element of a screen in one
+  call, with one script for all of them (the steps of a flow: the agent locates each screen before
+  leaving it, since a closed screen's elements can't be checked; a secure field's text comes from
+  an environment variable). Agents call it only when asked for locators, a script or a test.
+  `find(locator=…)` looks one up with exact matching (also with
+  `scroll=true`) and reports `count` and `unique`; in the SDK, `find(locator=…).click()` raises the
+  new error codes `ELEMENT_NOT_FOUND` and `LOCATOR_AMBIGUOUS` instead of guessing. See
+  [Locators](docs/locators.md).
+- Dropdowns in every kind of app: `select_option` opens the control, waits for its menu or list,
+  picks the option by title or index, checks that the control took it, and closes the menu again
+  if anything fails (including the kill switch). It covers pop-up buttons (also when their menu
+  belongs to the application), menu buttons such as Notes "Format" and Finder "Action" (refused
+  before), combo boxes (Java and Qt ones whose list opens in a window of its own), web `<select>`
+  elements, and custom web and Electron pickers (React Select, MUI, Slack, VS Code), which get
+  real mouse clicks; a web combo box that shows nothing on a click gets the Down arrow, and one
+  that does not list the option is typed into to filter it (the text is put back on failure).
+  `set_value` and `fill_form` choose pop-up options the same way. Snapshots taken while a menu is
+  open list its items, so opening a menu with `perform_action` and clicking an item also works.
+- The first time a tool finds Accessibility missing (or a screenshot finds Screen Recording
+  missing), AXPilot shows macOS's own permission prompt, which also lists AXPilot in System
+  Settings, ready to be switched on. Before, a new user had to add AXPilot.app there by hand.
+- `axpilot doctor` in launcher mode no longer judges Accessibility and Screen Recording by the app
+  it runs in (a terminal without them showed a failure although AXPilot.app worked); it says it
+  did not check AXPilot.app and shows the terminal's grants as information for direct mode.
+- `axpilot stdio` completes the MCP handshake even when it cannot reach the AXPilot host
+  (AXPilot.app not installed, the host does not start, or it refused this client): it prints the
+  error on stderr, lists the usual tools and returns the error with its hint ("Run `axpilot setup`
+  once") from every tool call, so MCP clients show the reason instead of "server failed to start".
+- A CI job builds the Swift launcher (`launcher/build.sh`) on macOS and runs its contract tests
+  against the built bundle on every change; nothing is published.
+- An eval suite (`python -m axpilot.evals`): 43 tasks on the simulated desktop (input, controls,
+  dropdowns, menus, windows, long lists, OCR, web pages, an Electron and a Java app, and safety
+  requests that must not succeed), judged by state through read-only tools. A scripted agent replays each task's reference
+  solution in CI; model-backed agents plug in as `module:factory` and get JSON and Markdown reports.
+- The kill switch and the on-screen indicator (macOS, real engine; not yet run on a Mac): ⌃⌥⌘.
+  (`[safety] kill_switch`) stops the input action in progress and pauses AXPilot, and pressing it
+  again resumes; a frame around the screen and a status pill show while AXPilot acts
+  (`[safety] indicator`), orange while paused. The hotkey is a Carbon hotkey (no permission
+  needed); the UI is best effort, so the server runs on without it if AppKit fails.
+- The HTTP bearer token lives in the macOS login keychain (`[server] token_store`, `auto` by
+  default). A token from the old file moves there, so configured clients keep working; a locked
+  or unavailable keychain falls back to the private file with a warning. The token is written
+  through `security`'s standard input, never in a command line.
+- Confirmations through the MCP client in direct mode: a client that supports elicitation shows
+  AXPilot's question in its own window (`[safety] elicitation`, on by default; off with `--yes`).
+  On protocol 2026-07-28 the question ends the call with an `InputRequiredResult` and the
+  client's retry carries the answer, which counts once, for the same call and question, within
+  the confirmation timeout. While the question is open every acting tool waits with
+  `NEEDS_USER`. Clients without elicitation keep the dialog or the safe "no".
+- Project plan ([docs/PLAN.md](docs/PLAN.md)) and architecture decision records for language,
+  architecture, minimum macOS, MCP surface, signing and distribution, privacy, and the name
+  ([docs/adr/](docs/adr/README.md)).
+- Package foundation: stable error codes with hints (`axpilot.errors`), platform-independent data
+  types (`axpilot.models`), configuration with TOML file, `AXPILOT_<SECTION>_<KEY>` environment
+  variables and CLI overrides (`axpilot.config`), and redirectable filesystem locations
+  (`axpilot.paths`).
+- The `Engine` interface, the in-memory `FakeEngine` with a demo desktop fixture for tests and
+  `--engine fake`, and the PyObjC-based macOS engine.
+- Perception: accessibility snapshots with refs, pruning, paging, diffs, fuzzy element search,
+  the compact text format, and snapshot and capture stores.
+- Stable element refs: a ref is unique per session, never reused for another element, and kept
+  by its element across snapshots of a window, so refs held from earlier snapshots keep working
+  after actions re-snapshot the UI. A ref whose element is gone, or a list row that scrolled
+  away, gives `STALE_REF` instead of hitting another element. Diffs pair equal refs first.
+- Navigation tools: `explore` (a map of an app: windows, menus with item counts, toolbar, tabs,
+  sidebar, scroll areas, dialogs, focus and its compatibility profile), `find` (fuzzy search that
+  can scroll a list or page until the element appears), `scroll` (by lines or pages, to the top or
+  bottom, or an element into view; reports `moved` and `at_end`) and `read` (the whole content of a
+  long list, table, text view or web page, joined page by page without repeats, with `complete`).
+  Scrolling measures the app's line height, applies the input policy and lock, and every loop is
+  bounded, returning partial results with a warning instead of failing.
+- App and system tools: `app` (launch, activate, hide, unhide, quit, force-quit), `window` (focus,
+  move, resize, minimize, restore, zoom, full screen, close), `open` (URLs, files and folders; only
+  http(s), mailto, file and System Settings URLs unless scripting is enabled), `clipboard` (text,
+  images, files), `notify`, `spotlight_search`, `system_info`, `system_control` (volume, mute,
+  appearance) and `processes` (list; stopping one refuses system processes, AXPilot and protected
+  apps before asking the user). A `manage` policy kind applies the deny lists to app and window
+  management without the Terminal typing rule; protected apps are recognized by their bundle id,
+  even renamed.
+- Scripting tools, off by default: `shell` (zsh with the user's PATH), `applescript` (AppleScript
+  and JXA), `shortcuts` (list and run) and `defaults` (read and write preferences). Every command,
+  script, shortcut run and preference change is shown to the user for approval, after the call is
+  validated; apps a script names and preference domains are checked against the deny lists.
+- Browser tools, off by default: `browser_tabs` (list, switch, open, close in Safari and Chromium
+  browsers), `browser_read` (the page's text through accessibility, in reading order, paged) and
+  `browser_eval_js` (approved per script, showing the page and the code). URLs and scripts are
+  embedded as escaped AppleScript strings; tabs matching `deny_windows` are hidden.
+- The `computer` tool and profile: screenshot-pixel computer use (clicks, drags, typing, keys with
+  xdotool-style names, scrolling, waiting, the cursor position) with the same policy hit-testing,
+  rate limit, input lock and kill switch as the other input tools.
+- The automation SDK: `from axpilot import Desktop` (blocking, thread-safe) or `AsyncDesktop`, with
+  typed results and element handles (`mac.find("Share").click()`), on the simulated desktop
+  (`Desktop.fake()`), in-process (`Desktop.direct()`) or through AXPilot.app
+  (`Desktop.connect()`). Scripts use the same tools, policy, confirmations, audit log and error
+  codes as agents.
+- Examples: five automation scripts that run against the simulated desktop, and agent examples
+  for thirteen frameworks (OpenAI Agents SDK, LangGraph, CrewAI, Google ADK, Pydantic AI,
+  LlamaIndex, smolagents, Microsoft Agent Framework, Claude Agent SDK, Agno, Strands Agents, Vercel AI
+  SDK, Mastra).
+- `select_option` (dropdowns, radio and tab groups, segmented controls, list rows by title or
+  index) and `handle_dialog` (read a sheet or dialog; accept, cancel or press a button;
+  buttons that delete or discard ask first, before `text` is typed into the dialog, so a "no"
+  changes nothing; in open and save panels, `path` goes to a folder or file with Go to the folder
+  first).
+- Menu bar extras: `select_menu` with `extras: true` lists and chooses status items (Wi‑Fi,
+  Battery, an app's icon; Control Center by default); a one-title path clicks the item. Menu
+  titles match across hyphen variants ("wi-fi" finds "Wi‑Fi").
+- Date pickers: `set_value` takes ISO 8601 dates and times (`"2026-10-20"`, `"2026-10-20 14:30"`,
+  `"14:30"` for a time field), sends them as dates and checks what the picker shows; snapshots
+  show `AXDateTimeArea` pickers as `date` and time fields as `time`, in local time.
+- Table column headers show how the table is sorted (`value` "ascending"/"descending"); color wells
+  get a clear `ELEMENT_NOT_ACTIONABLE` that points to the Colors panel; the Agent Skill covers
+  editing table cells and toolbar items hidden behind `»`.
+- Portable input schemas that OpenAI, Gemini and Anthropic function calling all accept (no `null`
+  unions or `$ref`s, `additionalProperties: false`, every parameter described), and an optional
+  tool-name prefix (`[tools] prefix = "mac_"`).
+- The tool reference ([docs/tools.md](docs/tools.md)) is generated from the tool registry
+  (`scripts/gen_tool_docs.py`), and golden files pin `tools/list` for every profile and naming.
+- The `windows-mcp` tool naming (`[tools] naming` or `--naming windows-mcp`): Windows-MCP's tool
+  names and parameter shapes (`Click(loc=[x, y])`, `Type(text, label=12)`, `Shortcut`, `App`,
+  `MultiSelect`, `Shell` for PowerShell, `Defaults` for Registry, …) on top of AXPilot's tools, so
+  Windows-MCP prompts and agents carry over to macOS.
+- The AXPilot host and the stdio bridge: MCP clients run `axpilot stdio`, which starts
+  `AXPilot.app` if needed and connects to the host's private Unix socket (`0600` in a `0700`
+  folder, same-user only). The host asks once per client app whether it may connect, remembers
+  the answer, gives each client its own profile and naming, and limits concurrent clients.
+  `axpilot stdio --direct` and `--engine fake` run the server in-process instead.
+- Streamable HTTP (`axpilot http`): loopback only by default, a bearer token stored privately,
+  `Host` and `Origin` checks and no CORS; other addresses need `--allow-remote` and TLS.
+- The `axpilot` command: `stdio`, `http`, `host`, `setup`, `update`, `uninstall`, `doctor`,
+  `connect`/`disconnect`, `config`, `skill install`, `tools`, `call`, `debug dump-tree` and
+  `version`, with documented exit codes, `--json` output, one-line errors and tracebacks only with
+  `--debug`. The Agent Skill ships inside the package.
+- Input helpers: key-combo parsing (`cmd+shift+t`, `⌘⇧T`, `Command-Shift-T`) and screenshot-to-screen
+  coordinate mapping.
+- Policy layer: profiles and toolsets, app and window deny-lists, the Terminal rule, secure-field
+  protection, confirmations, rate limiting, an audit log with argument redaction, and input
+  serialization with yield-to-user and pause.
+- Command-line integrations: a subprocess runner with timeouts, AppleScript/JXA, shell, Spotlight,
+  Shortcuts, `defaults`, processes, system information and browser tab scripting.
+- The frozen launcher source (`launcher/`), its build script and tests, and harnesses for
+  spikes S1–S6.
+- Documentation site skeleton, contributor guide, security policy, code of conduct, AGENTS.md,
+  issue and pull request templates, CI workflow, Dependabot and pre-commit configuration, the
+  Agent Skill (`skills/axpilot/SKILL.md`), MCP Registry metadata and the installer script
+  (`packaging/`).
+
+### Fixed
+
+- The pairing dialog, `status`, the pairing file and logs named Claude Code `claude` (the bundle
+  it runs in inside the Claude app), and command-line clients by their program (`codex`,
+  `gemini`). Known clients now show their readable name ("Claude Code", "Codex CLI", "Gemini
+  CLI"…); other names are unchanged, and pairing decisions stay keyed as before, so nobody is
+  asked again (#21).
+- `set_value` and `fill_form` refused a date field in a web page (`<input type="date">`):
+  browsers ignore an accessibility value there. AXPilot now focuses each part (month, day, year,
+  in the order the page shows them, whatever the language) and types it, then reads the parts
+  back. Only a date is typed; a value with a time is refused with a hint (#26).
+- `select_option` and `set_value` on TextEdit's font-size box (macOS 26) found no options: its list
+  holds text-field rows, which AXPilot did not count as options. They are read now, so the size is
+  picked from the list.
+- When a combo box's list opened but could not be read, AXPilot clicked the box's arrow next; on
+  macOS 26 the list can cover the box, so that click chose whatever option lay there (9 pt instead
+  of 24). AXPilot no longer clicks a combo box that reports its list open, and says so.
+- `set_value` with a size TextEdit's font-size box does not list (15) failed with "cannot take
+  keyboard focus": on macOS 26 that box refuses focus through accessibility. AXPilot now clicks its
+  text instead, then presses Return.
+- After a pick from TextEdit's font-size list, `select_option` warned that the list "may still be
+  open" and pressed Escape, which opened TextEdit's word-completion popup: macOS 26 keeps the closed
+  list's elements valid. The box's own expanded state now tells whether its list is open.
+- Web date fields still failed in Safari and Chrome (macOS 26): a part's digits went in as one key
+  event, and the browsers keep only its first character, so "03" set the month to 0 and "2026"
+  the year to 2. Each digit is now its own keystroke.
+- In Chrome, a web date field that took the date was then reported as failed: the parts read back
+  as numbers (2026.0), which AXPilot compared as 20260. They are read as numbers now.
+- `explore` listed the files of Finder's list view as sidebar sections: every outline's rows
+  counted. Only an outline named like a sidebar, or a narrow one along a window edge, is a sidebar
+  now; a wide one is the window's content and stays under scroll areas (#19).
+- AXPilot could switch on the full accessibility tree (`AXManualAccessibility`) of an Electron or
+  Chromium app the agent never targeted: after an action whose app quit, the report of whatever
+  app came forward (often the MCP client itself) did so, and a call without `app` could read an app
+  that came forward after the policy check. Reports of an untargeted app now read it as it is, and
+  a call without `app` stays on the frontmost app the policy checked (#23).
+- Clipboard reads and writes (the `clipboard` tool, and saving and restoring the clipboard around
+  a paste) ran on a worker thread, where macOS complains about apps fulfilling copied data
+  synchronously. They now run on the main thread, waiting at most 0.5 s for it, then as before on
+  the worker; work left waiting there is cancelled, so a late restore can never undo a newer copy
+  (#25).
+- When AXPilot.app crashed or was force-quit, the host it started kept running and held the
+  socket, with nothing left to restart it. A host started by AXPilot.app now notices within a
+  second that its launcher is gone and stops cleanly (#29).
+- `set_value` and `select_option` reported success on a native combo box such as TextEdit's font
+  size, but the text kept its size: setting a combo box's text only changes what it shows, and the
+  app acts on a pick from its list or on Return. Both tools now pick the value from the box's own
+  list (opened with its arrow), even when the box already shows it; `set_value` with text that is
+  not an option types it and presses Return, except in a dialog, where Return would press the
+  default button and a warning says so instead. `set_value` also works on Java and Qt combo boxes,
+  whose text cannot be set (#33).
+
+[Unreleased]: https://github.com/vansh3503/Mac-Mcp/compare/v0.1.0a1...HEAD
+[0.1.0a1]: https://github.com/vansh3503/Mac-Mcp/releases/tag/v0.1.0a1

axpilot-0.1.0a1/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.