@mrclrchtr/supi-review 10.0.0 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (146) hide show
  1. package/node_modules/@mrclrchtr/supi-agent-runtime/README.md +11 -0
  2. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  3. package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +2 -2
  4. package/node_modules/@mrclrchtr/supi-agent-runtime/src/api.ts +2 -0
  5. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-data.ts +61 -0
  6. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-message-validation.ts +230 -0
  7. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-validation.ts +249 -0
  8. package/node_modules/@mrclrchtr/supi-agent-runtime/src/context.ts +33 -0
  9. package/node_modules/@mrclrchtr/supi-agent-runtime/src/run.ts +34 -8
  10. package/node_modules/@mrclrchtr/supi-agent-runtime/src/types.ts +14 -2
  11. package/node_modules/@mrclrchtr/supi-agent-runtime/src/usage.ts +175 -25
  12. package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +77 -21
  13. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
  14. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/README.md +743 -0
  15. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/index.js +17 -0
  16. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/constants.js +184 -0
  17. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/parse.js +1425 -0
  18. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/picomatch.js +361 -0
  19. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/scan.js +403 -0
  20. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/utils.js +72 -0
  21. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/package.json +83 -0
  22. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/posix.js +3 -0
  23. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
  24. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
  25. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
  26. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -0
  27. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  28. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +88 -2
  29. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
  30. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/README.md +743 -0
  31. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/index.js +17 -0
  32. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/constants.js +184 -0
  33. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/parse.js +1425 -0
  34. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/picomatch.js +361 -0
  35. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/scan.js +403 -0
  36. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/utils.js +72 -0
  37. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/package.json +83 -0
  38. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/posix.js +3 -0
  39. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
  40. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
  41. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
  42. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -0
  43. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  44. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +3 -3
  45. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +1 -0
  46. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +3 -0
  47. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +6 -4
  48. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-request-enrollment.ts +66 -22
  49. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-barrier.ts +37 -5
  50. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +136 -43
  51. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +261 -22
  52. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +13 -0
  53. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-discovery.ts +151 -0
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-normalizer.ts +97 -129
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-protocol.ts +132 -0
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +8 -1
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +7 -20
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-rename.ts +172 -0
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +14 -0
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/utils.ts +12 -11
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/README.md +63 -17
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/README.md +743 -0
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/index.js +17 -0
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/constants.js +184 -0
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/parse.js +1425 -0
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/picomatch.js +361 -0
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/scan.js +403 -0
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/utils.js +72 -0
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/package.json +83 -0
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/posix.js +3 -0
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -0
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/language.ts +16 -10
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/operation-support.ts +13 -6
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +19 -1
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime-controller.ts +18 -4
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/session.ts +10 -3
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +17 -2
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-process.ts +22 -5
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-protocol.ts +36 -1
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/syntax-errors.ts +73 -0
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/syntax-node.ts +4 -0
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +15 -9
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +24 -15
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +8 -1
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/imports.ts +233 -7
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/node-at.ts +7 -3
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-expansion.ts +78 -0
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-jvm.ts +25 -4
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-nested.ts +390 -0
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline.ts +49 -28
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +16 -0
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/process-host.mjs +61 -24
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +44 -10
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/service.ts +13 -9
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/worker-main.ts +15 -2
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/apply.ts +35 -14
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +9 -2
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/implementations.ts +7 -2
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +90 -12
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +1 -0
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored-structural.ts +1 -0
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/discovery.ts +29 -0
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/file.ts +19 -9
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/types.ts +5 -0
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/src/config.ts +46 -7
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +2 -2
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph-types.ts +6 -0
  115. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect/collect.ts +35 -20
  116. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-types.ts +9 -2
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +90 -18
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-sections.ts +22 -1
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/gather.ts +46 -6
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +7 -1
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-plans.ts +17 -0
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +13 -6
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-store.ts +5 -0
  124. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +3 -0
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/workspace-provider-host.ts +22 -2
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/markdown.ts +17 -4
  127. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/result.ts +17 -3
  128. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/details.ts +2 -0
  129. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/display.ts +1 -0
  130. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/format.ts +1 -0
  131. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/result.ts +32 -6
  132. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/markdown.ts +15 -1
  133. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/result.ts +11 -0
  134. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/result.ts +4 -2
  135. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/markdown.ts +34 -14
  136. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/result.ts +7 -3
  137. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +20 -2
  138. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/display.ts +2 -1
  139. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  140. package/package.json +4 -4
  141. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/LICENSE-MIT +0 -21
  142. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/README.md +0 -501
  143. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.d.ts +0 -81
  144. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.js +0 -1566
  145. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/legacy.js +0 -1346
  146. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/package.json +0 -93
