@mrclrchtr/supi-review 6.4.0 → 7.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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 +17 -3
  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
@@ -21,6 +21,7 @@ pnpm add @mrclrchtr/supi-core
21
21
  ## Package surfaces
22
22
 
23
23
  - `@mrclrchtr/supi-core/api` — reusable helpers for other packages and extensions
24
+ - `@mrclrchtr/supi-core/llm` — PI-owned direct model requests and JSON helpers
24
25
  - `@mrclrchtr/supi-core/report` — shared text/report rendering helpers for TUI and plain-text summaries
25
26
 
26
27
  ## What you get from the API
@@ -48,6 +49,13 @@ Config file locations:
48
49
 
49
50
  - `wrapExtensionContext()` — wrap injected text in SuPi's `<extension-context>` tag
50
51
 
52
+ ### Model requests
53
+
54
+ - `completeModelRequest(ctx, model, context, options)` — complete through PI's model registry with stable feature affinity. PI owns auth and endpoint resolution.
55
+ - `callWithJsonResponse()` — retry a registry request, extract JSON, and validate it with TypeBox.
56
+
57
+ `completeModelRequest()` requires a stable `affinityScope`. It keeps cache retention defaults, does not include prompt content in the affinity ID, and adds OpenCode headers only when the provider or exact model endpoint matches OpenCode. Pass `maxTokens: model.maxTokens` when a caller needs the model's declared output cap without using PI private modules.
58
+
51
59
  ### Shared registries
52
60
 
53
61
  - context-provider registry for `/supi-context`
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "6.4.0",
3
+ "version": "7.0.1",
4
4
  "description": "Shared settings, configuration, reporting, and session infrastructure",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -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
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-agent-runtime",
3
- "version": "6.4.0",
3
+ "version": "7.0.1",
4
4
  "description": "SuPi Agent Run runtime — neutral lifecycle management for in-process pi sessions",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -28,7 +28,7 @@
28
28
  "!__tests__"
29
29
  ],
30
30
  "dependencies": {
31
- "@mrclrchtr/supi-core": "6.4.0"
31
+ "@mrclrchtr/supi-core": "7.0.1"
32
32
  },
33
33
  "peerDependencies": {
34
34
  "@earendil-works/pi-ai": "*",
@@ -22,7 +22,13 @@ export interface AgentRunProviderAuthority {
22
22
 
23
23
  /** Model-specific request auth returned by PI's compatibility registry facade. */
24
24
  export type AgentRunRequestAuth =
25
- | { ok: true; apiKey?: string; headers?: ProviderHeaders; env?: Record<string, string> }
25
+ | {
26
+ ok: true;
27
+ apiKey?: string;
28
+ headers?: ProviderHeaders;
29
+ baseUrl?: string;
30
+ env?: Record<string, string>;
31
+ }
26
32
  | { ok: false; error: string };
27
33
 
28
34
  /** Adapt PI's public model registry to the narrow Agent Run authority interface. */
@@ -203,11 +209,17 @@ function resolveParentModel(
203
209
  childModel: Model<Api>,
204
210
  fallback: Model<Api>,
205
211
  ): Model<Api> {
212
+ let parentModel = fallback;
206
213
  try {
207
- return provider.getModels().find((candidate) => candidate.id === childModel.id) ?? fallback;
214
+ parentModel =
215
+ provider.getModels().find((candidate) => candidate.id === childModel.id) ?? fallback;
208
216
  } catch {
209
- return fallback;
217
+ // Keep the authorized fallback when the parent catalog is unavailable.
210
218
  }
219
+ // ModelRuntime may resolve a credential-specific endpoint onto childModel.
220
+ return parentModel.baseUrl === childModel.baseUrl
221
+ ? parentModel
222
+ : { ...parentModel, baseUrl: childModel.baseUrl };
211
223
  }
212
224
 
213
225
  function mergeRequestAuth(
@@ -216,6 +228,7 @@ function mergeRequestAuth(
216
228
  ): AuthResult {
217
229
  const auth = providerAuth?.auth;
218
230
  const resolved = requestAuth?.ok ? requestAuth : undefined;
231
+ const baseUrl = resolved?.baseUrl ?? auth?.baseUrl;
219
232
  return {
220
233
  ...(providerAuth?.source ? { source: providerAuth.source } : {}),
221
234
  ...(providerAuth?.env || resolved?.env
@@ -223,6 +236,7 @@ function mergeRequestAuth(
223
236
  : {}),
224
237
  auth: {
225
238
  ...(auth ?? {}),
239
+ ...(baseUrl ? { baseUrl } : {}),
226
240
  ...(resolved?.apiKey ? { apiKey: resolved.apiKey } : {}),
227
241
  ...(auth?.headers || resolved?.headers
228
242
  ? { headers: { ...(auth?.headers ?? {}), ...(resolved?.headers ?? {}) } }