nextloop 0.1.0rc1__py3-none-any.whl

nextloop-0.1.0rc1.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: nextloop
+Version: 0.1.0rc1
+Summary: An embeddable AgentLoop with explicit event, tool, recovery, and delivery semantics
+Author-email: 12bitsD <bis12@163.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/12bitsD/nextloop
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: jsonschema<5,>=4.23
+Provides-Extra: dev
+Requires-Dist: build<2,>=1.2; extra == "dev"
+Requires-Dist: mypy<2,>=1.13; extra == "dev"
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: pytest-asyncio<2,>=0.24; extra == "dev"
+Requires-Dist: ruff<1,>=0.8; extra == "dev"
+Requires-Dist: twine<7,>=5; extra == "dev"
+Requires-Dist: types-jsonschema<5,>=4.23; extra == "dev"
+Dynamic: license-file
+
+# nextloop
+
+A small, embeddable Python AgentLoop with explicit execution, recovery, and delivery semantics.
+
+Current version: **0.1.0rc1**.
+
+## Install
+
+```bash
+python -m pip install nextloop==0.1.0rc1
+```
+
+For local development:
+
+```bash
+uv venv --python 3.11 .venv
+uv pip install --python .venv/bin/python -e '.[dev]'
+```
+
+## What it provides
+
+- DSH-aligned Session/Turn/Step execution with 4D integer coordinates and writer fencing.
+- Append-only Trajectory and O(Δ) `surface_op` watermark projection.
+- In-memory `Inbox` serialization for steer and final commitment.
+- Whole-batch Tool Schema validation, bounded parallel calls, and exclusive failure barriers.
+- Closed five-variant `ToolOutcome`: `Completed`, `Skipped`, `Cancelled`, `UncertainSettled`, `UncertainHanging`.
+- Bounded Provider retries, protocol correction, WorkingContext, Compaction, and cancellation.
+- SQLite and in-memory EventStores, crash closers, and delivery-only recovery.
+- OpenAI-compatible and Anthropic streaming Provider adapters.
+
+It is a library, not an HTTP service, product bot, Router, EventBus, or multi-agent framework.
+
+## Public API
+
+```python
+AgentLoop.run(TurnContext) -> TurnOutcome
+AgentLoop.steer(session_id, content, *, input_id=None) -> bool
+AgentLoop.cancel(session_id, cause="user_stop") -> bool
+AgentLoop.recover(session_id, store, delivery) -> RecoveryOutcome
+```
+
+The only four Adapter protocols are `EventStore`, `ModelProvider`, `ToolRuntime`, and `DeliveryOwner`. Context projection and Compaction are built in and configured through `LoopConfig`.
+
+`ToolRegistry` is the built-in `ToolRuntime` implementation:
+
+```python
+from nextloop import ToolRegistry, ToolSpec, ToolExecutionMode
+
+registry = ToolRegistry()
+registry.register(
+    ToolSpec(
+        "read",
+        "Read a file",
+        {
+            "type": "object",
+            "properties": {"path": {"type": "string"}},
+            "required": ["path"],
+        },
+        mode=ToolExecutionMode.PARALLEL,
+    ),
+    lambda arguments, context: "file contents",
+)
+```
+
+Run the complete fake-Provider example:
+
+```bash
+python examples/basic.py
+```
+
+It executes model → Tool → Observation → model → delivery without a hosted model.
+
+## Code structure
+
+```text
+src/nextloop/
+  contracts.py       # public schemas, ToolOutcome, four Protocols, LoopConfig
+  loop.py            # AgentLoop and active Session registry
+  driver.py          # thin Turn/Step orchestration and SessionActor
+  events/            # pure projection, response/outcome folds, crash repair
+  execute/           # model retries, Tool registration, batch scheduling
+  adapters/          # SQLite, memory, OpenAI, Anthropic
+```
+
+`events/` performs no I/O. `execute/` owns side effects and classified failures. `driver.py` only composes them.
+
+## Verification
+
+The release-candidate checks cover:
+
+- text, Tool, multi-Step, mixed, empty, truncated, and malformed responses;
+- whole-batch rejection and parallel/exclusive scheduling with deterministic gates;
+- steer/final ordering, cancellation, WorkingContext, and Compaction;
+- protocol exhaustion, exact-byte retry, and partial-output failure;
+- resource-lock recovery, conflict prevention, and explicit release;
+- real subprocess exits during Tool execution and final delivery, followed by SQLite recovery;
+- recorded OpenAI and Anthropic SSE streams;
+- `ruff`, `mypy`, wheel/sdist builds, `twine check`, and clean wheel installation.
+
+Current limits:
+
+- Hosted-model smoke and nika integration are separate acceptance work.
+- Concurrent writers across multiple processes fail closed; they are not coordinated.
+- Large-asset lifecycle, backup, and GC are not part of this release candidate.
+
+## Documents
+
+- [AgentLoop design](docs/design/agent-loop.md)
+- [Public interface](docs/design/loop-interface.md)
+- [ReAct protocol](docs/design/react-protocol.md)
+- [Verification matrix](docs/design/verification-matrix.md)
+- [Development plan](docs/architecture/development-plan.md)
+- [Changelog](CHANGELOG.md)
+- [ADR-0002](docs/adr/0002-dsh-aligned-agent-loop.md) and [ADR-0003](docs/adr/0003-python-and-centralized-contracts.md)
+
+## Release
+
+CI covers Python 3.11, 3.12, and 3.13. A `v*` tag runs the release workflow, which verifies the package, publishes wheel and sdist to PyPI through Trusted Publishing, and creates a GitHub Release.
+
+This is a public repository. Do not commit credentials, private trajectories, internal endpoints, or personal data.

