pi-background-tasks 2.5.0 → 2.6.1

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.
Files changed (204) hide show
  1. package/BACKGROUND-TASKS-INSTRUCTIONS.md +1 -1
  2. package/PUBLISHING.md +1 -1
  3. package/README.md +70 -25
  4. package/TESTING.md +44 -2
  5. package/TEST_PLAN.md +9 -5
  6. package/dist/extensions/anthropic-attribution-child.js +8 -0
  7. package/dist/extensions/anthropic-attribution-child.js.map +1 -0
  8. package/dist/extensions/anthropic-attribution.js +102 -0
  9. package/dist/extensions/anthropic-attribution.js.map +1 -0
  10. package/dist/extensions/background-tasks.js +2 -0
  11. package/dist/extensions/background-tasks.js.map +1 -0
  12. package/dist/extensions/delegate-child.js +2 -0
  13. package/dist/extensions/delegate-child.js.map +1 -0
  14. package/dist/extensions/fusion-child.js +2 -0
  15. package/dist/extensions/fusion-child.js.map +1 -0
  16. package/dist/package.json +5 -0
  17. package/dist/src/core/anthropic-attribution-path.js +24 -0
  18. package/dist/src/core/anthropic-attribution-path.js.map +1 -0
  19. package/dist/src/core/anthropic-attribution.js +2253 -0
  20. package/dist/src/core/anthropic-attribution.js.map +1 -0
  21. package/dist/src/core/attested-pi-contract.js +5 -0
  22. package/dist/src/core/attested-pi-contract.js.map +1 -0
  23. package/dist/src/core/attested-pi-run.js +749 -0
  24. package/dist/src/core/attested-pi-run.js.map +1 -0
  25. package/dist/src/core/canonical-json.js +19 -0
  26. package/dist/src/core/canonical-json.js.map +1 -0
  27. package/dist/src/core/common.js +787 -0
  28. package/dist/src/core/common.js.map +1 -0
  29. package/dist/src/core/config.js +78 -0
  30. package/dist/src/core/config.js.map +1 -0
  31. package/dist/src/core/context/parent-snapshot.js +75 -0
  32. package/dist/src/core/context/parent-snapshot.js.map +1 -0
  33. package/dist/src/core/context/token-budget.js +631 -0
  34. package/dist/src/core/context/token-budget.js.map +1 -0
  35. package/dist/src/core/context/visible-conversation-v2.js +390 -0
  36. package/dist/src/core/context/visible-conversation-v2.js.map +1 -0
  37. package/dist/src/core/delegate/artifacts.js +357 -0
  38. package/dist/src/core/delegate/artifacts.js.map +1 -0
  39. package/dist/src/core/delegate/budget.js +266 -0
  40. package/dist/src/core/delegate/budget.js.map +1 -0
  41. package/dist/src/core/delegate/facade-contract.js +7 -0
  42. package/dist/src/core/delegate/facade-contract.js.map +1 -0
  43. package/dist/src/core/delegate/hook-contract-evidence.json +18 -0
  44. package/dist/src/core/delegate/hook-contract.js +124 -0
  45. package/dist/src/core/delegate/hook-contract.js.map +1 -0
  46. package/dist/src/core/delegate/launch.js +366 -0
  47. package/dist/src/core/delegate/launch.js.map +1 -0
  48. package/dist/src/core/delegate/result-package.js +293 -0
  49. package/dist/src/core/delegate/result-package.js.map +1 -0
  50. package/dist/src/core/delegate/runner.js +398 -0
  51. package/dist/src/core/delegate/runner.js.map +1 -0
  52. package/dist/src/core/delegate/seed.js +334 -0
  53. package/dist/src/core/delegate/seed.js.map +1 -0
  54. package/dist/src/core/delegate/types.js +103 -0
  55. package/dist/src/core/delegate/types.js.map +1 -0
  56. package/dist/src/core/durable-fs.js +372 -0
  57. package/dist/src/core/durable-fs.js.map +1 -0
  58. package/dist/src/core/extension-api.js +382 -0
  59. package/dist/src/core/extension-api.js.map +1 -0
  60. package/dist/src/core/fusion/artifacts.js +654 -0
  61. package/dist/src/core/fusion/artifacts.js.map +1 -0
  62. package/dist/src/core/fusion/budget.js +949 -0
  63. package/dist/src/core/fusion/budget.js.map +1 -0
  64. package/dist/src/core/fusion/child-protocol.js +176 -0
  65. package/dist/src/core/fusion/child-protocol.js.map +1 -0
  66. package/dist/src/core/fusion/claude-cache.js +156 -0
  67. package/dist/src/core/fusion/claude-cache.js.map +1 -0
  68. package/dist/src/core/fusion/clean-context.js +64 -0
  69. package/dist/src/core/fusion/clean-context.js.map +1 -0
  70. package/dist/src/core/fusion/config.js +349 -0
  71. package/dist/src/core/fusion/config.js.map +1 -0
  72. package/dist/src/core/fusion/context.js +184 -0
  73. package/dist/src/core/fusion/context.js.map +1 -0
  74. package/dist/src/core/fusion/evaluation.js +696 -0
  75. package/dist/src/core/fusion/evaluation.js.map +1 -0
  76. package/dist/src/core/fusion/facade-contract.js +3 -0
  77. package/dist/src/core/fusion/facade-contract.js.map +1 -0
  78. package/dist/src/core/fusion/orchestrator.js +867 -0
  79. package/dist/src/core/fusion/orchestrator.js.map +1 -0
  80. package/dist/src/core/fusion/output-contract.js +27 -0
  81. package/dist/src/core/fusion/output-contract.js.map +1 -0
  82. package/dist/src/core/fusion/pi-child.js +1741 -0
  83. package/dist/src/core/fusion/pi-child.js.map +1 -0
  84. package/dist/src/core/fusion/prompts.js +260 -0
  85. package/dist/src/core/fusion/prompts.js.map +1 -0
  86. package/dist/src/core/fusion/result-package.js +857 -0
  87. package/dist/src/core/fusion/result-package.js.map +1 -0
  88. package/dist/src/core/fusion/source-policy.js +259 -0
  89. package/dist/src/core/fusion/source-policy.js.map +1 -0
  90. package/dist/src/core/fusion/types.js +207 -0
  91. package/dist/src/core/fusion/types.js.map +1 -0
  92. package/dist/src/core/fusion/web-fetch.js +777 -0
  93. package/dist/src/core/fusion/web-fetch.js.map +1 -0
  94. package/dist/src/core/fusion/workflows.js +126 -0
  95. package/dist/src/core/fusion/workflows.js.map +1 -0
  96. package/dist/src/core/lazy-module.js +181 -0
  97. package/dist/src/core/lazy-module.js.map +1 -0
  98. package/dist/src/core/pi-launch.js +431 -0
  99. package/dist/src/core/pi-launch.js.map +1 -0
  100. package/dist/src/core/registry.js +3331 -0
  101. package/dist/src/core/registry.js.map +1 -0
  102. package/dist/src/core/reload-shell-owner.js +1396 -0
  103. package/dist/src/core/reload-shell-owner.js.map +1 -0
  104. package/dist/src/core/shell-policy.js +80 -0
  105. package/dist/src/core/shell-policy.js.map +1 -0
  106. package/dist/src/core/task-durable.js +51 -0
  107. package/dist/src/core/task-durable.js.map +1 -0
  108. package/dist/src/core/update-check.js +92 -0
  109. package/dist/src/core/update-check.js.map +1 -0
  110. package/dist/src/core/windows-taskkill.js +185 -0
  111. package/dist/src/core/windows-taskkill.js.map +1 -0
  112. package/dist/src/delegate-child-extension.js +776 -0
  113. package/dist/src/delegate-child-extension.js.map +1 -0
  114. package/dist/src/delegate-extension.js +746 -0
  115. package/dist/src/delegate-extension.js.map +1 -0
  116. package/dist/src/extension.js +953 -0
  117. package/dist/src/extension.js.map +1 -0
  118. package/dist/src/fusion-child-extension.js +760 -0
  119. package/dist/src/fusion-child-extension.js.map +1 -0
  120. package/dist/src/fusion-extension.js +1030 -0
  121. package/dist/src/fusion-extension.js.map +1 -0
  122. package/dist/src/ui/background-tasks-manager.js +689 -0
  123. package/dist/src/ui/background-tasks-manager.js.map +1 -0
  124. package/dist/src/ui/fusion-model-selector.js +277 -0
  125. package/dist/src/ui/fusion-model-selector.js.map +1 -0
  126. package/docs/INDEX.md +35 -33
  127. package/docs/api/eventbus-v1.md +21 -5
  128. package/docs/choose-a-workflow.md +2 -0
  129. package/docs/commands/bg-clear.md +3 -3
  130. package/docs/commands/bg-update.md +3 -3
  131. package/docs/commands/bg.md +18 -6
  132. package/docs/commands/claude-cache.md +4 -4
  133. package/docs/commands/fusion-models.md +49 -4
  134. package/docs/commands/fusion.md +3 -3
  135. package/docs/commands/jobs.md +3 -3
  136. package/docs/commands/kill.md +3 -3
  137. package/docs/commands/logs.md +3 -3
  138. package/docs/commands/task-manager.md +5 -5
  139. package/docs/concepts/completion-delivery.md +6 -2
  140. package/docs/getting-started.md +7 -1
  141. package/docs/manifest.json +228 -42
  142. package/docs/operations/configuration.md +58 -5
  143. package/docs/operations/releasing.md +5 -3
  144. package/docs/operations/testing.md +22 -0
  145. package/docs/operations/troubleshooting.md +7 -2
  146. package/docs/read-before-edit.md +44 -31
  147. package/docs/reference/runtime-contracts.md +87 -51
  148. package/docs/reference/shortcuts-and-dock.md +28 -14
  149. package/docs/subsystems/anthropic-attribution.md +23 -11
  150. package/docs/subsystems/attested-pi-runs.md +12 -7
  151. package/docs/subsystems/background-task-runtime.md +53 -11
  152. package/docs/subsystems/child-launch-durability-and-safety.md +28 -9
  153. package/docs/subsystems/delegation.md +16 -3
  154. package/docs/subsystems/docs-freshness-gate.md +14 -7
  155. package/docs/subsystems/fusion.md +36 -11
  156. package/docs/subsystems/host-ui-and-telemetry.md +22 -9
  157. package/docs/tools/bg_delegate.md +3 -1
  158. package/docs/tools/bg_kill.md +3 -1
  159. package/docs/tools/bg_logs.md +3 -1
  160. package/docs/tools/bg_result.md +5 -3
  161. package/docs/tools/bg_run.md +31 -5
  162. package/docs/tools/bg_run_pi_attested.md +3 -1
  163. package/docs/tools/bg_status.md +3 -1
  164. package/docs/tools/fusion_investigate.md +3 -1
  165. package/docs/tools/fusion_reason.md +3 -1
  166. package/docs/tools/fusion_research.md +3 -1
  167. package/docs/tools/fusion_validate.md +3 -1
  168. package/extensions/anthropic-attribution-child.ts +10 -0
  169. package/extensions/anthropic-attribution.ts +157 -1
  170. package/package.json +13 -10
  171. package/src/core/anthropic-attribution-path.ts +5 -4
  172. package/src/core/anthropic-attribution.ts +306 -112
  173. package/src/core/attested-pi-contract.ts +4 -0
  174. package/src/core/attested-pi-run.ts +468 -81
  175. package/src/core/canonical-json.ts +21 -0
  176. package/src/core/common.ts +450 -40
  177. package/src/core/config.ts +121 -0
  178. package/src/core/context/visible-conversation-v2.ts +3 -6
  179. package/src/core/delegate/artifacts.ts +13 -9
  180. package/src/core/delegate/budget.ts +13 -6
  181. package/src/core/delegate/facade-contract.ts +6 -0
  182. package/src/core/delegate/result-package.ts +32 -14
  183. package/src/core/delegate/runner.ts +129 -58
  184. package/src/core/delegate/seed.ts +5 -7
  185. package/src/core/durable-fs.ts +178 -30
  186. package/src/core/extension-api.ts +36 -8
  187. package/src/core/fusion/artifacts.ts +17 -16
  188. package/src/core/fusion/clean-context.ts +8 -5
  189. package/src/core/fusion/config.ts +2 -1
  190. package/src/core/fusion/context.ts +2 -6
  191. package/src/core/fusion/facade-contract.ts +2 -0
  192. package/src/core/fusion/orchestrator.ts +3 -3
  193. package/src/core/fusion/prompts.ts +1 -1
  194. package/src/core/fusion/result-package.ts +259 -72
  195. package/src/core/fusion/source-policy.ts +43 -17
  196. package/src/core/lazy-module.ts +215 -0
  197. package/src/core/pi-launch.ts +390 -65
  198. package/src/core/registry.ts +2010 -381
  199. package/src/core/reload-shell-owner.ts +1662 -0
  200. package/src/core/shell-policy.ts +134 -0
  201. package/src/core/task-durable.ts +67 -0
  202. package/src/delegate-extension.ts +404 -144
  203. package/src/extension.ts +387 -114
  204. package/src/fusion-extension.ts +202 -96
