@mrclrchtr/supi-review 6.4.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 (145) 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 +6 -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/manager/manager-diagnostics.ts +10 -4
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-process-crash-report.ts +50 -1
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +11 -7
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +608 -45
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +3 -1
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +37 -4
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +31 -11
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +19 -3
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +8 -1
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md +8 -0
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +10 -3
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/index.ts +2 -0
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/llm.ts +141 -16
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +2 -0
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callee-display-name.ts +165 -0
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +67 -9
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +2 -0
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +19 -18
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/browser/dist/nodes/Alias.js +25 -23
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/dist/compose/resolve-flow-scalar.js +19 -18
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/dist/nodes/Alias.js +25 -23
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/yaml/package.json +1 -1
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/diagnostics.ts +1 -2
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/file-scope.ts +4 -1
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/server-status.ts +1 -1
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +17 -8
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/implementations.ts +1 -2
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/references.ts +8 -4
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/types.ts +6 -30
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored.ts +9 -1
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/symbol.ts +29 -11
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/types.ts +14 -6
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/src/api.ts +2 -0
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +18 -3
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +12 -1
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +18 -6
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +21 -19
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +5 -6
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-workflow.ts +10 -2
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +9 -6
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/source-tracking.ts +11 -6
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/guidance.ts +2 -2
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/spec.ts +5 -4
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/tui.ts +7 -1
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/details.ts +32 -0
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/display.ts +54 -0
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/format.ts +60 -0
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/guidance.ts +1 -1
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/markdown.ts +76 -198
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/read-next.ts +65 -0
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/result.ts +118 -83
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/tui.ts +216 -54
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/guidance.ts +2 -4
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/markdown.ts +75 -58
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-outcome.ts +41 -1
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-status.ts +114 -48
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/scope.ts +78 -0
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/spec.ts +1 -1
  115. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/tui.ts +25 -38
  116. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/tui.ts +7 -1
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/result.ts +31 -8
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/tui.ts +26 -5
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/guidance.ts +1 -1
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/tui.ts +7 -3
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/guidance.ts +1 -1
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/tui.ts +7 -1
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/guidance.ts +2 -4
  124. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/result.ts +13 -10
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/tui.ts +18 -1
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/truncate.ts +39 -13
  127. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/candidate-row.ts +27 -0
  128. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/errors.ts +21 -6
  129. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +7 -3
  130. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/schemas.ts +5 -0
  131. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/execution.ts +2 -0
  132. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/index.ts +2 -0
  133. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/candidate-legacy-body.ts +69 -0
  134. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/candidate-selection.ts +366 -0
  135. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/common.ts +26 -31
  136. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/execution-error.ts +92 -0
  137. package/node_modules/@mrclrchtr/supi-core/README.md +8 -0
  138. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  139. package/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +10 -3
  140. package/node_modules/@mrclrchtr/supi-core/src/index.ts +2 -0
  141. package/node_modules/@mrclrchtr/supi-core/src/llm.ts +141 -16
  142. package/package.json +4 -4
  143. package/src/tool/review_audit/guidance.ts +3 -7
  144. package/src/tool/review_output/guidance.ts +2 -3
  145. package/src/tool/review_run/guidance.ts +1 -1
@@ -2,17 +2,24 @@
2
2
  //
3
3
  // Extensions register pre-styled text chunks with a placement hint
4
4
  // ("stats" for the metrics line, "status" for the extension status line).
5
- // The custom footer in supi-extras (or PI's built-in footer) reads these
6
- // contributions and renders them alongside the built-in metrics.
5
+ // The custom footer in supi-extras reads these contributions and renders them
6
+ // alongside the built-in metrics. Extensions can use PI's status API as a
7
+ // fallback when the custom footer is not installed.
7
8
 
8
9
  import { createRegistry } from "./registry-utils.ts";
9
10
 
11
+ /** Event emitted when a dynamic footer contribution needs a new render. */
12
+ export const FOOTER_INVALIDATE_EVENT = "supi:footer:invalidate";
13
+
10
14
  /** Where the contribution should appear in the footer. */
11
15
  export type FooterPlacement = "stats" | "stats-end" | "status";
12
16
 
13
17
  /** A single footer contribution registered by an extension. */
14
18
  export interface FooterContribution {
15
- /** Unique key for this contribution. Re-registering with the same key replaces it. */
19
+ /**
20
+ * Unique key for this contribution. Re-registering with the same key replaces it.
21
+ * A same-key Pi status is treated as this contribution's built-in-footer fallback.
22
+ */
16
23
  key: string;
17
24
  /** Which footer line this belongs on. */
18
25
  placement: FooterPlacement;
@@ -15,6 +15,8 @@ export * from "./debug.ts";
15
15
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
16
  export * from "./footer-registry.ts";
17
17
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
18
+ export * from "./llm.ts";
19
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
18
20
  export * from "./model-selection.ts";
19
21
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
20
22
  export * from "./path.ts";
@@ -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.4.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.4.0",
35
- "@mrclrchtr/supi-code-intelligence": "6.4.0",
36
- "@mrclrchtr/supi-core": "6.4.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,5 +1,5 @@
1
1
  export const toolDescription =
2
- "Run independent review tasks concurrently under an Inspection-only protocol against one frozen Review Target. Use for code reviews or criteria-based inspections instead of generic subagents, not for exploration or simple direct checks.";
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.";
3
3
 
4
4
  export const promptSnippet = "Run independent inspection-only reviews";
5
5