@@ -33,6 +33,17 @@ const outcome = await run.result;
33
33
 
34
34
  Agent Runs share the containing process's permissions and external sandbox; context isolation is not filesystem or security isolation.
35
35
 
36
+ ## Restored conversation context
37
+
38
+ Callers can set `captureContext: true` on a run to receive finalized native Pi entries and their active leaf in `outcome.context`. Pass that plain data as `inputs.context` on a later run. Each run creates and disposes its own session; the runtime does not keep an idle worker or persist the context itself.
39
+
40
+ - `cloneAgentRunContext()` copies and validates context before admission. Invalid entry payloads, ancestry, and references are rejected rather than replaced with fresh context.
41
+ - Current caller-owned model, tools, prompt, and resource policy apply to the new run. Saved history does not grant permissions.
42
+ - Native compaction and context-edit entries remain part of the restored history. Run Usage excludes imported history and includes only newly billed work.
43
+ - Capture is opt-in and can be absent when no valid context is available. Failure, cancellation, and timeout can return valid captured context; no interrupted action is replayed automatically.
44
+ - Context can contain source text, tool data, and other sensitive content. Known assistant transport diagnostics are omitted; arbitrary conversation content is not redacted.
45
+ - Callers own storage, retention, branch selection, and result delivery. `supi-agent` stores checkpoints in parent task results. Reviewer Runs retain their existing policy.
46
+
36
47
  ## Finite continuation
37
48
 
38
49
  A package can add a bounded same-session continuation for a required structured result. The caller supplies declarative steps through `continuation.resolveNext()`. Each step specifies a prompt, an exact active-tool set, a thinking level, and an optional pre-authorized model. The runtime performs all prompts, model switches, tool changes, usage snapshots, cancellation checks, and final disposal.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "10.0.0",
3
+ "version": "11.0.0",
4
4
  "description": "Shared settings, configuration, reporting, and session infrastructure",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-agent-runtime",
3
- "version": "10.0.0",
3
+ "version": "11.0.0",
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": "10.0.0"
31
+ "@mrclrchtr/supi-core": "11.0.0"
32
32
  },
