@mrclrchtr/supi-review 6.3.0 → 7.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 (154) hide show
  1. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/README.md +8 -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/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +10 -3
  4. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/index.ts +2 -0
  5. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/llm.ts +141 -16
  6. package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +2 -2
  7. package/node_modules/@mrclrchtr/supi-agent-runtime/src/provider-authority.ts +8 -2
  8. package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +164 -82
  9. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  10. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +8 -1
  11. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/README.md +8 -0
  12. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  13. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +10 -3
  14. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/index.ts +2 -0
  15. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/llm.ts +141 -16
  16. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +35 -13
  17. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  18. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +8 -1
  19. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/README.md +8 -0
  20. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  21. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +10 -3
  22. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/index.ts +2 -0
  23. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/llm.ts +141 -16
  24. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.js +3 -1
  25. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/legacy.js +3 -1
  26. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/package.json +1 -1
  27. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +3 -3
  28. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +16 -0
  29. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +43 -35
  30. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-capabilities.ts +83 -17
  31. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-collection.ts +108 -92
  32. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-evidence.ts +44 -82
  33. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +3 -4
  34. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-publication.ts +9 -68
  35. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-pull.ts +45 -58
  36. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +230 -331
  37. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +201 -1
  38. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-timing.ts +129 -70
  39. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-typescript.ts +395 -0
  40. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-waiters.ts +8 -12
  41. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +685 -183
  42. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +2 -2
  43. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +60 -60
  44. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-request-enrollment.ts +75 -0
  45. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-barrier.ts +443 -0
  46. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-errors.ts +30 -0
  47. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-file.ts +15 -0
  48. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +290 -37
  49. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/transport.ts +72 -16
  50. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/capabilities.ts +1 -0
  51. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-scope.ts +30 -4
  52. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +1 -1
  53. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sentinels.ts +4 -32
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sources.ts +108 -0
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-diagnostics.ts +10 -4
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-process-crash-report.ts +50 -1
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +11 -7
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +770 -56
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +3 -1
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +37 -4
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +48 -12
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +50 -4
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +8 -1
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md +8 -0
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +10 -3
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/index.ts +2 -0
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/llm.ts +141 -16
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +2 -0
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callee-display-name.ts +165 -0
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +67 -9
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +2 -0
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +19 -18
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/browser/dist/nodes/Alias.js +25 -23
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/dist/compose/resolve-flow-scalar.js +19 -18
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/dist/nodes/Alias.js +25 -23
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/package.json +1 -1
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/diagnostics.ts +1 -2
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/file-scope.ts +4 -1
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/server-status.ts +1 -1
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +17 -8
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/implementations.ts +1 -2
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/references.ts +8 -4
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/types.ts +6 -30
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored.ts +9 -1
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/symbol.ts +29 -11
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/types.ts +14 -6
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/src/api.ts +2 -0
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +18 -3
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +27 -11
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +21 -4
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +28 -22
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +5 -6
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-workflow.ts +10 -2
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +12 -5
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +9 -6
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +53 -47
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/source-tracking.ts +252 -0
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/guidance.ts +3 -3
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/spec.ts +5 -4
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/tui.ts +7 -1
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/details.ts +32 -0
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/display.ts +54 -0
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/format.ts +60 -0
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/guidance.ts +2 -2
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/markdown.ts +76 -198
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/read-next.ts +65 -0
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/result.ts +118 -83
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/tui.ts +216 -54
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/guidance.ts +3 -5
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/markdown.ts +90 -57
  115. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-outcome.ts +51 -0
  116. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-status.ts +130 -43
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/scope.ts +78 -0
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/spec.ts +1 -1
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/tui.ts +29 -38
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/guidance.ts +5 -3
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/tui.ts +7 -1
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/guidance.ts +3 -4
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/result.ts +31 -8
  124. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/tui.ts +26 -5
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/guidance.ts +1 -1
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/tui.ts +7 -3
  127. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/guidance.ts +3 -5
  128. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/tui.ts +7 -1
  129. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/guidance.ts +3 -5
  130. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/result.ts +13 -10
  131. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/tui.ts +18 -1
  132. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/guidance.ts +11 -9
  133. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/truncate.ts +39 -13
  134. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/candidate-row.ts +27 -0
  135. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/errors.ts +21 -6
  136. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +7 -3
  137. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/schemas.ts +5 -0
  138. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/execution.ts +2 -0
  139. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/index.ts +2 -0
  140. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/candidate-legacy-body.ts +69 -0
  141. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/candidate-selection.ts +366 -0
  142. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/common.ts +26 -31
  143. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/execution-error.ts +92 -0
  144. package/node_modules/@mrclrchtr/supi-core/README.md +8 -0
  145. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  146. package/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +10 -3
  147. package/node_modules/@mrclrchtr/supi-core/src/index.ts +2 -0
  148. package/node_modules/@mrclrchtr/supi-core/src/llm.ts +141 -16
  149. package/package.json +4 -4
  150. package/src/tool/review_audit/guidance.ts +3 -7
  151. package/src/tool/review_output/guidance.ts +2 -3
  152. package/src/tool/review_run/guidance.ts +4 -9
  153. package/src/tool/review_run/input-schema.ts +10 -15
  154. package/src/tool/review_run/schemas.ts +8 -12
