node-mantis 0.1.0a10__py3-none-macosx_11_0_arm64.whl

node_mantis-0.1.0a10.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: node-mantis
+Version: 0.1.0a10
+Summary: NodeMantis Python configuration, browser setup, and installation validation tools
+Author: NodeMantis
+License-Expression: LicenseRef-NodeMantis-Proprietary
+Project-URL: Homepage, https://github.com/Node-Mantis/CleanSlate#readme
+Project-URL: Repository, https://github.com/Node-Mantis/CleanSlate
+Project-URL: Issues, https://github.com/Node-Mantis/CleanSlate/issues
+Keywords: browser,automation,playwright,node-mantis,nodemantis
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Provides-Extra: browser
+Requires-Dist: playwright>=1.59.1; extra == "browser"
+Dynamic: license-file
+
+# NodeMantis Python
+
+The NodeMantis Python SDK: browser-driving agent sessions at parity with the
+npm `node-mantis` package, plus configuration, browser setup, and installation
+validation tools.
+
+Platform wheels bundle the same compiled native runtime the npm SDK uses; the
+Python layer is a thin client that spawns it and forwards requests. Browser
+sessions additionally need Playwright for Python (the `[browser]` extra) — the
+runtime launches and drives a real Google Chrome through it.
+
+Customer install:
+
+```bash
+pip install "node-mantis[browser]"
+python -m nodemantis configure --api-key "$NODEMANTIS_API_KEY"
+python -m nodemantis install-browser --browser chrome
+python -m nodemantis smoke
+```
+
+Run a browser goal:
+
+```python
+from nodemantis import NodeMantis
+
+with NodeMantis.start(start_url="https://example.com", headless=True) as mantis:
+    result = mantis.run("Open the More information link.", max_iterations=5)
+    print(result.ok, result.reason)
+```
+
+The session surface mirrors the TypeScript SDK: `NodeMantis.start()` /
+`NodeMantis.preflight()`, and per-session `go`, `run`, `step`, `retrieve`,
+`extract`, `check`, `close` (sessions are context managers). Options are
+snake_case (`max_iterations`, `screenshot_enabled`, `result_schema`,
+`allow_navigation`, …); `model` selects a size tier (`"small"`, `"standard"`,
+`"large"`). `run`/`step` accept an `on_progress` callback for per-iteration
+narration; callbacks arrive on a background thread and must not call session
+methods. `retrieve` returns a discriminated result (`status` of `success`,
+`not_found`, or `error`, with `data`, `contributor_ids`, `warnings`, `tokens`,
+`final_url`). Schemas are plain JSON Schema dicts (pydantic v2 model classes
+are also accepted). `attach()` and `context_options` are TypeScript-only.
+
+API keys resolve from the `api_key` argument, then `NODEMANTIS_API_KEY`,
+`NODEMANTIS_AUTH_TOKEN`, and finally the `nodemantis configure` config file.
+The package always connects to the hosted Node Mantis API; the service
+endpoint is not customer-configurable.
+
+`node-mantis[browser]` installs Playwright for browser sessions, checks, and
+smoke tests. Browser binaries are installed separately; run
+`python -m nodemantis install-browser --browser chrome` for Google Chrome or
+use `--browser chromium` for Playwright Chromium.
+
+Installing the wheel also puts a `nodemantis` command on `PATH` (equivalent to
+`python -m nodemantis`); `pipx install node-mantis` gives the same command in
+an isolated environment. This CLI covers setup verbs only — `configure`,
+`doctor`, `install-browser`, `smoke`. Command-line task execution
+(`nodemantis run`, `nodemantis retrieve`) ships with the npm package:
+`npm install -g node-mantis`. If both are installed, whichever is first on
+`PATH` wins; the setup verbs behave identically.
+
+Validate API access, credentials, and the selected browser from Python:
+
+```python
+from nodemantis import preflight
+
+report = preflight(check_browser_launch=True, timeout_seconds=5)
+if not report.ok:
+    raise RuntimeError(report.checks)
+```
+
+Supported alpha platforms: Linux x64, Windows x64, macOS x64, and macOS arm64.
+Wheels without a bundled runtime (source-free builds) raise
+`RUNTIME_NOT_INSTALLED` when starting a session; advanced setups can point
+`NODEMANTIS_RUNTIME_PATH` at a runtime executable.
+
+This package is proprietary alpha software. Use is governed by `LICENSE.txt`
+and applicable NodeMantis terms.

