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/chunks/{chunk-W3N72XYK.js → chunk-4X4HTEB4.js} +1 -1
- package/dist/core/shell-inbox.d.ts.map +1 -1
- package/dist/durable-extension.d.ts +1 -1
- package/dist/durable-extension.js +1 -1
- package/dist/durable-extension.js.map +1 -1
- package/dist/extension-bootstrap.js +1 -1
- package/dist/fabric-runtime-state.js +39 -23
- package/dist/fabric-runtime-state.js.map +2 -2
- package/dist/index.js +1 -1
- package/docs/background-tasks.md +24 -12
- package/package.json +1 -1
- /package/dist/chunks/{chunk-W3N72XYK.js.map → chunk-4X4HTEB4.js.map} +0 -0
package/dist/index.js
CHANGED
|
@@ -93,7 +93,7 @@ import {
|
|
|
93
93
|
createFabricExtension,
|
|
94
94
|
createFabricPersistedExecutionDetails,
|
|
95
95
|
readFabricExecutionRenderDetails
|
|
96
|
-
} from "./chunks/chunk-
|
|
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";
|
package/docs/background-tasks.md
CHANGED
|
@@ -88,14 +88,24 @@ before sealing their log, regardless of extension shutdown order.
|
|
|
88
88
|
|
|
89
89
|
## Agent awareness and yielding
|
|
90
90
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
discards the nested shell result, the owning agent can
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
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
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
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
|
File without changes
|