power-loop 0.7.0__tar.gz → 0.7.2__tar.gz

{power_loop-0.7.0 → power_loop-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: power-loop
-Version: 0.7.0
+Version: 0.7.2
 Summary: Embeddable agent execution kernel — LLM loop, hooks, events, tools, dynamic sub-agents.
 Author-email: zhangran <zhangran24@126.com>
 License: MIT
@@ -125,6 +125,37 @@ See [Getting Started](docs/en/getting-started.md) for the complete first run.
 | Pluggable cross-session memory | [Memory](docs/en/user-guide/memory.md) |
 | Provider configuration | [Providers](docs/en/user-guide/providers.md) |
 
+### Per-call overrides
+
+Build one loop and reuse it across callers; restrict tools or swap the system
+prompt **per `send`** without rebuilding (the model only *sees* the allowed
+tools). Ideal for multi-tenant hosts.
+
+```python
+# loop registered with all tools; this run exposes only "get_weather"
+await loop.send("…", session_id=sid, tools=["get_weather"])
+
+# per-run system prompt override (precedence: per-call > session > config)
+await loop.send("…", session_id=sid, system_prompt="You are a terse bot.")
+```
+
+The same overrides are available on `send_sync()`. When `follow_up()` is idle
+and falls back to a new send, it accepts them too. A follow-up queued into an
+already running call keeps that call's active tool and prompt policy.
+
+For a multi-tenant host that reuses one registry across workspaces, build an
+**unbound** registry and supply the workspace at invocation time:
+
+```python
+from power_loop import RuntimeEnv, create_default_tool_registry, runtime_env_context
+
+registry = create_default_tool_registry(preset="core", bind=False)
+with runtime_env_context(RuntimeEnv(workspace_dir=tenant_workspace)):
+    result = await registry.invoke_async("read_file", {"path": "README.md"})
+```
+
+See [`examples/23_per_send_overrides.py`](examples/23_per_send_overrides.py).
+
 ## Public API
 
 Stable imports are re-exported from `power_loop`:

{power_loop-0.7.0 → power_loop-0.7.2}/README.md

@@ -88,6 +88,37 @@ See [Getting Started](docs/en/getting-started.md) for the complete first run.
 | Pluggable cross-session memory | [Memory](docs/en/user-guide/memory.md) |
 | Provider configuration | [Providers](docs/en/user-guide/providers.md) |
 
+### Per-call overrides
+
+Build one loop and reuse it across callers; restrict tools or swap the system
+prompt **per `send`** without rebuilding (the model only *sees* the allowed
+tools). Ideal for multi-tenant hosts.
+
+```python
+# loop registered with all tools; this run exposes only "get_weather"
+await loop.send("…", session_id=sid, tools=["get_weather"])
+
+# per-run system prompt override (precedence: per-call > session > config)
+await loop.send("…", session_id=sid, system_prompt="You are a terse bot.")
+```
+
+The same overrides are available on `send_sync()`. When `follow_up()` is idle
+and falls back to a new send, it accepts them too. A follow-up queued into an
+already running call keeps that call's active tool and prompt policy.
+
+For a multi-tenant host that reuses one registry across workspaces, build an
+**unbound** registry and supply the workspace at invocation time:
+
+```python
+from power_loop import RuntimeEnv, create_default_tool_registry, runtime_env_context
+
+registry = create_default_tool_registry(preset="core", bind=False)
+with runtime_env_context(RuntimeEnv(workspace_dir=tenant_workspace)):
+    result = await registry.invoke_async("read_file", {"path": "README.md"})
+```
+
+See [`examples/23_per_send_overrides.py`](examples/23_per_send_overrides.py).
+
 ## Public API
 
 Stable imports are re-exported from `power_loop`:

{power_loop-0.7.0 → power_loop-0.7.2}/power_loop/__init__.py

@@ -22,7 +22,7 @@ Stability tiers
 无版本承诺，可随时变更或删除。
 """
 
-__version__ = "0.7.0"
+__version__ = "0.7.2"
 
 from power_loop.agent.follow_up import FollowUpQueued
 from power_loop.agent.sink import MessageSink, NullSink, SQLiteSink
@@ -116,7 +116,7 @@ from power_loop.core.pipeline import AgentPipeline
 from power_loop.core.runner import AgentRunner
 from power_loop.runtime.budget import estimate_text_tokens, estimate_tokens, trim_history
 from power_loop.runtime.cancellation import CancellationLike, CancellationToken
-from power_loop.runtime.env import RuntimeEnv, RuntimeEnvError
+from power_loop.runtime.env import RuntimeEnv, RuntimeEnvError, runtime_env_context
 from power_loop.runtime.exec_backend import (
     DEFAULT_SHELL_BACKEND,
     LocalShellBackend,
@@ -244,6 +244,7 @@ __all__ = [
 	"CancellationLike",
 	"RuntimeEnv",
 	"RuntimeEnvError",
+	"runtime_env_context",
 	"ShellBackend",
 	"LocalShellBackend",
 	"DEFAULT_SHELL_BACKEND",

{power_loop-0.7.0 → power_loop-0.7.2}/power_loop/agent/stateful_loop.py

@@ -196,9 +196,17 @@ class StatefulAgentLoop:
         session_id: str,
         *,
         stop_event: CancellationLike = None,
+        tools: Sequence[str] | ToolRegistry | None = None,
+        system_prompt: str | None = None,
     ) -> StatefulResult | FollowUpQueued:
         return asyncio.run(
-            self.follow_up(user_input, session_id, stop_event=stop_event)
+            self.follow_up(
+                user_input,
+                session_id,
+                stop_event=stop_event,
+                tools=tools,
+                system_prompt=system_prompt,
+            )
         )
 
     def send_sync(
@@ -207,9 +215,17 @@ class StatefulAgentLoop:
         session_id: str,
         *,
         stop_event: CancellationLike = None,
+        tools: Sequence[str] | ToolRegistry | None = None,
+        system_prompt: str | None = None,
     ) -> StatefulResult:
         return asyncio.run(
-            self.send(user_input, session_id, stop_event=stop_event)
+            self.send(
+                user_input,
+                session_id,
+                stop_event=stop_event,
+                tools=tools,
+                system_prompt=system_prompt,
+            )
         )
 
     async def resume(

{power_loop-0.7.0 → power_loop-0.7.2}/power_loop/tools/__init__.py

@@ -50,6 +50,9 @@ def create_default_tool_registry(
             If omitted, ``POWER_LOOP_HOME`` is used when present.
         skills_dir: Optional default skills directory for ``load_skill``.
             If omitted, ``POWER_LOOP_SKILLS_DIR`` is used when present.
+        bind: When true (default), bind handlers to one ``RuntimeEnv`` now.
+            When false, return handlers that resolve the current
+            ``runtime_env_context`` at invocation time.
 
     Examples::
 
@@ -68,9 +71,6 @@ def create_default_tool_registry(
             workspace_dir="/path/to/project",
         )
     """
-    from power_loop.tools.default_manifest import get_tool_definitions
-    from power_loop.tools.default_tools import DEFAULT_TOOL_HANDLERS
-
     definitions = get_tool_definitions(preset=preset, include=include, exclude=exclude)
     if not bind:
         # Unbound: handlers read the current RuntimeEnv at call time; the caller

{power_loop-0.7.0 → power_loop-0.7.2}/power_loop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: power-loop
-Version: 0.7.0
+Version: 0.7.2
 Summary: Embeddable agent execution kernel — LLM loop, hooks, events, tools, dynamic sub-agents.
 Author-email: zhangran <zhangran24@126.com>
 License: MIT
@@ -125,6 +125,37 @@ See [Getting Started](docs/en/getting-started.md) for the complete first run.
 | Pluggable cross-session memory | [Memory](docs/en/user-guide/memory.md) |
 | Provider configuration | [Providers](docs/en/user-guide/providers.md) |
 
+### Per-call overrides
+
+Build one loop and reuse it across callers; restrict tools or swap the system
+prompt **per `send`** without rebuilding (the model only *sees* the allowed
+tools). Ideal for multi-tenant hosts.
+
+```python
+# loop registered with all tools; this run exposes only "get_weather"
+await loop.send("…", session_id=sid, tools=["get_weather"])
+
+# per-run system prompt override (precedence: per-call > session > config)
+await loop.send("…", session_id=sid, system_prompt="You are a terse bot.")
+```
+
+The same overrides are available on `send_sync()`. When `follow_up()` is idle
+and falls back to a new send, it accepts them too. A follow-up queued into an
+already running call keeps that call's active tool and prompt policy.
+
+For a multi-tenant host that reuses one registry across workspaces, build an
+**unbound** registry and supply the workspace at invocation time:
+
+```python
+from power_loop import RuntimeEnv, create_default_tool_registry, runtime_env_context
+
+registry = create_default_tool_registry(preset="core", bind=False)
+with runtime_env_context(RuntimeEnv(workspace_dir=tenant_workspace)):
+    result = await registry.invoke_async("read_file", {"path": "README.md"})
+```
+
+See [`examples/23_per_send_overrides.py`](examples/23_per_send_overrides.py).
+
 ## Public API
 
 Stable imports are re-exported from `power_loop`: