@hassangameryt/freeflow 0.7.3 → 0.9.0

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 (426) hide show
  1. package/.agents/plugins/marketplace.json +2 -2
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +2 -2
  4. package/.codex-plugin/plugin.json +3 -3
  5. package/.cursor-plugin/plugin.json +1 -1
  6. package/NOTICE +14 -0
  7. package/README.md +101 -159
  8. package/capabilities/cognitive-routing/SKILL.md +47 -210
  9. package/capabilities/cognitive-routing/references/coordinator.md +163 -0
  10. package/capabilities/cognitive-routing/references/worker.md +38 -0
  11. package/capabilities/compaction/SKILL.md +49 -0
  12. package/capabilities/compaction/references/summary-format.md +250 -0
  13. package/capabilities/messaging/SKILL.md +49 -0
  14. package/capabilities/task-memory/SKILL.md +87 -0
  15. package/command-surface.json +8 -52
  16. package/gemini-extension.json +1 -1
  17. package/hooks/claude/hooks.json +13 -3
  18. package/hooks/codex/hooks.json +2 -1
  19. package/hooks/shared/runtime-context.mjs +73 -83
  20. package/licenses/Apache-2.0.txt +55 -0
  21. package/package.json +42 -12
  22. package/pi-extension/README.md +41 -0
  23. package/pi-extension/dist/ask-user/ask.js +108 -0
  24. package/pi-extension/dist/ask-user/form.js +250 -0
  25. package/pi-extension/dist/ask-user/questions.js +66 -0
  26. package/pi-extension/dist/ask-user/tool.js +124 -0
  27. package/pi-extension/dist/cognitive-routing/assembler.js +417 -0
  28. package/pi-extension/dist/cognitive-routing/bootstrap.js +90 -0
  29. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/config.js +8 -6
  30. package/pi-extension/dist/cognitive-routing/economics.js +45 -0
  31. package/pi-extension/dist/cognitive-routing/event-schema.js +388 -0
  32. package/pi-extension/dist/{session-sources/events.js → cognitive-routing/event-store.js} +107 -41
  33. package/pi-extension/dist/cognitive-routing/gate.js +256 -0
  34. package/pi-extension/dist/cognitive-routing/handlers.js +901 -0
  35. package/pi-extension/dist/cognitive-routing/handoffs.js +350 -0
  36. package/pi-extension/dist/cognitive-routing/model-control.js +476 -0
  37. package/pi-extension/dist/cognitive-routing/projection.js +520 -0
  38. package/pi-extension/dist/cognitive-routing/provenance.js +83 -0
  39. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/render.js +15 -15
  40. package/pi-extension/dist/cognitive-routing/runtime.js +398 -0
  41. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/schemas.js +47 -11
  42. package/pi-extension/dist/cognitive-routing/session.js +223 -0
  43. package/pi-extension/dist/{session-sources → cognitive-routing}/sources.js +126 -87
  44. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/state.js +55 -386
  45. package/pi-extension/dist/cognitive-routing/status.js +81 -0
  46. package/pi-extension/dist/cognitive-routing/tools.js +74 -0
  47. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/types.js +14 -11
  48. package/pi-extension/dist/compaction/carry.js +205 -0
  49. package/pi-extension/dist/compaction/config.js +24 -0
  50. package/pi-extension/dist/compaction/controller.js +494 -0
  51. package/pi-extension/dist/compaction/harness.js +93 -0
  52. package/pi-extension/dist/compaction/results.js +159 -0
  53. package/pi-extension/dist/compaction/thresholds.js +35 -0
  54. package/pi-extension/dist/compaction/tool.js +57 -0
  55. package/pi-extension/dist/host/branch.js +13 -0
  56. package/pi-extension/dist/host/canonical.js +12 -0
  57. package/pi-extension/dist/host/catalog.js +62 -0
  58. package/pi-extension/dist/host/config-validation.js +233 -0
  59. package/pi-extension/dist/host/config.js +361 -0
  60. package/pi-extension/dist/host/inbound.js +142 -0
  61. package/pi-extension/dist/host/projection-tags.js +60 -0
  62. package/pi-extension/dist/host/prompts.js +93 -0
  63. package/pi-extension/dist/{session-sources → host}/read-only-session.js +117 -1
  64. package/pi-extension/dist/{runtime → host}/request-history.js +125 -39
  65. package/pi-extension/dist/host/rows.js +25 -0
  66. package/pi-extension/dist/host/runtime-state.js +204 -0
  67. package/pi-extension/dist/host/section-keeper.js +85 -0
  68. package/pi-extension/dist/host/settings/freeflow-command.js +2323 -0
  69. package/pi-extension/dist/{settings/settings-tui.js → host/settings/settings-view.js} +205 -73
  70. package/pi-extension/dist/host/staging.js +28 -0
  71. package/pi-extension/dist/host/status.js +115 -0
  72. package/pi-extension/dist/index.js +1004 -188
  73. package/pi-extension/dist/messaging/config.js +27 -0
  74. package/pi-extension/dist/messaging/messaging.js +398 -0
  75. package/pi-extension/dist/messaging/registry.js +57 -0
  76. package/pi-extension/dist/messaging/render.js +90 -0
  77. package/pi-extension/dist/messaging/tools.js +109 -0
  78. package/pi-extension/dist/messaging/transport.js +101 -0
  79. package/pi-extension/dist/provider-support/cache/anchor.js +21 -0
  80. package/pi-extension/dist/provider-support/cache/anthropic.js +102 -0
  81. package/pi-extension/dist/provider-support/cache/health.js +73 -0
  82. package/pi-extension/dist/provider-support/cache/index.js +58 -0
  83. package/pi-extension/dist/provider-support/cache/keepalive.js +222 -0
  84. package/pi-extension/dist/provider-support/cache/monitor.js +17 -0
  85. package/pi-extension/dist/provider-support/cache/openai-responses.js +48 -0
  86. package/pi-extension/dist/provider-support/effort.js +13 -0
  87. package/pi-extension/dist/provider-support/index.js +44 -3
  88. package/pi-extension/dist/provider-support/{astra → openai}/adapter.js +46 -29
  89. package/pi-extension/dist/provider-support/{astra → openai}/history.js +10 -8
  90. package/pi-extension/dist/provider-support/{astra → openai}/index.js +8 -4
  91. package/pi-extension/dist/provider-support/{astra → openai}/session-state.js +29 -38
  92. package/pi-extension/dist/provider-support/routes.js +17 -0
  93. package/pi-extension/dist/task-memory/config.js +49 -0
  94. package/pi-extension/dist/task-memory/registry.js +119 -0
  95. package/pi-extension/dist/task-memory/render.js +107 -0
  96. package/pi-extension/dist/task-memory/runtime.js +994 -0
  97. package/pi-extension/dist/task-memory/tool.js +233 -0
  98. package/pi-extension/dist/tool-execution/apply-patch/grammar.js +23 -0
  99. package/pi-extension/dist/tool-execution/apply-patch/match.js +38 -0
  100. package/pi-extension/dist/tool-execution/apply-patch/parser.js +177 -0
  101. package/pi-extension/dist/tool-execution/apply-patch/plan.js +201 -0
  102. package/pi-extension/dist/tool-execution/apply-patch/tool.js +84 -0
  103. package/pi-extension/dist/tool-execution/background.js +430 -0
  104. package/pi-extension/dist/tool-execution/bash-guard.js +23 -0
  105. package/pi-extension/dist/tool-execution/config.js +33 -0
  106. package/pi-extension/dist/tool-execution/edit-messages.js +120 -0
  107. package/pi-extension/dist/tool-execution/file-state.js +138 -0
  108. package/pi-extension/dist/tool-execution/file-tracking.js +163 -0
  109. package/pi-extension/dist/tool-execution/guidance-notices.js +124 -0
  110. package/pi-extension/dist/tool-execution/prompt.js +54 -0
  111. package/pi-extension/dist/tool-execution/skill-reads.js +143 -0
  112. package/pi-extension/dist/tool-execution/tools.js +16 -0
  113. package/pi-extension/freeflow/README.md +9 -0
  114. package/runtime/prompts/cognitive-routing.md +4 -4
  115. package/runtime/prompts/core.md +29 -72
  116. package/runtime/prompts/interaction-contract.md +18 -8
  117. package/runtime/prompts/tool-execution.md +25 -0
  118. package/runtime/prompts/working-method.md +25 -0
  119. package/skills/deliver-work/SKILL.md +76 -0
  120. package/skills/deliver-work/references/branch-closeout.md +134 -0
  121. package/skills/deliver-work/references/commit.md +83 -0
  122. package/skills/deliver-work/references/launch.md +94 -0
  123. package/skills/deliver-work/references/release.md +85 -0
  124. package/skills/deliver-work/scripts/commit-state.mjs +139 -0
  125. package/skills/deliver-work/scripts/delivery-state.mjs +107 -0
  126. package/skills/deliver-work/scripts/lib/git-state.mjs +178 -0
  127. package/skills/deliver-work/scripts/push-route.mjs +122 -0
  128. package/skills/deliver-work/scripts/release-preflight.mjs +177 -0
  129. package/skills/discuss-work/SKILL.md +148 -0
  130. package/skills/{discuss → discuss-work}/references/discussion-continuity.md +13 -50
  131. package/skills/discuss-work/references/learning-action.md +36 -0
  132. package/skills/discuss-work/scripts/choices.mjs +101 -0
  133. package/skills/discuss-work/scripts/lib/choices.mjs +159 -0
  134. package/skills/evaluate-behavior/SKILL.md +107 -0
  135. package/skills/evaluate-behavior/references/authoring.md +381 -0
  136. package/skills/evaluate-behavior/references/coding-tasks.md +145 -0
  137. package/skills/evaluate-behavior/references/conversations-pipelines-judges.md +177 -0
  138. package/skills/evaluate-behavior/references/design-and-measurement.md +273 -0
  139. package/skills/evaluate-behavior/references/running-and-evidence.md +245 -0
  140. package/skills/evaluate-behavior/scripts/claude-guard.mjs +76 -0
  141. package/skills/evaluate-behavior/scripts/guard-rules.mjs +309 -0
  142. package/skills/evaluate-behavior/scripts/lib/agreement.mjs +90 -0
  143. package/skills/evaluate-behavior/scripts/lib/arms.mjs +55 -0
  144. package/skills/evaluate-behavior/scripts/lib/budget.mjs +87 -0
  145. package/skills/evaluate-behavior/scripts/lib/build-source.mjs +287 -0
  146. package/skills/evaluate-behavior/scripts/lib/clear.mjs +74 -0
  147. package/skills/evaluate-behavior/scripts/lib/container.mjs +395 -0
  148. package/skills/evaluate-behavior/scripts/lib/decision.mjs +418 -0
  149. package/skills/evaluate-behavior/scripts/lib/definitions.mjs +1072 -0
  150. package/skills/evaluate-behavior/scripts/lib/freeflow.mjs +103 -0
  151. package/skills/evaluate-behavior/scripts/lib/grade-command.mjs +591 -0
  152. package/skills/evaluate-behavior/scripts/lib/grade-comparison.mjs +90 -0
  153. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/grade-interaction.mjs +19 -18
  154. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/grade-support.mjs +32 -5
  155. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/grade-workspace.mjs +28 -12
  156. package/skills/evaluate-behavior/scripts/lib/grade.mjs +101 -0
  157. package/skills/evaluate-behavior/scripts/lib/hooks.mjs +98 -0
  158. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/confinement.mjs +196 -0
  159. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/constraints.mjs +111 -0
  160. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/index.mjs +48 -0
  161. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/isolation.mjs +74 -0
  162. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/launch.mjs +123 -0
  163. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/model-call.mjs +73 -0
  164. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/recorder.mjs +178 -0
  165. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/session.mjs +494 -0
  166. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/skills.mjs +81 -0
  167. package/skills/evaluate-behavior/scripts/lib/hosts/index.mjs +31 -0
  168. package/skills/evaluate-behavior/scripts/lib/hosts/names.mjs +3 -0
  169. package/skills/evaluate-behavior/scripts/lib/hosts/pi/confinement.mjs +173 -0
  170. package/skills/evaluate-behavior/scripts/lib/hosts/pi/host.mjs +148 -0
  171. package/skills/evaluate-behavior/scripts/lib/hosts/pi/index.mjs +70 -0
  172. package/skills/evaluate-behavior/scripts/lib/hosts/pi/isolation.mjs +81 -0
  173. package/skills/evaluate-behavior/scripts/lib/hosts/pi/model-call.mjs +79 -0
  174. package/skills/evaluate-behavior/scripts/lib/hosts/pi/process.mjs +241 -0
  175. package/skills/{evaluate-skill/scripts/lib → evaluate-behavior/scripts/lib/hosts/pi}/rpc.mjs +144 -26
  176. package/skills/evaluate-behavior/scripts/lib/identity.mjs +82 -0
  177. package/skills/evaluate-behavior/scripts/lib/judge.mjs +688 -0
  178. package/skills/evaluate-behavior/scripts/lib/metrics.mjs +332 -0
  179. package/skills/evaluate-behavior/scripts/lib/model-call.mjs +17 -0
  180. package/skills/evaluate-behavior/scripts/lib/participants.mjs +616 -0
  181. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/process.mjs +22 -0
  182. package/skills/evaluate-behavior/scripts/lib/queue.mjs +54 -0
  183. package/skills/evaluate-behavior/scripts/lib/reference.mjs +343 -0
  184. package/skills/evaluate-behavior/scripts/lib/reuse.mjs +277 -0
  185. package/skills/evaluate-behavior/scripts/lib/review.mjs +933 -0
  186. package/skills/evaluate-behavior/scripts/lib/runner.mjs +732 -0
  187. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/sandbox.mjs +121 -14
  188. package/skills/evaluate-behavior/scripts/lib/scan-shell.mjs +457 -0
  189. package/skills/evaluate-behavior/scripts/lib/scan.mjs +479 -0
  190. package/skills/evaluate-behavior/scripts/lib/seal.mjs +91 -0
  191. package/skills/evaluate-behavior/scripts/lib/shell.mjs +560 -0
  192. package/skills/evaluate-behavior/scripts/lib/source-override.mjs +64 -0
  193. package/skills/evaluate-behavior/scripts/lib/subject-file.mjs +88 -0
  194. package/skills/{evaluate-skill/scripts/lib/pi.mjs → evaluate-behavior/scripts/lib/subject.mjs} +239 -262
  195. package/skills/evaluate-behavior/scripts/lib/task-copy.mjs +124 -0
  196. package/skills/evaluate-behavior/scripts/lib/trials.mjs +524 -0
  197. package/skills/evaluate-behavior/scripts/lib/validity.mjs +68 -0
  198. package/skills/evaluate-behavior/scripts/lib/view-html.mjs +454 -0
  199. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/view.mjs +218 -11
  200. package/skills/evaluate-behavior/scripts/pi-command-tool.mjs +159 -0
  201. package/skills/evaluate-behavior/scripts/pi-container-route.mjs +23 -0
  202. package/skills/evaluate-behavior/scripts/pi-guard.mjs +77 -0
  203. package/skills/evaluate-behavior/scripts/pi-login-refresh.mjs +31 -0
  204. package/skills/evaluate-behavior/scripts/skill-eval.mjs +586 -0
  205. package/skills/execute-work/SKILL.md +96 -72
  206. package/skills/execute-work/references/code-practices.md +27 -49
  207. package/skills/execute-work/references/design.md +271 -0
  208. package/skills/execute-work/references/diagnose.md +117 -0
  209. package/skills/execute-work/references/migration.md +108 -0
  210. package/skills/execute-work/references/simplify.md +65 -0
  211. package/skills/execute-work/scripts/self-review.mjs +422 -0
  212. package/skills/execute-work/scripts/touch-map.mjs +290 -0
  213. package/skills/review-work/SKILL.md +94 -64
  214. package/skills/review-work/references/adjudication.md +94 -0
  215. package/skills/review-work/references/artifact.md +198 -0
  216. package/skills/review-work/references/evals-and-judges.md +66 -0
  217. package/skills/review-work/references/work.md +177 -0
  218. package/skills/review-work/scripts/check-brief.mjs +128 -0
  219. package/skills/review-work/scripts/review-packet.mjs +233 -0
  220. package/skills/setup-freeflow/SKILL.md +69 -16
  221. package/skills/track-work/SKILL.md +135 -151
  222. package/skills/track-work/references/handoff.md +190 -0
  223. package/skills/track-work/references/projects.md +51 -0
  224. package/skills/track-work/references/working-record-format.md +201 -344
  225. package/skills/track-work/scripts/lib/document.mjs +79 -19
  226. package/skills/track-work/scripts/lib/format.mjs +18 -1
  227. package/skills/track-work/scripts/lib/recover.mjs +254 -0
  228. package/skills/track-work/scripts/lib/registry.mjs +656 -0
  229. package/skills/track-work/scripts/lib/search.mjs +40 -0
  230. package/skills/track-work/scripts/lib/store.mjs +53 -21
  231. package/skills/track-work/scripts/lib/transitions.mjs +79 -4
  232. package/skills/track-work/scripts/lib/views.mjs +50 -1
  233. package/skills/track-work/scripts/working-record.mjs +263 -22
  234. package/skills/verify-work/SKILL.md +64 -47
  235. package/skills/verify-work/references/feature-map.md +120 -0
  236. package/skills/verify-work/references/runtime-evidence.md +203 -0
  237. package/skills/verify-work/references/test-design.md +27 -6
  238. package/skills/verify-work/scripts/test-changes.mjs +246 -0
  239. package/skills/write-docs/SKILL.md +171 -0
  240. package/skills/write-docs/references/documentation-shapes.md +184 -0
  241. package/skills/write-docs/references/spec-and-plan-shapes.md +308 -0
  242. package/skills/write-docs/scripts/artifact-check.mjs +148 -0
  243. package/skills/write-docs/scripts/docs-check.mjs +229 -0
  244. package/skills/write-docs/scripts/plan-lint.mjs +123 -0
  245. package/skills/write-skill/SKILL.md +165 -165
  246. package/skills/write-skill/references/activation-and-wording.md +143 -0
  247. package/skills/write-skill/references/placement-and-dependencies.md +154 -0
  248. package/skills/write-skill/scripts/lib/compare.mjs +701 -0
  249. package/skills/write-skill/scripts/lib/similarity.mjs +56 -0
  250. package/skills/write-skill/scripts/lib/skill-author.mjs +197 -3
  251. package/skills/write-skill/scripts/skill-author.mjs +67 -8
  252. package/capabilities/context-virtualization/SKILL.md +0 -103
  253. package/capabilities/conversation-history/SKILL.md +0 -53
  254. package/hooks/tests/check-host-adapters.test.mjs +0 -82
  255. package/hooks/tests/check-runtime-context-hook.sh +0 -212
  256. package/pi-extension/dist/cognitive-routing-v2/projection.js +0 -330
  257. package/pi-extension/dist/cognitive-routing-v2/runtime.js +0 -2181
  258. package/pi-extension/dist/cognitive-routing-v2/tools.js +0 -60
  259. package/pi-extension/dist/context-virtualization/commands.js +0 -89
  260. package/pi-extension/dist/context-virtualization/projector.js +0 -42
  261. package/pi-extension/dist/context-virtualization/runtime.js +0 -378
  262. package/pi-extension/dist/context-virtualization/state.js +0 -57
  263. package/pi-extension/dist/context-virtualization/types.js +0 -10
  264. package/pi-extension/dist/conversation-history/passages.js +0 -66
  265. package/pi-extension/dist/conversation-history/ranking.js +0 -105
  266. package/pi-extension/dist/conversation-history/runtime.js +0 -226
  267. package/pi-extension/dist/conversation-history/search.js +0 -56
  268. package/pi-extension/dist/conversation-history/types.js +0 -1
  269. package/pi-extension/dist/freeflow-context/resolver.js +0 -120
  270. package/pi-extension/dist/freeflow-context/runtime.js +0 -80
  271. package/pi-extension/dist/freeflow-context/source-projector.js +0 -95
  272. package/pi-extension/dist/freeflow-context/tool.js +0 -314
  273. package/pi-extension/dist/freeflow-context/types.js +0 -12
  274. package/pi-extension/dist/freeflow-context/visibility.js +0 -28
  275. package/pi-extension/dist/integrations/mcp-config.js +0 -29
  276. package/pi-extension/dist/runtime/runtime-context.js +0 -754
  277. package/pi-extension/dist/runtime/runtime-identity.js +0 -5
  278. package/pi-extension/dist/session-sources/provenance.js +0 -32
  279. package/pi-extension/dist/settings/settings-ui.js +0 -1360
  280. package/pi-extension/dist/ui/text-component.js +0 -57
  281. package/pi-extension/src/cognitive-routing-v2/budget.ts +0 -42
  282. package/pi-extension/src/cognitive-routing-v2/config.ts +0 -173
  283. package/pi-extension/src/cognitive-routing-v2/projection.ts +0 -375
  284. package/pi-extension/src/cognitive-routing-v2/render.ts +0 -277
  285. package/pi-extension/src/cognitive-routing-v2/runtime.ts +0 -2241
  286. package/pi-extension/src/cognitive-routing-v2/schemas.ts +0 -180
  287. package/pi-extension/src/cognitive-routing-v2/state.ts +0 -839
  288. package/pi-extension/src/cognitive-routing-v2/tools.ts +0 -62
  289. package/pi-extension/src/cognitive-routing-v2/types.ts +0 -254
  290. package/pi-extension/src/context-virtualization/commands.ts +0 -111
  291. package/pi-extension/src/context-virtualization/projector.ts +0 -62
  292. package/pi-extension/src/context-virtualization/runtime.ts +0 -428
  293. package/pi-extension/src/context-virtualization/state.ts +0 -79
  294. package/pi-extension/src/context-virtualization/types.ts +0 -92
  295. package/pi-extension/src/conversation-history/passages.ts +0 -81
  296. package/pi-extension/src/conversation-history/ranking.ts +0 -155
  297. package/pi-extension/src/conversation-history/runtime.ts +0 -250
  298. package/pi-extension/src/conversation-history/search.ts +0 -79
  299. package/pi-extension/src/conversation-history/types.ts +0 -31
  300. package/pi-extension/src/freeflow-context/resolver.ts +0 -139
  301. package/pi-extension/src/freeflow-context/runtime.ts +0 -100
  302. package/pi-extension/src/freeflow-context/source-projector.ts +0 -106
  303. package/pi-extension/src/freeflow-context/tool.ts +0 -366
  304. package/pi-extension/src/freeflow-context/types.ts +0 -70
  305. package/pi-extension/src/freeflow-context/visibility.ts +0 -53
  306. package/pi-extension/src/index.ts +0 -390
  307. package/pi-extension/src/integrations/mcp-config.ts +0 -32
  308. package/pi-extension/src/provider-support/astra/adapter.ts +0 -108
  309. package/pi-extension/src/provider-support/astra/history.ts +0 -145
  310. package/pi-extension/src/provider-support/astra/index.ts +0 -12
  311. package/pi-extension/src/provider-support/astra/session-state.ts +0 -113
  312. package/pi-extension/src/provider-support/index.ts +0 -5
  313. package/pi-extension/src/runtime/request-history.ts +0 -243
  314. package/pi-extension/src/runtime/runtime-context.ts +0 -860
  315. package/pi-extension/src/runtime/runtime-identity.ts +0 -8
  316. package/pi-extension/src/session-sources/events.ts +0 -230
  317. package/pi-extension/src/session-sources/provenance.ts +0 -39
  318. package/pi-extension/src/session-sources/read-only-session.ts +0 -170
  319. package/pi-extension/src/session-sources/sources.ts +0 -334
  320. package/pi-extension/src/settings/settings-tui.ts +0 -501
  321. package/pi-extension/src/settings/settings-ui.ts +0 -1652
  322. package/pi-extension/src/ui/text-component.ts +0 -66
  323. package/pi-extension/tests/cache-reuse/history.test.js +0 -117
  324. package/pi-extension/tests/cache-reuse/native.test.js +0 -91
  325. package/pi-extension/tests/cache-reuse/settings.test.js +0 -211
  326. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +0 -577
  327. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +0 -183
  328. package/pi-extension/tests/cognitive-routing-v2/delegation.test.js +0 -557
  329. package/pi-extension/tests/cognitive-routing-v2/native.test.js +0 -474
  330. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +0 -87
  331. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +0 -300
  332. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +0 -241
  333. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +0 -1034
  334. package/pi-extension/tests/cognitive-routing-v2/render.test.js +0 -244
  335. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +0 -423
  336. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +0 -521
  337. package/pi-extension/tests/cognitive-routing-v2/state.test.js +0 -586
  338. package/pi-extension/tests/context-virtualization/extension.test.js +0 -775
  339. package/pi-extension/tests/context-virtualization/projector.test.js +0 -110
  340. package/pi-extension/tests/context-virtualization/runtime.test.js +0 -230
  341. package/pi-extension/tests/conversation-history/runtime.test.js +0 -98
  342. package/pi-extension/tests/conversation-history/search.test.js +0 -97
  343. package/pi-extension/tests/fixtures/pi-host.js +0 -4
  344. package/pi-extension/tests/fixtures/routing-native.js +0 -191
  345. package/pi-extension/tests/integration/mode-free-core.test.js +0 -220
  346. package/pi-extension/tests/integration/pi-extension.test.js +0 -1447
  347. package/pi-extension/tests/integration/prompt-architecture.test.js +0 -447
  348. package/pi-extension/tests/integration/unaffected-regressions.test.js +0 -478
  349. package/pi-extension/tests/provider-support/astra-boundaries.test.js +0 -75
  350. package/pi-extension/tests/provider-support/astra.test.js +0 -306
  351. package/pi-extension/tests/provider-support/cli.test.js +0 -92
  352. package/pi-extension/tests/provider-support/native.test.js +0 -183
  353. package/pi-extension/tests/settings/settings-tui.test.js +0 -243
  354. package/pi-extension/tsconfig.json +0 -16
  355. package/plugin.json +0 -33
  356. package/runtime/prompts/context-virtualization.md +0 -3
  357. package/runtime/prompts/conversation-history.md +0 -3
  358. package/skills/action-selection/SKILL.md +0 -100
  359. package/skills/action-selection/references/trajectory-stalls.md +0 -71
  360. package/skills/bypass/SKILL.md +0 -153
  361. package/skills/commit-work/SKILL.md +0 -145
  362. package/skills/commit-work/references/git-state-edges.md +0 -94
  363. package/skills/commit-work/references/simple-push.md +0 -92
  364. package/skills/commit-work/references/staging-decisions.md +0 -106
  365. package/skills/decision-gate/SKILL.md +0 -106
  366. package/skills/design-for-depth/SKILL.md +0 -117
  367. package/skills/design-for-depth/references/design-pressure-signals.md +0 -182
  368. package/skills/design-for-depth/references/implementation-decisions.md +0 -76
  369. package/skills/design-for-depth/references/interface-design-loop.md +0 -136
  370. package/skills/design-for-depth/references/module-and-dependency-design.md +0 -147
  371. package/skills/design-for-depth/references/software-design-philosophy.md +0 -202
  372. package/skills/design-for-depth/references/state-and-failure-boundaries.md +0 -136
  373. package/skills/diagnose-failure/SKILL.md +0 -125
  374. package/skills/diagnose-failure/references/diagnostic-loop-catalog.md +0 -48
  375. package/skills/diagnose-failure/references/flaky-and-performance-diagnosis.md +0 -51
  376. package/skills/discuss/SKILL.md +0 -116
  377. package/skills/evaluate-skill/SKILL.md +0 -219
  378. package/skills/evaluate-skill/references/evaluation-definition-schema.md +0 -385
  379. package/skills/evaluate-skill/references/evaluation-design.md +0 -112
  380. package/skills/evaluate-skill/references/execution-and-evidence.md +0 -90
  381. package/skills/evaluate-skill/references/review-and-revision.md +0 -92
  382. package/skills/evaluate-skill/scripts/lib/definitions.mjs +0 -407
  383. package/skills/evaluate-skill/scripts/lib/grade-comparison.mjs +0 -60
  384. package/skills/evaluate-skill/scripts/lib/grade.mjs +0 -64
  385. package/skills/evaluate-skill/scripts/lib/runner.mjs +0 -368
  386. package/skills/evaluate-skill/scripts/pi-guard.mjs +0 -164
  387. package/skills/evaluate-skill/scripts/skill-eval.mjs +0 -102
  388. package/skills/execute-work/references/execute-work-edges.md +0 -68
  389. package/skills/finish-branch/SKILL.md +0 -117
  390. package/skills/finish-branch/references/integration-options.md +0 -80
  391. package/skills/handoff/SKILL.md +0 -82
  392. package/skills/handoff/references/handoff-templates.md +0 -150
  393. package/skills/launch-work/SKILL.md +0 -116
  394. package/skills/launch-work/references/launch-readiness.md +0 -85
  395. package/skills/migration-work/SKILL.md +0 -115
  396. package/skills/migration-work/references/migration-lifecycle.md +0 -82
  397. package/skills/release-work/SKILL.md +0 -118
  398. package/skills/release-work/references/release-evidence.md +0 -78
  399. package/skills/review-artifact/SKILL.md +0 -142
  400. package/skills/review-artifact/references/adjudicate-artifact-review.md +0 -101
  401. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +0 -159
  402. package/skills/review-work/references/adjudicate-work-review.md +0 -97
  403. package/skills/review-work/references/independent-work-reviewer-contract.md +0 -139
  404. package/skills/review-work/references/security-risk-lens.md +0 -69
  405. package/skills/setup-freeflow/references/activation-contract.md +0 -109
  406. package/skills/setup-freeflow/references/host-setup.md +0 -67
  407. package/skills/simplify-code/SKILL.md +0 -85
  408. package/skills/simplify-code/references/simplification-patterns.md +0 -70
  409. package/skills/verify-work/references/browser-runtime-evidence.md +0 -55
  410. package/skills/verify-work/references/integration-evidence.md +0 -47
  411. package/skills/verify-work/references/performance-evidence.md +0 -57
  412. package/skills/workflow/SKILL.md +0 -127
  413. package/skills/workflow/references/domain-skill-composition.md +0 -43
  414. package/skills/write-plan/SKILL.md +0 -92
  415. package/skills/write-plan/references/plan-shapes.md +0 -156
  416. package/skills/write-skill/references/activation-boundaries.md +0 -104
  417. package/skills/write-skill/references/agent-first-instructions.md +0 -121
  418. package/skills/write-skill/references/progressive-disclosure.md +0 -127
  419. package/skills/write-skill/references/skill-dependency-graphs.md +0 -190
  420. package/skills/write-spec/SKILL.md +0 -92
  421. package/skills/write-spec/references/artifact-standards.md +0 -86
  422. package/skills/write-spec/references/decision-records.md +0 -78
  423. package/skills/write-spec/references/spec-shapes.md +0 -143
  424. /package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/budget.js +0 -0
  425. /package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/evidence.mjs +0 -0
  426. /package/skills/{evaluate-skill → evaluate-behavior}/scripts/pi-observer.mjs +0 -0
