pi-fabric 0.131.1 → 0.131.2

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/dist/index.js CHANGED
@@ -93,7 +93,7 @@ import {
93
93
  createFabricExtension,
94
94
  createFabricPersistedExecutionDetails,
95
95
  readFabricExecutionRenderDetails
96
- } from "./chunks/chunk-W3N72XYK.js";
96
+ } from "./chunks/chunk-4X4HTEB4.js";
97
97
  import "./chunks/chunk-WWTGWGH7.js";
98
98
  import "./chunks/chunk-QNMQJNXE.js";
99
99
  import "./chunks/chunk-37NIOSVU.js";
@@ -88,14 +88,24 @@ before sealing their log, regardless of extension shutdown order.
88
88
 
89
89
  ## Agent awareness and yielding
90
90
 
91
- Before each model request, Fabric projects one bounded live-task reminder into
92
- context, independently of the returned `fabric_exec` value. Even if a program
93
- discards the nested shell result, the owning agent can see that work is running.
94
- The reminder is reconstructed from live session state after context compaction;
95
- it is not a persisted transcript entry and **never triggers a turn** itself.
96
- Unchanged task state keeps the same message; elapsed time and process output do
97
- not churn it. It includes at most eight task IDs and short, quoted labels, with
98
- an omitted count for additional jobs.
91
+ When a task moves to the background, Fabric appends one note to the result of
92
+ the tool call that spilled it, independently of the returned `fabric_exec`
93
+ value. Even if a program discards the nested shell result, the owning agent can
94
+ see that work is running. Tasks spilled by one call share one note, which
95
+ includes at most eight task IDs and short, quoted labels, with an omitted count
96
+ for additional jobs, and never elapsed time or process output. The note
97
+ **never triggers a turn** itself.
98
+
99
+ The note records a moment and is never edited or retracted; later task events
100
+ report each outcome in transcript order. Fabric does not rewrite requests for
101
+ awareness, so each request extends the previous one and the provider's prompt
102
+ cache keeps hitting while tasks run. A reminder projected at the end of every
103
+ request would be missing from the next request in that position, which caps
104
+ the cached prefix at the last request without it. The note lives in an ordinary
105
+ tool result, not a custom message, because Pi rebuilds custom-message objects
106
+ on every refresh and its idle cache warmer, which compares objects by identity,
107
+ then treats the conversation as changed. After compaction, which replaces the
108
+ prefix anyway, Fabric restates still-running tasks on the next tool result.
99
109
 
100
110
  For ordinary detached commands and wake-enabled monitors, it tells the agent to
101
111
  continue independent work or **end the turn if it needs their results**. Completion
@@ -104,10 +114,12 @@ are unnecessary. UI-only monitors are explicitly marked **no automatic wakeup**,
104
114
  including on completion, so the agent must not yield expecting them to resume it.
105
115
  Pending required results are not evidence that the assignment is complete.
106
116
 
107
- Foreground, completed, stopping, and abandoned-branch jobs are excluded. Abort/error
108
- suspension suppresses the reminder until new input, just like automatic delivery.
109
- Reload/session shutdown removes the context hook along with the inbox. Awareness
110
- works without a terminal and does not restore processes across Pi restarts.
117
+ Foreground jobs, jobs that end before the next tool result, abandoned-branch
118
+ jobs, and durable tasks reattached after a restart are not announced; the
119
+ process that spilled a reattached task already wrote its note. A note stays on
120
+ its own branch of the session tree. Reload/session shutdown closes the inbox.
121
+ Awareness works without a terminal and does not restore processes across Pi
122
+ restarts.
111
123
 
112
124
  ### Prompt-cache warming while yielded
113
125
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-fabric",
3
- "version": "0.131.1",
3
+ "version": "0.131.2",
4
4
  "description": "A programmable tool and agent runtime for Pi",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",