@mrclrchtr/supi-review 10.0.0 → 11.0.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 (146) hide show
  1. package/node_modules/@mrclrchtr/supi-agent-runtime/README.md +11 -0
  2. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  3. package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +2 -2
  4. package/node_modules/@mrclrchtr/supi-agent-runtime/src/api.ts +2 -0
  5. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-data.ts +61 -0
  6. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-message-validation.ts +230 -0
  7. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-validation.ts +249 -0
  8. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context.ts +33 -0
  9. package/node_modules/@mrclrchtr/supi-agent-runtime/src/run.ts +34 -8
  10. package/node_modules/@mrclrchtr/supi-agent-runtime/src/types.ts +14 -2
  11. package/node_modules/@mrclrchtr/supi-agent-runtime/src/usage.ts +175 -25
  12. package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +77 -21
  13. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
  14. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/README.md +743 -0
  15. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/index.js +17 -0
  16. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/constants.js +184 -0
  17. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/parse.js +1425 -0
  18. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/picomatch.js +361 -0
  19. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/scan.js +403 -0
  20. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/utils.js +72 -0
  21. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/package.json +83 -0
  22. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/posix.js +3 -0
  23. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
  24. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
  25. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
  26. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -0
  27. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  28. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +88 -2
  29. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
  30. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/README.md +743 -0
  31. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/index.js +17 -0
  32. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/constants.js +184 -0
  33. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/parse.js +1425 -0
  34. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/picomatch.js +361 -0
  35. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/scan.js +403 -0
  36. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/utils.js +72 -0
  37. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/package.json +83 -0
  38. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/posix.js +3 -0
  39. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
  40. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
  41. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
  42. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -0
  43. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  44. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +3 -3
  45. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +1 -0
  46. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +3 -0
  47. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +6 -4
  48. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-request-enrollment.ts +66 -22
  49. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-barrier.ts +37 -5
  50. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +136 -43
  51. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +261 -22
  52. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +13 -0
  53. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-discovery.ts +151 -0
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-normalizer.ts +97 -129
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-protocol.ts +132 -0
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +8 -1
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +7 -20
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-rename.ts +172 -0
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +14 -0
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/utils.ts +12 -11
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/README.md +63 -17
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/README.md +743 -0
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/index.js +17 -0
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/constants.js +184 -0
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/parse.js +1425 -0
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/picomatch.js +361 -0
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/scan.js +403 -0
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/utils.js +72 -0
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/package.json +83 -0
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/posix.js +3 -0
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -0
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/language.ts +16 -10
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/operation-support.ts +13 -6
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +19 -1
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime-controller.ts +18 -4
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/session.ts +10 -3
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +17 -2
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-process.ts +22 -5
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-protocol.ts +36 -1
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/syntax-errors.ts +73 -0
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/syntax-node.ts +4 -0
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +15 -9
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +24 -15
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +8 -1
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/imports.ts +233 -7
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/node-at.ts +7 -3
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-expansion.ts +78 -0
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-jvm.ts +25 -4
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-nested.ts +390 -0
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline.ts +49 -28
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +16 -0
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/process-host.mjs +61 -24
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +44 -10
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/service.ts +13 -9
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/worker-main.ts +15 -2
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/apply.ts +35 -14
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +9 -2
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/implementations.ts +7 -2
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +90 -12
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +1 -0
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored-structural.ts +1 -0
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/discovery.ts +29 -0
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/file.ts +19 -9
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/types.ts +5 -0
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/src/config.ts +46 -7
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +2 -2
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph-types.ts +6 -0
  115. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect/collect.ts +35 -20
  116. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-types.ts +9 -2
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +90 -18
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-sections.ts +22 -1
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/gather.ts +46 -6
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +7 -1
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-plans.ts +17 -0
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +13 -6
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-store.ts +5 -0
  124. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +3 -0
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/workspace-provider-host.ts +22 -2
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/markdown.ts +17 -4
  127. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/result.ts +17 -3
  128. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/details.ts +2 -0
  129. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/display.ts +1 -0
  130. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/format.ts +1 -0
  131. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/result.ts +32 -6
  132. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/markdown.ts +15 -1
  133. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/result.ts +11 -0
  134. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/result.ts +4 -2
  135. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/markdown.ts +34 -14
  136. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/result.ts +7 -3
  137. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +20 -2
  138. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/display.ts +2 -1
  139. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  140. package/package.json +4 -4
  141. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/LICENSE-MIT +0 -21
  142. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/README.md +0 -501
  143. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.d.ts +0 -81
  144. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.js +0 -1566
  145. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/legacy.js +0 -1346
  146. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/package.json +0 -93
@@ -12,13 +12,18 @@ import {
12
12
  createAgentSession,
13
13
  createAgentSessionRuntime,
14
14
  getAgentDir,
15
- SessionManager,
16
15
  } from "@earendil-works/pi-coding-agent";
16
+ import {
17
+ captureAgentRunContext,
18
+ cloneAgentRunContext,
19
+ createAgentRunSessionManager,
20
+ } from "./context.ts";
17
21
  import { buildAgentRunDiagnostics } from "./diagnostics.ts";
18
22
  import { AgentRunLifecycleTraceCollector, getRegisteredToolNames } from "./lifecycle-trace.ts";
19
23
  import { createAgentRunModelRuntime } from "./provider-authority.ts";
20
24
  import { createAgentRunSessionView, deactivateAgentRunSessionView } from "./session-view.ts";
