mentiora-loom 0.9.8__tar.gz

mentiora_loom-0.9.8/.gitignore

@@ -0,0 +1,34 @@
+council/
+specs/
+target/
+.claude/
+.DS_Store
+*.swp
+.idea/
+.vscode/
+.envrc
+.env
+.env.local
+.env.dev.local
+
+# cargo-dist intermediates
+dist-manifest.json
+
+# Python SDK build artifacts (`python -m build`, used by publish-pypi.yml)
+python-sdk/dist/
+python-sdk/*.egg-info/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+
+# event-log substrate (loom is a public repo — keep internal infra config + any
+# telemetry/runtime artifacts OUT of git). Internal users configure the hosted
+# backend via a LOCAL .feature-workflow/event-log.yaml (ignored below); the
+# fallback queue can contain sensitive text and must never be committed.
+.feature-workflow/event-log.yaml
+.feature-workflow/event-log-fallback.jsonl
+.feature-workflow/event-log-fallback.jsonl.lock
+.feature-workflow/event-log.off
+.feature-workflow/events/
+.feature-workflow/backfill-checkpoint.json
+.feature-workflow/backfill-checkpoint.json.tmp

mentiora_loom-0.9.8/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: mentiora-loom
+Version: 0.9.8
+Summary: Python client library for the loom browser-automation daemon
+Project-URL: Homepage, https://github.com/mentiora-ai/loom
+Project-URL: Repository, https://github.com/mentiora-ai/loom
+Project-URL: Issues, https://github.com/mentiora-ai/loom/issues
+Author-email: Mentiora <hello@mentiora.ai>
+License: Apache-2.0
+Keywords: automation,browser,loom
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# loom (Python SDK)
+
+Python client library for the [loom](https://github.com/mentiora-ai/loom)
+browser-automation daemon.
+
+## Prerequisites
+
+The SDK talks to a running `loom-daemon` over a Unix socket. Install
+loom (CLI + daemon + chromium pin) first via Homebrew, `cargo install`,
+or the install script — see the
+[main README](https://github.com/mentiora-ai/loom#install). Then start
+the daemon:
+
+```bash
+loom serve
+```
+
+## Install
+
+```bash
+pip install mentiora-loom
+```
+
+The distribution is named `mentiora-loom`; it still imports as `loom`
+(`import loom`). Requires Python ≥ 3.11.
+
+## Quick start (sync)
+
+```python
+import loom
+
+with loom.Session.create() as session:
+    receipt = session.navigate("https://example.com")
+    print(receipt.action_hash)
+```
+
+## Quick start (async)
+
+```python
+import asyncio
+import loom
+
+async def main():
+    async with await loom.AsyncSession.create() as session:
+        receipt = await session.navigate("https://example.com")
+        print(receipt.action_hash)
+
+asyncio.run(main())
+```
+
+## What the SDK exposes
+
+- `Session` / `AsyncSession` — session lifecycle (create / close / abort
+  / kill / replay / inspect / validate / export).
+- `Session.{navigate, click, type_text, select, hover, scroll, wait,
+  evaluate, screenshot, snapshot}` — every web action surface.
+- Admin RPCs: `kill_session(session_id, ...)` (force-terminate without a
+  handle), `daemon_health(deep=...)` (operational snapshot).
+- Receipt + summary types in `loom.types` — `Receipt`, `SessionInfo`,
+  `SessionInspection`, `DiffReport`, `ExportInfo`, `ValidationResult`,
+  `GrantInfo`, `SchemaRegistry`, `LoomErrorCode`.
+- Typed errors: `LoomError`, `LoomRPCError`, `LoomConnectionError`,
+  `LoomTokenError`.
+
+## Cancellation (async only)
+
+`AsyncSession` supports transparent cancellation via standard asyncio
+primitives. Wrap a call in `asyncio.wait_for` or cancel its enclosing
+task and the SDK fires a `request.cancel` envelope at the daemon, then
+re-raises `asyncio.CancelledError` so `TaskGroup` / `asyncio.timeout`
+keep working:
+
+```python
+import asyncio
+import loom
+
+async with await loom.AsyncSession.create() as s:
+    try:
+        await asyncio.wait_for(s.navigate("https://example.com"), timeout=5.0)
+    except asyncio.TimeoutError:
+        # SDK already sent request.cancel before the timeout re-raised.
+        ...
+```
+
+Sync `Session` is single-in-flight by design — there is no cancellation
+hook. For cancellable work, reach for `AsyncSession`.
+
+## Connection details
+
+`Session.create()` defaults work when a single user runs the daemon on
+their own machine. Override per-call if needed:
+
+```python
+session = loom.Session.create(
+    socket_path="/var/run/loom/loom.sock",  # custom daemon socket
+    token="...",                             # explicit HELLO-token
+    profile="standard",                      # or "safe", "full"
+    network_mode="live",                     # or "replay"
+    seed=42,                                 # determinism seed
+)
+```
+
+## License
+
+Apache-2.0. See the [main repository](https://github.com/mentiora-ai/loom)
+for details.

mentiora_loom-0.9.8/README.md

@@ -0,0 +1,106 @@
+# loom (Python SDK)
+
+Python client library for the [loom](https://github.com/mentiora-ai/loom)
+browser-automation daemon.
+
+## Prerequisites
+
+The SDK talks to a running `loom-daemon` over a Unix socket. Install
+loom (CLI + daemon + chromium pin) first via Homebrew, `cargo install`,
+or the install script — see the
+[main README](https://github.com/mentiora-ai/loom#install). Then start
+the daemon:
+
+```bash
+loom serve
+```
+
+## Install
+
+```bash
+pip install mentiora-loom
+```
+
+The distribution is named `mentiora-loom`; it still imports as `loom`
+(`import loom`). Requires Python ≥ 3.11.
+
+## Quick start (sync)
+
+```python
+import loom
+
+with loom.Session.create() as session:
+    receipt = session.navigate("https://example.com")
+    print(receipt.action_hash)
+```
+
+## Quick start (async)
+
+```python
+import asyncio
+import loom
+
+async def main():
+    async with await loom.AsyncSession.create() as session:
+        receipt = await session.navigate("https://example.com")
+        print(receipt.action_hash)
+
+asyncio.run(main())
+```
+
+## What the SDK exposes
+
+- `Session` / `AsyncSession` — session lifecycle (create / close / abort
+  / kill / replay / inspect / validate / export).
+- `Session.{navigate, click, type_text, select, hover, scroll, wait,
+  evaluate, screenshot, snapshot}` — every web action surface.
+- Admin RPCs: `kill_session(session_id, ...)` (force-terminate without a
+  handle), `daemon_health(deep=...)` (operational snapshot).
+- Receipt + summary types in `loom.types` — `Receipt`, `SessionInfo`,
+  `SessionInspection`, `DiffReport`, `ExportInfo`, `ValidationResult`,
+  `GrantInfo`, `SchemaRegistry`, `LoomErrorCode`.
+- Typed errors: `LoomError`, `LoomRPCError`, `LoomConnectionError`,
+  `LoomTokenError`.
+
+## Cancellation (async only)
+
+`AsyncSession` supports transparent cancellation via standard asyncio
+primitives. Wrap a call in `asyncio.wait_for` or cancel its enclosing
+task and the SDK fires a `request.cancel` envelope at the daemon, then
+re-raises `asyncio.CancelledError` so `TaskGroup` / `asyncio.timeout`
+keep working:
+
+```python
+import asyncio
+import loom
+
+async with await loom.AsyncSession.create() as s:
+    try:
+        await asyncio.wait_for(s.navigate("https://example.com"), timeout=5.0)
+    except asyncio.TimeoutError:
+        # SDK already sent request.cancel before the timeout re-raised.
+        ...
+```
+
+Sync `Session` is single-in-flight by design — there is no cancellation
+hook. For cancellable work, reach for `AsyncSession`.
+
+## Connection details
+
+`Session.create()` defaults work when a single user runs the daemon on
+their own machine. Override per-call if needed:
+
+```python
+session = loom.Session.create(
+    socket_path="/var/run/loom/loom.sock",  # custom daemon socket
+    token="...",                             # explicit HELLO-token
+    profile="standard",                      # or "safe", "full"
+    network_mode="live",                     # or "replay"
+    seed=42,                                 # determinism seed
+)
+```
+
+## License
+
+Apache-2.0. See the [main repository](https://github.com/mentiora-ai/loom)
+for details.