pi-python-core 0.10.0__py3-none-any.whl → 0.10.1__py3-none-any.whl

pi_python/_version.py

@@ -1 +1 @@
-__version__ = "0.10.0"
+__version__ = "0.10.1"

pi_python/plugins/__init__.py

@@ -21,6 +21,7 @@ import hashlib
 import importlib
 import importlib.machinery
 import importlib.util
+import inspect
 import json
 import math
 import os
@@ -49,6 +50,7 @@ from ..tools import Tool, ToolContext, ToolResult, invoke
 from .._mcp_interaction import MCPCallbacks
 from ._compose import (
     HOOK_NAMES,
+    HOOK_PARAMETERS,
     PluginFailure,
     compose_hooks,
     isolated_listener,
@@ -286,7 +288,9 @@ class PluginAPI:
             raise ConfigurationError(f"Unknown hook {hook!r}; hooks are {', '.join(HOOK_NAMES)}")
 
         def register(function: F) -> F:
-            _require_callable(function, f"the {hook} handler of plugin {self.name!r}")
+            _require_callable(
+                function, f"the {hook} handler of plugin {self.name!r}", HOOK_PARAMETERS[hook]
+            )
             self._handlers.append((hook, function))
             return function
 
@@ -294,7 +298,7 @@ class PluginAPI:
 
     def subscribe(self, listener: EventListener) -> None:
         """Receive the events of agents built from this set; failures are reported, not raised."""
-        _require_callable(listener, f"an event listener of plugin {self.name!r}")
+        _require_callable(listener, f"an event listener of plugin {self.name!r}", ("event",))
         self._listeners.append(listener)
 
     def _path(self, path: str | os.PathLike[str]) -> Path:
@@ -1087,9 +1091,21 @@ def _redact(text: str, secrets: set[str] | None) -> str:
     return text
 
 
-def _require_callable(value: Any, what: str) -> None:
+def _require_callable(value: Any, what: str, arguments: tuple[str, ...] = ()) -> None:
+    """Reject a callback now if it cannot take the positional `arguments` it will be called
+    with; otherwise each call would fail and, for a hook, only be logged and skipped."""
     if not callable(value):
         raise ConfigurationError(f"{what} must be callable, not {type(value).__name__}")
+    try:
+        # Not following __wrapped__: a decorator's own wrapper is what gets called.
+        signature = inspect.signature(value, follow_wrapped=False)
+    except (TypeError, ValueError):
+        return  # no signature to inspect, as for some builtins
+    try:
+        signature.bind(*arguments)
+    except TypeError as exc:
+        expected = f"the arguments ({', '.join(arguments)})" if arguments else "no arguments"
+        raise ConfigurationError(f"{what} must accept {expected}: {exc}") from None
 
 
 def _looks_like_path(text: str) -> bool:

pi_python/plugins/_compose.py

@@ -34,6 +34,21 @@ from ..hooks import Hooks, RunContext, TurnUpdate
 from ..tools import ToolResult, ToolResultUpdate, apply_result_update, invoke
 
 HOOK_NAMES = tuple(f.name for f in fields(Hooks))
+# The positional arguments the composed hooks below pass to each handler.
+HOOK_PARAMETERS: dict[str, tuple[str, ...]] = {
+    "before_tool_call": ("call", "args", "context"),
+    "after_tool_call": ("call", "result", "context"),
+    "transform_context": ("messages", "cancel"),
+    "convert_to_llm": ("messages",),
+    "prepare_request": ("context", "cancel"),
+    "prepare_next_turn": ("context", "cancel"),
+    "finish_turn": ("context", "cancel"),
+    "get_api_key": ("provider",),
+    "on_payload": ("payload",),
+    "on_response": ("response",),
+    "on_provider_stream_event": ("event",),
+}
+assert set(HOOK_PARAMETERS) == set(HOOK_NAMES)
 logger = logging.getLogger("pi_python.plugins")
 
 

{pi_python_core-0.10.0.dist-info → pi_python_core-0.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pi-python-core
-Version: 0.10.0
+Version: 0.10.1
 Summary: An embeddable asyncio agent core with opt-in Claude and OpenAI providers
 License-Expression: MIT
 License-File: LICENSE
@@ -99,6 +99,7 @@ To try it offline first: `python examples/quickstart.py`.
 | Use MCP tools | `async with connect_stdio(...) as tools`, or `connect_http(url)` for a remote server | [mcp_tools](examples/mcp_tools.py) |
 | Let one agent call another | Wrap the sub-agent as a tool; cancellation propagates down. Plugins can also define subagents in Markdown | [subagent](examples/subagent.py) |
 | Package and share capabilities | A plugin bundles tools, instructions, hooks, skills, prompt templates, subagents and MCP servers; load it by name or path with `load_plugins` and build the agent with `plugins.agent(...)` | [plugin_demo](examples/plugin_demo.py) |
+| Remember across conversations | Not built in, as in Pi's core; an example plugin saves facts to a file and puts them in the system prompt, ready to copy and adapt | [memory_demo](examples/memory_demo.py) |
 | Intervene mid-run | `steer` injects guidance, `follow_up` queues the next task, `abort` cancels at any time (callable from any thread) | |
 | Context full, service errors | `is_context_overflow` and `is_retryable_error` tell you why, `continue_run()` retries, `transform_context` compacts | [recovery](examples/recovery.py) |
 | Save and restore conversations | `encode_messages` / `decode_messages`; your application decides where to store them | [save_restore](examples/save_restore.py) |

{pi_python_core-0.10.0.dist-info → pi_python_core-0.10.1.dist-info}/RECORD

@@ -3,7 +3,7 @@ pi_python/_mcp_host.py,sha256=CXio-tiEeUCUfdl65tatwSrzIOYdgecdS00sO6tNy5k,8630
 pi_python/_mcp_interaction.py,sha256=jPL-C8wLjBDV9tOdvGVFfXOl8-1FQIDJLq-MojlzXaM,43851
 pi_python/_mcp_process.py,sha256=4szi5gMEP_0GUGOcV-oLPUuVQAUSb0ToAaiM979zHME,6324
 pi_python/_mcp_sampling.py,sha256=BcWCrPgjsRC-GNx65fIB-JPq2WzWnoBK2w9iTnyPUww,12148
-pi_python/_version.py,sha256=v4zmKjsKOPZbp6BrWoz7iK4ST0sdZdUh9bQSJmluZ5o,23
+pi_python/_version.py,sha256=v7Gyp89umFzDtY45tTjCdXqZnQ2RN01AibdYNxEvxYo,23
 pi_python/agent.py,sha256=I4P4waCdkcURDd022H4XgBbHNhpa7LrI5Iwb5ncxhGU,16021
 pi_python/cancellation.py,sha256=DoQVdX7DcQdVLkl4OvhcpMhKZJEW0Kscl2-xxF6i6Y0,608
 pi_python/errors.py,sha256=65lT0nYfzqxRfUlFG-Y9vgYxfDHEuFiBfgqmFnX9_O8,675
@@ -31,8 +31,8 @@ pi_python/testing.py,sha256=XfTSOkEv0CenqrBILI_T205jOhyitW53YQZ9yiMXir4,1046
 pi_python/tools.py,sha256=zBrYVoPOgrVHqvrL5sIhMXCf501QjyuDNdmR-tV6Ads,23274
 pi_python/transcript.py,sha256=g6Tg8eiyMCAK43iLpcBv220MHBq8kO7Ty-6OYLCzw2A,6685
 pi_python/data/models.json,sha256=oa_LGv7vaRrS-l7_Z7iu8f7WTyoJJLPhUQyptUz7OmE,77549
-pi_python/plugins/__init__.py,sha256=OnQoKk63SJ_t8I3yldTn0Zw12tGqzD2K-LDqM3JdAfY,55330
-pi_python/plugins/_compose.py,sha256=x1yZZtoXWqTugMWcNeFFitWSeFnRH3WI0XiQdH7oJxA,10767
+pi_python/plugins/__init__.py,sha256=FeYHYxgaOjKuq3QBBv1ezOyfORi5Fl2SdnImN_O0IrE,56156
+pi_python/plugins/_compose.py,sha256=vmIh901G6D298uQBn_IhiKkczIBymsqCPWo7SxXUrTM,11411
 pi_python/plugins/_frontmatter.py,sha256=_i5QeDcPlz9n8ou9W7b20TNWMVoeYThI1f4j68ZbuCk,16127
 pi_python/plugins/_resources.py,sha256=uK5TSyJc1H6aptJqKw5FI83Gyp2MghxcUvgxOmWQu08,13531
 pi_python/plugins/_subagents.py,sha256=HhUYK4z7gdtX2_DSh3vFfxyJCKo2zz0zSOjRE1j8CmY,10252
@@ -43,8 +43,8 @@ pi_python/providers/completions.py,sha256=vcqoLfJ-9quMREEEAJcHYs3Oq-A0Sz8Q1NV1QL
 pi_python/providers/oauth.py,sha256=ZY8j7P-I-R6hZ8sInkGao957KWNGsqfvMF0F-YzlSgU,22786
 pi_python/providers/openai.py,sha256=p0WHDnojAYb7mUX8EbComwEU_XskcYoMhMIR07QlSfc,30196
 pi_python/providers/transport.py,sha256=B1mGKlVEqYGVK1MlcA9opwRhnuUYGuaYuTslNC3O8xs,26772
-pi_python_core-0.10.0.dist-info/METADATA,sha256=Ntw_teJVikFWKlCZtjeUPxCZMfq0poW7Z1E2caoFpJ8,8731
-pi_python_core-0.10.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-pi_python_core-0.10.0.dist-info/licenses/LICENSE,sha256=BFf1vOw7OyEWBd-10aSQQv1jjzaGpBD-CZwkolrxPEg,1069
-pi_python_core-0.10.0.dist-info/licenses/NOTICE,sha256=fJna16fm1ECHN7zVZhtyNmjLw8KGxGp8mL9blISF1K0,633
-pi_python_core-0.10.0.dist-info/RECORD,,
+pi_python_core-0.10.1.dist-info/METADATA,sha256=AncCL6Sz-4xE1Kx9_iHB2TmHcOtq8jJjBFHxAGExpxs,8939
+pi_python_core-0.10.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pi_python_core-0.10.1.dist-info/licenses/LICENSE,sha256=BFf1vOw7OyEWBd-10aSQQv1jjzaGpBD-CZwkolrxPEg,1069
+pi_python_core-0.10.1.dist-info/licenses/NOTICE,sha256=fJna16fm1ECHN7zVZhtyNmjLw8KGxGp8mL9blISF1K0,633
+pi_python_core-0.10.1.dist-info/RECORD,,