@llblab/pi-state-flow 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.5: Skill attribution and state model clarification
4
+
5
+ - Attribute successful Skill acquisition to finalized `tool_execution_start` arguments, with a tested compatibility fallback to the intercepted `tool_call` input.
6
+ - Clarify that the three-field materialized handoff coexists with mutable exogenous project and runtime state that can also shape model behavior.
7
+ - Remove the obsolete `/reload` step from the usage instructions.
8
+
9
+ ## 0.1.4: Release verification hotfix
10
+
11
+ - Kept npm pack lifecycle output out of release inventory JSON so Trusted Publisher releases can complete public verification and GitHub Release creation.
12
+
3
13
  ## 0.1.3: Trusted Publisher release automation
4
14
 
5
15
  - Added immutable-tag GitHub Actions automation that validates the package, publishes and verifies npm through Trusted Publisher with provenance, and creates the matching GitHub Release.
package/README.md CHANGED
@@ -32,7 +32,6 @@ pi install git:github.com/llblab/pi-state-flow
32
32
  ## Usage
33
33
 
34
34
  ```text
35
- /reload
36
35
  /state-flow-start
37
36
  ```
38
37
 
@@ -90,6 +89,8 @@ This removes `working.move`, replaces `working.result`, preserves every other me
90
89
 
91
90
  State and patch size have no byte, growth, pressure, or project-schema limit. Patch history remains only in the Pi trace, not in model context.
92
91
 
92
+ These three fields are the complete **materialized State Flow state**, but they are not the only state that can shape model behavior. A situational fourth, exogenous state lives outside the handoff: the current project, workspace, tools, processes, and runtime environment. It can change while work is in progress—including through the model's own tool effects—and later observations of those changes can alter subsequent behavior. State Flow neither snapshots nor rolls back this external state; `working` should retain only the decision-relevant facts needed to reconnect the next run to it.
93
+
93
94
  ## Terminal handoff quality
94
95
 
95
96
  The terminal patch is a required handoff, not a progress phrase or transcript summary. The next run may see only this state plus its new user prompt. A fresh model should be able to continue without rereading, rediscovering, re-deriving decisions, or repeating failed approaches.
@@ -157,7 +158,7 @@ The normative protocol remains in the system prompt throughout a tool/retry chai
157
158
 
158
159
  ## Distribution
159
160
 
160
- Version `0.1.3` supports public npm, local, and source/GitHub distribution from the canonical `llblab/pi-state-flow` repository. Version tags trigger `.github/workflows/release.yml`, which validates the exact tag, publishes through npm Trusted Publisher with provenance, verifies the public package, and then creates the matching GitHub Release.
161
+ Version `0.1.4` supports public npm, local, and source/GitHub distribution from the canonical `llblab/pi-state-flow` repository. Version tags trigger `.github/workflows/release.yml`, which validates the exact tag, publishes through npm Trusted Publisher with provenance, verifies the public package, and then creates the matching GitHub Release.
161
162
 
162
163
  Configure the npm Trusted Publisher with owner `llblab`, repository `pi-state-flow`, workflow filename `release.yml`, and no environment. No long-lived npm token is used.
163
164
 
package/index.ts CHANGED
@@ -475,6 +475,12 @@ export default function stateFlowExtension(pi: ExtensionAPI): void {
475
475
  pendingSkillReads.set(event.toolCallId, { toolName: event.toolName, args: event.input });
476
476
  });
477
477
 
478
+ pi.on("tool_execution_start", (event) => {
479
+ const pending = pendingSkillReads.get(event.toolCallId);
480
+ if (!snapshot.enabled || !pending) return;
481
+ pendingSkillReads.set(event.toolCallId, { toolName: event.toolName, args: event.args });
482
+ });
483
+
478
484
  pi.on("tool_execution_end", (event) => {
479
485
  const pending = pendingSkillReads.get(event.toolCallId);
480
486
  pendingSkillReads.delete(event.toolCallId);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@llblab/pi-state-flow",
3
- "version": "0.1.3",
3
+ "version": "0.1.5",
4
4
  "private": false,
5
5
  "description": "State Flow terminal-handoff runtime for Pi, inspired by SKILL.state",
6
6
  "keywords": ["pi-package", "pi-extension", "state-management"],