node_mantis-0.1.0a10.dist-info/RECORD

@@ -0,0 +1,30 @@
+node_mantis-0.1.0a10.dist-info/licenses/LICENSE.txt,sha256=GhWAtDo-CX1aQUTGoqDnWM8Jc0cP8uJjPNPi9cgoR3I,902
+nodemantis/__init__.py,sha256=J7urZT0tLUBj5-oe5NTpA8X3iHua6DJxnJrvkFmMzHI,1652
+nodemantis/__main__.py,sha256=MHKZ_ae3fSLGTLUUMOx15fWdeOnJSHhq-zslRP5F5Lc,79
+nodemantis/_bridge.py,sha256=7Oov0gh6gVbRUFJVHJxuMP-BgVXhR7HbQVTYianAk34,30585
+nodemantis/_constants.py,sha256=zK-cBJ0GApszOqpw_a4CU1YEzgry2pysHq-b_xx7yqE,50
+nodemantis/_framing.py,sha256=7kbPDiTY6UrFCoisACbsaTtCS9ZcbMot5k4gHn0Wj4M,4541
+nodemantis/_host.py,sha256=3SpIjAIvYIZ_sTkmfijsZ8NkbrO-GzYneTsoEbcPLNE,4807
+nodemantis/_process.py,sha256=4an13j9cDc_E4SXvIyWrI15cBs36NqP_TZIpJsdUETY,17594
+nodemantis/_protocol.py,sha256=SIJKLaEBqkv1FDZZ_3K3pg58aPTE6BT40sNOqdxlfBQ,3435
+nodemantis/_rpc.py,sha256=ggeAEdtz2cUb7w1yVjH9dxOImmtjAHcjTZ9j9PgqILc,20218
+nodemantis/browser.py,sha256=3-BcvgQlD1-9l0dkQ9O_JOxInhT7NKqfUhZ-A4ijFoQ,2416
+nodemantis/cli.py,sha256=vo6zvka9oF-HkQrSE2Gk89fhqdTcPrX7RhhkthTfaFM,5105
+nodemantis/config.py,sha256=pgrWoSCJcgY_cWInRJjFmH_S6t3muQI10TI2OPPfV4c,3453
+nodemantis/errors.py,sha256=-0Tx-nwaxH7soShLMGYuO_U3l9YNSwCL7TPRMHb75Ks,3057
+nodemantis/preflight.py,sha256=8LggeOB6m7sq5_3TPwzFYVvvCj4O2W_Xkw-DBI_xAuU,4205
+nodemantis/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+nodemantis/runtime.py,sha256=zaHDIilBwQjcRUOaMtGEX-LNZ-YycZiijkPsxgDlq0o,2132
+nodemantis/runtime_broker.py,sha256=PvTCoQnPKDzryopnsp5tHxPuziH-UiLmqy773Q98xMU,564
+nodemantis/session.py,sha256=kp-ZQSj3EPgzVhub2gPCQQ2E4jl0haga0x8HcN7qRKA,19935
+nodemantis/smoke.py,sha256=IYnaMeBpnKStmnDqUQBurieUPE77BF484OP9rVdwZV4,4718
+nodemantis/types.py,sha256=zF_rgq25rHLX8aaXmQiw3OVCdLsyPfJ51s85pIDyUxk,9049
+nodemantis/_runtime_bin/README.md,sha256=CJqRBCTQEkZTnNUS37gYi2RRK3ebYcxEODAfS2wfF-k,423
+nodemantis/_runtime_bin/nodemantis-runtime,sha256=l0uhTb6ElLQmqHa1NzwhOJSy4lJ661X4jHID7wg_JGA,4661664
+nodemantis/_runtime_bin/runtime-manifest.json,sha256=dxV6ebHF1fBQocIz1lXhVYskjkVESNcccIUOd3NyydM,279
+nodemantis/fixtures/smoke.html,sha256=HlkvOyT-yfkelFQzUZz2-j1MDWHdeM7PqOSMiL-TVQY,668
+node_mantis-0.1.0a10.dist-info/METADATA,sha256=Vkjr2sZmiA1hB3WbIPbzNUhdGPZzjQPDORUY65bWDOA,4448
+node_mantis-0.1.0a10.dist-info/WHEEL,sha256=ZXH3vDMl8AFCSH5yRAEZvhxcAfU_WRPmBH7oy36RDKI,106
+node_mantis-0.1.0a10.dist-info/entry_points.txt,sha256=iB3hkGF-CFZaPeeUadgxrljZqJV2FRCIClWIJGEK-hg,51
+node_mantis-0.1.0a10.dist-info/top_level.txt,sha256=9kaSA3eSBIApvJUTG4Ni6h42DcfJebMhccQj_tS9Bu4,11
+node_mantis-0.1.0a10.dist-info/RECORD,,