nextloop-0.1.0rc1.dist-info/RECORD

@@ -0,0 +1,25 @@
+nextloop/__init__.py,sha256=ay9yFORTWZyBJoG0RR4AGVbNLCgqSrQF5fdyXbTEsPs,1914
+nextloop/contracts.py,sha256=xAqLM9tb9ar_o4ZFa7Z5g0qIkvFagxxo4uw07CXSCkE,8928
+nextloop/driver.py,sha256=i3Gv6r4Qrmru5uBg_qA-22tNNUqryzuh3T-SvhLH45k,17591
+nextloop/loop.py,sha256=fNP91rboueHW7GXDicjps-dMkaFqhuxyq7U0OAE6qZU,6743
+nextloop/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nextloop/adapters/__init__.py,sha256=gF6fQXIuApctPG3bvPBetNf4LiFgp93VONzTA256xe8,245
+nextloop/adapters/_sse.py,sha256=ZDOOYnY1RJ-errBgs-ocJex-mg29ftaYixkf0acXsKQ,691
+nextloop/adapters/anthropic.py,sha256=L4UhLAOyRikKGlabZgJz79zZmQFLYkuYWvlOjU3KWNA,8496
+nextloop/adapters/memory.py,sha256=oBBfE86fkkALYCyAERCOP_LxLXDadqoDQDsOLtI37OQ,3559
+nextloop/adapters/openai.py,sha256=XH4F6nbHenKvHTPxwhB2LaMBxeZgyM_EvT65J5zTcyk,7022
+nextloop/adapters/sqlite.py,sha256=DXNi8zdpelMP6EdyCxfd4p-rVpdsJayo1YWgaUpgQYw,9810
+nextloop/events/__init__.py,sha256=Br2AHEBVTFT6Cfjd8B3hvUUEcbX75ijYtHYplA3L900,465
+nextloop/events/outcome.py,sha256=MlJR4IHC5nwirZ-idYwj1ML0LwxGgZx8vgjn8CGKTXo,6083
+nextloop/events/project.py,sha256=dEQiirHNXz5HusvDRcV-RZRe-KrpxDKyoQWtTxUx5vc,5542
+nextloop/events/repair.py,sha256=qjUs6kcRwdHFAXKQ8pVCZhhLooEOV7Dm5HqYD3cONn0,5214
+nextloop/events/response.py,sha256=tWE1fvh9e3mplfbgHCQNJzpxLw7PCMVHe_ueP0vwrmo,6699
+nextloop/execute/__init__.py,sha256=7qiWBjCJePVwOSYYSXrR9KBm8NXsiMU9T8riUjAnjQI,374
+nextloop/execute/batch.py,sha256=O6CS9Z4-rpWhUmukACOYVAxl9hSL4EpDBq-I0jn4XFc,5673
+nextloop/execute/model.py,sha256=Z2KaUkl0Jj1G1dy64o1JXnMuJ1W483_q3MZQFbV7oT0,4964
+nextloop/execute/tools.py,sha256=MRNhlvnC45AyERtgJZlwHtYgcMxiWUl54Is_uyzeUZE,5599
+nextloop-0.1.0rc1.dist-info/licenses/LICENSE,sha256=SC2YSuode-D_ZgS0Wv5P1_p_EmOvyc4Pm1Rsr2lrWzs,1064
+nextloop-0.1.0rc1.dist-info/METADATA,sha256=7zaNXJ1QdDg-3Yotbe1DlRH2CVU1fg-EWoRDyptD-mM,5517
+nextloop-0.1.0rc1.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+nextloop-0.1.0rc1.dist-info/top_level.txt,sha256=eIkI84Hci0_JzqLksxx2DUnwj2-7YHSsi1KgYswONeY,9
+nextloop-0.1.0rc1.dist-info/RECORD,,

nextloop-0.1.0rc1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

nextloop-0.1.0rc1.dist-info/licenses/LICENSE

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

nextloop-0.1.0rc1.dist-info/top_level.txt

@@ -0,0 +1 @@
+nextloop