21
25
  import type {
26
+ AgentRunContext,
22
27
  AgentRunContinuationEvent,
23
28
  AgentRunContinuationFailureCode,
24
29
  AgentRunContinuationStep,
@@ -35,7 +40,11 @@ import type {
35
40
  StartAgentRunOptions,
36
41
  StartRegisteredAgentRunOptions,
37
42
  } from "./types.ts";
38
- import { collectAgentRunUsage } from "./usage.ts";
43
+ import {
44
+ type AgentRunUsageBaseline,
45
+ collectAgentRunUsage,
46
+ createAgentRunUsageBaseline,
47
+ } from "./usage.ts";
39
48
 
40
49
  /** Grace period for a provider abort before disposal continues. */
41
50
  export const AGENT_RUN_ABORT_GRACE_MS = 2_000;
@@ -71,6 +80,8 @@ export const AGENT_RUN_MAX_CONTINUATION_TURNS = 8;
71
80
  /** Start one foreground Agent Run and return its control handle immediately. */
72
81
  // biome-ignore lint/complexity/noExcessiveLinesPerFunction: lifecycle state and teardown stay in one audited closure.
73
82
  export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHandle<T> {
83
+ const restoredContext =
84
+ options.inputs.context === undefined ? undefined : cloneAgentRunContext(options.inputs.context);
74
85
  const listeners = new Set<AgentRunProgressListener>();
75
86
  const progressState: {
76
87
  status: AgentRunStatus;
@@ -87,6 +98,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
87
98
  let lifecycle = new AgentRunLifecycleTraceCollector();
88
99
  let runtime: AgentSessionRuntime | undefined;
89
100
  let session: AgentSession | undefined;
101
+ let usageBaseline: AgentRunUsageBaseline | undefined;
90
102
  let view: AgentRunSessionView | undefined;
91
103
  let unsubscribe: (() => void) | undefined;
92
104
  let observerCleanup: (() => void) | undefined;
@@ -174,7 +186,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
174
186
 
175
187
  const refreshUsage = (): Usage | undefined => {
176
188
  if (!session) return progressState.usage;
177
- const usage = collectAgentRunUsage(session);
189
+ const usage = collectAgentRunUsage(session, usageBaseline);
178
190
  if (usage) progressState.usage = usage;
179
191
  return progressState.usage;
180
192
  };
@@ -209,6 +221,11 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
209
221
  return usage ? ({ ...outcome, usage } as TOutcome) : outcome;
210
222
  };
211
223
 
224
+ const captureFinalizedContext = () => {
225
+ if (!options.captureContext || !session) return undefined;
226
+ return captureAgentRunContext(session);
227
+ };
228
+
212
229
  const trackExtensionWork = (start: () => Promise<unknown>): void => {
213
230
  let resolveWork!: () => void;
214
231
  let rejectWork!: (error: unknown) => void;
@@ -311,6 +328,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
311
328
  finalizing = true;
312
329
  closeSessionAdmission();
313
330
  finalization = (async () => {
331
+ const capturedContext = captureFinalizedContext();
314
332
  if (timeoutId) clearTimeout(timeoutId);
315
333
  timeoutId = undefined;
316
334
  unsubscribe?.();
@@ -323,7 +341,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
323
341
  observerCleanup = undefined;
324
342
  if (view) deactivateAgentRunSessionView(view);
325
343
  await disposeRuntime();
326
- const finalOutcome = outcomeWithUsage(outcome);
344
+ const finalOutcome = outcomeWithUsage(withAgentRunContext(outcome, capturedContext));
327
345
  terminal = true;
328
346
  progressState.status = finalOutcome.kind === "success" ? "completed" : finalOutcome.kind;
329
347
  progressState.usage = finalOutcome.usage ?? progressState.usage;
@@ -536,7 +554,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
536
554
  const requestedModelId = step.model?.modelId ?? currentModelId;
537
555
  observeContinuation({ type: "turn-start", turn, modelId: requestedModelId });
538
556
  if (aborting || terminal || finalizing) return undefined;
539
- const usageBefore = collectAgentRunUsage(activeSession);
557
+ const usageBefore = collectAgentRunUsage(activeSession, usageBaseline);
540
558
  if (step.model) {
541
559
  const requested = step.model.value as Model<Api> | undefined;
542
560
  const modelIdMatches = requested
@@ -569,7 +587,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
569
587
  modelId: requestedModelId,
570
588
  outcome: "model-switch-failed",
571
589
  promptAccepted: false,
572
- ...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession)),
590
+ ...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession, usageBaseline)),
573
591
  };
574
592
  observeContinuationTurn(failed);
575
593
  observeContinuation({
@@ -626,7 +644,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
626
644
  modelId: requestedModelId,
627
645
  outcome,
628
646
  promptAccepted: accepted,
629
- ...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession)),
647
+ ...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession, usageBaseline)),
630
648
  };
631
649
  observeContinuationTurn(completed);
632
650
  observeContinuation({ type: "turn-end", turn, modelId: requestedModelId, outcome });
@@ -945,10 +963,11 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
945
963
  {
946
964
  cwd: options.inputs.cwd,
947
965
  agentDir,
948
- sessionManager: SessionManager.inMemory(options.inputs.cwd),
966
+ sessionManager: createAgentRunSessionManager(options.inputs.cwd, restoredContext),
949
967
  },
950
968
  );
951
969
  session = runtime.session;
970
+ if (restoredContext) usageBaseline = createAgentRunUsageBaseline(session);
952
971
  installSingleSessionDisposal(session);
953
972
  installExtensionSendGuards(session);