33
33
  "peerDependencies": {
34
34
  "@earendil-works/pi-ai": "*",
@@ -1,5 +1,6 @@
1
1
  /** Public API for @mrclrchtr/supi-agent-runtime. */
2
2
 
3
+ export { cloneAgentRunContext } from "./context.ts";
3
4
  export type { AgentRunDiagnosticErrorRow } from "./diagnostics.ts";
4
5
  export {
5
6
  createEarlyCancellationDiagnostics,
@@ -35,6 +36,7 @@ export type {
35
36
  } from "./session/transcript-store.ts";
36
37
  export { AgentRunTranscriptCapture, AgentRunTranscriptStore } from "./session/transcript-store.ts";
37
38
  export type {
39
+ AgentRunContext,
38
40
  AgentRunContinuation,
39
41
  AgentRunContinuationContext,
40
42
  AgentRunContinuationEvent,
@@ -0,0 +1,61 @@
1
+ /** Copy plain session data without changing its field names. */
2
+ export function cloneSessionData(value: unknown): unknown {
3
+ return clonePlainData(value, new Set());
4
+ }
5
+
6
+ function clonePlainData(value: unknown, ancestors: Set<object>): unknown {
7
+ if (
8
+ value === undefined ||
9
+ value === null ||
10
+ typeof value === "string" ||
11
+ typeof value === "boolean"
12
+ ) {
13
+ return value;
14
+ }
15
+ if (typeof value === "number") {
16
+ if (!Number.isFinite(value)) throw new TypeError("Session data must use finite numbers");
17
+ return value;
18
+ }
19
+ if (typeof value !== "object") throw new TypeError("Session data must be plain data");
20
+ if (ancestors.has(value)) throw new TypeError("Session data must not contain cycles");
21
+ ancestors.add(value);
22
+ try {
23
+ return Array.isArray(value) ? cloneArray(value, ancestors) : cloneObject(value, ancestors);
24
+ } finally {
25
+ ancestors.delete(value);
26
+ }
27
+ }
28
+
29
+ function cloneArray(value: unknown[], ancestors: Set<object>): unknown[] {
30
+ return Array.from({ length: value.length }, (_unused, index) => {
31
+ const item = Object.getOwnPropertyDescriptor(value, String(index));
32
+ if (!item || !("value" in item)) {
33
+ throw new TypeError("Session arrays must contain plain values");
34
+ }
35
+ return clonePlainData(item.value, ancestors);
36
+ });
37
+ }
38
+
39
+ function cloneObject(value: object, ancestors: Set<object>): Record<string, unknown> {
40
+ const prototype = Object.getPrototypeOf(value);
41
+ if (prototype !== Object.prototype && prototype !== null) {
42
+ throw new TypeError("Session data must use plain objects");
43
+ }
44
+ const output: Record<string, unknown> = {};
45
+ for (const key of Object.keys(value)) {
46
+ const item = Object.getOwnPropertyDescriptor(value, key);
47
+ if (!item || !("value" in item)) {
48
+ throw new TypeError("Session objects must contain plain values");
49
+ }
50
+ const copied = clonePlainData(item.value, ancestors);
51
+ if (copied !== undefined) {
52
+ Object.defineProperty(output, key, {
53
+ value: copied,
54
+ enumerable: true,
55
+ configurable: true,
56
+ writable: true,
57
+ });
58
+ }
59
+ }
60
+ return output;
61
+ }
@@ -0,0 +1,230 @@
1
+ const STOP_REASONS = new Set([
2
+ "pending",
3
+ "stop",
4
+ "length",
5
+ "toolUse",
6
+ "error",
7
+ "aborted",
8
+ "deferred",
9
+ ]);
10
+
11
+ export function validateSessionMessage(message: Record<string, unknown>): boolean {
12
+ if (!isString(message.role) || !isFiniteNumber(message.timestamp)) return false;
13
+ switch (message.role) {
14
+ case "system":
15
+ return validateSystemMessage(message);
16
+ case "user":
17
+ return isNativeContent(message.content, isTextOrImageContent);
18
+ case "assistant":
19
+ return (
20
+ isNativeContent(message.content, isAssistantContent, true) &&
21
+ isString(message.api) &&
22
+ isString(message.provider) &&
23
+ isString(message.model) &&
24
+ STOP_REASONS.has(message.stopReason as string) &&
25
+ isNativeUsage(message.usage) &&
26
+ optionalStrings(message, ["responseModel", "responseId", "providerThinkingLevel"]) &&
27
+ optionalString(message, "thinkingLevel") &&
28
+ optionalBoolean(message, "endTurn") &&
29
+ optionalNonNegative(message, "durationMs")
30
+ );
31
+ case "toolResult":
32
+ return (
33
+ isString(message.toolCallId) &&
34
+ isString(message.toolName) &&
35
+ isNativeContent(message.content, isTextOrImageContent, true) &&
36
+ typeof message.isError === "boolean" &&
37
+ optionalUsage(message) &&
38
+ optionalNestedCalls(message) &&
39
+ optionalNonNegative(message, "durationMs")
40
+ );
41
+ case "bashExecution":
42
+ return (
43
+ isString(message.command) &&
44
+ isString(message.output) &&
45
+ (message.exitCode === undefined || isFiniteNumber(message.exitCode)) &&
46
+ typeof message.cancelled === "boolean" &&
47
+ typeof message.truncated === "boolean" &&
48
+ optionalString(message, "fullOutputPath") &&
49
+ optionalBoolean(message, "excludeFromContext")
50
+ );
51
+ case "custom":
52
+ return (
53
+ isString(message.customType) &&
54
+ isNativeContent(message.content, isTextOrImageContent) &&
55
+ typeof message.display === "boolean"
56
+ );
57
+ case "branchSummary":
58
+ return isString(message.summary) && (message.fromId === null || isString(message.fromId));
59
+ case "compactionSummary":
60
+ return isString(message.summary) && isNonNegativeNumber(message.tokensBefore);
61
+ default:
62
+ return true;
63
+ }
64
+ }
65
+
66
+ export function validateSystemMessage(value: unknown): boolean {
67
+ if (
68
+ !isRecord(value) ||
69
+ value.role !== "system" ||
70
+ !isFiniteNumber(value.timestamp) ||
71
+ !isNativeContent(value.content, isTextContent)
72
+ ) {
73
+ return false;
74
+ }
75
+ if (
76
+ value.sections !== undefined &&
77
+ (!isRecord(value.sections) ||
78
+ !Object.values(value.sections).every((item) => item === null || isString(item)))
79
+ ) {
80
+ return false;
81
+ }
82
+ if (
83
+ value.toolsAdded !== undefined &&
84
+ (!Array.isArray(value.toolsAdded) || !value.toolsAdded.every(isTool))
85
+ ) {
86
+ return false;
87
+ }
88
+ return (
89
+ value.toolsRemoved === undefined ||
90
+ (Array.isArray(value.toolsRemoved) &&
91
+ value.toolsRemoved.every((tool) => isRecord(tool) && isString(tool.name)))
92
+ );
93
+ }
94
+
95
+ export function isAssistantContent(value: unknown): boolean {
96
+ if (isTextContent(value)) return true;
97
+ if (isRecord(value) && value.type === "thinking") {
98
+ return (
99
+ isString(value.thinking) &&
100
+ optionalString(value, "thinkingSignature") &&
101
+ optionalBoolean(value, "redacted")
102
+ );
103
+ }
104
+ return (
105
+ isRecord(value) &&
106
+ value.type === "toolCall" &&
107
+ isString(value.id) &&
108
+ isString(value.name) &&
109
+ isRecord(value.arguments) &&
110
+ optionalStrings(value, ["thoughtSignature", "namespace", "argumentsError"])
111
+ );
112
+ }
113
+
114
+ export function isTextOrImageContent(value: unknown): boolean {
115
+ return (
116
+ isTextContent(value) ||
117
+ (isRecord(value) && value.type === "image" && isString(value.data) && isString(value.mimeType))
118
+ );
119
+ }
120
+
121
+ export function isEditableContent(value: unknown): boolean {
122
+ return isTextOrImageContent(value) || isAssistantContent(value);
123
+ }
124
+
125
+ export function isNativeContent(
126
+ value: unknown,
127
+ accepts: (item: unknown) => boolean,
128
+ arrayOnly = false,
129
+ ): boolean {
130
+ return (!arrayOnly && isString(value)) || (Array.isArray(value) && value.every(accepts));
131
+ }
132
+
133
+ export function isNativeUsage(value: unknown): boolean {
134
+ if (!isRecord(value) || !isRecord(value.cost)) return false;
135
+ const cost = value.cost;
136
+ return (
137
+ ["input", "output", "cacheRead", "cacheWrite", "totalTokens"].every((key) =>
138
+ isNonNegativeNumber(value[key]),
139
+ ) &&
140
+ ["input", "output", "cacheRead", "cacheWrite", "total"].every((key) =>
141
+ isNonNegativeNumber(cost[key]),
142
+ ) &&
143
+ optionalNonNegative(value, "cacheWrite1h") &&
144
+ optionalNonNegative(value, "reasoning")
145
+ );
146
+ }
147
+
148
+ function isTool(value: unknown): boolean {
149
+ if (
150
+ !isRecord(value) ||
151
+ !isString(value.name) ||
152
+ !isString(value.description) ||
153
+ !isRecord(value.parameters)
154
+ ) {
155
+ return false;
156
+ }
157
+ const sampling = value.constrainedSampling;
158
+ if (sampling === undefined || sampling === false) return true;
159
+ return (
160
+ isRecord(sampling) &&
161
+ ((sampling.type === "json_schema" &&
162
+ ["prefer", "require"].includes(sampling.strict as string)) ||
163
+ (sampling.type === "grammar" && isRecord(sampling.variants)))
164
+ );
165
+ }
166
+
167
+ function isTextContent(value: unknown): boolean {
168
+ return (
169
+ isRecord(value) &&
170
+ value.type === "text" &&
171
+ isString(value.text) &&
172
+ optionalString(value, "textSignature")
173
+ );
174
+ }
175
+
176
+ function optionalStrings(value: Record<string, unknown>, keys: string[]): boolean {
177
+ return keys.every((key) => optionalString(value, key));
178
+ }
179
+
180
+ function optionalUsage(value: Record<string, unknown>): boolean {
181
+ return value.usage === undefined || isNativeUsage(value.usage);
182
+ }
183
+
184
+ function optionalNestedCalls(value: Record<string, unknown>): boolean {
185
+ if (value.nestedCalls === undefined) return true;
186
+ return (
187
+ isRecord(value.nestedCalls) &&
188
+ typeof value.nestedCalls.complete === "boolean" &&
189
+ Array.isArray(value.nestedCalls.calls) &&
190
+ value.nestedCalls.calls.every(
191
+ (call) =>
192
+ isRecord(call) &&
193
+ isString(call.id) &&
194
+ isString(call.name) &&
195
+ ["ok", "error", "unfinished"].includes(call.status as string) &&
196
+ optionalNonNegative(call, "durationMs") &&
197
+ optionalNonNegative(call, "argumentsBytes") &&
198
+ optionalString(call, "error") &&
199
+ (call.arguments === undefined || isRecord(call.arguments)),
200
+ )
201
+ );
202
+ }
203
+
204
+ function optionalString(value: Record<string, unknown>, key: string): boolean {
205
+ return value[key] === undefined || isString(value[key]);
206
+ }
207
+
208
+ function optionalBoolean(value: Record<string, unknown>, key: string): boolean {
209
+ return value[key] === undefined || typeof value[key] === "boolean";
210
+ }
211
+
212
+ function optionalNonNegative(value: Record<string, unknown>, key: string): boolean {
213
+ return value[key] === undefined || isNonNegativeNumber(value[key]);
214
+ }
215
+
216
+ function isNonNegativeNumber(value: unknown): boolean {
217
+ return isFiniteNumber(value) && value >= 0;
218
+ }
219
+
220
+ function isFiniteNumber(value: unknown): value is number {
221
+ return typeof value === "number" && Number.isFinite(value);
222
+ }
223
+
224
+ function isString(value: unknown): value is string {
225
+ return typeof value === "string";
226
+ }
227
+
228
+ function isRecord(value: unknown): value is Record<string, unknown> {
229
+ return typeof value === "object" && value !== null && !Array.isArray(value);
230
+ }
@@ -0,0 +1,249 @@
1
+ import type { SessionEntry } from "@earendil-works/pi-coding-agent";
2
+ import { cloneSessionData } from "./context-data.ts";
3
+ import {
4
+ isAssistantContent,
5
+ isEditableContent,
6
+ isNativeContent,
7
+ isNativeUsage,
8
+ isTextOrImageContent,
9
+ validateSessionMessage,
10
+ validateSystemMessage,
11
+ } from "./context-message-validation.ts";
12
+ import type { AgentRunContext } from "./types.ts";
13
+
14
+ const ENTRY_TYPES = new Set([
15
+ "message",
16
+ "thinking_level_change",
17
+ "model_change",
18
+ "usage",
19
+ "compaction",
20
+ "branch_summary",
21
+ "custom",
22
+ "custom_message",
23
+ "context_edit",
24
+ "label",
25
+ "session_info",
26
+ ]);
27
+ const ASSISTANT_METADATA_TO_OMIT = ["diagnostics", "deferred", "errorMessage", "rawStopReason"];
28
+
29
+ /** Copy a context and validate its native session entries. */
30
+ export function cloneAndValidateContext(value: AgentRunContext): AgentRunContext {
31
+ let data: unknown;
32
+ try {
33
+ data = cloneSessionData(value);
34
+ } catch (error) {
35
+ throw new TypeError("Invalid Agent Run context: entries must contain plain session data", {
36
+ cause: error,
37
+ });
38
+ }
39
+ if (!isRecord(data) || !Array.isArray(data.entries)) {
40
+ throw new TypeError("Invalid Agent Run context: entries and leafId are required");
41
+ }
42
+ if (data.leafId !== null && typeof data.leafId !== "string") {
43
+ throw new TypeError("Invalid Agent Run context: leafId must be a string or null");
44
+ }
45
+ const entries = data.entries.map(validateEntry);
46
+ const byId = validateAncestry(entries, data.leafId);
47
+ validateReferences(entries, byId);
48
+ return { entries, leafId: data.leafId };
49
+ }
50
+
51
+ function validateEntry(value: unknown): SessionEntry {
52
+ if (
53
+ !isRecord(value) ||
54
+ !ENTRY_TYPES.has(value.type as string) ||
55
+ !isString(value.id) ||
56
+ !value.id ||
57
+ (value.parentId !== null && !isString(value.parentId)) ||
58
+ !isString(value.timestamp)
59
+ )
60
+ throw invalid("entry");
61
+
62
+ if (!validateEntryPayload(value)) throw invalid(`${value.type} entry`);
63
+ const entry = value as unknown as SessionEntry;
64
+ if (entry.type !== "message" || entry.message.role !== "assistant") return entry;
65
+ const message = { ...entry.message } as Record<string, unknown>;
66
+ for (const key of ASSISTANT_METADATA_TO_OMIT) delete message[key];
67
+ return { ...entry, message } as unknown as SessionEntry;
68
+ }
69
+
70
+ function validateEntryPayload(entry: Record<string, unknown>): boolean {
71
+ switch (entry.type) {
72
+ case "message":
73
+ return isRecord(entry.message) && validateSessionMessage(entry.message);
74
+ case "thinking_level_change":
75
+ return isString(entry.thinkingLevel);
76
+ case "model_change":
77
+ return isString(entry.provider) && isString(entry.modelId);
78
+ case "usage":
79
+ return (
80
+ isString(entry.kind) &&
81
+ isString(entry.provider) &&
82
+ isString(entry.model) &&
83
+ isNativeUsage(entry.usage)
84
+ );
85
+ case "compaction":
86
+ return (
87
+ isString(entry.summary) &&
88
+ isString(entry.firstKeptEntryId) &&
89
+ nonNegative(entry.tokensBefore) &&
90
+ optionalUsage(entry) &&
91
+ optionalBoolean(entry, "fromHook") &&
92
+ (entry.systemMessage === undefined || validateSystemMessage(entry.systemMessage))
93
+ );
94
+ case "branch_summary":
95
+ return (
96
+ isString(entry.fromId) &&
97
+ isString(entry.summary) &&
98
+ optionalUsage(entry) &&
99
+ optionalBoolean(entry, "fromHook")
100
+ );
101
+ case "custom":
102
+ return isString(entry.customType);
103
+ case "custom_message":
104
+ return (
105
+ isString(entry.customType) &&
106
+ isNativeContent(entry.content, isTextOrImageContent) &&
107
+ typeof entry.display === "boolean"
108
+ );
109
+ case "context_edit":
110
+ return (
111
+ isString(entry.targetId) &&
112
+ Object.hasOwn(entry, "replacement") &&
113
+ (entry.replacement === null ||
114
+ (isRecord(entry.replacement) &&
115
+ Object.hasOwn(entry.replacement, "content") &&
116
+ isNativeContent(entry.replacement.content, isEditableContent)))
117
+ );
118
+ case "label":
119
+ return isString(entry.targetId) && (entry.label === undefined || isString(entry.label));
120
+ case "session_info":
121
+ return entry.name === undefined || isString(entry.name);
122
+ default:
123
+ return false;
124
+ }
125
+ }
126
+
127
+ function validateReferences(
128
+ entries: readonly SessionEntry[],
129
+ byId: ReadonlyMap<string, SessionEntry>,
130
+ ): void {
131
+ for (const entry of entries) {
132
+ const path = entryPath(entry, byId);
133
+ if (
134
+ entry.type === "compaction" &&
135
+ entry.firstKeptEntryId !== entry.id &&
136
+ !path.slice(1).some((item) => item.id === entry.firstKeptEntryId)
137
+ ) {
138
+ throw invalid("compaction boundary is not on its ancestry");
139
+ }
140
+ if (entry.type === "context_edit") validateContextEdit(entry, path, byId);
141
+ // Pi uses "root" when a branch summary has no previous leaf.
142
+ if (entry.type === "branch_summary" && entry.fromId !== "root" && !byId.has(entry.fromId)) {
143
+ throw invalid("branch summary source does not exist");
144
+ }
145
+ if (entry.type === "label" && !byId.has(entry.targetId))
146
+ throw invalid("label target does not exist");
147
+ }
148
+ }
149
+
150
+ function validateContextEdit(
151
+ entry: Extract<SessionEntry, { type: "context_edit" }>,
152
+ path: SessionEntry[],
153
+ byId: ReadonlyMap<string, SessionEntry>,
154
+ ): void {
155
+ const target = byId.get(entry.targetId);
156
+ if (
157
+ !target ||
158
+ !path.slice(1).some((item) => item.id === entry.targetId) ||
159
+ !isEditableTarget(target)
160
+ ) {
161
+ throw invalid("context edit target is not an earlier editable entry on its branch");
162
+ }
163
+ if (entry.replacement !== null && !replacementMatchesTarget(target, entry.replacement.content)) {
164
+ throw invalid("context edit content does not match its target");
165
+ }
166
+ }
167
+
168
+ function replacementMatchesTarget(target: SessionEntry, content: unknown): boolean {
169
+ if (target.type === "custom_message") return isNativeContent(content, isTextOrImageContent);
170
+ if (target.type !== "message") return false;
171
+ if (target.message.role === "assistant") return isNativeContent(content, isAssistantContent);
172
+ if (target.message.role === "user") return isNativeContent(content, isTextOrImageContent);
173
+ return target.message.role === "toolResult" && isNativeContent(content, isTextOrImageContent);
174
+ }
175
+
176
+ function isEditableTarget(entry: SessionEntry): boolean {
177
+ return (
178
+ entry.type === "custom_message" ||
179
+ (entry.type === "message" && ["user", "assistant", "toolResult"].includes(entry.message.role))
180
+ );
181
+ }
182
+
183
+ function validateAncestry(
184
+ entries: readonly SessionEntry[],
185
+ leafId: unknown,
186
+ ): Map<string, SessionEntry> {
187
+ const byId = new Map(entries.map((entry) => [entry.id, entry]));
188
+ if (byId.size !== entries.length) throw invalid("entry IDs must be unique");
189
+ if (leafId !== null && !byId.has(leafId as string))
190
+ throw invalid("leafId does not identify an entry");
191
+ const complete = new Set<string>();
192
+ for (const entry of entries) validateEntryAncestry(entry, byId, complete);
193
+ return byId;
194
+ }
195
+
196
+ function validateEntryAncestry(
197
+ entry: SessionEntry,
198
+ byId: ReadonlyMap<string, SessionEntry>,
199
+ complete: Set<string>,
200
+ ): void {
201
+ const path = new Set<string>();
202
+ let current: SessionEntry | undefined = entry;
203
+ while (current && !complete.has(current.id)) {
204
+ if (path.has(current.id)) throw invalid("entry ancestry contains a cycle");
205
+ path.add(current.id);
206
+ if (current.parentId === null) break;
207
+ current = byId.get(current.parentId);
208
+ if (!current) throw invalid("entry ancestry is incomplete");
209
+ }
210
+ for (const id of path) complete.add(id);
211
+ }
212
+
213
+ function entryPath(entry: SessionEntry, byId: ReadonlyMap<string, SessionEntry>): SessionEntry[] {
214
+ const path = [entry];
215
+ let current = entry;
216
+ while (current.parentId !== null) {
217
+ current = byId.get(current.parentId) as SessionEntry;
218
+ path.push(current);
219
+ }
220
+ return path;
221
+ }
222
+
223
+ function optionalUsage(value: Record<string, unknown>): boolean {
224
+ return value.usage === undefined || isNativeUsage(value.usage);
225
+ }
226
+
227
+ function optionalBoolean(value: Record<string, unknown>, key: string): boolean {
228
+ return value[key] === undefined || typeof value[key] === "boolean";
229
+ }
230
+
231
+ function nonNegative(value: unknown): boolean {
232
+ return finite(value) && value >= 0;
233
+ }
234
+
235
+ function finite(value: unknown): value is number {
236
+ return typeof value === "number" && Number.isFinite(value);
237
+ }
238
+
239
+ function isString(value: unknown): value is string {
240
+ return typeof value === "string";
241
+ }
242
+
243
+ function isRecord(value: unknown): value is Record<string, unknown> {
244
+ return typeof value === "object" && value !== null && !Array.isArray(value);
245
+ }
246
+
247
+ function invalid(detail: string): TypeError {
248
+ return new TypeError(`Invalid Agent Run context: ${detail}`);
249
+ }
@@ -0,0 +1,33 @@
1
+ import type { AgentSession } from "@earendil-works/pi-coding-agent";
2
+ import { SessionManager } from "@earendil-works/pi-coding-agent";
3
+ import { cloneAndValidateContext } from "./context-validation.ts";
4
+ import type { AgentRunContext } from "./types.ts";
5
+
6
+ /** Copy and validate restored session data before the runtime starts setup. */
7
+ export function cloneAgentRunContext(value: AgentRunContext): AgentRunContext {
8
+ return cloneAndValidateContext(value);
9
+ }
10
+
11
+ /** Create an in-memory Pi manager with the selected restored branch. */
12
+ export function createAgentRunSessionManager(
13
+ cwd: string,
14
+ context?: AgentRunContext,
15
+ ): SessionManager {
16
+ if (!context) return SessionManager.inMemory(cwd);
17
+ const manager = SessionManager.inMemory(cwd, undefined, [...context.entries]);
18
+ if (context.leafId === null) manager.resetLeaf();
19
+ else manager.branch(context.leafId);
20
+ return manager;
21
+ }
22
+
23
+ /** Capture a detached copy of the owned session's native history. */
24
+ export function captureAgentRunContext(session: AgentSession): AgentRunContext | undefined {
25
+ try {
26
+ return cloneAgentRunContext({
27
+ entries: session.sessionManager.getEntries(),
28
+ leafId: session.sessionManager.getLeafId(),
29
+ });
30
+ } catch {
31
+ return undefined;
32
+ }
33
+ }