@@ -0,0 +1,5 @@
1
+ {
2
+ "name": "pi-background-tasks",
3
+ "version": "2.6.1",
4
+ "type": "module"
5
+ }
@@ -0,0 +1,24 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { dirname, resolve } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ /**
5
+ * Resolve the package-owned always-on Anthropic child attribution extension.
6
+ *
7
+ * Package-owned child Pi processes disable ambient extension discovery, so they
8
+ * must explicitly load this safety entrypoint. It deliberately bypasses the
9
+ * independently selectable ambient parent capability. Keeping path resolution
10
+ * in one module prevents Fusion, delegation, and attested runs from deriving
11
+ * different package paths.
12
+ */
13
+ export function resolveAnthropicAttributionExtensionPath(moduleUrl = import.meta.url, pathExists = existsSync) {
14
+ const modulePath = fileURLToPath(moduleUrl);
15
+ const extension = modulePath.endsWith('.ts')
16
+ ? 'anthropic-attribution-child.ts'
17
+ : 'anthropic-attribution-child.js';
18
+ const candidate = resolve(dirname(modulePath), '../../extensions', extension);
19
+ if (!pathExists(candidate)) {
20
+ throw new Error(`Anthropic attribution extension is missing: ${candidate}`);
21
+ }
22
+ return candidate;
23
+ }
24
+ //# sourceMappingURL=anthropic-attribution-path.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anthropic-attribution-path.js","sourceRoot":"","sources":["../../../src/core/anthropic-attribution-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,UAAU,wCAAwC,CACtD,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAC3B,aAAwC,UAAU;IAElD,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1C,CAAC,CAAC,gCAAgC;QAClC,CAAC,CAAC,gCAAgC,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;IAC9E,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,SAAS,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Resolve the package-owned always-on Anthropic child attribution extension.\n *\n * Package-owned child Pi processes disable ambient extension discovery, so they\n * must explicitly load this safety entrypoint. It deliberately bypasses the\n * independently selectable ambient parent capability. Keeping path resolution\n * in one module prevents Fusion, delegation, and attested runs from deriving\n * different package paths.\n */\nexport function resolveAnthropicAttributionExtensionPath(\n moduleUrl = import.meta.url,\n pathExists: (path: string) => boolean = existsSync,\n): string {\n const modulePath = fileURLToPath(moduleUrl);\n const extension = modulePath.endsWith('.ts')\n ? 'anthropic-attribution-child.ts'\n : 'anthropic-attribution-child.js';\n const candidate = resolve(dirname(modulePath), '../../extensions', extension);\n if (!pathExists(candidate)) {\n throw new Error(`Anthropic attribution extension is missing: ${candidate}`);\n }\n return candidate;\n}\n"]}