@davidorex/pi-jit-agents 0.29.0 → 0.30.0

package/CHANGELOG.md

@@ -4,6 +4,8 @@ All notable changes to this package are documented here. Format follows [Keep a
 
 ## [Unreleased]
 
+## [0.30.0] - 2026-06-04
+
 ## [0.29.0] - 2026-06-04
 
 ## [0.28.1] - 2026-06-03

package/README.md

@@ -19,11 +19,15 @@ The package owns four public surfaces:
 
 - `loadAgent(name, ctx) → AgentSpec` — resolves spec from discovery tiers, fully resolves all path fields to absolute
 - `compileAgent(spec, ctx) → CompiledAgent` — renders templates, injects `contextBlocks` from the substrate directory, composes final prompts
-- `executeAgent(compiled, dispatch) → JitAgentResult` — in-process LLM dispatch with phantom tool enforcement
+- `executeAgent(compiled, dispatch) → JitAgentResult` — in-process LLM dispatch with phantom tool enforcement; clamps the compiled agent's tool grant to a subset of the caller-supplied parent grant at the dispatch boundary
 - `agentContract(spec) → AgentContract` — projection for introspection, no execution
 
 Subprocess dispatch stays in pi-workflows. The package never reads from `.pi/` — that directory is Pi platform territory.
 
+## Tool-grant clamping
+
+`AgentSpec.tools` (operation-granular tool names) threads through `compileAgent` into `CompiledAgent.tools`. At dispatch, `executeAgent` clamps `compiled.tools` to a subset of `DispatchContext.parentGrant` (the caller's own grant; undefined parent grant means the empty set). A child requesting a tool outside the parent grant raises `GrantViolationError`, naming the agent and the violating tools.
+
 ## Discovery tiers
 
 Agent specs are searched in this order:
@@ -34,12 +38,20 @@ Agent specs are searched in this order:
 
 The framework package itself ships no bundled agent specs. Consumer packages supply their own builtin directory at loader construction time.
 
+## Bundled templates
+
+The agent-template tree ships in this package under `templates/` (relocated here from pi-workflows). `bundledTemplateDir()` returns its absolute path so consumers can discover the bundled templates from either source or built (`dist`) layouts. `templates/shared/macros.md` provides one per-item rendering macro per block kind plus six whole-block delegator macros (`render_decisions`, `render_features`, `render_framework_gaps`, `render_layer_plans`, `render_research`, `render_spec_reviews`) that wrap the per-item macros.
+
+`CANONICAL_MACRO_NAMES` is the registry mapping each block kind to its `{ macro_name, array_key }`, surfacing the cases where the block kind differs from the data key the items live under (e.g. `framework-gaps`→`gaps`, `layer-plans`→`plans`, `spec-reviews`→`reviews`). `createRendererRegistry` builds the kind→macro-ref map consumed during compilation.
+
 ## Exports
 
 - `.` — main barrel
 - `./types` — type definitions
 - `./agent-spec` — `parseAgentYaml`, `createAgentLoader`
 - `./template` — `createTemplateEnv`, `renderTemplate`, `renderTemplateFile`
-- `./compile` — `compileAgent`
-- `./runtime` — `executeAgent`, `buildPhantomTool`
+- `./compile` — `compileAgent`, `registerCompositionGlobals`
+- `./runtime` — `executeAgent`, `buildPhantomTool`, `normalizeToolChoice`, `GrantViolationError`
 - `./introspect` — `agentContract`
+
+The main barrel additionally re-exports the bundled-template entry point (`bundledTemplateDir`), the renderer registry (`CANONICAL_MACRO_NAMES`, `createRendererRegistry`), and `GrantViolationError`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@davidorex/pi-jit-agents",
-	"version": "0.29.0",
+	"version": "0.30.0",
 	"publishConfig": {
 		"access": "public"
 	},
@@ -62,7 +62,7 @@
 		"test": "tsx --test src/*.test.ts"
 	},
 	"dependencies": {
-		"@davidorex/pi-context": "^0.29.0",
+		"@davidorex/pi-context": "^0.30.0",
 		"@earendil-works/pi-ai": "^0.75.4",
 		"nunjucks": "^3.2.4",
 		"proper-lockfile": "^4.1.2",