954
973
  if (cancelRequested || terminal || finalizing) {
@@ -1169,6 +1188,13 @@ export function startRegisteredAgentRun<T>(
1169
1188
  return registeredHandle;
1170
1189
  }
1171
1190
 
1191
+ function withAgentRunContext<T>(
1192
+ outcome: AgentRunOutcome<T>,
1193
+ context: AgentRunContext | undefined,
1194
+ ): AgentRunOutcome<T> {
1195
+ return context ? { ...outcome, context } : outcome;
1196
+ }
1197
+
1172
1198
  function usageFields(usage: Usage | undefined): { usage?: Usage } {
1173
1199
  return usage ? { usage } : {};
1174
1200
  }
@@ -3,6 +3,7 @@ import type {
3
3
  AgentSession,
4
4
  AgentSessionEvent,
5
5
  ResourceLoader,
6
+ SessionEntry,
6
7
  SessionStats,
7
8
  SettingsManager,
8
9
  ToolDefinition,
@@ -23,8 +24,14 @@ export type AgentRunFailureCode =
23
24
  | "provider-error"
24
25
  | "unexpected-runner-failure";
25
26
 
27
+ /** Detached native Pi session entries and their active leaf. */
28
+ export interface AgentRunContext {
29
+ readonly entries: readonly SessionEntry[];
30
+ readonly leafId: string | null;
31
+ }
32
+
26
33
  /** Terminal outcome of one managed Agent Run. */
27
- export type AgentRunOutcome<T> =
34
+ export type AgentRunOutcome<T> = (
28
35
  | { kind: "success"; value: T; usage?: Usage }
29
36
  | ({ kind: "failed"; usage?: Usage } & (
30
37
  | { failureCode: "session-creation-failed"; diagnostics?: never }
@@ -34,7 +41,8 @@ export type AgentRunOutcome<T> =
34
41
  }
35
42
  ))
36
43
  | { kind: "canceled"; diagnostics: AgentRunDiagnostics; usage?: Usage }
37
- | { kind: "timeout"; timeoutMs: number; diagnostics: AgentRunDiagnostics; usage?: Usage };
44
+ | { kind: "timeout"; timeoutMs: number; diagnostics: AgentRunDiagnostics; usage?: Usage }
45
+ ) & { context?: AgentRunContext };
38
46
 
39
47
  /** Caller-owned resources and policy used to create an Agent Run session. */
40
48
  export interface AgentSessionInputs {
@@ -62,6 +70,8 @@ export interface AgentSessionInputs {
62
70
  settingsManager: SettingsManager;
63
71
  /** Optional PI agent directory; defaults to PI's configured directory. */
64
72
  agentDir?: string;
73
+ /** Optional native Pi conversation history to restore for this run. */
74
+ readonly context?: AgentRunContext;
65
75
  }
66
76
 
67
77
  /** Read-only message shape exposed to caller-owned completion and observer callbacks. */
@@ -294,6 +304,8 @@ export interface StartAgentRunOptions<T> {
294
304
  timeoutMs?: number;
295
305
  /** Optional containing-session cancellation signal. */
296
306
  signal?: AbortSignal;
307
+ /** Capture finalized native Pi context in the terminal outcome. Defaults to false. */
308
+ captureContext?: boolean;
297
309
  }
298
310
 
299
311
  /** Sole public control interface for one Agent Run. */
@@ -1,5 +1,5 @@
1
1
  import type { Usage } from "@earendil-works/pi-ai";
2
- import type { AgentSession } from "@earendil-works/pi-coding-agent";
2
+ import type { AgentSession, SessionEntry } from "@earendil-works/pi-coding-agent";
3
3
 
4
4
  function addOptional(first: number | undefined, second: number | undefined): number | undefined {
5
5
  return first === undefined && second === undefined ? undefined : (first ?? 0) + (second ?? 0);
@@ -35,48 +35,138 @@ export function combineAgentRunUsage(usages: readonly (Usage | undefined)[]): Us
35
35
  );
36
36
  }
37
37
 
38
+ /** Historical data present before a restored Agent Run starts. */
39
+ export interface AgentRunUsageBaseline {
40
+ readonly entryIds: ReadonlySet<string>;
41
+ readonly messages: ReadonlySet<object>;
42
+ /** Stable keys match projected copies created for native context edits. */
43
+ readonly messageKeys: ReadonlySet<string>;
44
+ readonly usage?: Usage;
45
+ }
46
+
47
+ /** Snapshot historical usage before the restored run starts. */
48
+ export function createAgentRunUsageBaseline(session: AgentSession): AgentRunUsageBaseline {
49
+ const entryIds = new Set<string>();
50
+ const messages = new Set<object>();
51
+ const messageKeys = new Set<string>();
52
+ try {
53
+ for (const entry of session.sessionManager.getEntries()) {
54
+ entryIds.add(entry.id);
55
+ if (entry.type === "message") addBaselineMessage(entry.message, messages, messageKeys);
56
+ }
57
+ } catch {
58
+ // Continue with the live session snapshot when test doubles omit session entries.
59
+ }
60
+ try {
61
+ for (const message of session.messages) addBaselineMessage(message, messages, messageKeys);
62
+ } catch {
63
+ // Usage can still be collected from session entries.
64
+ }
65
+ return { entryIds, messages, messageKeys, usage: collectStatsUsage(session) };
66
+ }
67
+
38
68
  /**
39
- * Collect every usage-bearing entry owned by the in-memory Agent Run session.
40
- * This includes assistant turns, tool-result work, non-message usage entries, compaction,
41
- * branch summaries, and finalized/live messages that have not reached persistence yet.
69
+ * Collect billed usage created by this Agent Run. A baseline excludes imported session history.
42
70
  */
43
- export function collectAgentRunUsage(session: AgentSession): Usage | undefined {
71
+ export function collectAgentRunUsage(
72
+ session: AgentSession,
73
+ baseline?: AgentRunUsageBaseline,
74
+ ): Usage | undefined {
44
75
  const knownMessages = new Set<object>();
76
+ const knownMessageKeys = new Set(baseline?.messageKeys);
77
+ const entryUsages = collectEntryUsage(
78
+ session,
79
+ knownMessages,
80
+ knownMessageKeys,
81
+ baseline?.entryIds,
82
+ );
45
83
  const usages = [
46
- ...collectEntryUsage(session, knownMessages),
47
- ...collectLiveMessageUsage(session, knownMessages),
48
- collectStreamingUsage(session, knownMessages),
84
+ ...entryUsages,
85
+ ...collectLiveMessageUsage(session, knownMessages, knownMessageKeys, baseline?.messages),
86
+ collectStreamingUsage(session, knownMessages, knownMessageKeys, baseline?.messages),
49
87
  ];
50
- return combineAgentRunUsage(usages) ?? collectStatsUsage(session);
88
+ const collected = combineAgentRunUsage(usages);
89
+ if (collected) return collected;
90
+ const currentStats = collectStatsUsage(session);
91
+ return baseline ? subtractUsage(currentStats, baseline.usage) : currentStats;
51
92
  }
52
93
 
53
- function collectEntryUsage(session: AgentSession, knownMessages: Set<object>): Usage[] {
54
- const usages: Usage[] = [];
94
+ interface EntryUsageCollector {
95
+ readonly usages: Usage[];
96
+ readonly knownMessages: Set<object>;
97
+ readonly knownMessageKeys: Set<string>;
98
+ readonly historicalEntryIds?: ReadonlySet<string>;
99
+ }
100
+
101
+ function collectEntryUsage(
102
+ session: AgentSession,
103
+ knownMessages: Set<object>,
104
+ knownMessageKeys: Set<string>,
105
+ historicalEntryIds?: ReadonlySet<string>,
106
+ ): Usage[] {
107
+ const collector: EntryUsageCollector = {
108
+ usages: [],
109
+ knownMessages,
110
+ knownMessageKeys,
111
+ historicalEntryIds,
112
+ };
55
113
  try {
56
114
  for (const entry of session.sessionManager.getEntries()) {
57
- if (entry.type === "message") {
58
- if (isObject(entry.message)) knownMessages.add(entry.message);
59
- pushUsage(usages, entry.message);
60
- } else if (
61
- entry.type === "usage" ||
62
- entry.type === "compaction" ||
63
- entry.type === "branch_summary"
64
- ) {
65
- pushUsage(usages, entry);
66
- }
115
+ collectEntryUsageItem(entry, collector);
67
116
  }
68
117
  } catch {
69
118
  // Test doubles and older PI versions may not expose session entries.
70
119
  }
71
- return usages;
120
+ return collector.usages;
121
+ }
122
+
123
+ function collectEntryUsageItem(entry: SessionEntry, collector: EntryUsageCollector): void {
124
+ const { historicalEntryIds, knownMessages, knownMessageKeys, usages } = collector;
125
+ if (entry.type === "message") {
126
+ if (isObject(entry.message)) knownMessages.add(entry.message);
127
+ const key = historicalEntryIds ? getMessageKey(entry.message) : undefined;
128
+ if (key) knownMessageKeys.add(key);
129
+ if (!historicalEntryIds?.has(entry.id)) pushUsage(usages, entry.message);
130
+ return;
131
+ }
132
+ if (historicalEntryIds?.has(entry.id)) return;
133
+ if (entry.type === "usage" || entry.type === "compaction" || entry.type === "branch_summary") {
134
+ pushUsage(usages, entry);
135
+ }
136
+ }
137
+
138
+ function addBaselineMessage(
139
+ message: unknown,
140
+ messages: Set<object>,
141
+ messageKeys: Set<string>,
142
+ ): void {
143
+ if (isObject(message)) messages.add(message);
144
+ const key = getMessageKey(message);
145
+ if (key) messageKeys.add(key);
72
146
  }
73
147
 
74
- function collectLiveMessageUsage(session: AgentSession, knownMessages: Set<object>): Usage[] {
148
+ function collectLiveMessageUsage(
149
+ session: AgentSession,
150
+ knownMessages: Set<object>,
151
+ knownMessageKeys: Set<string>,
152
+ historicalMessages?: ReadonlySet<object>,
153
+ ): Usage[] {
75
154
  const usages: Usage[] = [];
76
155
  try {
77
156
  for (const message of session.messages) {
78
- if (isObject(message) && knownMessages.has(message)) continue;
157
+ const messageKey = historicalMessages ? getMessageKey(message) : undefined;
158
+ if (
159
+ isObject(message) &&
160
+ (knownMessages.has(message) ||
161
+ historicalMessages?.has(message) ||
162
+ (historicalMessages !== undefined &&
163
+ messageKey !== undefined &&
164
+ knownMessageKeys.has(messageKey)))
165
+ ) {
166
+ continue;
167
+ }
79
168
  if (isObject(message)) knownMessages.add(message);
169
+ if (historicalMessages !== undefined && messageKey) knownMessageKeys.add(messageKey);
80
170
  pushUsage(usages, message);
81
171
  }
82
172
  } catch {
@@ -88,16 +178,53 @@ function collectLiveMessageUsage(session: AgentSession, knownMessages: Set<objec
88
178
  function collectStreamingUsage(
89
179
  session: AgentSession,
90
180
  knownMessages: Set<object>,
181
+ knownMessageKeys: Set<string>,
182
+ historicalMessages?: ReadonlySet<object>,
91
183
  ): Usage | undefined {
92
184
  try {
93
185
  const message = session.agent.state.streamingMessage;
94
- if (isObject(message) && !knownMessages.has(message)) return readUsage(message);
186
+ const messageKey = historicalMessages ? getMessageKey(message) : undefined;
187
+ if (
188
+ isObject(message) &&
189
+ !knownMessages.has(message) &&
190
+ !historicalMessages?.has(message) &&
191
+ !(
192
+ historicalMessages !== undefined &&
193
+ messageKey !== undefined &&
194
+ knownMessageKeys.has(messageKey)
195
+ )
196
+ ) {
197
+ return readUsage(message);
198
+ }
95
199
  } catch {
96
200
  // Continue with the best-effort stats snapshot.
97
201
  }
98
202
  return undefined;
99
203
  }
100
204
 
205
+ function getMessageKey(value: unknown): string | undefined {
206
+ if (!isObject(value)) return undefined;
207
+ const message = value as Record<string, unknown>;
208
+ if (
209
+ typeof message.role !== "string" ||
210
+ (typeof message.timestamp !== "number" && typeof message.timestamp !== "string")
211
+ ) {
212
+ return undefined;
213
+ }
214
+ const usage = normalizeUsage(message.usage);
215
+ if (!usage) return undefined;
216
+ return JSON.stringify([
217
+ message.role,
218
+ message.timestamp,
219
+ message.provider,
220
+ message.model,
221
+ message.toolCallId,
222
+ message.toolName,
223
+ message.stopReason,
224
+ usage,
225
+ ]);
226
+ }
227
+
101
228
  function collectStatsUsage(session: AgentSession): Usage | undefined {
102
229
  try {
103
230
  const stats = session.getSessionStats();
@@ -129,6 +256,29 @@ function pushUsage(usages: Usage[], value: unknown): void {
129
256
  if (usage) usages.push(usage);
130
257
  }
131
258
 
259
+ function subtractUsage(after: Usage | undefined, before: Usage | undefined): Usage | undefined {
260
+ if (!after) return undefined;
261
+ const difference = (next: number, previous: number | undefined) =>
262
+ Math.max(0, next - (previous ?? 0));
263
+ const usage: Usage = {
264
+ input: difference(after.input, before?.input),
265
+ output: difference(after.output, before?.output),
266
+ cacheRead: difference(after.cacheRead, before?.cacheRead),
267
+ cacheWrite: difference(after.cacheWrite, before?.cacheWrite),
268
+ totalTokens: difference(after.totalTokens, before?.totalTokens),
269
+ cost: {
270
+ input: difference(after.cost.input, before?.cost.input),
271
+ output: difference(after.cost.output, before?.cost.output),
272
+ cacheRead: difference(after.cost.cacheRead, before?.cost.cacheRead),
273
+ cacheWrite: difference(after.cost.cacheWrite, before?.cost.cacheWrite),
274
+ total: difference(after.cost.total, before?.cost.total),
275
+ },
276
+ };
277
+ return usage.input || usage.output || usage.cacheRead || usage.cacheWrite || usage.cost.total
278
+ ? usage
279
+ : undefined;
280
+ }
281
+
132
282
  function isObject(value: unknown): value is object {
133
283
  return typeof value === "object" && value !== null;
134
284
  }
@@ -77,7 +77,7 @@ code_health({ scope: "packages/api/src/index.ts", refresh: true })
77
77
  Important tool rules:
78
78
 
79
79
  - **Resolve:** new target handles require semantic readiness. A comment or whitespace point is not a symbol; use `code_inspect` there. Handles are session-local and become stale when file contents change. Resolve the symbol again rather than reuse a stale handle. Symbol queries put case-sensitive exact-name matches first, before the display cap. Provider order stays unchanged within exact-name and other matches. An incomplete provider result never selects a target automatically.
80
- - **Graph:** relations are `references` (default), `callees`, and `implements`. Use `["all"]` for all three. Callee depth is `direct` by default; `deep` includes nested scopes, not transitive calls. Callees match source shape, not symbol identity. Counts include each distinct call site; repeated expressions share one agent-output row with all shown line/column coordinates. Each relation reports its counts and limits once. Provider-limited results have unknown totals; invalid locations are disclosed separately. Callee previews shorten receiver argument lists from syntax without changing grouping by the full expression. Matching previews get local expression numbers so distinct source expressions remain clear. Unavailable references retain the provider reason, including an exhausted enrollment retry. Unavailable callees retain the provider reason and a source-inspection next step. Ambiguous targets ask for candidate selection, not input correction. Candidate limits retain exact totals, or unknown totals when the provider returns partial data. Agent output and both transcript views disclose omissions. Only shown candidates receive target handles. The human transcript shows the resolved target and per-relation evidence types and status. The expanded view groups up to 20 sites per relation by file, without a duplicate Markdown body. If this display limit hides returned sites, the transcript links to a temporary file with all returned evidence. This file does not include evidence beyond `maxResults`, and its path does not add text to an otherwise complete agent result. Merged read ranges use neutral guidance.
80
+ - **Graph:** relations are `references` (default), `callees`, and `implements`. Use `["all"]` for all three. Callee depth is `direct` by default; `deep` includes nested scopes, not transitive calls. Callees match source shape, not symbol identity. Counts include each distinct call site; repeated expressions share one agent-output row with all shown line/column coordinates. Each relation reports its counts and limits once. Provider-limited results have unknown totals; invalid locations are disclosed separately. Callee previews shorten receiver argument lists from syntax without changing grouping by the full expression. Matching previews get local expression numbers so distinct source expressions remain clear. Unavailable references and implementations keep the provider reason. If no provider exists, the result names that gap. Unavailable callees keep the provider reason and a source-inspection next step. Ambiguous targets ask for candidate selection, not input correction. Candidate limits retain exact totals, or unknown totals when the provider returns partial data. Agent output and both transcript views disclose omissions. Only shown candidates receive target handles. The human transcript shows the resolved target and per-relation evidence types and status. The expanded view groups up to 20 sites per relation by file, without a duplicate Markdown body. If this display limit hides returned sites, the transcript links to a temporary file with all returned evidence. This file does not include evidence beyond `maxResults`, and its path does not add text to an otherwise complete agent result. Merged read ranges use neutral guidance.
81
81
  - **Find:** AST mode requires `kind`: `definition`, `import`, `export`, `call`, `type`, `interface`, `class`, `method`, or `enum`. Semantic mode does not accept `kind`. A supplied `scope` is a non-empty array.
82
82
  - **Health:** `include` accepts `diagnostics` and `servers` (both by default); `level` is `summary` (default) or `detailed`. Server inventory and route counts remain workspace-wide, even with a diagnostic scope. A diagnostic snapshot does not prove that the whole workspace is clean. Tsconfig and jsconfig coverage applies only to TypeScript and JavaScript-family files; other-language files have no `Tsconfig` label.
83
83
 
@@ -107,7 +107,9 @@ Candidate selection for Graph, Resolve, and Orientation uses one structured tran
107
107
 
108
108
  ### Refactor checks
109
109
 
110
- The planner accepts one target handle or anchor and one operation: `rename_symbol`, `extract_function`, `extract_variable`, `update_imports`, or `delete_dead_code`. Availability depends on the language server. Unsupported operations do not fall back to text edits.
110
+ The planner accepts one target handle or anchor and one operation: `rename_symbol`, `extract_function`, `extract_variable`, `update_imports`, or `delete_dead_code`. Rename, import updates, and dead-code removal depend on the language server and validated edits. Function and variable extraction are currently unavailable for all languages: standard LSP code actions do not provide a safe exact extraction-name contract. Unsupported operations do not fall back to text edits.
111
+
112
+ Rename can discover affected files and repeat the request once after validated same-route enrollment, with a limit of 64 files. A null server document version for an open file is accepted only with a verified request snapshot of synchronized content. Plans retain its content fingerprint and client version; unknown or mismatched state remains unavailable.
111
113
 
112
114
  Plans are held in memory for the current session. Apply accepts only the returned `planId`; it does not create or regenerate a plan. It checks SHA-256 file fingerprints, provider-authorized roots, document versions when available, edit ranges, and overlaps before writing. Changed files require a new plan. A successful apply removes the plan.
113
115
 
@@ -115,33 +117,67 @@ Refactors can change several files. If a later write fails, the tool attempts to
115
117
 
116
118
  ## Language support
117
119
 
118
- Install the required language servers yourself. The extension detects project languages and starts available configured commands on `PATH` in trusted projects. It does not download or install servers. Individual semantic features depend on server support and readiness.
120
+ The matrix shows built-in LSP routes and implemented AST operations, not a live server test. Install the required language servers yourself. The extension starts available configured commands in trusted projects; it does not download or install servers. A route does not guarantee hover, references, diagnostics, or refactors. Each semantic feature needs a ready server that supports it.
119
121
 
120
- Tree-sitter grammars are bundled and parse locally. Grammar selection uses the file extension, not a shebang.
122
+ Tree-sitter grammars are bundled and parse locally without an LSP server. Both layers match file extensions without case sensitivity; AST grammar selection does not use a shebang. LSP and AST extension lists are separate.
121
123
 
122
- | Language | Default LSP binary | Tree-sitter file extensions |
123
- |---|---|---|
124
- | TypeScript / JavaScript | `typescript-language-server` | `.ts`, `.mts`, `.cts`, `.tsx`, `.js`, `.jsx`, `.mjs`, `.cjs` |
125
- | Python | `pyright-langserver` | `.py`, `.pyi` |
126
- | Rust | `rust-analyzer` | `.rs` |
127
- | Go | `gopls` | `.go` |
128
- | C / C++ | `clangd` | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`, `.hxx`, `.c++`, `.h++` |
129
- | Bash | `bash-language-server` | `.sh`, `.bash`, `.zsh`, `.ksh` (Bash grammar) |
130
- | HTML | `vscode-html-language-server` | `.html`, `.htm`, `.xhtml` |
131
- | SQL | `sql-language-server` | `.sql` |
132
- | Ruby | `ruby-lsp` | `.rb`, `.gemspec` |
133
- | Java | `jdtls` | `.java` |
134
- | Kotlin | `kotlin-lsp` | `.kt`, `.kts` |
135
- | R | `R` with the `languageserver` package | `.r` |
136
- | LaTeX / BibTeX | `texlab` | `.tex`, `.sty`, `.cls` |
137
-
138
- Texlab routes `.tex` and `.bib` files. The bundled Tree-sitter grammar parses `.tex`, `.sty`, and `.cls`, but it does not parse `.bib`. LaTeX AST search supports outlines and imports for packages, classes, source files, and bibliographies. It does not support export searches, callee queries, or call-site analysis. AST import searches also support JavaScript, TypeScript, and TSX. Export searches support only those languages. Other AST operations depend on each grammar's extractors. Structural queries work without an LSP server. Semantic targets and related operations need a running server.
124
+ | Language | Default LSP command | LSP file extensions | AST file extensions | AST search operations |
125
+ |---|---|---|---|---|
126
+ | TypeScript / JavaScript | `typescript-language-server` | `.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, `.cts`, `.mjs`, `.cjs` | `.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, `.cts`, `.mjs`, `.cjs` | Outline, imports, exports, calls |
127
+ | Python | `pyright-langserver` | `.py`, `.pyi` | `.py`, `.pyi` | Outline, imports, calls |
128
+ | Rust | `rust-analyzer` | `.rs` | `.rs` | Outline, imports, calls |
129
+ | Go | `gopls` | `.go`, `.mod` | `.go` | Outline, imports, calls |
130
+ | C / C++ | `clangd` | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`, `.hxx`, `.c++`, `.h++` | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`, `.hxx`, `.c++`, `.h++` | Outline, imports, calls |
131
+ | Bash / shell | `bash-language-server` | `.sh`, `.bash`, `.zsh`, `.ksh` | `.sh`, `.bash`, `.zsh`, `.ksh` | Outline, calls |
132
+ | HTML | `vscode-html-language-server` | `.html`, `.htm`, `.xhtml` | `.html`, `.htm`, `.xhtml` | Outline |
133
+ | SQL | `sql-language-server` | `.sql` | `.sql` | Outline |
134
+ | Ruby | `ruby-lsp` | `.rb`, `.erb`, `.gemspec` | `.rb`, `.gemspec` | Outline, calls |
135
+ | Java | `jdtls` | `.java` | `.java` | Outline, imports, calls |
136
+ | Kotlin | `kotlin-lsp` | `.kt`, `.kts` | `.kt`, `.kts` | Outline, calls |
137
+ | R | `R` with the `languageserver` package | `.r` | `.r` | Outline, calls |
138
+ | LaTeX / BibTeX | `texlab` | `.tex`, `.bib` | `.tex`, `.sty`, `.cls` | Outline, imports |
139
+
140
+ The AST operation column applies only to the AST extensions in that row:
141
+
142
+ - **Outline** supplies `code_find` kind `definition`. TS/JS, Python, Java, Go, Rust, and C/C++ include nested named declarations and members, not every local binding. Kinds `type`, `interface`, `class`, `method`, and `enum` use common filters while results retain native declaration kinds. For example, a Rust trait matches `interface`, and a Go struct or Java record matches `type`; they do not become classes. Other languages retain their existing extraction limits. HTML outlines contain elements with non-empty `id` attributes. SQL outlines contain supported `CREATE` declarations and shallow table/type members.
143
+ - **Imports** supply kind `import` and match written source targets, not local aliases or resolved files. Supported forms include JS/TS declarations, Python `import`/`from`, Java ordinary/static imports, Go import paths, Rust `use`/`extern crate`/external `mod`, literal C/C++ includes, and LaTeX dependency directives. Conditional directives are source evidence, not proof of active dependencies. CommonJS loader calls, dynamic import calls, computed targets, and C++20 module imports are not collected.
144
+ - **Exports** supply kind `export` from file-level JS/TS export statements. CommonJS assignments and a cross-language public-interface model are not supported.
145
+ - **Calls** supply kind `call` from file-wide call-site queries; graph callees use a separate anchored query. Each distinct site retains its source coordinates, including repeated calls on one line. These are written expressions, not symbol-identity relationships. Rust macro invocations remain syntax evidence; JSX tags and compiler-expanded calls are not collected. HTML, SQL, and LaTeX have no built-in call-site or callee queries.
146
+ - `.mod`, `.erb`, and `.bib` have built-in LSP routes but no AST grammar. `.sty` and `.cls` have AST support but no built-in LSP route. `.h` selects C by default; [project file associations](#cc-file-associations) can select C++ consistently for parsing and the LSP document language ID. `.jsx` selects JavaScript; `.tsx` selects TSX. Shell extensions all select the Bash grammar, not separate Zsh or KornShell grammars.
147
+
148
+ AST search and point syntax inspection can work without LSP. New target handles require semantic readiness, including handles used for `code_graph` callee queries. Workspace and directory inventories can include any file type; inclusion does not establish language support.
149
+
150
+ Unlisted extensions have no built-in route or grammar. A [custom LSP server](../supi-lsp/README.md#custom-server-configuration) can add semantic coverage, but it does not add AST support. See the [AST operation matrix](../supi-tree-sitter/README.md#language-support-matrix) and [LSP route matrix](../supi-lsp/README.md#built-in-route-matrix) for details. The source definitions are the [LSP defaults](../supi-lsp/src/config/defaults.json), [grammar map](../supi-tree-sitter/src/language.ts), [AST operation registry](../supi-tree-sitter/src/operation-support.ts), and [search-kind mapping](src/analysis/search/pattern.ts).
151
+
152
+ ### Reference-server verification
153
+
154
+ The [language capability baseline](../../docs/conventions/code-language-baseline.md) has a separate [public-tool acceptance suite](__tests__/acceptance/language-baseline-harness.ts) and required Linux/macOS CI jobs. Its [server and toolchain pins](../../scripts/language-baseline/pins.json) are test combinations, not promises for every installed version. Qualification remains pending until both pinned jobs pass. Parser tests and configured routes do not qualify semantic support.
155
+
156
+ Pyright remains the default Python route. The audited Pyright server does not provide implementation lookup. The Python acceptance case uses an explicit Basedpyright configuration; this is not an automatic fallback. Install Basedpyright yourself and configure it if you need that reference combination:
157
+
158
+ ```json
159
+ {
160
+ "lsp": {
161
+ "servers": {
162
+ "python": {
163
+ "command": "basedpyright-langserver",
164
+ "args": ["--stdio"]
165
+ }
166
+ }
167
+ }
168
+ }
169
+ ```
170
+
171
+ Basedpyright uses `basedpyright.*` settings rather than most `python.*` settings, and has different diagnostic defaults. SuPi does not translate them. See the [server settings reference](https://docs.basedpyright.com/latest/configuration/language-server-settings/).
172
+
173
+ Developers run `pnpm test:language-baseline:acceptance` with the pinned prerequisites. Missing prerequisites fail the command; they do not produce skipped passes. The CI setup installs test tools on isolated runners, not through the runtime extension.
139
174
 
140
175
  ### Search and output limits
141
176
 
142
177
  - An AST search has a 5,000 eligible-file limit and a 10-second deadline shared by file enumeration and analysis. These are not tool-call settings.
143
178
  - Below directory roots, AST search excludes hidden entries, dependency/build/cache directories, symlinks, non-regular files, configured `code-intelligence.exclude` paths, and files unsupported by the requested operation. It does **not** read `.gitignore`. Explicit roots are resolved and honored, including excluded paths and symlink roots. See the [scan policy](src/analysis/search/ast-scan.ts) for the exact directory list.
144
179
  - An exact file that does not support the requested AST operation is invalid. Results disclose policy exclusions, interrupted scans, provider limits, and omitted matches. No matches do not mean that unsupported files were searched.
180
+ - Syntax recovery retains usable evidence as partial and reports the affected file and available error ranges. Scan limits separate recovered syntax from provider failures, with counts and file examples for each. Partial scans have unknown match totals. A recovered parse does not establish complete absence.
145
181
  - Tool text is truncated at Pi's default 2,000 lines or 50 KB. When this occurs, the full text is written to a temporary file and its path is returned. Result-list limits still apply to that full text.
146
182
 
147
183
  ## Status and settings
@@ -168,6 +204,7 @@ Project values override global values, which override defaults. Project configur
168
204
  | `code-intelligence.overviewEnabled` | `true` | Add the hidden overview; the choice is fixed for the session |
169
205
  | `code-intelligence.instructionFileNames` | `["CLAUDE.md", "AGENTS.md"]` | Ordered plain filenames for directory instruction discovery |
170
206
  | `code-intelligence.exclude` | `[]` | Gitignore-style patterns for automatic workspace navigation, LSP work, and broad AST searches; not an access control |
207
+ | `code-intelligence.fileAssociations` | `[]` | Ordered C/C++ language rules in trusted project configuration only; edit the JSON file directly |
171
208
  | `lsp.servers.<language>.enabled` | Enabled unless `false` | Disable a language server |
172
209
 
173
210
  Example `.pi/supi/config.json`:
@@ -189,6 +226,25 @@ Example `.pi/supi/config.json`:
189
226
 
190
227
  Use `typescript`, `python`, `rust`, `go`, `c`, `ruby`, `java`, `kotlin`, `bash`, `html`, `sql`, `r`, or `latex` for built-in server keys (`cpp` aliases `c`). Server command and routing overrides are defined in the [LSP configuration reference](../supi-lsp/README.md#custom-server-configuration). `.pi-lsp.json` is not read. Only the boolean `true` enables the overview; non-boolean values do not enable it. The shared exclusion list uses gitignore syntax and project-over-global replacement. An explicit project `[]` clears configured patterns. `/supi-settings` shows the config path and says to reload or restart Pi after saving. LSP and AST work use saved exclusions after reload or restart. New workspace observations read the current exclusions. Exact file and explicitly selected directory requests remain available. An old `lsp.exclude` value reports a migration error and is not used.
191
228
 
229
+ ### C/C++ file associations
230
+
231
+ Set ordered rules in the project's `.pi/supi/config.json`:
232
+
233
+ ```json
234
+ {
235
+ "code-intelligence": {
236
+ "fileAssociations": [
237
+ { "pattern": "vendor/**/*.h", "language": "c" },
238
+ { "pattern": "**/*.h", "language": "cpp" }
239
+ ]
240
+ }
241
+ }
242
+ ```
243
+
244
+ The first matching rule wins; no match keeps the extension default. Patterns are case-sensitive globs over project-relative paths with `/` separators. They support `*`, `?`, `**`, character classes, and brace alternatives. Rules apply only to existing C-family suffixes and accept only `c` or `cpp`. A rule cannot add an AST grammar or change server routing. Invalid rules fail configuration loading. There is a limit of 64 rules and 512 characters per pattern.
245
+
246
+ Global association values and untrusted project values do not apply. The workspace provider host captures one rule set for AST grammar selection and LSP document language IDs. Restart Pi, or release all sessions that share the host and reload, to use changed rules. This setting has no settings-overlay editor. It does not bypass exclusions or establish compiler flags.
247
+
192
248
  Directory orientation checks the path from the workspace root to the focused directory. It selects the first valid configured instruction file per directory, skips files already loaded by Pi or shown on the active branch, and shows at most 200 lines per file. Resolved instruction paths must stay inside the workspace. These snippets are tool output, not additions to Pi's system prompt.
193
249
 
194
250
  ## Privacy and security
@@ -0,0 +1,21 @@
1
+ The MIT License (MIT)
2
+
3
+ Copyright (c) 2017-present, Jon Schlinkert.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.