nexilume 0.47.0__tar.gz

nexilume-0.47.0/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+## 0.47.0 — 2026-10-01
+
+- Publish the SDK on PyPI as `nexilume`; Python imports remain `nexus_agent`
+  and CLI names, including `nexus-computer`, stay unchanged.
+- Update Runtime self-update, Windows service packaging and optional-dependency
+  installation guidance to use the public distribution name.
+- Use Nexus Community License 1.0 for this new release: multi-tenant service
+  operation and removal of supplied UI branding require written authorization.
+  Earlier Apache-2.0 releases and third-party licenses remain unchanged.
+- Add the prospective contributor agreement and licensing explanation to the
+  source distribution. Commercial contact: cary.nexilume@outlook.com.
+- When migrating from a previous GitHub wheel, uninstall `nexus-openwrt-agent-sdk`
+  before installing `nexilume`; do not install both distributions in the same
+  environment because they provide the same import package.
+
+## 0.46.5
+
+- Use a real POSIX PTY and an interactive shell for macOS/Linux Computer terminals, restoring the initial prompt, input echo, line editing and Ctrl+C.
+- Apply initial terminal dimensions and subsequent resize requests on both RPC and live-stream paths.
+- Drain final streamed output and release terminal resources when the shell exits or the stream closes. Windows retains its existing pipe transport.
+- Add real PTY regressions for prompts, zsh editing, resizing, interruption, stream output and process cleanup. Restart Runtime and open a new terminal after installing the updated SDK; existing pairings remain valid.
+
+## 0.46.4
+
+- Select zsh for automatic Computer Runtime terminals on macOS, with `/bin/zsh` as the fallback path. Explicit bash/sh choices remain unchanged.
+- Requires the accompanying Cloud update that forwards `auto` to Runtime instead of resolving it to sh on the server. Restart Runtime after upgrading and open a new terminal session.
+- Add shell-selection regressions and a real macOS zsh execution test.
+- Add a runnable two-Agent OpenWrt example with bidirectional calls and English README instructions.
+
+
+## 0.46.3
+
+- Include SOCKS proxy support in the `computer` extra.
+- Send an explicit Nexus Computer User-Agent on HTTP uploads, session requests and WebSocket connections.
+- Normalize browser Enter input for POSIX pipe-based terminals; preserve Windows input handling.
+- Keep the existing install-then-pair workflow and device configuration during upgrades.
+- Add macOS to the CI matrix and regression tests for headers and terminal input.
+
+Runtime fixes adapted from [Nexus Cloud Community PR #5](https://github.com/Nexilume-AI/nexus-cloud-community/pull/5), without its generated installer or site-packages patches.
+
+## 0.46.2
+
+- First standalone public distribution, named `nexus-openwrt-agent-sdk`.
+  Python imports remain `nexus_agent`; the unrelated PyPI package `nexus-agent-sdk`
+  is not this SDK. Install this release's wheel or source checkout.
+- Accept the transient Cloud state `unavailable` and continue bounded readiness polling
+  through `pending` to `ready`, including OpenWrt cold-boot recovery.
+- Include OpenWrt and hosted MCP examples, IPv6 helpers, optional Computer/Browser support,
+  standalone tests and package verification.
+- Update Windows service distribution lookup to the new public package name.
+
+Earlier versions were developed in the Nexus workspace. This repository starts with a
+clean source snapshot and does not include that workspace's history or server code.

nexilume-0.47.0/CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing
+
+Use GitHub Issues for reproducible bugs and feature requests, and pull requests for changes.
+Include the SDK version, Python version, OS, minimal reproduction, and expected behavior.
+Remove tokens, device identifiers, private addresses and user data from reports.
+
+Use Python 3.10+ to build from source:
+
+```sh
+python -m venv .venv
+. .venv/bin/activate
+# Windows: .venv\Scripts\Activate.ps1
+python -m pip install -e '.[computer,browser,fastmcp,a2a]' pytest build twine
+python -m pytest tests -q
+python -m build
+python -m twine check dist/*
+python scripts/verify_artifacts.py
+```
+
+Core tests run locally with mock services and loopback HTTP. Optional A2A/FastMCP tests
+require the respective extras. Hardware, Docker and separate Server integration tests
+report explicit skips when their prerequisites are absent. A core test pass is not
+acceptance of those integrations. Tests must not use production credentials or networks.
+
+Changes require explicit contributor agreement acceptance before merge. Keep dependencies optional where possible.
+
+For the two Server boot integration tests, explicitly set `NEXUS_SERVER_SOURCE` to a separate Server source checkout. Without it those tests skip.
+
+## Contribution licensing
+
+Nexus-authored changes are distributed under the Nexus Community License 1.0.
+Read [LICENSE](LICENSE), [LICENSING.md](LICENSING.md) and the
+[Nexus Contributor License Agreement](CONTRIBUTOR_LICENSE_AGREEMENT.md).
+Every contributing author must explicitly accept that agreement for their PR
+before merge; maintainers must record the acceptance as described there.
+Contributors retain copyright while permitting commercial use, dual licensing
+and future relicensing. Historical contributions and third-party code are not
+automatically subject to the new grant. Preserve all upstream notices.
+
+许可咨询：cary.nexilume@outlook.com。每位贡献者须对本 PR 明确同意贡献者协议；
+仅勾选模板或由维护者代为声明不构成其他作者的同意。

nexilume-0.47.0/CONTRIBUTOR_LICENSE_AGREEMENT.md

@@ -0,0 +1,64 @@
+# Nexus Contributor License Agreement — Version 1.0
+
+This agreement is between you, the contributor, and the Nexus project copyright
+owner operating through **cary.nexilume@outlook.com** (the Project). It applies
+only to contributions you intentionally submit for incorporation and explicitly
+identify when accepting this agreement. It is not a copyright assignment.
+
+## Rights granted
+
+You retain copyright. You grant the Project a perpetual, worldwide,
+non-exclusive, royalty-free, irrevocable copyright license to use, reproduce,
+modify, prepare derivative works, display, perform, distribute and sublicense
+your contribution, in source or object form. This includes commercial hosting,
+commercial distribution, proprietary and community editions, and sublicensing
+under different licenses, including more permissive or more restrictive terms
+for future releases. No further permission or payment is required for those uses.
+
+You also grant the Project and recipients of software incorporating your
+contribution a perpetual, worldwide, non-exclusive, royalty-free patent license
+to make, have made, use, sell, offer for sale, import and otherwise transfer the
+contribution. This grant covers only claims you can license that are necessarily
+infringed by your contribution alone or in combination with the work to which
+you submitted it. If a recipient initiates patent litigation alleging that your
+contribution or that work infringes a patent, that recipient's patent license
+under this agreement terminates as of filing.
+
+## Your representations
+
+You represent that you have authority to make these grants, including any
+required employer permission, and that your contribution is original or that
+you have clearly identified third-party material and its applicable licenses.
+Do not submit confidential material or code whose terms conflict with this
+grant. Separately identified third-party material is not relicensed by this
+agreement. Tell maintainers if you learn that a representation is inaccurate.
+
+Except for these representations, contributions are provided as-is, without
+warranties or an obligation to provide support. Nothing requires you to
+contribute future work or gives the Project ownership of unrelated work.
+
+## Existing rights and acceptance
+
+The Project may change licensing for future releases within these grants, but
+cannot withdraw licenses already granted to recipients of earlier releases.
+This agreement does not automatically apply to past contributions. A separate
+written agreement must be obtained where past rights are insufficient.
+
+For each pull request, every contributing author must post this statement from
+their own account, identifying the contribution covered:
+
+> I have read and agree to the Nexus Contributor License Agreement, Version 1.0,
+> for my contributions in this pull request. I have authority to grant these
+> rights, including any required employer permission, and have disclosed all
+> third-party material.
+
+Maintainers must verify all contributing authors' assent before merging and
+retain the PR/comment URL, agreement version, author identity and merged commit
+in the repository's contribution record. A checked template box, a bot response
+or a maintainer's assertion alone is not another author's assent. If the scope
+or authors change, obtain the additional assent before merging. A separately
+signed agreement identifying the contributions may be used instead. Do not
+publish private identity documents in issues or comments.
+
+The English text is authoritative. Questions and private agreements:
+**cary.nexilume@outlook.com**.

nexilume-0.47.0/LICENSE

@@ -0,0 +1,162 @@
+Nexus Community License, Version 1.0
+SPDX-License-Identifier: LicenseRef-Nexus-Community-1.0
+
+Licensor: the Nexus project copyright owner granting rights in this Work,
+contactable at cary.nexilume@outlook.com. This designation does not assert
+ownership of third-party code or of contributions without an appropriate grant.
+
+This is a source-available license, not the unmodified Apache License 2.0 and
+not an OSI-approved open-source license. The Apache License 2.0 text reproduced
+below is incorporated subject to the following additional conditions. These
+conditions prevail for the Nexus-authored Work where they differ from that text.
+
+1. Permitted use and multi-tenant operation
+
+Personal use, evaluation, modification, redistribution and single-tenant
+self-hosting, including commercial single-tenant use, are permitted subject to
+this license. Operating the Work or a derivative of the Work as a service or
+platform for two or more independent tenants requires prior, explicit written
+commercial authorization from the Licensor. This applies whether or not the
+operator charges users, and whether tenancy is implemented in one deployment
+or in separately deployed instances of the same offered service.
+
+A tenant is an independently administered workspace or organization with its
+own logically separated user access, data and configuration. Multiple users,
+projects or devices within one such tenant do not by themselves constitute
+multiple tenants. Giving the same service a different name does not avoid this
+condition. Merely distributing source code does not constitute operating it.
+
+Using the Nexus SDK, Mobile client, Computer Runtime or OpenWrt client solely
+to connect to a service does not make the client user its multi-tenant operator.
+The service operator remains responsible for authorization. An independent
+application that only uses public interfaces, and does not operate the Work or
+a derivative as a multi-tenant platform, is not restricted on that account.
+
+2. Product attribution and branding
+
+When operating or distributing a Nexus user interface or a derivative of it,
+retain the Nexus names, logos, copyright notices and attribution displayed by
+the supplied interface. Do not remove, replace, obscure or make them materially
+less visible without prior written authorization from the Licensor. Additional
+branding may be displayed without suggesting endorsement and without obscuring
+the retained attribution. Ordinary responsive or accessibility adjustments that
+preserve its meaning and visibility are permitted.
+
+This applies to Nexus web consoles, Nexus-authored LuCI pages, Mobile screens
+and other supplied graphical interfaces. It does not require an independent
+interface or a headless SDK/API integration to add a Nexus logo it never
+displayed. Source and redistribution notices must still be retained as required
+by this license. No general trademark license or endorsement is granted.
+
+3. Contributions and future licensing
+
+Contributions intended for incorporation must be covered by the separate Nexus
+Contributor License Agreement, Version 1.0, or an individually executed written
+agreement accepted by the Licensor. The contribution agreement provides the
+rights needed for commercial use, dual licensing and future releases under
+different, more permissive or more restrictive terms. Contributors retain
+ownership. Mere use of the software is not acceptance of a contributor grant.
+
+License changes apply to versions offered under the changed terms; they do not
+revoke rights already granted for an earlier version. Existing contributions
+are not deemed to have accepted a new contributor agreement retroactively.
+
+4. Scope, prior releases and third-party material
+
+These terms apply only to the Nexus-authored material made available under this
+license and contributions the Licensor is authorized to license this way.
+Separately identified third-party files and dependencies keep their licenses,
+including any Apache, MIT or GPL obligations. Do not remove their notices or
+apply these additional conditions to their independent licenses. A complete
+OpenWrt firmware image is not licensed solely under these terms. If applicable
+third-party obligations do not permit a proposed combination, obtain a compatible
+license or do not distribute that combination.
+
+Previously distributed Apache-2.0 versions remain available under the grants
+made with those versions; this license does not revoke or restrict those grants.
+Private Enterprise implementation is not granted by publishing this Work.
+
+5. Commercial exceptions and distribution
+
+Contact cary.nexilume@outlook.com for multi-tenant, branding or other commercial
+permissions. A separate written agreement must identify its covered parties,
+software and permitted use. A request for permission is not authorization.
+Redistributors must include this entire license, not only its Apache portion.
+The English text governs; translated explanations are informational.
+
+Incorporated Apache License 2.0 terms (unmodified text follows)
+============================================================
+
+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:
+
+You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+You must cause any modified files to carry prominent notices stating that You changed the files; and
+
+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
+
+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.

nexilume-0.47.0/LICENSING.md

@@ -0,0 +1,43 @@
+# Nexus licensing / Nexus 许可说明
+
+Current Nexus-authored releases carrying this notice use the **Nexus Community
+License 1.0** (`LicenseRef-Nexus-Community-1.0`); read [LICENSE](LICENSE) for the
+complete, authoritative English terms. This is **source-available**, not plain
+Apache-2.0 or OSI-approved open source.
+
+| Use | Community terms |
+| --- | --- |
+| Personal use, evaluation, single-tenant self-hosting | Permitted, including commercial single-tenant use |
+| Operating a service for multiple independent tenants | Prior written commercial authorization required, even if free |
+| Removing or replacing existing Nexus UI branding | Prior written authorization required |
+| Headless SDK integration or an independently built UI | No newly imposed logo display; preserve applicable notices |
+| Client connection to an authorized multi-tenant Cloud | Does not itself make the client user the service operator |
+| Future contribution to Nexus | Explicit contributor agreement before merge |
+
+**Licensing contact: [cary.nexilume@outlook.com](mailto:cary.nexilume@outlook.com).**
+The licensor is the Nexus copyright owner, not an invented corporate entity.
+Contributors retain copyright and grant the rights described in
+[CONTRIBUTOR_LICENSE_AGREEMENT.md](CONTRIBUTOR_LICENSE_AGREEMENT.md).
+
+Earlier versions distributed under Apache-2.0 retain those grants. This notice
+does not relicense upstream dependencies, OpenWrt/GPL components, or existing
+third-party contributions without authorization. Preserve their notices.
+Public documentation does not license private Enterprise implementation.
+Release dates and commits, not a retroactive calendar cutoff, identify which
+license accompanies a particular version. Existing published artifacts are not
+replaced under the same version number.
+
+## 中文说明（以英文许可证为准）
+
+- 个人使用、评估及单租户自托管允许，包括单租户商业使用。
+- 为多个独立租户运营服务，无论收费与否，都需要项目方事先书面商业授权。
+- 不得未经授权移除、替换、遮挡或显著弱化 Nexus 界面已有品牌和版权标识。
+  无界面的 SDK 集成不要求新增 Logo，但仍须保留许可证和版权声明。
+- 多个用户、Project 或设备不自动等于多个租户；租户定义见 LICENSE。
+- 贡献者保留版权，通过独立贡献者协议明确授权商业使用、双重许可和后续版本重新许可。
+  不能仅因更新贡献指南，就推定历史贡献者已经同意。
+- 历史 Apache-2.0 版本授权不撤回；第三方组件保持原许可证。
+- 本许可属于“源码可用”，不应继续宣传为纯 Apache-2.0 或 OSI 开源许可。
+
+咨询及授权邮箱：**cary.nexilume@outlook.com**。是否符合特定使用场景，应结合
+完整条款及依赖许可判断；发布者应在对外发布前完成必要的法律审核。

nexilume-0.47.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE LICENSING.md CONTRIBUTOR_LICENSE_AGREEMENT.md README.md CHANGELOG.md CONTRIBUTING.md SECURITY.md RELEASING.md
+include README_PYPI.md
+include install-linux.sh
+recursive-include examples *.py *.md *.txt Dockerfile
+recursive-include deploy *.example *.service *.sysusers *.ps1
+recursive-include tests *.py
+recursive-include scripts *.py
+global-exclude *.pyc

nexilume-0.47.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: nexilume
+Version: 0.47.0
+Summary: Python Agent SDK for Nexus OpenWrt and hosted MCP runtimes
+Author: Nexus OpenWrt Team
+License-Expression: LicenseRef-Nexus-Community-1.0
+Project-URL: Repository, https://github.com/Nexilume-AI/nexus-agent-sdk-python
+Project-URL: Issues, https://github.com/Nexilume-AI/nexus-agent-sdk-python/issues
+Project-URL: Changelog, https://github.com/Nexilume-AI/nexus-agent-sdk-python/blob/main/CHANGELOG.md
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: fastmcp
+Requires-Dist: fastmcp<4,>=3.0; extra == "fastmcp"
+Provides-Extra: fastmcp-tasks
+Requires-Dist: fastmcp<4,>=3.0; extra == "fastmcp-tasks"
+Requires-Dist: fastmcp-tasks<1,>=0.1; extra == "fastmcp-tasks"
+Provides-Extra: a2a
+Requires-Dist: a2a-sdk<2,>=1.1; extra == "a2a"
+Provides-Extra: windows
+Requires-Dist: pywin32>=306; platform_system == "Windows" and extra == "windows"
+Provides-Extra: browser
+Requires-Dist: playwright<2,>=1.50; extra == "browser"
+Provides-Extra: computer
+Requires-Dist: websockets<16,>=15; extra == "computer"
+Requires-Dist: cryptography<51,>=50.0.1; extra == "computer"
+Requires-Dist: python-socks[asyncio]<3,>=2.4.3; extra == "computer"
+Dynamic: license-file
+
+# nexilume — Nexus Python Agent SDK
+
+Build callable Agents and connect an authorized Computer to Nexus Cloud with
+the same Python SDK. Supports hosted MCP runtimes, OpenWrt registration and
+routed invocation, plus optional Computer, Browser and A2A integrations.
+
+## Install
+
+Use a virtual environment. The dependency-free core supports Python 3.9+;
+Python 3.12 is recommended for optional integrations.
+
+```sh
+python -m pip install nexilume==0.47.0
+python -m pip install "nexilume[fastmcp]==0.47.0"
+```
+
+The distribution name is **nexilume**, while the import name remains
+**nexus_agent**. The PyPI project named `nexus-agent-sdk` is unrelated.
+
+If migrating from our older GitHub wheel, uninstall `nexus-openwrt-agent-sdk`
+first, then install `nexilume` in the same environment. Do not install both:
+they contain the same import namespace. Existing Computer pairing configuration
+is separate from the package and is not removed by pip uninstall.
+
+## A hosted MCP Agent
+
+```python
+from nexus_agent import NexusAgent
+
+agent = NexusAgent(runtime="hosted", cloud_name="Echo Agent")
+
+@agent.capability("demo.echo")
+def echo(payload):
+    return {"echo": payload}
+
+if __name__ == "__main__":
+    agent.run()
+```
+
+Install the `fastmcp` extra to run this example. Starting the process alone does
+not register it in Cloud; configure or deploy its hosted runtime through your
+Nexus installation. OpenWrt LAN registration is a separate supported mode.
+
+## Computer Runtime
+
+```sh
+python -m pip install "nexilume[computer,browser]==0.47.0"
+nexus-computer setup "<pairing-url-from-your-cloud>"
+nexus-computer status
+```
+
+Run as your ordinary OS user. Wait until connected, then attach and authorize
+the Computer in Cloud. No inbound SSH port is needed. Browser control requires
+a compatible local Chromium browser and the `browser` extra. Never share
+pairing links, device keys or tokens.
+
+## Optional integrations
+
+| Extra | Purpose |
+| --- | --- |
+| `fastmcp` | Hosted MCP tools |
+| `fastmcp-tasks` | MCP task integration |
+| `computer` | Outbound Computer Runtime |
+| `browser` | Browser automation integration |
+| `a2a` | Agent-to-Agent integration |
+| `windows` | Windows service helpers |
+
+## Documentation and support
+
+- [Repository and bilingual guides](https://github.com/Nexilume-AI/nexus-agent-sdk-python)
+- [Examples](https://github.com/Nexilume-AI/nexus-agent-sdk-python/tree/main/examples)
+- [Issue tracker](https://github.com/Nexilume-AI/nexus-agent-sdk-python/issues)
+- [Detailed guide](https://github.com/Nexilume-AI/nexus-agent-sdk-python/blob/main/README_GUIDE.md)
+
+## License
+
+Version 0.47.0 uses **Nexus Community License 1.0**
+(`LicenseRef-Nexus-Community-1.0`), a source-available license, not unmodified
+Apache-2.0 or an OSI-approved open-source license. The complete LICENSE is
+bundled in the wheel and source distribution.
+
+Personal and single-tenant self-hosted use, including commercial single-tenant
+use, is allowed under the license. Operating a multi-tenant service or removing
+supplied Nexus UI branding requires prior written authorization. Headless SDK
+integration does not require adding a new logo. Earlier Apache-2.0 grants and
+third-party licenses remain unchanged. New contributions require the explicit
+contributor agreement included in the source distribution.
+
+Commercial licensing: **cary.nexilume@outlook.com**.

nexilume-0.47.0/README.md

@@ -0,0 +1,151 @@
+<div align="center">
+
+# Nexus Agent SDK for Python
+
+**Write Python. Publish capabilities. Connect devices.**
+
+[![License: Nexus Community](https://img.shields.io/badge/License-Nexus_Community-17251d.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/Read-the_docs-b8ef73.svg)](README_GUIDE.md)
+[![Cite this software](https://img.shields.io/badge/Cite-this_software-e8e9e4.svg)](#citation)
+[![Repository checks](https://github.com/Nexilume-AI/nexus-agent-sdk-python/actions/workflows/ci.yml/badge.svg)](https://github.com/Nexilume-AI/nexus-agent-sdk-python/actions/workflows/ci.yml)
+
+`Python` · `MCP` · `Computer Runtime`
+
+**English** · [简体中文](README_zh.md)
+
+[Highlights](#highlights) · [Quick start](#quick-start) · [Documentation](#documentation) · [Ecosystem](#ecosystem) · [Contributing](#contributing) · [Citation](#citation)
+
+</div>
+
+Build callable Agents, expose MCP tools, register through OpenWrt, and connect an authorized Computer Runtime to Nexus Cloud.
+
+![Nexus Agent SDK for Python: illustrated workflow](docs/media/overview.svg)
+
+*Workflow illustration, not a product screenshot. Connections require the setup and authorization described below.*
+
+## From Python to a private Run
+
+**Enterprise UI, October 1, 2026.** This real Docker-hosted SDK example uses
+`NexusMCPServer`, `plan`, `chat.ask()` and private file upload. It is deterministic,
+uses no paid model and does not access a personal device.
+
+![A real SDK Agent asks an inline question in Private Display](docs/media/enterprise-inline-question.jpg)
+
+<details>
+<summary>View the generated Markdown file</summary>
+
+![The SDK-generated checklist in the Run Files preview](docs/media/enterprise-file-preview.jpg)
+
+</details>
+
+[Reproduce the capture](docs/media/capture-notes.md). Cloud UI is a separate
+installation; these Enterprise screenshots do not expand the Community feature set.
+
+## Highlights
+
+| Build | Use | Start here |
+| --- | --- | --- |
+| **A callable Python Agent** | Dependency-free core; local HTTP serving | [Local round trip](README_GUIDE.md#run-your-first-agent) |
+| **An MCP tool server** | Hosted mode with the optional FastMCP integration | [Hosted runtime](README_GUIDE.md#use-a-hosted-mcp-runtime) |
+| **Distributed capabilities** | Registration, renewal and routed calls through OpenWrt | [Two-Agent walkthrough](README_GUIDE.md#example-two-distributed-agents-calling-each-other) |
+| **An Attached Computer** | Outbound WSS for authorized files, terminal and browser operations | [Computer setup](README_GUIDE.md#set-up-computer-runtime) |
+
+## Quick start
+
+Use Python **3.12** for the optional integrations. Core runtime supports Python 3.9+; building from source needs 3.10+. Start in a virtual environment:
+
+```sh
+python -m venv .venv
+```
+
+Activate with `source .venv/bin/activate` on bash/zsh, or `.venv\Scripts\Activate.ps1` in Windows PowerShell. Then:
+
+```sh
+python -m pip install "nexilume[fastmcp]==0.47.0"
+```
+
+Save this as `echo_agent.py`:
+
+```python
+from nexus_agent import NexusAgent
+
+agent = NexusAgent(runtime="hosted", cloud_name="Echo Agent")
+
+@agent.capability("demo.echo")
+def echo(payload):
+    return {"echo": payload}
+
+if __name__ == "__main__":
+    agent.run()
+```
+
+Run `python echo_agent.py` to start hosted mode. Use the [hosted guide](README_GUIDE.md#use-a-hosted-mcp-runtime) to connect/deploy it; running the process alone does not register it in Cloud. For a complete local HTTP request and expected response, use the [local round-trip tutorial](README_GUIDE.md#run-your-first-agent).
+
+> [!IMPORTANT]
+> The PyPI distribution is **nexilume**, imported as **nexus_agent**. The unrelated PyPI package `nexus-agent-sdk` is not this SDK. When migrating from an older GitHub wheel, uninstall `nexus-openwrt-agent-sdk` first in the same environment; these distributions share an import namespace.
+
+## Connect your computer
+
+Install the `computer,browser` extras and a compatible browser, then create a pairing link in your own Cloud installation:
+
+```sh
+python -m pip install "nexilume[computer,browser]==0.47.0"
+nexus-computer setup "<pairing-url-from-your-cloud>"
+nexus-computer status
+```
+
+Run as your normal OS user. Wait for `connected`, then attach and authorize the device in Cloud. No inbound SSH port is needed. Do not publish pairing URLs, tokens or device keys.
+
+## Documentation
+
+| Goal | Guide or example |
+| --- | --- |
+| Install wheels and choose extras | [Installation](README_GUIDE.md#install) |
+| Register and invoke through OpenWrt | [Router walkthrough](README_GUIDE.md#connect-to-openwrt) |
+| Run the same application in Cloud or on the edge | [Dual runtime example](examples/dual_runtime_agent.py) |
+| Browser, streaming, files and A2A examples | [Example directory](README_GUIDE.md#explore-the-examples) |
+| Upgrade Computer Runtime without re-pairing | [Upgrade guide](README_GUIDE.md#upgrade-an-existing-computer-runtime) |
+| Linux IPv6 and platform acceptance limits | [IPv6](README_GUIDE.md#configure-agent-ipv6-on-linux) · [Validation scope](README_GUIDE.md#linux-validation) |
+| Diagnose common errors | [Troubleshooting](README_GUIDE.md#troubleshooting) |
+| Follow changes | [Changelog](CHANGELOG.md) |
+
+Windows/Linux/macOS behavior depends on the selected extra, OS and installed browser. Existing platform tests are not equivalent to full device acceptance on every platform; see the validation scope.
+
+## Ecosystem
+
+| Project | Role | Install separately? |
+| --- | --- | --- |
+| [Cloud Community](https://github.com/Nexilume-AI/nexus-cloud-community) | Server, Web Console and bundled Cloud Relay | Main workspace |
+| [Python SDK](https://github.com/Nexilume-AI/nexus-agent-sdk-python) | Agent applications and outbound Computer Runtime | Yes |
+| [OpenWrt](https://github.com/Nexilume-AI/nexus-openwrt) | Edge registration and capability routing | Optional |
+| [Mobile](https://github.com/Nexilume-AI/nexus-mobile) | Authorized Android device integration | Optional |
+| [Documentation](https://github.com/Nexilume-AI/nexus-docs) | User guides and reference | Read online or build locally |
+
+Repository access, release availability and compatibility determine which integrations you can install. Cloud installation does not install device runtimes.
+
+## Contributing
+
+Start with [CONTRIBUTING.md](CONTRIBUTING.md). Small reproducible fixes, clearer tutorials, translations and sanitized examples are welcome. Use [Issues](https://github.com/Nexilume-AI/nexus-agent-sdk-python/issues) for reproducible bugs; include versions and redacted diagnostics, never credentials or private files.
+
+Follow [SECURITY.md](SECURITY.md) for security reports. Release checks and CI are not a guarantee of production readiness on every platform.
+
+## Citation
+
+If this software helps your work, cite the repository and record the exact release or commit you used. [CITATION.cff](CITATION.cff) provides machine-readable software metadata; this is a **software citation**, not a claim of a peer-reviewed paper or DOI.
+
+```bibtex
+@misc{nexus_agent_sdk_python,
+  author       = {{Nexus contributors}},
+  title        = {Nexus Agent SDK for Python},
+  howpublished = {\url{https://github.com/Nexilume-AI/nexus-agent-sdk-python}},
+  note         = {Software; specify the release or commit used}
+}
+```
+
+## License
+
+Nexus-authored source is distributed under [Nexus Community License 1.0](LICENSE). Third-party components retain their own licenses and notices. Documentation does not grant rights to separately distributed Enterprise implementation.
+
+### Licensing conditions / 许可条件
+
+Source-available, not unmodified Apache-2.0 or OSI-approved open source. Multi-tenant service operation and removal of existing Nexus UI branding require prior written authorization. Earlier Apache-2.0 grants and third-party licenses remain unchanged. Contributions require explicit agreement permitting commercial use and future relicensing. 许可说明：[LICENSING.md](LICENSING.md)。授权联系：**cary.nexilume@outlook.com**。