@@ -1,66 +0,0 @@
1
- export const PASSAGE_TARGET_CHARACTERS = 2_000;
2
- export const PASSAGE_OVERLAP_CHARACTERS = 200;
3
- export const SNIPPET_MAX_CHARACTERS = 400;
4
- export function normalizeText(value) {
5
- return value.normalize("NFKC").toLocaleLowerCase().replace(/\s+/g, " ").trim();
6
- }
7
- export function tokenize(value) {
8
- return normalizeText(value).match(/[\p{L}\p{N}_]+(?:[./:@#$%+-][\p{L}\p{N}_]+)*/gu) ?? [];
9
- }
10
- export function unique(values) {
11
- return [...new Set(values)];
12
- }
13
- export function throwIfAborted(signal) {
14
- if (!signal?.aborted) return;
15
- const error = new Error("conversation_history_search_cancelled");
16
- error.name = "AbortError";
17
- throw error;
18
- }
19
- function passageEnd(text, start) {
20
- const target = Math.min(text.length, start + PASSAGE_TARGET_CHARACTERS);
21
- if (target === text.length) return target;
22
- const paragraphBreak = text.lastIndexOf("\n\n", target);
23
- if (paragraphBreak > start + PASSAGE_TARGET_CHARACTERS / 2) return paragraphBreak + 2;
24
- const lineBreak = text.lastIndexOf("\n", target);
25
- if (lineBreak > start + PASSAGE_TARGET_CHARACTERS / 2) return lineBreak + 1;
26
- return target;
27
- }
28
- export function splitTextIntoPassages(text, signal) {
29
- throwIfAborted(signal);
30
- if (text.length <= PASSAGE_TARGET_CHARACTERS) {
31
- return [{ text, start: 0, end: text.length, tokens: tokenize(text), length: Math.max(1, tokenize(text).length) }];
32
- }
33
- const result = [];
34
- let start = 0;
35
- while (start < text.length) {
36
- throwIfAborted(signal);
37
- const end = passageEnd(text, start);
38
- const passageText = text.slice(start, end);
39
- const tokens = tokenize(passageText);
40
- result.push({ text: passageText, start, end, tokens, length: Math.max(1, tokens.length) });
41
- if (end >= text.length) break;
42
- start = Math.max(start + 1, end - PASSAGE_OVERLAP_CHARACTERS);
43
- }
44
- return result;
45
- }
46
- export function snippet(text, phrase, terms) {
47
- if (text.length <= SNIPPET_MAX_CHARACTERS) return text;
48
- const lower = text.toLocaleLowerCase();
49
- const phraseIndex = phrase ? lower.indexOf(phrase) : -1;
50
- const termIndex =
51
- phraseIndex >= 0
52
- ? phraseIndex
53
- : terms.reduce((best, term) => {
54
- const index = lower.indexOf(term);
55
- return index >= 0 && (best < 0 || index < best) ? index : best;
56
- }, -1);
57
- const center = termIndex >= 0 ? termIndex : 0;
58
- let start = Math.max(0, center - Math.floor(SNIPPET_MAX_CHARACTERS / 3));
59
- const end = Math.min(text.length, start + SNIPPET_MAX_CHARACTERS);
60
- if (end - start < SNIPPET_MAX_CHARACTERS) start = Math.max(0, end - SNIPPET_MAX_CHARACTERS);
61
- const prefix = start > 0 ? "…" : "";
62
- const suffix = end < text.length ? "…" : "";
63
- const available = SNIPPET_MAX_CHARACTERS - prefix.length - suffix.length;
64
- const body = text.slice(start, start + available);
65
- return `${prefix}${body}${suffix}`;
66
- }
@@ -1,105 +0,0 @@
1
- import { normalizeText, splitTextIntoPassages, throwIfAborted, tokenize, unique } from "./passages.js";
2
- export const BM25_K1 = 1.2;
3
- export const BM25_B = 0.75;
4
- function bm25Score(tokens, terms, documentFrequency, documentCount, averageLength) {
5
- const counts = new Map();
6
- for (const token of tokens) counts.set(token, (counts.get(token) ?? 0) + 1);
7
- const length = Math.max(1, tokens.length);
8
- let score = 0;
9
- for (const term of terms) {
10
- const termFrequency = counts.get(term) ?? 0;
11
- if (termFrequency === 0) continue;
12
- const df = documentFrequency.get(term) ?? 0;
13
- const inverseDocumentFrequency = Math.log(1 + (documentCount - df + 0.5) / (df + 0.5));
14
- const normalization = BM25_K1 * (1 - BM25_B + BM25_B * (length / Math.max(1, averageLength)));
15
- score += inverseDocumentFrequency * ((termFrequency * (BM25_K1 + 1)) / (termFrequency + normalization));
16
- }
17
- return score;
18
- }
19
- function comparePassages(left, right) {
20
- if (left.exactPhrase !== right.exactPhrase) return left.exactPhrase ? -1 : 1;
21
- if (left.score !== right.score) return right.score - left.score;
22
- if (left.matchedTerms.length !== right.matchedTerms.length) {
23
- return right.matchedTerms.length - left.matchedTerms.length;
24
- }
25
- if (left.entry.position !== right.entry.position) return right.entry.position - left.entry.position;
26
- return left.passage.start - right.passage.start;
27
- }
28
- function compareTextPassages(left, right) {
29
- if (left.exactPhrase !== right.exactPhrase) return left.exactPhrase ? -1 : 1;
30
- if (left.score !== right.score) return right.score - left.score;
31
- if (left.matchedTerms.length !== right.matchedTerms.length) {
32
- return right.matchedTerms.length - left.matchedTerms.length;
33
- }
34
- return left.passage.start - right.passage.start;
35
- }
36
- function rankInputs(inputs, terms, signal) {
37
- const documentFrequency = new Map();
38
- for (const input of inputs) {
39
- throwIfAborted(signal);
40
- for (const term of unique(input.passage.tokens)) {
41
- documentFrequency.set(term, (documentFrequency.get(term) ?? 0) + 1);
42
- }
43
- }
44
- const averageLength =
45
- inputs.length === 0 ? 1 : inputs.reduce((total, input) => total + input.passage.length, 0) / inputs.length;
46
- const matching = [];
47
- for (const input of inputs) {
48
- throwIfAborted(signal);
49
- if (input.matchedTerms.length > 0 || input.exactPhrase) matching.push(input);
50
- }
51
- return matching
52
- .map((input) => ({
53
- ...input,
54
- score: bm25Score(input.passage.tokens, terms, documentFrequency, inputs.length, averageLength),
55
- }))
56
- .sort((left, right) => {
57
- if (left.entry && right.entry) {
58
- return comparePassages({ ...left, entry: left.entry }, { ...right, entry: right.entry });
59
- }
60
- return compareTextPassages(left, right);
61
- });
62
- }
63
- export function rankMatchingPassages(entries, query, signal) {
64
- throwIfAborted(signal);
65
- const normalizedQuery = normalizeText(query);
66
- const terms = unique(tokenize(query));
67
- if (!normalizedQuery || terms.length === 0) return [];
68
- const inputs = [];
69
- for (const entry of entries) {
70
- throwIfAborted(signal);
71
- for (const passage of splitTextIntoPassages(entry.text, signal)) {
72
- const normalizedPassage = normalizeText(passage.text);
73
- inputs.push({
74
- entry,
75
- passage,
76
- exactPhrase: normalizedPassage.includes(normalizedQuery),
77
- matchedTerms: terms.filter((term) => passage.tokens.includes(term)),
78
- });
79
- }
80
- }
81
- return rankInputs(inputs, terms, signal);
82
- }
83
- export function strongestTextPassage(text, query) {
84
- const normalizedQuery = normalizeText(query);
85
- const terms = unique(tokenize(query));
86
- if (!normalizedQuery || terms.length === 0) return undefined;
87
- const inputs = splitTextIntoPassages(text).map((passage) => ({
88
- passage,
89
- exactPhrase: normalizeText(passage.text).includes(normalizedQuery),
90
- matchedTerms: terms.filter((term) => passage.tokens.includes(term)),
91
- }));
92
- return rankInputs(inputs, terms)[0];
93
- }
94
- export function focusedWindow(text, focus, maxCharacters) {
95
- const strongest = strongestTextPassage(text, focus);
96
- if (!strongest) return undefined;
97
- const center = Math.floor((strongest.passage.start + strongest.passage.end) / 2);
98
- const proposedStart = Math.max(0, Math.min(center - Math.floor(maxCharacters / 2), text.length - maxCharacters));
99
- const previousLineBreak = proposedStart > 0 ? text.lastIndexOf("\n", proposedStart - 1) : -1;
100
- const start = previousLineBreak >= 0 ? previousLineBreak + 1 : proposedStart;
101
- const proposedEnd = Math.min(text.length, start + maxCharacters);
102
- const previousEndLineBreak = proposedEnd < text.length ? text.lastIndexOf("\n", proposedEnd) : -1;
103
- const end = previousEndLineBreak > start ? previousEndLineBreak + 1 : proposedEnd;
104
- return text.slice(start, end);
105
- }
@@ -1,226 +0,0 @@
1
- import { FreeflowContextRuntime } from "../freeflow-context/runtime.js";
2
- import { contextRefForEntry, entryIdFromContextRef } from "../freeflow-context/types.js";
3
- import { focusedWindow } from "./ranking.js";
4
- import { searchConversationEntries } from "./search.js";
5
- import { tokenize, unique } from "./passages.js";
6
- const MAX_QUERY_CHARACTERS = 500;
7
- const MAX_QUERY_TERMS = 32;
8
- const MAX_TOOL_NAMES = 8;
9
- const MAX_TOOL_NAME_CHARACTERS = 128;
10
- const MAX_REF_CHARACTERS = 256;
11
- const MAX_FOCUS_CHARACTERS = 500;
12
- const MAX_RETRIEVE_REFS = 3;
13
- const MAX_SOURCE_CHARACTERS = 8_000;
14
- const MAX_TOTAL_RETRIEVED_CHARACTERS = 24_000;
15
- const VALID_KINDS = new Set(["user", "assistant", "toolResult", "summary"]);
16
- function normalizedTerms(value) {
17
- return unique(tokenize(value));
18
- }
19
- function failure(operation, reason, message) {
20
- return {
21
- status: "rejected",
22
- operation,
23
- reason: reason.slice(0, 64),
24
- ...(message ? { message: message.slice(0, 500) } : {}),
25
- };
26
- }
27
- function unavailable(operation, reason = "conversation_history_unavailable") {
28
- return { status: "unavailable", operation, reason: reason.slice(0, 64) };
29
- }
30
- function sourceMetadata(source) {
31
- return {
32
- ref: source.ref,
33
- kind: source.kind,
34
- ...(source.toolNames
35
- ? {
36
- toolNames: source.toolNames.slice(0, MAX_TOOL_NAMES),
37
- ...(source.toolNames.length > MAX_TOOL_NAMES ? { toolNamesTruncated: true } : {}),
38
- }
39
- : {}),
40
- ...(source.isError === undefined ? {} : { isError: source.isError }),
41
- timestamp: source.timestamp.slice(0, 64),
42
- };
43
- }
44
- export class ConversationHistoryRuntime {
45
- ctx;
46
- freeflowContext;
47
- isSourceFullyProjected;
48
- snapshot;
49
- available = true;
50
- unavailableReason;
51
- constructor(ctx, isSourceFullyProjected = () => true, freeflowContext = new FreeflowContextRuntime(ctx)) {
52
- this.ctx = ctx;
53
- this.isSourceFullyProjected = isSourceFullyProjected;
54
- this.freeflowContext = freeflowContext;
55
- }
56
- setContext(ctx) {
57
- this.ctx = ctx;
58
- this.freeflowContext.setContext(ctx);
59
- }
60
- capture(contextVirtualizationEnabled = false) {
61
- try {
62
- this.freeflowContext.setContext(this.ctx);
63
- this.snapshot = this.freeflowContext.captureSnapshot({
64
- contextVirtualizationEnabled,
65
- isSourceFullyProjected: this.isSourceFullyProjected,
66
- });
67
- this.available = true;
68
- this.unavailableReason = undefined;
69
- return true;
70
- } catch (error) {
71
- this.snapshot = undefined;
72
- this.available = false;
73
- this.unavailableReason = error instanceof Error ? error.message : String(error);
74
- return false;
75
- }
76
- }
77
- async search(params, signal) {
78
- if (signal?.aborted) return unavailable("search", "conversation_history_search_cancelled");
79
- if (!this.available || !this.snapshot) return unavailable("search", this.unavailableReason);
80
- const validation = this.validateSearch(params);
81
- if (validation) return validation;
82
- const query = params.query.trim();
83
- const hidden = [...this.snapshot.entries.values()].filter(
84
- (entry) =>
85
- !this.snapshot?.visibleSourceIds.has(entry.source.source.entryId) &&
86
- !this.snapshot?.materializedSourceIds.has(entry.source.source.entryId),
87
- );
88
- if (hidden.length === 0) {
89
- if (this.snapshot.skippedEntries === 0) return failure("search", "no_hidden_conversation_history");
90
- return {
91
- status: "ok",
92
- operation: "search",
93
- query,
94
- coverage: "partial",
95
- skippedEntries: this.snapshot.skippedEntries,
96
- returned: 0,
97
- truncated: false,
98
- hits: [],
99
- };
100
- }
101
- let result;
102
- try {
103
- result = searchConversationEntries(
104
- hidden,
105
- {
106
- query,
107
- kinds: params.kinds,
108
- toolNames: Array.isArray(params.toolNames)
109
- ? params.toolNames.map((name) => (typeof name === "string" ? name.trim() : ""))
110
- : undefined,
111
- limit: params.limit,
112
- },
113
- signal,
114
- );
115
- } catch (error) {
116
- if (signal?.aborted || (error instanceof Error && error.name === "AbortError")) {
117
- return unavailable("search", "conversation_history_search_cancelled");
118
- }
119
- return unavailable("search");
120
- }
121
- return {
122
- status: "ok",
123
- operation: "search",
124
- query,
125
- coverage: this.snapshot.skippedEntries > 0 ? "partial" : "complete",
126
- ...(this.snapshot.skippedEntries > 0 ? { skippedEntries: this.snapshot.skippedEntries } : {}),
127
- returned: result.returned,
128
- truncated: result.truncated,
129
- hits: result.hits,
130
- };
131
- }
132
- async retrieve(params, signal) {
133
- if (signal?.aborted) return unavailable("retrieve", "conversation_history_retrieve_cancelled");
134
- if (!this.available || !this.snapshot) return unavailable("retrieve", this.unavailableReason);
135
- const refs = params.refs;
136
- if (!Array.isArray(refs) || refs.length < 1 || refs.length > MAX_RETRIEVE_REFS) {
137
- return failure("retrieve", "refs_count_invalid");
138
- }
139
- if (refs.some((ref) => typeof ref !== "string" || ref.length > MAX_REF_CHARACTERS)) {
140
- return failure("retrieve", "ref_invalid");
141
- }
142
- const canonicalRefs = refs.map((ref) => {
143
- const entryId = entryIdFromContextRef(ref);
144
- return entryId ? contextRefForEntry(entryId) : undefined;
145
- });
146
- if (canonicalRefs.some((ref) => ref === undefined)) return failure("retrieve", "ref_invalid");
147
- const uniqueRefs = canonicalRefs;
148
- if (new Set(uniqueRefs).size !== uniqueRefs.length) return failure("retrieve", "duplicate_ref");
149
- const focus = params.focus;
150
- if (
151
- focus !== undefined &&
152
- (typeof focus !== "string" || focus.trim().length === 0 || focus.length > MAX_FOCUS_CHARACTERS)
153
- ) {
154
- return failure("retrieve", "focus_invalid");
155
- }
156
- const items = [];
157
- let total = 0;
158
- for (const ref of uniqueRefs) {
159
- if (signal?.aborted) return unavailable("retrieve", "conversation_history_retrieve_cancelled");
160
- const entryId = entryIdFromContextRef(ref);
161
- const source = entryId ? this.snapshot.entries.get(contextRefForEntry(entryId)) : undefined;
162
- if (!source) return failure("retrieve", "reference_unresolved");
163
- if (this.snapshot.visibleSourceIds.has(entryId) || this.snapshot.materializedSourceIds.has(entryId)) {
164
- return failure("retrieve", "source_visible");
165
- }
166
- const sourceCharacters = source.text.length;
167
- let content = source.text;
168
- let completeness = "complete";
169
- if (sourceCharacters > MAX_SOURCE_CHARACTERS) {
170
- if (typeof focus !== "string") return failure("retrieve", "focus_required_for_oversized_source");
171
- const focused = focusedWindow(source.text, focus.trim(), MAX_SOURCE_CHARACTERS);
172
- if (focused === undefined) return failure("retrieve", "focus_no_match");
173
- content = focused;
174
- completeness = "partial";
175
- }
176
- if (total + content.length > MAX_TOTAL_RETRIEVED_CHARACTERS)
177
- return failure("retrieve", "retrieval_budget_exceeded");
178
- total += content.length;
179
- items.push({
180
- ...sourceMetadata(source),
181
- content,
182
- completeness,
183
- sourceCharacters,
184
- returnedCharacters: content.length,
185
- });
186
- }
187
- return {
188
- status: "ok",
189
- operation: "retrieve",
190
- ...(typeof focus === "string" ? { focus: focus.trim() } : {}),
191
- items,
192
- };
193
- }
194
- validateSearch(params) {
195
- if (typeof params.query !== "string" || params.query.trim().length === 0)
196
- return failure("search", "query_required");
197
- if (params.query.length > MAX_QUERY_CHARACTERS) return failure("search", "query_too_long");
198
- if (normalizedTerms(params.query).length > MAX_QUERY_TERMS) return failure("search", "query_terms_too_many");
199
- if (params.kinds !== undefined) {
200
- if (!Array.isArray(params.kinds) || params.kinds.length < 1 || params.kinds.length > 4)
201
- return failure("search", "kinds_invalid");
202
- if (
203
- new Set(params.kinds).size !== params.kinds.length ||
204
- params.kinds.some((kind) => typeof kind !== "string" || !VALID_KINDS.has(kind))
205
- ) {
206
- return failure("search", "kinds_invalid");
207
- }
208
- }
209
- if (params.toolNames !== undefined) {
210
- if (!Array.isArray(params.toolNames) || params.toolNames.length < 1 || params.toolNames.length > MAX_TOOL_NAMES)
211
- return failure("search", "tool_names_invalid");
212
- const normalizedNames = params.toolNames.map((name) => (typeof name === "string" ? name.trim() : ""));
213
- if (
214
- params.toolNames.some((name) => typeof name !== "string") ||
215
- new Set(normalizedNames.map((name) => name.toLocaleLowerCase())).size !== normalizedNames.length ||
216
- normalizedNames.some((name) => name.length === 0 || name.length > MAX_TOOL_NAME_CHARACTERS)
217
- ) {
218
- return failure("search", "tool_names_invalid");
219
- }
220
- }
221
- if (params.limit !== undefined && (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 20)) {
222
- return failure("search", "limit_invalid");
223
- }
224
- return undefined;
225
- }
226
- }
@@ -1,56 +0,0 @@
1
- import { normalizeText, snippet, throwIfAborted, tokenize, unique } from "./passages.js";
2
- import { rankMatchingPassages } from "./ranking.js";
3
- const MAX_DISPLAYED_TOOL_NAMES = 8;
4
- function matchesFilters(entry, options) {
5
- if (options.kinds && !options.kinds.includes(entry.kind)) return false;
6
- if (options.toolNames) {
7
- const names = new Set((entry.toolNames ?? []).map((name) => name.toLocaleLowerCase()));
8
- if (!options.toolNames.some((name) => names.has(name.toLocaleLowerCase()))) return false;
9
- }
10
- return true;
11
- }
12
- export function searchConversationEntries(entries, options, signal) {
13
- throwIfAborted(signal);
14
- const normalizedQuery = normalizeText(options.query);
15
- const terms = unique(tokenize(options.query));
16
- const limit = Math.min(20, Math.max(1, Math.trunc(options.limit ?? 8)));
17
- if (!normalizedQuery || terms.length === 0) return { returned: 0, truncated: false, hits: [] };
18
- const candidates = entries.filter((entry) => matchesFilters(entry, options));
19
- const rankedPassages = rankMatchingPassages(candidates, options.query, signal);
20
- const byEntry = new Map();
21
- for (const passage of rankedPassages) {
22
- throwIfAborted(signal);
23
- if (!byEntry.has(passage.entry.ref)) byEntry.set(passage.entry.ref, passage);
24
- }
25
- const ranked = [...byEntry.values()];
26
- const hits = ranked.slice(0, limit).map((passage) => {
27
- const matchType = passage.exactPhrase
28
- ? "exact-phrase"
29
- : passage.matchedTerms.length === terms.length
30
- ? "all-terms"
31
- : "partial-terms";
32
- return {
33
- ref: passage.entry.ref,
34
- kind: passage.entry.kind,
35
- ...(passage.entry.toolNames
36
- ? {
37
- toolNames: passage.entry.toolNames.slice(0, MAX_DISPLAYED_TOOL_NAMES),
38
- ...(passage.entry.toolNames.length > MAX_DISPLAYED_TOOL_NAMES ? { toolNamesTruncated: true } : {}),
39
- }
40
- : {}),
41
- ...(passage.entry.isError === undefined ? {} : { isError: passage.entry.isError }),
42
- timestamp: passage.entry.timestamp.slice(0, 64),
43
- snippet: snippet(passage.passage.text, normalizedQuery, terms),
44
- match: {
45
- type: matchType,
46
- matchedTerms: passage.matchedTerms,
47
- queryTermCount: terms.length,
48
- },
49
- };
50
- });
51
- return {
52
- returned: hits.length,
53
- truncated: ranked.length > limit,
54
- hits,
55
- };
56
- }
@@ -1 +0,0 @@
1
- export {};
@@ -1,120 +0,0 @@
1
- import { entryIdFromContextRef } from "./types.js";
2
- export function isToolResultEntry(entry) {
3
- return entry?.type === "message" && entry?.message?.role === "toolResult";
4
- }
5
- export class ContextSourceResolver {
6
- ctx;
7
- constructor(ctx) {
8
- this.ctx = ctx;
9
- }
10
- setContext(ctx) {
11
- this.ctx = ctx;
12
- }
13
- sessionId() {
14
- const value = this.ctx?.sessionManager?.getSessionId?.() ?? this.ctx?.sessionId ?? this.ctx?.cwd ?? "current";
15
- return String(value);
16
- }
17
- branchLeafId() {
18
- try {
19
- return this.ctx?.sessionManager?.getLeafId?.();
20
- } catch {
21
- return undefined;
22
- }
23
- }
24
- branchEntries() {
25
- const entries = this.ctx?.sessionManager?.getBranch?.() ?? this.ctx?.sessionManager?.getEntries?.() ?? [];
26
- return Array.isArray(entries) ? entries : [];
27
- }
28
- activeContextEntries() {
29
- try {
30
- const entries = this.ctx?.sessionManager?.buildContextEntries?.() ?? this.branchEntries();
31
- return Array.isArray(entries) ? entries : [];
32
- } catch {
33
- return this.branchEntries();
34
- }
35
- }
36
- activeContextEntriesStrict() {
37
- const manager = this.ctx?.sessionManager;
38
- if (typeof manager?.buildContextEntries !== "function") return this.branchEntries();
39
- const entries = manager.buildContextEntries();
40
- if (!Array.isArray(entries)) throw new Error("active_context_entries_unavailable");
41
- return entries;
42
- }
43
- resolvedEntriesById(entries = this.branchEntries(), sessionId = this.sessionId()) {
44
- const result = new Map();
45
- for (const entry of entries) {
46
- const resolved = this.entryFromSessionEntry(entry, sessionId);
47
- if (resolved) result.set(resolved.source.entryId, resolved);
48
- }
49
- return result;
50
- }
51
- toolResultSources(entries = this.branchEntries(), sessionId = this.sessionId()) {
52
- const grouped = new Map();
53
- for (const entry of entries) {
54
- const source = this.sourceFromEntry(entry, sessionId);
55
- if (!source) continue;
56
- const group = grouped.get(source.source.toolCallId) ?? [];
57
- group.push(source);
58
- grouped.set(source.source.toolCallId, group);
59
- }
60
- const unique = new Map();
61
- for (const [toolCallId, sources] of grouped) {
62
- if (sources.length === 1) unique.set(toolCallId, sources[0]);
63
- }
64
- return unique;
65
- }
66
- sourcesByEntryId(entries = this.branchEntries(), sessionId = this.sessionId()) {
67
- const result = new Map();
68
- for (const source of this.toolResultSources(entries, sessionId).values()) {
69
- result.set(source.source.entryId, source);
70
- }
71
- return result;
72
- }
73
- activeToolResultIds() {
74
- const ids = new Set();
75
- for (const entry of this.activeContextEntries()) {
76
- if (isToolResultEntry(entry) && typeof entry.id === "string") ids.add(entry.id);
77
- }
78
- return ids;
79
- }
80
- resolveCurrent(ref) {
81
- const entryId = entryIdFromContextRef(ref);
82
- if (!entryId) return undefined;
83
- const entry = this.branchEntries().find((candidate) => candidate?.id === entryId);
84
- return entry ? this.entryFromSessionEntry(entry, this.sessionId()) : undefined;
85
- }
86
- sourceFromEntry(entry, sessionId) {
87
- const resolved = this.entryFromSessionEntry(entry, sessionId);
88
- return resolved?.kind === "toolResult" ? resolved : undefined;
89
- }
90
- entryFromSessionEntry(entry, sessionId) {
91
- if (!entry || typeof entry.id !== "string") return undefined;
92
- const kind = this.kindForEntry(entry);
93
- if (!kind) return undefined;
94
- const message = entry.message;
95
- const toolCallId =
96
- kind === "toolResult" && typeof message?.toolCallId === "string" ? message.toolCallId : undefined;
97
- return {
98
- kind,
99
- entry,
100
- ...(message ? { message } : {}),
101
- source: {
102
- sessionId,
103
- entryId: entry.id,
104
- ...(toolCallId ? { toolCallId } : {}),
105
- ...(typeof message?.toolName === "string" ? { toolName: message.toolName } : {}),
106
- },
107
- };
108
- }
109
- kindForEntry(entry) {
110
- if (entry.type === "custom") return "custom";
111
- if (entry.type === "compaction" || entry.type === "branch_summary") return "summary";
112
- if (entry.type !== "message") return undefined;
113
- if (entry.message?.role === "user") return "user";
114
- if (entry.message?.role === "assistant") return "assistant";
115
- if (entry.message?.role === "toolResult") return "toolResult";
116
- if (entry.message?.role === "custom") return "custom";
117
- if (entry.message?.role === "branchSummary" || entry.message?.role === "compactionSummary") return "summary";
118
- return undefined;
119
- }
120
- }
@@ -1,80 +0,0 @@
1
- import { buildContextVisibility } from "./visibility.js";
2
- import { ContextSourceResolver } from "./resolver.js";
3
- import { projectContextSource } from "./source-projector.js";
4
- export class FreeflowContextRuntime {
5
- resolver;
6
- ctx;
7
- generation = 0;
8
- latestRequestSnapshot;
9
- constructor(ctx) {
10
- this.ctx = ctx;
11
- this.resolver = new ContextSourceResolver(ctx);
12
- }
13
- setContext(ctx) {
14
- this.ctx = ctx;
15
- this.resolver.setContext(ctx);
16
- }
17
- sessionId() {
18
- return this.resolver.sessionId();
19
- }
20
- branchLeafId() {
21
- return this.resolver.branchLeafId();
22
- }
23
- branchEntries() {
24
- return this.resolver.branchEntries();
25
- }
26
- resolveCurrent(ref) {
27
- return this.resolver.resolveCurrent(ref);
28
- }
29
- recordRequest(refs) {
30
- this.generation += 1;
31
- this.latestRequestSnapshot = {
32
- generation: this.generation,
33
- sessionId: this.sessionId(),
34
- branchLeafId: this.branchLeafId(),
35
- refs,
36
- };
37
- return this.latestRequestSnapshot;
38
- }
39
- clearRequest() {
40
- this.latestRequestSnapshot = undefined;
41
- }
42
- latestRequest() {
43
- return this.latestRequestSnapshot;
44
- }
45
- captureSnapshot(options) {
46
- const branchEntries = this.resolver.branchEntries();
47
- const activeEntries = this.resolver.activeContextEntriesStrict();
48
- const sessionId = this.sessionId();
49
- const resolvedByEntryId = this.resolver.resolvedEntriesById(branchEntries, sessionId);
50
- const visibility = buildContextVisibility(activeEntries, resolvedByEntryId, options);
51
- const entries = new Map();
52
- let skippedEntries = 0;
53
- for (let position = 0; position < branchEntries.length; position += 1) {
54
- const entry = branchEntries[position];
55
- if (typeof entry?.id !== "string") continue;
56
- const resolved = resolvedByEntryId.get(entry.id);
57
- if (!resolved) continue;
58
- const outcome = projectContextSource({ ...resolved, entry: { ...resolved.entry, position } });
59
- if (outcome.status === "eligible") entries.set(outcome.source.ref, outcome.source);
60
- else if (
61
- outcome.status === "invalid" &&
62
- !visibility.visibleSourceIds.has(entry.id) &&
63
- !visibility.materializedSourceIds.has(entry.id)
64
- ) {
65
- skippedEntries += 1;
66
- }
67
- }
68
- const generation = this.latestRequestSnapshot?.generation ?? ++this.generation;
69
- return {
70
- generation,
71
- sessionId,
72
- branchLeafId: this.branchLeafId(),
73
- visibleEntryIds: visibility.visibleEntryIds,
74
- visibleSourceIds: visibility.visibleSourceIds,
75
- materializedSourceIds: visibility.materializedSourceIds,
76
- skippedEntries,
77
- entries,
78
- };
79
- }
80
- }