Metadata-Version: 2.4
Name: power-loop
Version: 11.0.0
Summary: Embeddable agent execution kernel — LLM loop, hooks, events, tools, dynamic sub-agents.
Author-email: zhangran <zhangran24@126.com>
License: MIT
Project-URL: Homepage, https://github.com/PL-play/power-loop
Project-URL: Repository, https://github.com/PL-play/power-loop
Project-URL: Changelog, https://github.com/PL-play/power-loop/blob/main/CHANGELOG.md
Project-URL: Roadmap, https://github.com/PL-play/power-loop/blob/main/ROADMAP.md
Keywords: agent,llm,openai,anthropic,tool-use,hooks
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.42.0; extra == "anthropic"
Provides-Extra: openai
Requires-Dist: openai>=1.52.0; extra == "openai"
Provides-Extra: skills
Requires-Dist: pyyaml>=6.0; extra == "skills"
Provides-Extra: workflow
Requires-Dist: pyyaml>=6.0; extra == "workflow"
Provides-Extra: pdf
Requires-Dist: pypdf>=5.3.0; extra == "pdf"
Provides-Extra: images
Requires-Dist: Pillow>=10; extra == "images"
Provides-Extra: prometheus
Requires-Dist: prometheus-client>=0.19; extra == "prometheus"
Provides-Extra: statsd
Requires-Dist: statsd>=4.0; extra == "statsd"
Provides-Extra: otel
Requires-Dist: opentelemetry-sdk>=1.20; extra == "otel"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == "mcp"
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.29; extra == "postgres"
Provides-Extra: mysql
Requires-Dist: aiomysql>=0.2; extra == "mysql"
Provides-Extra: all
Requires-Dist: anthropic>=0.42.0; extra == "all"
Requires-Dist: openai>=1.52.0; extra == "all"
Requires-Dist: pyyaml>=6.0; extra == "all"
Requires-Dist: pypdf>=5.3.0; extra == "all"
Requires-Dist: Pillow>=10; extra == "all"
Requires-Dist: prometheus-client>=0.19; extra == "all"
Requires-Dist: statsd>=4.0; extra == "all"
Requires-Dist: opentelemetry-sdk>=1.20; extra == "all"
Requires-Dist: mcp>=1.0; extra == "all"
Requires-Dist: asyncpg>=0.29; extra == "all"
Requires-Dist: aiomysql>=0.2; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: hypothesis>=6.0.0; extra == "dev"
Requires-Dist: ruff>=0.6.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Requires-Dist: anthropic>=0.42.0; extra == "dev"
Requires-Dist: openai>=1.52.0; extra == "dev"
Requires-Dist: pyyaml>=6.0; extra == "dev"
Requires-Dist: pypdf>=5.3.0; extra == "dev"
Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
Requires-Dist: prometheus-client>=0.19; extra == "dev"
Requires-Dist: opentelemetry-sdk>=1.20; extra == "dev"
Requires-Dist: mcp>=1.0; extra == "dev"
Requires-Dist: asyncpg>=0.29; extra == "dev"
Requires-Dist: aiomysql>=0.2; extra == "dev"
Dynamic: license-file

# power-loop 11.0.0

An embeddable agent runtime. Main agents, children, background work and workflows
use one ID-addressed client/worker execution path. The default composition is
single-process, with no Redis dependency. Shared execution requires explicit
shared ownership and messaging adapters.

Current task schema: **15**. Protocol: **42**. Descriptor schema: **1**.
Use a fresh SDK database or table prefix; historical tasks are not imported.
This branch is a source delivery, not a published or deployed release. See the
P7 delivery report for the full regression status.

- [Current API and startup guide](docs/runtime-11.md)
- [Runnable single-process example](examples/design203_single_process.py)
- [Runnable default timers](examples/26_timers.py)
- [Changelog](CHANGELOG.md)
- [Authoritative stable exports](power_loop/__init__.py)
- [中文](README.zh.md)

Install the checkout with `python -m pip install -e '.[dev]'`. From an isolated
test directory, run `python /absolute/path/to/examples/design203_single_process.py`.
The demo uses a fixed model; a real deployment resolves models, tools, hooks and
resources in its registered `RuntimeFactory`.

`StatefulAgentLoop` accepts `runtime=`. Direct LLM/DSN construction is retired.
An acceptance receipt is not completion: wait for its original `InputRef`.
Normal authorization, accounting, context and cleanup remain required. Failures
may leave interrupted/unknown results; unknown external actions are not replayed.

Finite child waits use `WaitPolicy` and `register_wait_handoff_tool`: the factory
sets a deadline, the child releases capacity, and its original main explicitly
continues, defers or cancels the same task. Configure the timer backend/driver in
the Runtime; see [the contract and assembly](docs/runtime-11.md#finite-child-review).