@@ -1,12 +1,131 @@
1
- import { complete } from "@earendil-works/pi-ai/compat";
1
+ import { createHash } from "node:crypto";
2
+ import type {
3
+ Api,
4
+ AssistantMessage,
5
+ Context,
6
+ Model,
7
+ ModelsApiStreamOptions,
8
+ ProviderHeaders,
9
+ } from "@earendil-works/pi-ai";
2
10
  import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
3
11
  import type { TSchema } from "typebox";
4
12
  import { Value } from "typebox/value";
5
13
 
6
14
  // Shared LLM utilities for SuPi extensions.
7
15
  //
8
- // Provides retry logic, structured LLM call helpers, and other
9
- // common patterns for extensions that interact with AI models.
16
+ // Provides PI-owned model requests, retry logic, structured LLM call helpers,
17
+ // and other common patterns for extensions that interact with AI models.
18
+
19
+ const MODEL_REQUEST_NAMESPACE = "supi-direct-model-request-v1";
20
+
21
+ /**
22
+ * Options for {@link completeModelRequest}.
23
+ *
24
+ * Authentication, provider environment, and session identity stay under PI
25
+ * control. The feature supplies a stable scope for its prompt stream.
26
+ */
27
+ export type CompleteModelRequestOptions<TApi extends Api = Api> = Omit<
28
+ ModelsApiStreamOptions<TApi>,
29
+ "apiKey" | "env" | "sessionId"
30
+ > & {
31
+ /** Stable feature scope. Do not include prompt, turn, or retry data. */
32
+ affinityScope: string;
33
+ /** PI owns these fields, including for APIs with open-ended option types. */
34
+ apiKey?: never;
35
+ env?: never;
36
+ sessionId?: never;
37
+ };
38
+
39
+ function createModelRequestAffinityId(
40
+ sessionId: string,
41
+ affinityScope: string,
42
+ model: Model<Api>,
43
+ ): string {
44
+ const material = JSON.stringify([
45
+ MODEL_REQUEST_NAMESPACE,
46
+ sessionId,
47
+ affinityScope,
48
+ model.provider,
49
+ model.id,
50
+ ]);
51
+ const digest = createHash("sha256").update(material, "utf8").digest("hex");
52
+ return `supi-${digest.slice(0, 56)}`;
53
+ }
54
+
55
+ function isOpenCodeModel(model: Model<Api>): boolean {
56
+ if (model.provider === "opencode" || model.provider === "opencode-go") return true;
57
+
58
+ try {
59
+ return new URL(model.baseUrl).hostname === "opencode.ai";
60
+ } catch {
61
+ return false;
62
+ }
63
+ }
64
+
65
+ function hasHeader(headers: ProviderHeaders, name: string): boolean {
66
+ const lowerName = name.toLowerCase();
67
+ return Object.keys(headers).some((headerName) => headerName.toLowerCase() === lowerName);
68
+ }
69
+
70
+ function addOpenCodeDefaultHeaders(
71
+ model: Model<Api>,
72
+ affinityId: string,
73
+ headers: ProviderHeaders,
74
+ ): ProviderHeaders {
75
+ if (!isOpenCodeModel(model)) return headers;
76
+
77
+ const result = { ...headers };
78
+ if (!hasHeader(result, "x-opencode-session")) {
79
+ result["x-opencode-session"] = affinityId;
80
+ }
81
+ if (!hasHeader(result, "x-opencode-client")) {
82
+ result["x-opencode-client"] = "pi";
83
+ }
84
+ return result;
85
+ }
86
+
87
+ /**
88
+ * Complete a direct request through PI's model registry.
89
+ *
90
+ * PI resolves authentication, provider headers, environment, and the
91
+ * effective endpoint. This helper adds one stable opaque session identity for
92
+ * the feature prompt stream and applies the OpenCode compatibility defaults.
93
+ * It does not retry, validate output, or present errors.
94
+ *
95
+ * When `maxTokens` is omitted, the underlying registry receives no explicit
96
+ * output cap. A caller that needs the selected model's declared cap can pass
97
+ * `maxTokens: model.maxTokens` without importing PI internals.
98
+ */
99
+ export async function completeModelRequest<TApi extends Api>(
100
+ ctx: ExtensionContext,
101
+ model: Model<TApi>,
102
+ context: Context,
103
+ options: CompleteModelRequestOptions<TApi>,
104
+ ): Promise<AssistantMessage> {
105
+ const { affinityScope, transformHeaders: callerTransformHeaders, ...requestOptions } = options;
106
+ const safeRequestOptions = { ...requestOptions };
107
+ delete safeRequestOptions.apiKey;
108
+ delete safeRequestOptions.env;
109
+ delete safeRequestOptions.sessionId;
110
+
111
+ const affinityId = createModelRequestAffinityId(
112
+ ctx.sessionManager.getSessionId(),
113
+ affinityScope,
114
+ model,
115
+ );
116
+ const transformHeaders = async (headers: ProviderHeaders): Promise<ProviderHeaders> => {
117
+ const transformed = callerTransformHeaders ? await callerTransformHeaders(headers) : headers;
118
+ return addOpenCodeDefaultHeaders(model, affinityId, transformed);
119
+ };
120
+
121
+ // Restore PI's conditional provider-option type after removing owned fields.
122
+ return ctx.modelRegistry.complete(model, context, {
123
+ ...safeRequestOptions,
124
+ signal: safeRequestOptions.signal ?? ctx.signal,
125
+ sessionId: affinityId,
126
+ transformHeaders,
127
+ } as unknown as ModelsApiStreamOptions<TApi>);
128
+ }
10
129
 
