@mrclrchtr/supi-review 4.10.0 → 5.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.
- package/README.md +92 -103
- package/node_modules/@mrclrchtr/supi-agent-runtime/README.md +38 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/README.md +116 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/package.json +72 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/api.ts +40 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/config/config.ts +232 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +363 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/config.ts +12 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/context/context-provider-registry.ts +36 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +31 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/context.ts +8 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +311 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/debug-timing.ts +120 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/evidence-badge.ts +41 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +57 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/index.ts +34 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/llm.ts +201 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/model-selection.ts +134 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/path-utils.ts +44 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/path.ts +2 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/project-roots.ts +170 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/project.ts +15 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/registry-utils.ts +93 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/report.ts +121 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/session-utils.ts +71 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/session.ts +8 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +105 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +453 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts +36 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/spinner-frames.ts +11 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/status-spinner.ts +68 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/terminal.ts +60 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +50 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/api.ts +42 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/diagnostic-sanitizer.ts +72 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/diagnostics.ts +203 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/lifecycle-trace.ts +275 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/provider-authority.ts +232 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/run.ts +1034 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/session-view.ts +120 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/types.ts +289 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/usage.ts +172 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +2 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/README.md +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +80 -5
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/README.md +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +7 -6
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +10 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +206 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-capabilities.ts +78 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-collection.ts +114 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-evidence.ts +372 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +14 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-pull.ts +62 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +491 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +9 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-timing.ts +71 -11
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-waiters.ts +206 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +365 -297
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +52 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +185 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-file-state.ts +25 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +467 -115
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/transport.ts +161 -33
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/capabilities.ts +10 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/defaults.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/debug-telemetry.ts +45 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +38 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-client-state.ts +79 -9
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-diagnostics.ts +13 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +300 -24
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-symbol.ts +5 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +464 -96
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-refactor-provider.ts +130 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts +45 -329
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +57 -120
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-normalizer.ts +320 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-symbol-mapper.ts +207 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/readiness.ts +72 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +151 -26
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +40 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +50 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +136 -120
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-transition-debug.ts +49 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +102 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/README.md +17 -7
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/LICENSE +21 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/README.md +258 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/babel.cjs +257 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/jiti.cjs +1 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-cli.mjs +34 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-hooks.mjs +124 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-native.mjs +121 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.d.mts +1 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.mjs +4 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-static.mjs +23 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.cjs +30 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.cts +8 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.mts +8 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.mjs +29 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/types.d.ts +420 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/package.json +146 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +6 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/api.ts +0 -9
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/index.ts +0 -8
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +16 -12
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime-controller.ts +65 -87
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/session.ts +47 -95
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-timing.ts +147 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client-lifecycle.ts +39 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +561 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-message-size.ts +24 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-protocol.ts +452 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +4 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +12 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +4 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/imports.ts +4 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/node-at.ts +5 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +33 -12
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/blocking-test-bootstrap.mjs +34 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/bootstrap.mjs +8 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store-helpers.ts +23 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store.ts +400 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/request-control.ts +48 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-parser-helpers.ts +24 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-query-helpers.ts +43 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +421 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/service.ts +116 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/worker-main.ts +201 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/diagnostics.ts +236 -24
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/recovery.ts +6 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/provider.ts +58 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/readiness.ts +30 -9
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/apply.ts +45 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/mutation-authority.ts +143 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +9 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/types.ts +5 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan-timing.ts +9 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan.ts +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/deadline.ts +2 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +46 -32
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +12 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored.ts +20 -11
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/file.ts +18 -11
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/identity.ts +19 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/symbol.ts +36 -15
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/api.ts +4 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/diagnostics/evidence.ts +51 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/capability-adapter.ts +12 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/find-workflow.ts +17 -7
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +18 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph-workflow.ts +19 -12
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +148 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +37 -15
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +37 -39
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect/collect.ts +20 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-workflow.ts +10 -5
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +10 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-facts.ts +3 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-sections.ts +20 -7
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/gather.ts +17 -11
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +2 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-workflow.ts +15 -8
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-plans.ts +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +59 -14
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +4 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +54 -23
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/workflow-control.ts +7 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/lifecycle.ts +26 -46
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +199 -25
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/state.ts +2 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/workspace-provider-host.ts +25 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/execute.ts +7 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/render.ts +20 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/tui.ts +23 -21
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/execute.ts +23 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/tui.ts +59 -46
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/execute.ts +7 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/markdown.ts +56 -14
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/refresh-status.ts +105 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/tui.ts +95 -98
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/workflow-control.ts +8 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/execute.ts +7 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/tui.ts +26 -18
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/execute.ts +21 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/tui.ts +51 -35
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-apply/execute.ts +3 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-apply/tui.ts +43 -25
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-plan/execute.ts +4 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-plan/tui.ts +33 -20
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/register.ts +127 -22
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/execute.ts +18 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/tui.ts +42 -24
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/display.ts +107 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/errors.ts +20 -17
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/find.ts +52 -8
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/graph.ts +44 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/health.ts +53 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/inspect.ts +113 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/orientation.ts +66 -14
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/refactor.ts +36 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/resolve.ts +44 -7
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +20 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/execution.ts +18 -5
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/index.ts +8 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-command.ts +5 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-overlay.ts +4 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/common.ts +108 -10
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/display.ts +48 -0
- package/node_modules/@mrclrchtr/supi-core/README.md +2 -0
- package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
- package/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
- package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
- package/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
- package/package.json +6 -4
- package/src/audit/local-review-audit-store.ts +30 -6
- package/src/audit/replay-outline.ts +89 -0
- package/src/audit/review-audit-record.ts +40 -0
- package/src/audit/review-audit.ts +16 -4
- package/src/config.ts +44 -3
- package/src/git-command.ts +179 -23
- package/src/git.ts +71 -74
- package/src/history/collect.ts +13 -1
- package/src/model.ts +14 -0
- package/src/review-input.ts +72 -39
- package/src/review-limits.ts +1 -0
- package/src/review-path.ts +11 -63
- package/src/review-result.ts +7 -5
- package/src/review-scope.ts +164 -0
- package/src/review.ts +18 -342
- package/src/session/review-artifact-store.ts +2 -2
- package/src/target/change-metadata.ts +10 -9
- package/src/target/diff.ts +19 -16
- package/src/target/file-manifest.ts +1 -0
- package/src/target/packet.ts +78 -97
- package/src/target/resolve.ts +207 -227
- package/src/target/snapshot-match.ts +4 -23
- package/src/tool/agent-review-schemas.ts +135 -219
- package/src/tool/agent-review-tools.ts +65 -238
- package/src/tool/child-failure-diagnostics.ts +14 -156
- package/src/tool/child-session-runner.ts +119 -123
- package/src/tool/output-page.ts +33 -9
- package/src/tool/planner-input.ts +37 -0
- package/src/tool/planner-runner.ts +14 -13
- package/src/tool/post-review-policy.ts +9 -4
- package/src/tool/review-audit-tool.ts +159 -75
- package/src/tool/review-debug-summary.ts +8 -3
- package/src/tool/review-execution.ts +23 -7
- package/src/tool/review-format.ts +36 -27
- package/src/tool/review-output-tool.ts +20 -41
- package/src/tool/review-recovery.ts +191 -0
- package/src/tool/review-runner.ts +55 -14
- package/src/tool/review-system-prompt.ts +6 -6
- package/src/tool/review-tools.ts +45 -6
- package/src/tool/review-workflow.ts +250 -245
- package/src/tool/schemas.ts +32 -10
- package/src/tool/tool-specs.ts +137 -0
- package/src/tui/common.ts +18 -0
- package/src/tui/paged-output.ts +37 -14
- package/src/tui/review-command.ts +407 -0
- package/src/tui/review-scope-picker.ts +38 -0
- package/src/tui/review-target-picker.ts +106 -0
- package/src/tui/run.ts +90 -122
- package/src/types.ts +74 -88
- package/src/workspace/review-workspace.ts +59 -79
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime.ts +0 -351
- package/src/session/review-plan-store.ts +0 -124
- package/src/tool/child-lifecycle-trace.ts +0 -345
- package/src/tool/child-usage.ts +0 -73
- package/src/tool/criteria-only-scope.ts +0 -31
- package/src/tool/diagnostic-sanitizer.ts +0 -35
- package/src/tool/runner-helpers.ts +0 -52
- package/src/tool/session-lifecycle.ts +0 -281
- package/src/tui/prepare.ts +0 -187
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import type { AgentSession, SessionStats } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import type { AgentRunMessage, AgentRunSessionView } from "./types.ts";
|
|
3
|
+
|
|
4
|
+
const viewDeactivators = new WeakMap<object, () => void>();
|
|
5
|
+
|
|
6
|
+
/** Build the narrowed, control-free view supplied to runtime callbacks. */
|
|
7
|
+
export function createAgentRunSessionView(session: AgentSession, cwd: string): AgentRunSessionView {
|
|
8
|
+
let active = true;
|
|
9
|
+
let activeSession: AgentSession | undefined = session;
|
|
10
|
+
const subscriptions = new Set<() => void>();
|
|
11
|
+
const inactiveStats = Object.freeze({
|
|
12
|
+
sessionFile: undefined,
|
|
13
|
+
sessionId: "",
|
|
14
|
+
userMessages: 0,
|
|
15
|
+
assistantMessages: 0,
|
|
16
|
+
toolCalls: 0,
|
|
17
|
+
toolResults: 0,
|
|
18
|
+
totalMessages: 0,
|
|
19
|
+
tokens: Object.freeze({ input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 }),
|
|
20
|
+
cost: 0,
|
|
21
|
+
contextUsage: undefined,
|
|
22
|
+
}) as SessionStats;
|
|
23
|
+
const view: AgentRunSessionView = {
|
|
24
|
+
get cwd() {
|
|
25
|
+
return cwd;
|
|
26
|
+
},
|
|
27
|
+
get model() {
|
|
28
|
+
const current = activeSession;
|
|
29
|
+
return active && current ? snapshot(current.model) : undefined;
|
|
30
|
+
},
|
|
31
|
+
get thinkingLevel() {
|
|
32
|
+
const current = activeSession;
|
|
33
|
+
return active && current ? current.thinkingLevel : "off";
|
|
34
|
+
},
|
|
35
|
+
get isStreaming() {
|
|
36
|
+
const current = activeSession;
|
|
37
|
+
return active && current ? current.isStreaming : false;
|
|
38
|
+
},
|
|
39
|
+
get messages() {
|
|
40
|
+
const current = activeSession;
|
|
41
|
+
return active && current
|
|
42
|
+
? (snapshot(current.messages) as unknown as readonly AgentRunMessage[])
|
|
43
|
+
: Object.freeze([] as readonly AgentRunMessage[]);
|
|
44
|
+
},
|
|
45
|
+
getActiveToolNames: () => {
|
|
46
|
+
const current = activeSession;
|
|
47
|
+
if (!active || !current) return Object.freeze([] as string[]);
|
|
48
|
+
try {
|
|
49
|
+
return Object.freeze([...current.getActiveToolNames()]);
|
|
50
|
+
} catch {
|
|
51
|
+
return Object.freeze([] as string[]);
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
getSessionStats: () => {
|
|
55
|
+
const current = activeSession;
|
|
56
|
+
return active && current ? snapshot(current.getSessionStats()) : inactiveStats;
|
|
57
|
+
},
|
|
58
|
+
getLastAssistantText: () => {
|
|
59
|
+
const current = activeSession;
|
|
60
|
+
return active && current ? current.getLastAssistantText() : undefined;
|
|
61
|
+
},
|
|
62
|
+
subscribe: (listener) => {
|
|
63
|
+
const current = activeSession;
|
|
64
|
+
if (!active || !current) return () => undefined;
|
|
65
|
+
let sessionUnsubscribe: (() => void) | undefined;
|
|
66
|
+
const cleanup = (): void => {
|
|
67
|
+
subscriptions.delete(cleanup);
|
|
68
|
+
const unsubscribe = sessionUnsubscribe;
|
|
69
|
+
sessionUnsubscribe = undefined;
|
|
70
|
+
unsubscribe?.();
|
|
71
|
+
};
|
|
72
|
+
sessionUnsubscribe = current.subscribe((event) => {
|
|
73
|
+
if (!active || activeSession === undefined) return;
|
|
74
|
+
try {
|
|
75
|
+
listener(snapshot(event));
|
|
76
|
+
} catch {
|
|
77
|
+
// Observer failures must not change Agent Run lifecycle semantics.
|
|
78
|
+
}
|
|
79
|
+
});
|
|
80
|
+
subscriptions.add(cleanup);
|
|
81
|
+
return cleanup;
|
|
82
|
+
},
|
|
83
|
+
};
|
|
84
|
+
viewDeactivators.set(view, () => {
|
|
85
|
+
if (!active) return;
|
|
86
|
+
active = false;
|
|
87
|
+
for (const unsubscribe of subscriptions) unsubscribe();
|
|
88
|
+
subscriptions.clear();
|
|
89
|
+
activeSession = undefined;
|
|
90
|
+
});
|
|
91
|
+
return Object.freeze(view);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/** Disable a callback view before its owned session is disposed. */
|
|
95
|
+
export function deactivateAgentRunSessionView(view: AgentRunSessionView): void {
|
|
96
|
+
viewDeactivators.get(view)?.();
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
function snapshot<T>(value: T): T {
|
|
100
|
+
const seen = new WeakMap<object, unknown>();
|
|
101
|
+
|
|
102
|
+
const clone = (current: unknown): unknown => {
|
|
103
|
+
if (current === null || typeof current !== "object") return current;
|
|
104
|
+
const existing = seen.get(current);
|
|
105
|
+
if (existing) return existing;
|
|
106
|
+
if (Array.isArray(current)) {
|
|
107
|
+
const array: unknown[] = [];
|
|
108
|
+
seen.set(current, array);
|
|
109
|
+
for (const item of current) array.push(clone(item));
|
|
110
|
+
return Object.freeze(array);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
const object: Record<string, unknown> = {};
|
|
114
|
+
seen.set(current, object);
|
|
115
|
+
for (const [key, item] of Object.entries(current)) object[key] = clone(item);
|
|
116
|
+
return Object.freeze(object);
|
|
117
|
+
};
|
|
118
|
+
|
|
119
|
+
return clone(value) as T;
|
|
120
|
+
}
|
|
@@ -0,0 +1,289 @@
|
|
|
1
|
+
import type { Model, ModelThinkingLevel, Usage } from "@earendil-works/pi-ai";
|
|
2
|
+
import type {
|
|
3
|
+
AgentSessionEvent,
|
|
4
|
+
ResourceLoader,
|
|
5
|
+
SessionStats,
|
|
6
|
+
SettingsManager,
|
|
7
|
+
ToolDefinition,
|
|
8
|
+
} from "@earendil-works/pi-coding-agent";
|
|
9
|
+
import type { AgentRunProviderAuthority } from "./provider-authority.ts";
|
|
10
|
+
|
|
11
|
+
/** The host-owned failure stages of one Agent Run. */
|
|
12
|
+
export type AgentRunFailureCode =
|
|
13
|
+
| "session-creation-failed"
|
|
14
|
+
| "session-not-ready"
|
|
15
|
+
| "prompt-rejected"
|
|
16
|
+
| "missing-completion"
|
|
17
|
+
| "unexpected-runner-failure";
|
|
18
|
+
|
|
19
|
+
/** Terminal outcome of one managed Agent Run. */
|
|
20
|
+
export type AgentRunOutcome<T> =
|
|
21
|
+
| { kind: "success"; value: T; usage?: Usage }
|
|
22
|
+
| ({ kind: "failed"; usage?: Usage } & (
|
|
23
|
+
| { failureCode: "session-creation-failed"; diagnostics?: never }
|
|
24
|
+
| {
|
|
25
|
+
failureCode: Exclude<AgentRunFailureCode, "session-creation-failed">;
|
|
26
|
+
diagnostics: AgentRunDiagnostics;
|
|
27
|
+
}
|
|
28
|
+
))
|
|
29
|
+
| { kind: "canceled"; diagnostics: AgentRunDiagnostics; usage?: Usage }
|
|
30
|
+
| { kind: "timeout"; timeoutMs: number; diagnostics: AgentRunDiagnostics; usage?: Usage };
|
|
31
|
+
|
|
32
|
+
/** Caller-owned resources and policy used to create an Agent Run session. */
|
|
33
|
+
export interface AgentSessionInputs {
|
|
34
|
+
/** Working directory used for tools and resource discovery. */
|
|
35
|
+
cwd: string;
|
|
36
|
+
/** Effective model selected by the caller. */
|
|
37
|
+
// biome-ignore lint/suspicious/noExplicitAny: Model<any> is Pi's canonical type
|
|
38
|
+
model: Model<any>;
|
|
39
|
+
/** Additional models that a finite continuation can select in this Agent Run. */
|
|
40
|
+
// biome-ignore lint/suspicious/noExplicitAny: Model<any> is Pi's canonical type
|
|
41
|
+
readonly authorizedContinuationModels?: readonly Model<any>[];
|
|
42
|
+
/** Caller-owned provider and credential authority borrowed for this run. */
|
|
43
|
+
providerAuthority: AgentRunProviderAuthority;
|
|
44
|
+
/** Effective thinking level, normally clamped by the caller. */
|
|
45
|
+
thinkingLevel: ModelThinkingLevel;
|
|
46
|
+
/** Complete built-in and custom-tool allowlist for the run. */
|
|
47
|
+
readonly tools: readonly string[];
|
|
48
|
+
/** Optional active subset used for the initial prompt. Defaults to the complete allowlist. */
|
|
49
|
+
readonly initialActiveTools?: readonly string[];
|
|
50
|
+
/** Caller-owned custom tool definitions. */
|
|
51
|
+
readonly customTools?: readonly ToolDefinition[];
|
|
52
|
+
/** Explicit resource policy for this run. */
|
|
53
|
+
resourceLoader: ResourceLoader;
|
|
54
|
+
/** Explicit settings policy for this run. */
|
|
55
|
+
settingsManager: SettingsManager;
|
|
56
|
+
/** Optional PI agent directory; defaults to PI's configured directory. */
|
|
57
|
+
agentDir?: string;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** Read-only message shape exposed to caller-owned completion and observer callbacks. */
|
|
61
|
+
export interface AgentRunMessage {
|
|
62
|
+
readonly role: string;
|
|
63
|
+
readonly content?: unknown;
|
|
64
|
+
readonly usage?: Usage;
|
|
65
|
+
readonly [key: string]: unknown;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/** Read-only view of the owned session exposed to caller-owned callbacks. */
|
|
69
|
+
export interface AgentRunSessionView {
|
|
70
|
+
readonly cwd: string;
|
|
71
|
+
// biome-ignore lint/suspicious/noExplicitAny: Model<any> is Pi's canonical type
|
|
72
|
+
readonly model: Readonly<Model<any>> | undefined;
|
|
73
|
+
readonly thinkingLevel: ModelThinkingLevel;
|
|
74
|
+
readonly isStreaming: boolean;
|
|
75
|
+
readonly messages: readonly AgentRunMessage[];
|
|
76
|
+
/** Return a defensive copy of the current active tool names. */
|
|
77
|
+
getActiveToolNames(): readonly string[];
|
|
78
|
+
/** Return PI's current aggregate session statistics. */
|
|
79
|
+
getSessionStats(): SessionStats;
|
|
80
|
+
/** Return the last visible assistant text, when PI has one. */
|
|
81
|
+
getLastAssistantText(): string | undefined;
|
|
82
|
+
/** Observe session events; the runtime still owns the session lifecycle. */
|
|
83
|
+
subscribe(listener: (event: AgentSessionEvent) => void): () => void;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** Caller-owned function that derives required domain completion from a settled view. */
|
|
87
|
+
export type CompletionResolver<T> = (
|
|
88
|
+
session: AgentRunSessionView,
|
|
89
|
+
) => T | undefined | Promise<T | undefined>;
|
|
90
|
+
|
|
91
|
+
/** Caller-owned post-bind, pre-prompt capability check. */
|
|
92
|
+
export type SessionReadinessCheck = (
|
|
93
|
+
session: AgentRunSessionView,
|
|
94
|
+
) => boolean | undefined | Promise<boolean | undefined>;
|
|
95
|
+
|
|
96
|
+
/** Caller-owned evidence hook. Its disposer runs before normal disposal; forced teardown may run it later. */
|
|
97
|
+
export type AgentRunObserver = (
|
|
98
|
+
session: AgentRunSessionView,
|
|
99
|
+
) => undefined | (() => void) | Promise<undefined | (() => void)>;
|
|
100
|
+
|
|
101
|
+
/** Failure that a finite continuation can handle after the accepted initial prompt settles. */
|
|
102
|
+
export type AgentRunContinuationFailureCode = "missing-completion" | "unexpected-runner-failure";
|
|
103
|
+
|
|
104
|
+
/** One declarative same-session continuation step selected by the caller. */
|
|
105
|
+
export interface AgentRunContinuationStep {
|
|
106
|
+
/** Prompt sent from retained session history. */
|
|
107
|
+
prompt: string;
|
|
108
|
+
/** Complete active-tool replacement for this turn. */
|
|
109
|
+
readonly activeTools: readonly string[];
|
|
110
|
+
/** Thinking level applied before this turn. */
|
|
111
|
+
thinkingLevel: ModelThinkingLevel;
|
|
112
|
+
/** Optional requested model switch. Omission keeps the current model. */
|
|
113
|
+
readonly model?: {
|
|
114
|
+
/** Canonical requested model id retained when model resolution failed. */
|
|
115
|
+
readonly modelId: string;
|
|
116
|
+
/** Resolved model. Omission makes the model switch fail closed. */
|
|
117
|
+
// biome-ignore lint/suspicious/noExplicitAny: Model<any> is Pi's canonical type
|
|
118
|
+
readonly value?: Model<any>;
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** Result of one runtime-owned continuation step. */
|
|
123
|
+
export interface AgentRunContinuationTurn {
|
|
124
|
+
readonly turn: number;
|
|
125
|
+
readonly modelId: string;
|
|
126
|
+
readonly outcome: "settled" | "provider-failed" | "model-switch-failed";
|
|
127
|
+
readonly promptAccepted: boolean;
|
|
128
|
+
readonly usage?: Usage;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/** Read-only context used to select the next finite continuation step. */
|
|
132
|
+
export interface AgentRunContinuationContext {
|
|
133
|
+
readonly session: AgentRunSessionView;
|
|
134
|
+
readonly initialFailureCode: AgentRunContinuationFailureCode;
|
|
135
|
+
readonly nextTurn: number;
|
|
136
|
+
readonly previousTurn?: AgentRunContinuationTurn;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** Bounded host observation emitted while the runtime performs continuation mechanics. */
|
|
140
|
+
export type AgentRunContinuationEvent =
|
|
141
|
+
| { type: "turn-start"; turn: number; modelId: string }
|
|
142
|
+
| { type: "model-switch"; turn: number; modelId: string; success: boolean }
|
|
143
|
+
| {
|
|
144
|
+
type: "turn-end";
|
|
145
|
+
turn: number;
|
|
146
|
+
modelId: string;
|
|
147
|
+
outcome: AgentRunContinuationTurn["outcome"];
|
|
148
|
+
};
|
|
149
|
+
|
|
150
|
+
/** Caller-owned finite continuation policy. The runtime executes every selected step. */
|
|
151
|
+
export interface AgentRunContinuation {
|
|
152
|
+
/** Hard upper bound for continuation turns. */
|
|
153
|
+
maxTurns: number;
|
|
154
|
+
/** Select the next declarative step, or stop the continuation. */
|
|
155
|
+
resolveNext(
|
|
156
|
+
context: AgentRunContinuationContext,
|
|
157
|
+
): AgentRunContinuationStep | undefined | Promise<AgentRunContinuationStep | undefined>;
|
|
158
|
+
/** Optional bounded evidence observer for continuation mechanics. */
|
|
159
|
+
onEvent?: (event: AgentRunContinuationEvent) => void;
|
|
160
|
+
/** Optional per-turn observer for domain result mapping and usage provenance. */
|
|
161
|
+
onTurn?: (turn: AgentRunContinuationTurn) => void;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** Non-terminal and terminal status exposed through progress snapshots. */
|
|
165
|
+
export type AgentRunStatus =
|
|
166
|
+
| "starting"
|
|
167
|
+
| "running"
|
|
168
|
+
| "stopping"
|
|
169
|
+
| "completed"
|
|
170
|
+
| "failed"
|
|
171
|
+
| "canceled"
|
|
172
|
+
| "timeout";
|
|
173
|
+
|
|
174
|
+
/** Immutable-by-convention progress snapshot for one Agent Run. */
|
|
175
|
+
export interface AgentRunProgress {
|
|
176
|
+
readonly status: AgentRunStatus;
|
|
177
|
+
readonly turns: number;
|
|
178
|
+
readonly toolUses: number;
|
|
179
|
+
/** Tool executions that returned an error. */
|
|
180
|
+
readonly toolErrors: number;
|
|
181
|
+
readonly usage?: Usage;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/** Allowlisted lifecycle trace retained for normal diagnostics. */
|
|
185
|
+
export interface AgentRunLifecycleTrace {
|
|
186
|
+
readonly entries: readonly AgentRunLifecycleTraceEntry[];
|
|
187
|
+
readonly droppedCount: number;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/** Safe assistant stop reasons retained in normal diagnostics. */
|
|
191
|
+
export type SafeAssistantStopReason = "stop" | "length" | "toolUse" | "error" | "aborted";
|
|
192
|
+
|
|
193
|
+
/** Bounded, redacted diagnostics retained on non-success outcomes. */
|
|
194
|
+
export interface AgentRunDiagnostics {
|
|
195
|
+
readonly lifecycleTrace: AgentRunLifecycleTrace;
|
|
196
|
+
readonly turns: number;
|
|
197
|
+
readonly toolUses: number;
|
|
198
|
+
readonly tokens?: {
|
|
199
|
+
readonly input: number;
|
|
200
|
+
readonly output: number;
|
|
201
|
+
readonly total: number;
|
|
202
|
+
readonly cacheRead?: number;
|
|
203
|
+
readonly cacheWrite?: number;
|
|
204
|
+
};
|
|
205
|
+
readonly recentActivity?: readonly string[];
|
|
206
|
+
readonly lastAssistantStopReason?: SafeAssistantStopReason;
|
|
207
|
+
readonly lastAssistantToolCalls?: readonly string[];
|
|
208
|
+
readonly lastAssistantToolCallsDropped?: number;
|
|
209
|
+
readonly lastAssistantErrorText?: string;
|
|
210
|
+
readonly lastLifecycleErrorText?: string;
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/** Safe lifecycle event metadata retained in the bounded diagnostic tail. */
|
|
214
|
+
export type AgentRunLifecycleTraceEntry =
|
|
215
|
+
| { type: "agent_start" }
|
|
216
|
+
| { type: "agent_end"; willRetry: boolean }
|
|
217
|
+
| { type: "agent_settled" }
|
|
218
|
+
| { type: "compaction_start"; reason: "manual" | "threshold" | "overflow" }
|
|
219
|
+
| {
|
|
220
|
+
type: "compaction_end";
|
|
221
|
+
reason: "manual" | "threshold" | "overflow";
|
|
222
|
+
aborted: boolean;
|
|
223
|
+
willRetry: boolean;
|
|
224
|
+
hasResult: boolean;
|
|
225
|
+
hasError: boolean;
|
|
226
|
+
errorText?: string;
|
|
227
|
+
}
|
|
228
|
+
| { type: "auto_retry_start"; attempt: number; maxAttempts: number; delayMs: number }
|
|
229
|
+
| {
|
|
230
|
+
type: "auto_retry_end";
|
|
231
|
+
success: boolean;
|
|
232
|
+
attempt: number;
|
|
233
|
+
hasFinalError: boolean;
|
|
234
|
+
finalErrorText?: string;
|
|
235
|
+
}
|
|
236
|
+
| {
|
|
237
|
+
type: "summarization_retry_scheduled";
|
|
238
|
+
attempt: number;
|
|
239
|
+
maxAttempts: number;
|
|
240
|
+
delayMs: number;
|
|
241
|
+
}
|
|
242
|
+
| {
|
|
243
|
+
type: "summarization_retry_attempt_start";
|
|
244
|
+
source: "branchSummary" | "compaction";
|
|
245
|
+
reason?: "manual" | "threshold" | "overflow";
|
|
246
|
+
}
|
|
247
|
+
| { type: "summarization_retry_finished" }
|
|
248
|
+
| { type: "queue_update"; steeringCount: number; followUpCount: number }
|
|
249
|
+
| { type: "timeout_expired" }
|
|
250
|
+
| { type: "abort_requested"; reason: "canceled" | "timeout" }
|
|
251
|
+
| { type: "prompt_rejected" };
|
|
252
|
+
|
|
253
|
+
/** Result returned by an active-only steering request. */
|
|
254
|
+
export type AgentRunSteerResult = "accepted" | "not-running";
|
|
255
|
+
|
|
256
|
+
/** Listener used by the Agent Run Handle progress subscription. */
|
|
257
|
+
export type AgentRunProgressListener = (progress: AgentRunProgress) => void;
|
|
258
|
+
|
|
259
|
+
/** Options accepted by `startAgentRun`. */
|
|
260
|
+
export interface StartAgentRunOptions<T> {
|
|
261
|
+
/** Caller-owned session inputs and resource policy. */
|
|
262
|
+
inputs: AgentSessionInputs;
|
|
263
|
+
/** Initial user prompt sent after readiness succeeds. */
|
|
264
|
+
prompt: string;
|
|
265
|
+
/** Caller-owned completion derivation. */
|
|
266
|
+
completionResolver: CompletionResolver<T>;
|
|
267
|
+
/** Optional caller-owned readiness check. */
|
|
268
|
+
readinessCheck?: SessionReadinessCheck;
|
|
269
|
+
/** Optional caller-owned evidence observer. */
|
|
270
|
+
observer?: AgentRunObserver;
|
|
271
|
+
/** Optional bounded same-session continuation after an accepted recoverable failure. */
|
|
272
|
+
continuation?: AgentRunContinuation;
|
|
273
|
+
/** Optional host timeout, measured from immediately before prompting. */
|
|
274
|
+
timeoutMs?: number;
|
|
275
|
+
/** Optional containing-session cancellation signal. */
|
|
276
|
+
signal?: AbortSignal;
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
/** Sole public control interface for one Agent Run. */
|
|
280
|
+
export interface AgentRunHandle<T> {
|
|
281
|
+
/** Terminal outcome, including all usage attributable to the owned Agent Run session. */
|
|
282
|
+
readonly result: Promise<AgentRunOutcome<T>>;
|
|
283
|
+
/** Subscribe to immutable progress snapshots; the current snapshot is immediate. */
|
|
284
|
+
subscribe(listener: AgentRunProgressListener): () => void;
|
|
285
|
+
/** Queue a steering message only while the run is actively prompting. */
|
|
286
|
+
steer(message: string): Promise<AgentRunSteerResult>;
|
|
287
|
+
/** Stop the run; repeated calls share the same terminal cleanup. */
|
|
288
|
+
stop(): Promise<void>;
|
|
289
|
+
}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
import type { Usage } from "@earendil-works/pi-ai";
|
|
2
|
+
import type { AgentSession } from "@earendil-works/pi-coding-agent";
|
|
3
|
+
|
|
4
|
+
function addOptional(first: number | undefined, second: number | undefined): number | undefined {
|
|
5
|
+
return first === undefined && second === undefined ? undefined : (first ?? 0) + (second ?? 0);
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
/** Add two PI Usage records while preserving optional reasoning/cache fields. */
|
|
9
|
+
export function addAgentRunUsage(first: Usage, second: Usage): Usage {
|
|
10
|
+
const cacheWrite1h = addOptional(first.cacheWrite1h, second.cacheWrite1h);
|
|
11
|
+
const reasoning = addOptional(first.reasoning, second.reasoning);
|
|
12
|
+
return {
|
|
13
|
+
input: first.input + second.input,
|
|
14
|
+
output: first.output + second.output,
|
|
15
|
+
cacheRead: first.cacheRead + second.cacheRead,
|
|
16
|
+
cacheWrite: first.cacheWrite + second.cacheWrite,
|
|
17
|
+
...(cacheWrite1h === undefined ? {} : { cacheWrite1h }),
|
|
18
|
+
...(reasoning === undefined ? {} : { reasoning }),
|
|
19
|
+
totalTokens: first.totalTokens + second.totalTokens,
|
|
20
|
+
cost: {
|
|
21
|
+
input: first.cost.input + second.cost.input,
|
|
22
|
+
output: first.cost.output + second.cost.output,
|
|
23
|
+
cacheRead: first.cost.cacheRead + second.cost.cacheRead,
|
|
24
|
+
cacheWrite: first.cost.cacheWrite + second.cost.cacheWrite,
|
|
25
|
+
total: first.cost.total + second.cost.total,
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Combine available usage records, returning undefined when none were reported. */
|
|
31
|
+
export function combineAgentRunUsage(usages: readonly (Usage | undefined)[]): Usage | undefined {
|
|
32
|
+
return usages.reduce<Usage | undefined>(
|
|
33
|
+
(total, usage) => (usage ? (total ? addAgentRunUsage(total, usage) : usage) : total),
|
|
34
|
+
undefined,
|
|
35
|
+
);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Collect every usage-bearing entry owned by the in-memory Agent Run session.
|
|
40
|
+
* This includes assistant turns, tool-result work, compaction, branch summaries, and
|
|
41
|
+
* finalized/live messages that have not reached session persistence yet.
|
|
42
|
+
*/
|
|
43
|
+
export function collectAgentRunUsage(session: AgentSession): Usage | undefined {
|
|
44
|
+
const knownMessages = new Set<object>();
|
|
45
|
+
const usages = [
|
|
46
|
+
...collectEntryUsage(session, knownMessages),
|
|
47
|
+
...collectLiveMessageUsage(session, knownMessages),
|
|
48
|
+
collectStreamingUsage(session, knownMessages),
|
|
49
|
+
];
|
|
50
|
+
return combineAgentRunUsage(usages) ?? collectStatsUsage(session);
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function collectEntryUsage(session: AgentSession, knownMessages: Set<object>): Usage[] {
|
|
54
|
+
const usages: Usage[] = [];
|
|
55
|
+
try {
|
|
56
|
+
for (const entry of session.sessionManager.getEntries()) {
|
|
57
|
+
if (entry.type === "message") {
|
|
58
|
+
if (isObject(entry.message)) knownMessages.add(entry.message);
|
|
59
|
+
pushUsage(usages, entry.message);
|
|
60
|
+
} else if (entry.type === "compaction" || entry.type === "branch_summary") {
|
|
61
|
+
pushUsage(usages, entry);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
} catch {
|
|
65
|
+
// Test doubles and older PI versions may not expose session entries.
|
|
66
|
+
}
|
|
67
|
+
return usages;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
function collectLiveMessageUsage(session: AgentSession, knownMessages: Set<object>): Usage[] {
|
|
71
|
+
const usages: Usage[] = [];
|
|
72
|
+
try {
|
|
73
|
+
for (const message of session.messages) {
|
|
74
|
+
if (isObject(message) && knownMessages.has(message)) continue;
|
|
75
|
+
if (isObject(message)) knownMessages.add(message);
|
|
76
|
+
pushUsage(usages, message);
|
|
77
|
+
}
|
|
78
|
+
} catch {
|
|
79
|
+
// Continue with streaming state and the best-effort stats snapshot.
|
|
80
|
+
}
|
|
81
|
+
return usages;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function collectStreamingUsage(
|
|
85
|
+
session: AgentSession,
|
|
86
|
+
knownMessages: Set<object>,
|
|
87
|
+
): Usage | undefined {
|
|
88
|
+
try {
|
|
89
|
+
const message = session.agent.state.streamingMessage;
|
|
90
|
+
if (isObject(message) && !knownMessages.has(message)) return readUsage(message);
|
|
91
|
+
} catch {
|
|
92
|
+
// Continue with the best-effort stats snapshot.
|
|
93
|
+
}
|
|
94
|
+
return undefined;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
function collectStatsUsage(session: AgentSession): Usage | undefined {
|
|
98
|
+
try {
|
|
99
|
+
const stats = session.getSessionStats();
|
|
100
|
+
const tokens = stats.tokens;
|
|
101
|
+
if (!tokens.input && !tokens.output && !tokens.cacheRead && !tokens.cacheWrite)
|
|
102
|
+
return undefined;
|
|
103
|
+
return {
|
|
104
|
+
input: tokens.input,
|
|
105
|
+
output: tokens.output,
|
|
106
|
+
cacheRead: tokens.cacheRead,
|
|
107
|
+
cacheWrite: tokens.cacheWrite,
|
|
108
|
+
totalTokens: tokens.total,
|
|
109
|
+
cost: {
|
|
110
|
+
input: 0,
|
|
111
|
+
output: 0,
|
|
112
|
+
cacheRead: 0,
|
|
113
|
+
cacheWrite: 0,
|
|
114
|
+
total: stats.cost,
|
|
115
|
+
},
|
|
116
|
+
};
|
|
117
|
+
} catch {
|
|
118
|
+
// Usage is optional when PI cannot expose a stable snapshot.
|
|
119
|
+
return undefined;
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
function pushUsage(usages: Usage[], value: unknown): void {
|
|
124
|
+
const usage = readUsage(value);
|
|
125
|
+
if (usage) usages.push(usage);
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
function isObject(value: unknown): value is object {
|
|
129
|
+
return typeof value === "object" && value !== null;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function readUsage(value: unknown): Usage | undefined {
|
|
133
|
+
if (!value || typeof value !== "object") return undefined;
|
|
134
|
+
const candidate = value as { usage?: unknown };
|
|
135
|
+
return normalizeUsage(candidate.usage ?? value);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function normalizeUsage(value: unknown): Usage | undefined {
|
|
139
|
+
if (!value || typeof value !== "object") return undefined;
|
|
140
|
+
const candidate = value as Record<string, unknown>;
|
|
141
|
+
if (
|
|
142
|
+
typeof candidate.input !== "number" ||
|
|
143
|
+
typeof candidate.output !== "number" ||
|
|
144
|
+
typeof candidate.cacheRead !== "number" ||
|
|
145
|
+
typeof candidate.cacheWrite !== "number" ||
|
|
146
|
+
typeof candidate.totalTokens !== "number"
|
|
147
|
+
) {
|
|
148
|
+
return undefined;
|
|
149
|
+
}
|
|
150
|
+
const cost = candidate.cost;
|
|
151
|
+
const costRecord = cost && typeof cost === "object" ? (cost as Record<string, unknown>) : {};
|
|
152
|
+
const numberOrZero = (number: unknown) => (typeof number === "number" ? number : 0);
|
|
153
|
+
const optionalNumber = (number: unknown) => (typeof number === "number" ? number : undefined);
|
|
154
|
+
const cacheWrite1h = optionalNumber(candidate.cacheWrite1h);
|
|
155
|
+
const reasoning = optionalNumber(candidate.reasoning);
|
|
156
|
+
return {
|
|
157
|
+
input: candidate.input,
|
|
158
|
+
output: candidate.output,
|
|
159
|
+
cacheRead: candidate.cacheRead,
|
|
160
|
+
cacheWrite: candidate.cacheWrite,
|
|
161
|
+
totalTokens: candidate.totalTokens,
|
|
162
|
+
cost: {
|
|
163
|
+
input: numberOrZero(costRecord.input),
|
|
164
|
+
output: numberOrZero(costRecord.output),
|
|
165
|
+
cacheRead: numberOrZero(costRecord.cacheRead),
|
|
166
|
+
cacheWrite: numberOrZero(costRecord.cacheWrite),
|
|
167
|
+
total: numberOrZero(costRecord.total),
|
|
168
|
+
},
|
|
169
|
+
...(cacheWrite1h === undefined ? {} : { cacheWrite1h }),
|
|
170
|
+
...(reasoning === undefined ? {} : { reasoning }),
|
|
171
|
+
};
|
|
172
|
+
}
|
|
@@ -24,7 +24,8 @@ After installation, keep asking Pi normal coding questions. The agent can:
|
|
|
24
24
|
- **Map an unfamiliar repository** — understand workspaces, packages, entry points, dependencies, and local `CLAUDE.md` or `AGENTS.md` instructions before editing.
|
|
25
25
|
- **Navigate precisely with LSP** — identify the exact symbol at a source location and inspect its type, definition, enclosing declaration, and nearby diagnostics.
|
|
26
26
|
- **Follow relationships across LSP and AST evidence** — find references, implementations, and outgoing calls without guessing from matching text.
|
|
27
|
-
- **Search parsed code structure** — query AST definitions, types, interfaces, classes, methods, enums, imports, exports, and call sites.
|
|
27
|
+
- **Search parsed code structure** — query AST definitions, types, interfaces, classes, methods, enums, imports, exports, and call sites. One owned Structural Worker keeps Pi responsive. Tool cancellation and the shared AST deadline propagate through an atomic cancellation flag into Worker reads, parser progress, and query progress.
|
|
28
|
+
- **Correlate diagnostics** — each public `code_*` call gets one session-local opaque Debug Operation ID. Directly owned workflow, LSP, AST Scan, and Structural Worker events share it without changing normal Tool results.
|
|
28
29
|
- **Check live project health** — inspect language-server status and current errors or warnings, with an option to refresh stale diagnostics.
|
|
29
30
|
- **Refactor safely** — preview language-aware renames and extractions before applying them. Plans are rejected if the files changed in the meantime.
|
|
30
31
|
- **See uncertainty clearly** — results distinguish “nothing found” from incomplete or unavailable analysis and disclose omitted matches.
|
|
@@ -22,6 +22,8 @@ Read-only provider methods return `CodeQueryResult<T>`:
|
|
|
22
22
|
|
|
23
23
|
This keeps successful zero-result facts distinct from routing, transport, and provider failures.
|
|
24
24
|
|
|
25
|
+
Semantic and structural provider methods also accept optional `CodeRequestControl` metadata. It contains a caller `AbortSignal`, an absolute Unix-epoch deadline, and an optional opaque Debug Operation ID. Adapters preserve the same object. The ID does not change cancellation semantics. Canonical helpers identify cancellation and deadline expiry across bundled package copies. Cooperative structural substrates apply the control; unsupported substrates can preserve it without applying behavior.
|
|
26
|
+
|
|
25
27
|
## License
|
|
26
28
|
|
|
27
29
|
MIT
|
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
// Capability interfaces and availability states
|
|
10
10
|
export type {
|
|
11
11
|
CapabilityState,
|
|
12
|
+
CodeRequestControl,
|
|
12
13
|
SemanticProvider,
|
|
13
14
|
StructuralProvider,
|
|
14
15
|
StructuralResult,
|
|
@@ -21,6 +22,13 @@ export {
|
|
|
21
22
|
partialCodeQuery,
|
|
22
23
|
unavailableCodeQuery,
|
|
23
24
|
} from "./query-result.ts";
|
|
25
|
+
export {
|
|
26
|
+
CodeRequestDeadlineError,
|
|
27
|
+
isCodeRequestDeadlineError,
|
|
28
|
+
isCodeRequestInterrupted,
|
|
29
|
+
isCodeRequestInterruption,
|
|
30
|
+
throwIfCodeRequestInterrupted,
|
|
31
|
+
} from "./request-control.ts";
|
|
24
32
|
// Shared canonical types
|
|
25
33
|
export type {
|
|
26
34
|
CalleeDepth,
|
|
@@ -34,6 +42,7 @@ export type {
|
|
|
34
42
|
DeclarationNesting,
|
|
35
43
|
DisambiguationCandidate,
|
|
36
44
|
DocumentCodeSymbol,
|
|
45
|
+
DocumentEditPrecondition,
|
|
37
46
|
ExportData,
|
|
38
47
|
FileEdit,
|
|
39
48
|
ImportData,
|