pi-repl-py 0.2.0 → 0.2.1

package/README.md

@@ -49,12 +49,13 @@ clear notice. How the interpreter is resolved is in [docs/ARCHITECTURE.md](docs/
 
 ## Helpers
 
-A **helper** is a Python function you preload into every kernel. Drop a file in the one
-helpers directory, restart the session, and the function is callable from the workspace —
-for example, `helpers/double.py` exposing `def double` becomes `double(...)`. It ships
-**empty** (shell and file IO are already plain Python), so a fresh install preloads nothing
-until you add one. Each helper's `helper_description` is shown to the model verbatim;
-the full contract lives in [docs/how-to-functions.md](docs/how-to-functions.md).
+A **helper** is a `.py` file that gets exec'd into every kernel, so whatever it defines —
+functions, classes, constants, imports, or a module that manages a tricky piece of
+complexity — is available in the workspace. Drop a file in the one helpers directory and
+restart the session; e.g. `helpers/double.py` defining `def double(x)` becomes callable as
+`double(...)`. It ships **empty** (shell and file IO are already plain Python), so a fresh
+install preloads nothing until you add one. Each helper's `helper_description` is shown to
+the model verbatim; the full contract lives in [docs/helpers.md](docs/helpers.md).
 
 Everything the extension keeps lives under one folder in your home directory:
 

package/docs/ARCHITECTURE.md

@@ -121,7 +121,7 @@ The model discovers what is loaded by listing the namespace with ordinary Python
 ```
 
 For the full helper contract — the description, the docstring, disabling — see
-[how-to-functions.md](how-to-functions.md).
+[helpers.md](helpers.md).
 
 ## Snapshots & honest resets
 
@@ -179,4 +179,4 @@ but working cell may run on).
 ## Reference documentation
 
 - Philosophy and design rationale: [philosophy.md](philosophy.md)
-- Adding a helper: [how-to-functions.md](how-to-functions.md)
+- Adding a helper: [helpers.md](helpers.md)

package/docs/{how-to-functions.md → helpers.md}

@@ -1,12 +1,12 @@
 # How to write a helper
 
-A **helper** is a Python function you write once that becomes available to the agent in
-every `pi --repl` session. You drop a `.py` file into one folder, restart the session, and
-the function is callable from the workspace — like a bookmark for code the agent keeps
-reaching for.
+A **helper** is a `.py` file that gets exec'd into every kernel, so anything it defines —
+functions, classes, constants, imports, or a module that owns a fragile or opaque piece of
+work — becomes part of the agent's workspace; you drop the file into one folder, restart
+the session, and it's available. Like a bookmark for code the agent keeps reaching for.
 
-This guide shows the smallest helper that works, then explains the three parts every
-helper file has and the habits that make a helper useful.
+This guide shows the smallest callable helper that works, then explains the parts of a
+helper file and the habits that make a helper useful.
 
 ## Prerequisites
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-repl-py",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"type": "module",
 	"description": "A pi extension with a single tool: execute, running a TypeScript host with a persistent Python (ipykernel) evaluator and a user-configurable toolbox of functions.",
 	"keywords": [