node_mantis-0.1.0a10.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: false
+Tag: py3-none-macosx_11_0_arm64
+

node_mantis-0.1.0a10.dist-info/entry_points.txt

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

node_mantis-0.1.0a10.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,18 @@
+NodeMantis Alpha Proprietary License
+
+Copyright (c) NodeMantis. All rights reserved.
+
+This alpha package is proprietary software. You may install and use it only to
+evaluate or access NodeMantis services under an active NodeMantis account,
+agreement, or written authorization from NodeMantis.
+
+You may not copy, redistribute, sublicense, sell, rent, lease, host for third
+parties, or provide this software as a managed service without prior written
+permission from NodeMantis. You may not reverse engineer, decompile, disassemble,
+or attempt to derive source code from this software except to the extent that
+applicable law prohibits this restriction.
+
+This alpha software is provided "as is" without warranties of any kind. It may
+change, break compatibility, or be withdrawn at any time. To the maximum extent
+permitted by law, NodeMantis is not liable for damages arising from use of this
+software.

node_mantis-0.1.0a10.dist-info/top_level.txt

@@ -0,0 +1 @@
+nodemantis

nodemantis/__init__.py

@@ -0,0 +1,64 @@
+"""NodeMantis Python SDK: browser-driving sessions plus install/smoke helpers."""
+
+from .config import ResolvedConfig, resolve_config
+from .errors import (
+    NativeRuntimeExitedError,
+    NativeRuntimeHandshakeError,
+    NativeRuntimeResolutionError,
+    NativeRuntimeTerminationError,
+    NavigationOnlyError,
+    NodeMantisError,
+    RuntimeConnectionClosedError,
+    RuntimeRpcError,
+    SessionClosedError,
+)
+from .preflight import PreflightCheck, PreflightResult, preflight
+from .runtime import UnsupportedPlatformError, runtime_platform_info
+from .session import NodeMantis
+from .smoke import SmokeResult, run_smoke
+from .types import (
+    AgentOperationResult,
+    AgentProgressEvent,
+    AgentRetrieveResult,
+    BrowserGoResult,
+    MockLLMOptions,
+    MockLLMResponse,
+    MockLLMRule,
+    RetrievalPartialData,
+    RetrievalPartialRecord,
+    TokenUsage,
+)
+
+__all__ = [
+    "AgentOperationResult",
+    "AgentProgressEvent",
+    "AgentRetrieveResult",
+    "BrowserGoResult",
+    "MockLLMOptions",
+    "MockLLMResponse",
+    "MockLLMRule",
+    "NativeRuntimeExitedError",
+    "NativeRuntimeHandshakeError",
+    "NativeRuntimeResolutionError",
+    "NativeRuntimeTerminationError",
+    "NavigationOnlyError",
+    "NodeMantis",
+    "NodeMantisError",
+    "PreflightCheck",
+    "PreflightResult",
+    "ResolvedConfig",
+    "RetrievalPartialData",
+    "RetrievalPartialRecord",
+    "RuntimeConnectionClosedError",
+    "RuntimeRpcError",
+    "SessionClosedError",
+    "SmokeResult",
+    "TokenUsage",
+    "UnsupportedPlatformError",
+    "preflight",
+    "resolve_config",
+    "run_smoke",
+    "runtime_platform_info",
+]
+
+__version__ = "0.1.0a10"

nodemantis/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())