11
130
  /**
12
131
  * Options for {@link withRetry}.
@@ -122,6 +241,8 @@ export function extractJsonFromResponse<T extends TSchema>(
122
241
  export interface CallWithJsonResponseOptions {
123
242
  /** The prompt to send to the LLM. */
124
243
  prompt: string;
244
+ /** Stable feature scope for request affinity. Do not include prompt or retry data. */
245
+ affinityScope: string;
125
246
  /** Optional data context appended to the prompt. */
126
247
  dataContext?: string;
127
248
  /** Maximum tokens for the response. Default: 4096 */
@@ -135,8 +256,9 @@ export interface CallWithJsonResponseOptions {
135
256
  /**
136
257
  * Call the LLM with a prompt and validate the JSON response against a TypeBox schema.
137
258
  *
138
- * Handles model resolution, auth, retry via `withRetry`, text extraction,
139
- * JSON regex matching, and TypeBox validation.
259
+ * Handles model resolution, retry via `withRetry`, text extraction, JSON
260
+ * matching, and TypeBox validation. The request itself stays under PI
261
+ * registry authority through {@link completeModelRequest}.
140
262
  *
141
263
  * Returns `null` when:
142
264
  * - No model is available
@@ -145,7 +267,7 @@ export interface CallWithJsonResponseOptions {
145
267
  * - JSON doesn't match the schema
146
268
  * - The request is aborted
147
269
  *
148
- * @param ctx - The extension context for model resolution and auth.
270
+ * @param ctx - The extension context for model selection and PI registry access.
149
271
  * @param options - Call options including prompt, schema, and retry config.
150
272
  * @param schema - TypeBox schema to validate the JSON response against.
151
273
  * @returns The parsed and validated result, or `null`.
@@ -155,14 +277,18 @@ export async function callWithJsonResponse<T extends TSchema>(
155
277
  options: CallWithJsonResponseOptions,
156
278
  schema: T,
157
279
  ): Promise<{ parsed: import("typebox").Static<T> } | null> {
158
- const { prompt, dataContext, maxTokens = 4096, systemPrompt = "", retries = 2 } = options;
280
+ const {
281
+ prompt,
282
+ affinityScope,
283
+ dataContext,
284
+ maxTokens = 4096,
285
+ systemPrompt = "",
286
+ retries = 2,
287
+ } = options;
159
288
 
160
289
  const model = ctx.model ?? ctx.modelRegistry.getAvailable()[0] ?? null;
161
290
  if (!model) return null;
162
291
 
163
- const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
164
- if (!auth.ok || !auth.apiKey) return null;
165
-
166
292
  const fullPrompt = dataContext
167
293
  ? `${prompt}
168
294
 
@@ -171,8 +297,9 @@ ${dataContext}`
171
297
  : prompt;
172
298
 
173
299
  const response = await withRetry(
174
- async () => {
175
- return complete(
300
+ async () =>
301
+ completeModelRequest(
302
+ ctx,
176
303
  model,
177
304
  {
178
305
  systemPrompt,
@@ -185,13 +312,11 @@ ${dataContext}`
185
312
  ],
186
313
  },
187
314
  {
188
- apiKey: auth.apiKey,
189
- headers: auth.headers,
315
+ affinityScope,
190
316
  signal: ctx.signal,
191
317
  maxTokens,
192
318
  },
193
- );
194
- },
319
+ ),
195
320
  { retries, baseDelayMs: 1000, signal: ctx.signal },
196
321
  );
197
322
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-review",
3
- "version": "6.3.0",
3
+ "version": "7.0.0",
4
4
  "description": "Parallel inspection-only reviews of exact Git targets",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -31,9 +31,9 @@
31
31
  "README.md"
32
32
  ],
33
33
  "dependencies": {
34
- "@mrclrchtr/supi-agent-runtime": "6.3.0",
35
- "@mrclrchtr/supi-core": "6.3.0",
36
- "@mrclrchtr/supi-code-intelligence": "6.3.0"
34
+ "@mrclrchtr/supi-agent-runtime": "7.0.0",
35
+ "@mrclrchtr/supi-code-intelligence": "7.0.0",
36
+ "@mrclrchtr/supi-core": "7.0.0"
37
37
  },
38
38
  "bundledDependencies": [
39
39
  "@mrclrchtr/supi-agent-runtime",
@@ -1,10 +1,6 @@
1
- import { MAX_PAGE_CHARACTERS, MAX_PAGE_LINES } from "../output-page.ts";
2
-
3
- export const toolDescription = `List local reviewer replays or inspect one through bounded Replay Outline, selected-message, or raw views. Outline is metadata-only. Message and raw views can contain repository evidence and tool output. Pages are at most ${MAX_PAGE_CHARACTERS} UTF-16 characters and ${MAX_PAGE_LINES.toLocaleString("en-US")} lines. Available only when review auditing is enabled.`;
1
+ export const toolDescription =
2
+ "List local reviewer replays or inspect one through Replay Outline, selected-message, or raw views. Start with the metadata-only Replay Outline; message and raw views can contain repository evidence and tool output. Available only when review auditing is enabled.";
4
3
 
5
4
  export const promptSnippet = "List or navigate local reviewer replays";
6
5
 
7
- export const promptGuidelines = [
8
- "Use review_audit Replay Outline before selected-message or raw replay access.",
9
- "Do not repeat raw review_audit replay content unless necessary.",
10
- ];
6
+ export const promptGuidelines: string[] = [];
@@ -1,6 +1,5 @@
1
- import { MAX_PAGE_CHARACTERS, MAX_PAGE_LINES } from "../output-page.ts";
2
-
3
- export const toolDescription = `Read a current-process Review continuation page of at most ${MAX_PAGE_CHARACTERS} UTF-16 characters and ${MAX_PAGE_LINES.toLocaleString("en-US")} lines. Use only with an artifact id from review_run or /supi-review. Artifacts expire after 30 minutes, reload, resume, or a branch change.`;
1
+ export const toolDescription =
2
+ "Read a current-process Review continuation page. Use only with an artifact id from review_run or /supi-review. Artifacts expire after 30 minutes, reload, resume, or a branch change.";
4
3
 
5
4
  export const promptSnippet = "Continue paged review output";
6
5
 
@@ -1,11 +1,6 @@
1
- import { MAX_PAGE_CHARACTERS, MAX_PAGE_LINES } from "../output-page.ts";
1
+ export const toolDescription =
2
+ "Run one to four independent inspection-only review tasks against one frozen Review Target. Use for code reviews or criteria-based inspections; use agent_run for exploration or coding and direct tools for simple checks. Each task selects change or state evidence.";
2
3
 
3
- export const toolDescription = `Run one to four independent Inspection-only tasks concurrently against one exact frozen target. Use for code reviews instead of generic subagents. Each change task needs a non-empty change; committed change targets require from; all-state targets omit from. Creates a disposable linked Git worktree. A configured bootstrap can run one shell command there, and enabled auditing stores raw local replays. Output pages are limited to ${MAX_PAGE_CHARACTERS} UTF-16 characters and ${MAX_PAGE_LINES.toLocaleString("en-US")} lines.`;
4
+ export const promptSnippet = "Run independent inspection-only reviews";
4
5
 
5
- export const promptSnippet = "Run independent inspection-only review tasks";
6
-
7
- export const promptGuidelines = [
8
- "Use `review_run` for repository reviews and criteria-based inspections. Use task mode `change` for before-and-after changes and `state` for the frozen current code state.",
9
- "Do not use `review_run` for exploration.",
10
- "Do not use `review_run` for simple reviews you can complete directly.",
11
- ];
6
+ export const promptGuidelines: string[] = [];
@@ -6,12 +6,11 @@ import { normalizeReviewTarget, reviewTargetEndpoints } from "../../target/input
6
6
  import type { ReviewInput, ReviewScope, ReviewTargetSpec } from "../../types.ts";
7
7
  import { reviewInputSchema } from "./schemas.ts";
8
8
 
9
- function endpointSchema(role: "before" | "after") {
9
+ function endpointSchema() {
10
10
  return Type.String({
11
11
  minLength: 1,
12
12
  maxLength: 512,
13
13
  pattern: "^\\S+$",
14
- description: `Git revision for the exact ${role} state. Branches, hashes, ~, ^, and lightweight or annotated tags are valid. It must resolve to one commit; whitespace, ranges, trees, blobs, and blank values are not valid.`,
15
14
  });
16
15
  }
17
16
 
@@ -20,37 +19,36 @@ const scopePathsSchema = Type.Array(
20
19
  minLength: 1,
21
20
  maxLength: REVIEW_LIMITS.reviewScopePathCharacters,
22
21
  pattern: "\\S",
23
- description:
24
- "Repository-relative path that focuses every Review Task. A leading @ is accepted. The path must exist in the frozen after state.",
22
+ description: "Repository-relative path in the frozen after state; a leading @ is accepted.",
25
23
  }),
26
24
  {
27
25
  minItems: 1,
28
26
  maxItems: REVIEW_LIMITS.reviewScopePathsPerTarget,
29
27
  description:
30
- "Optional advisory path focus for this batch. This argument sits at the top level of the tool call, alongside target; do not place it inside target. It does not limit repository inspection, changed-path evidence, or findings.",
28
+ "Advisory focus for all tasks; it does not limit inspection, changed-path evidence, or findings.",
31
29
  },
32
30
  );
33
31
 
34
32
  const workingTreeTargetSchema = Type.Object(
35
33
  {
36
- from: Type.Optional(endpointSchema("before")),
34
+ from: Type.Optional(endpointSchema()),
37
35
  },
38
36
  {
39
37
  additionalProperties: false,
40
38
  description:
41
- "Review the frozen current filesystem, including staged, unstaged, and non-ignored untracked files. Optional from sets the committed before state.",
39
+ "Freeze the current filesystem, including staged, unstaged, and non-ignored untracked files; from selects the before commit.",
42
40
  },
43
41
  );
44
42
 
45
43
  const committedTargetSchema = Type.Object(
46
44
  {
47
- from: Type.Optional(endpointSchema("before")),
48
- to: Type.Optional(endpointSchema("after")),
45
+ from: Type.Optional(endpointSchema()),
46
+ to: Type.Optional(endpointSchema()),
49
47
  },
50
48
  {
51
49
  additionalProperties: false,
52
50
  description:
53
- "Review exact committed Git state. Optional from and to select the before and after commits; to defaults to HEAD.",
51
+ "Freeze committed state; from and to select before and after commits. The to endpoint defaults to HEAD. Change tasks require from and cannot use a root commit as to.",
54
52
  },
55
53
  );
56
54
 
@@ -63,7 +61,7 @@ const targetSchema = Type.Object(
63
61
  maxProperties: 1,
64
62
  additionalProperties: false,
65
63
  description:
66
- "Exact Review Target. Omit it, or use {}, for the current filesystem. Select workingTree or committed; endpoints resolve once to full commits.",
64
+ "Omit target or use {} for the current filesystem; otherwise select workingTree or committed. All-state batches must omit from. Endpoints must resolve to commits; ranges, trees, and blobs are invalid.",
67
65
  },
68
66
  );
69
67
 
@@ -74,10 +72,7 @@ export const runReviewSchema = Type.Object(
74
72
  paths: Type.Optional(scopePathsSchema),
75
73
  ...reviewInputSchema.properties,
76
74
  },
77
- {
78
- additionalProperties: false,
79
- description: "Run one complete caller-defined Review against one exact Review Target.",
80
- },
75
+ { additionalProperties: false },
81
76
  );
82
77
 
83
78
  interface RawRunReviewInput extends ReviewInput {
@@ -9,18 +9,17 @@ export const reviewTaskSchema = Type.Object(
9
9
  minLength: 1,
10
10
  maxLength: REVIEW_LIMITS.taskIdCharacters,
11
11
  pattern: "\\S",
12
- description: "Unique task id used to match its result, such as standards or spec.",
12
+ description: "Task id for its result, such as standards or spec.",
13
13
  }),
14
14
  instructions: Type.String({
15
15
  minLength: 1,
16
16
  maxLength: REVIEW_LIMITS.taskInstructionCharacters,
17
17
  pattern: "\\S",
18
- description:
19
- "Self-contained review objective and criteria. Tasks run independently and cannot see each other's progress.",
18
+ description: "Self-contained review objective and criteria for one task.",
20
19
  }),
21
20
  mode: StringEnum(["change", "state"] as const, {
22
21
  description:
23
- "Required evidence view. change reviews one non-empty before-and-after change. state reviews only the frozen after state.",
22
+ "Evidence view: change uses one non-empty before-and-after change; state uses only the frozen after state.",
24
23
  }),
25
24
  criteriaSources: Type.Optional(
26
25
  Type.Array(
@@ -30,15 +29,13 @@ export const reviewTaskSchema = Type.Object(
30
29
  minLength: 1,
31
30
  maxLength: REVIEW_LIMITS.criteriaReferenceCharacters,
32
31
  pattern: "\\S",
33
- description:
34
- "Authoritative source identifier, such as an issue reference, URL, or repository-relative document path.",
32
+ description: "Issue reference, URL, or repository-relative document path.",
35
33
  }),
36
34
  summary: Type.String({
37
35
  minLength: 1,
38
36
  maxLength: REVIEW_LIMITS.criteriaSummaryCharacters,
39
37
  pattern: "\\S",
40
- description:
41
- "Caller summary of the source used before the reviewer retrieves the source itself.",
38
+ description: "Source summary; the reviewer retrieves more detail only when needed.",
42
39
  }),
43
40
  },
44
41
  { additionalProperties: false },
@@ -46,7 +43,7 @@ export const reviewTaskSchema = Type.Object(
46
43
  {
47
44
  minItems: 1,
48
45
  maxItems: REVIEW_LIMITS.criteriaSourcesPerTask,
49
- description: "Authoritative issues or documents this task's Review Criteria derive from.",
46
+ description: "Authoritative sources for this task's Review Criteria.",
50
47
  },
51
48
  ),
52
49
  ),
@@ -61,14 +58,13 @@ export const reviewInputSchema = Type.Object(
61
58
  Type.String({
62
59
  maxLength: REVIEW_LIMITS.sharedContextCharacters,
63
60
  pattern: "\\S",
64
- description: "Context copied to every reviewer; omit task-specific instructions.",
61
+ description: "Context for all tasks; exclude task-specific instructions.",
65
62
  }),
66
63
  ),
67
64
  tasks: Type.Array(reviewTaskSchema, {
68
65
  minItems: 1,
69
66
  maxItems: 4,
70
- description:
71
- "One to four independent tasks, in caller order. Task ids must be unique; tasks run concurrently.",
67
+ description: "Results keep caller order; task ids must be unique.",
72
68
  }),
73
69
  },
74
70
  {