@mrclrchtr/supi-review 10.0.0 → 11.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/node_modules/@mrclrchtr/supi-agent-runtime/README.md +11 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +2 -2
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/api.ts +2 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-data.ts +61 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-message-validation.ts +230 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/context-validation.ts +249 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/context.ts +33 -0
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/run.ts +34 -8
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/types.ts +14 -2
- package/node_modules/@mrclrchtr/supi-agent-runtime/src/usage.ts +175 -25
- package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +77 -21
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/README.md +743 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/index.js +17 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/constants.js +184 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/parse.js +1425 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/picomatch.js +361 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/scan.js +403 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/lib/utils.js +72 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/package.json +83 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/posix.js +3 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -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-lsp/README.md +88 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/picomatch/LICENSE +21 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/file-associations.ts +190 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -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/package.json +3 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +1 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +3 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +6 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-request-enrollment.ts +66 -22
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-barrier.ts +37 -5
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +136 -43
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +261 -22
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +13 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-discovery.ts +151 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-normalizer.ts +97 -129
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-protocol.ts +132 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +8 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +7 -20
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-rename.ts +172 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +14 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/utils.ts +12 -11
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/README.md +63 -17
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +4 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +11 -0
- 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
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +22 -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/package.json +3 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/language.ts +16 -10
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/operation-support.ts +13 -6
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +19 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime-controller.ts +18 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/session.ts +10 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +17 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-process.ts +22 -5
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-protocol.ts +36 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/syntax-errors.ts +73 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/syntax-node.ts +4 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +15 -9
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +24 -15
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +8 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/imports.ts +233 -7
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/node-at.ts +7 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-expansion.ts +78 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-jvm.ts +25 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-nested.ts +390 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline.ts +49 -28
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +16 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/process-host.mjs +61 -24
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +44 -10
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/service.ts +13 -9
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/worker-main.ts +15 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/ignore/README.md +61 -6
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/ignore/index.d.ts +55 -20
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/ignore/index.js +93 -67
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/ignore/legacy.js +109 -85
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/ignore/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/apply.ts +35 -14
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +9 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/implementations.ts +7 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +90 -12
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +1 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored-structural.ts +1 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/discovery.ts +29 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/file.ts +19 -9
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/types.ts +5 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/config.ts +46 -7
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +2 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph-types.ts +6 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect/collect.ts +35 -20
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-types.ts +9 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +90 -18
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-sections.ts +22 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/gather.ts +46 -6
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +7 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-plans.ts +17 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +13 -6
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-store.ts +5 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +3 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/workspace-provider-host.ts +22 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/markdown.ts +17 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/result.ts +17 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/details.ts +2 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/display.ts +1 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/format.ts +1 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/result.ts +32 -6
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/markdown.ts +15 -1
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/result.ts +11 -0
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/result.ts +4 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/markdown.ts +34 -14
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/result.ts +7 -3
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +20 -2
- package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/display.ts +2 -1
- package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
- package/package.json +4 -4
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/LICENSE-MIT +0 -21
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/README.md +0 -501
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.d.ts +0 -81
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.js +0 -1566
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/legacy.js +0 -1346
- package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/package.json +0 -93
|
@@ -12,13 +12,18 @@ import {
|
|
|
12
12
|
createAgentSession,
|
|
13
13
|
createAgentSessionRuntime,
|
|
14
14
|
getAgentDir,
|
|
15
|
-
SessionManager,
|
|
16
15
|
} from "@earendil-works/pi-coding-agent";
|
|
16
|
+
import {
|
|
17
|
+
captureAgentRunContext,
|
|
18
|
+
cloneAgentRunContext,
|
|
19
|
+
createAgentRunSessionManager,
|
|
20
|
+
} from "./context.ts";
|
|
17
21
|
import { buildAgentRunDiagnostics } from "./diagnostics.ts";
|
|
18
22
|
import { AgentRunLifecycleTraceCollector, getRegisteredToolNames } from "./lifecycle-trace.ts";
|
|
19
23
|
import { createAgentRunModelRuntime } from "./provider-authority.ts";
|
|
20
24
|
import { createAgentRunSessionView, deactivateAgentRunSessionView } from "./session-view.ts";
|
|
21
25
|
import type {
|
|
26
|
+
AgentRunContext,
|
|
22
27
|
AgentRunContinuationEvent,
|
|
23
28
|
AgentRunContinuationFailureCode,
|
|
24
29
|
AgentRunContinuationStep,
|
|
@@ -35,7 +40,11 @@ import type {
|
|
|
35
40
|
StartAgentRunOptions,
|
|
36
41
|
StartRegisteredAgentRunOptions,
|
|
37
42
|
} from "./types.ts";
|
|
38
|
-
import {
|
|
43
|
+
import {
|
|
44
|
+
type AgentRunUsageBaseline,
|
|
45
|
+
collectAgentRunUsage,
|
|
46
|
+
createAgentRunUsageBaseline,
|
|
47
|
+
} from "./usage.ts";
|
|
39
48
|
|
|
40
49
|
/** Grace period for a provider abort before disposal continues. */
|
|
41
50
|
export const AGENT_RUN_ABORT_GRACE_MS = 2_000;
|
|
@@ -71,6 +80,8 @@ export const AGENT_RUN_MAX_CONTINUATION_TURNS = 8;
|
|
|
71
80
|
/** Start one foreground Agent Run and return its control handle immediately. */
|
|
72
81
|
// biome-ignore lint/complexity/noExcessiveLinesPerFunction: lifecycle state and teardown stay in one audited closure.
|
|
73
82
|
export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHandle<T> {
|
|
83
|
+
const restoredContext =
|
|
84
|
+
options.inputs.context === undefined ? undefined : cloneAgentRunContext(options.inputs.context);
|
|
74
85
|
const listeners = new Set<AgentRunProgressListener>();
|
|
75
86
|
const progressState: {
|
|
76
87
|
status: AgentRunStatus;
|
|
@@ -87,6 +98,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
87
98
|
let lifecycle = new AgentRunLifecycleTraceCollector();
|
|
88
99
|
let runtime: AgentSessionRuntime | undefined;
|
|
89
100
|
let session: AgentSession | undefined;
|
|
101
|
+
let usageBaseline: AgentRunUsageBaseline | undefined;
|
|
90
102
|
let view: AgentRunSessionView | undefined;
|
|
91
103
|
let unsubscribe: (() => void) | undefined;
|
|
92
104
|
let observerCleanup: (() => void) | undefined;
|
|
@@ -174,7 +186,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
174
186
|
|
|
175
187
|
const refreshUsage = (): Usage | undefined => {
|
|
176
188
|
if (!session) return progressState.usage;
|
|
177
|
-
const usage = collectAgentRunUsage(session);
|
|
189
|
+
const usage = collectAgentRunUsage(session, usageBaseline);
|
|
178
190
|
if (usage) progressState.usage = usage;
|
|
179
191
|
return progressState.usage;
|
|
180
192
|
};
|
|
@@ -209,6 +221,11 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
209
221
|
return usage ? ({ ...outcome, usage } as TOutcome) : outcome;
|
|
210
222
|
};
|
|
211
223
|
|
|
224
|
+
const captureFinalizedContext = () => {
|
|
225
|
+
if (!options.captureContext || !session) return undefined;
|
|
226
|
+
return captureAgentRunContext(session);
|
|
227
|
+
};
|
|
228
|
+
|
|
212
229
|
const trackExtensionWork = (start: () => Promise<unknown>): void => {
|
|
213
230
|
let resolveWork!: () => void;
|
|
214
231
|
let rejectWork!: (error: unknown) => void;
|
|
@@ -311,6 +328,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
311
328
|
finalizing = true;
|
|
312
329
|
closeSessionAdmission();
|
|
313
330
|
finalization = (async () => {
|
|
331
|
+
const capturedContext = captureFinalizedContext();
|
|
314
332
|
if (timeoutId) clearTimeout(timeoutId);
|
|
315
333
|
timeoutId = undefined;
|
|
316
334
|
unsubscribe?.();
|
|
@@ -323,7 +341,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
323
341
|
observerCleanup = undefined;
|
|
324
342
|
if (view) deactivateAgentRunSessionView(view);
|
|
325
343
|
await disposeRuntime();
|
|
326
|
-
const finalOutcome = outcomeWithUsage(outcome);
|
|
344
|
+
const finalOutcome = outcomeWithUsage(withAgentRunContext(outcome, capturedContext));
|
|
327
345
|
terminal = true;
|
|
328
346
|
progressState.status = finalOutcome.kind === "success" ? "completed" : finalOutcome.kind;
|
|
329
347
|
progressState.usage = finalOutcome.usage ?? progressState.usage;
|
|
@@ -536,7 +554,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
536
554
|
const requestedModelId = step.model?.modelId ?? currentModelId;
|
|
537
555
|
observeContinuation({ type: "turn-start", turn, modelId: requestedModelId });
|
|
538
556
|
if (aborting || terminal || finalizing) return undefined;
|
|
539
|
-
const usageBefore = collectAgentRunUsage(activeSession);
|
|
557
|
+
const usageBefore = collectAgentRunUsage(activeSession, usageBaseline);
|
|
540
558
|
if (step.model) {
|
|
541
559
|
const requested = step.model.value as Model<Api> | undefined;
|
|
542
560
|
const modelIdMatches = requested
|
|
@@ -569,7 +587,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
569
587
|
modelId: requestedModelId,
|
|
570
588
|
outcome: "model-switch-failed",
|
|
571
589
|
promptAccepted: false,
|
|
572
|
-
...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession)),
|
|
590
|
+
...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession, usageBaseline)),
|
|
573
591
|
};
|
|
574
592
|
observeContinuationTurn(failed);
|
|
575
593
|
observeContinuation({
|
|
@@ -626,7 +644,7 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
626
644
|
modelId: requestedModelId,
|
|
627
645
|
outcome,
|
|
628
646
|
promptAccepted: accepted,
|
|
629
|
-
...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession)),
|
|
647
|
+
...usageDeltaFields(usageBefore, collectAgentRunUsage(activeSession, usageBaseline)),
|
|
630
648
|
};
|
|
631
649
|
observeContinuationTurn(completed);
|
|
632
650
|
observeContinuation({ type: "turn-end", turn, modelId: requestedModelId, outcome });
|
|
@@ -945,10 +963,11 @@ export function startAgentRun<T>(options: StartAgentRunOptions<T>): AgentRunHand
|
|
|
945
963
|
{
|
|
946
964
|
cwd: options.inputs.cwd,
|
|
947
965
|
agentDir,
|
|
948
|
-
sessionManager:
|
|
966
|
+
sessionManager: createAgentRunSessionManager(options.inputs.cwd, restoredContext),
|
|
949
967
|
},
|
|
950
968
|
);
|
|
951
969
|
session = runtime.session;
|
|
970
|
+
if (restoredContext) usageBaseline = createAgentRunUsageBaseline(session);
|
|
952
971
|
installSingleSessionDisposal(session);
|
|
953
972
|
installExtensionSendGuards(session);
|
|
954
973
|
if (cancelRequested || terminal || finalizing) {
|
|
@@ -1169,6 +1188,13 @@ export function startRegisteredAgentRun<T>(
|
|
|
1169
1188
|
return registeredHandle;
|
|
1170
1189
|
}
|
|
1171
1190
|
|
|
1191
|
+
function withAgentRunContext<T>(
|
|
1192
|
+
outcome: AgentRunOutcome<T>,
|
|
1193
|
+
context: AgentRunContext | undefined,
|
|
1194
|
+
): AgentRunOutcome<T> {
|
|
1195
|
+
return context ? { ...outcome, context } : outcome;
|
|
1196
|
+
}
|
|
1197
|
+
|
|
1172
1198
|
function usageFields(usage: Usage | undefined): { usage?: Usage } {
|
|
1173
1199
|
return usage ? { usage } : {};
|
|
1174
1200
|
}
|
|
@@ -3,6 +3,7 @@ import type {
|
|
|
3
3
|
AgentSession,
|
|
4
4
|
AgentSessionEvent,
|
|
5
5
|
ResourceLoader,
|
|
6
|
+
SessionEntry,
|
|
6
7
|
SessionStats,
|
|
7
8
|
SettingsManager,
|
|
8
9
|
ToolDefinition,
|
|
@@ -23,8 +24,14 @@ export type AgentRunFailureCode =
|
|
|
23
24
|
| "provider-error"
|
|
24
25
|
| "unexpected-runner-failure";
|
|
25
26
|
|
|
27
|
+
/** Detached native Pi session entries and their active leaf. */
|
|
28
|
+
export interface AgentRunContext {
|
|
29
|
+
readonly entries: readonly SessionEntry[];
|
|
30
|
+
readonly leafId: string | null;
|
|
31
|
+
}
|
|
32
|
+
|
|
26
33
|
/** Terminal outcome of one managed Agent Run. */
|
|
27
|
-
export type AgentRunOutcome<T> =
|
|
34
|
+
export type AgentRunOutcome<T> = (
|
|
28
35
|
| { kind: "success"; value: T; usage?: Usage }
|
|
29
36
|
| ({ kind: "failed"; usage?: Usage } & (
|
|
30
37
|
| { failureCode: "session-creation-failed"; diagnostics?: never }
|
|
@@ -34,7 +41,8 @@ export type AgentRunOutcome<T> =
|
|
|
34
41
|
}
|
|
35
42
|
))
|
|
36
43
|
| { kind: "canceled"; diagnostics: AgentRunDiagnostics; usage?: Usage }
|
|
37
|
-
| { kind: "timeout"; timeoutMs: number; diagnostics: AgentRunDiagnostics; usage?: Usage }
|
|
44
|
+
| { kind: "timeout"; timeoutMs: number; diagnostics: AgentRunDiagnostics; usage?: Usage }
|
|
45
|
+
) & { context?: AgentRunContext };
|
|
38
46
|
|
|
39
47
|
/** Caller-owned resources and policy used to create an Agent Run session. */
|
|
40
48
|
export interface AgentSessionInputs {
|
|
@@ -62,6 +70,8 @@ export interface AgentSessionInputs {
|
|
|
62
70
|
settingsManager: SettingsManager;
|
|
63
71
|
/** Optional PI agent directory; defaults to PI's configured directory. */
|
|
64
72
|
agentDir?: string;
|
|
73
|
+
/** Optional native Pi conversation history to restore for this run. */
|
|
74
|
+
readonly context?: AgentRunContext;
|
|
65
75
|
}
|
|
66
76
|
|
|
67
77
|
/** Read-only message shape exposed to caller-owned completion and observer callbacks. */
|
|
@@ -294,6 +304,8 @@ export interface StartAgentRunOptions<T> {
|
|
|
294
304
|
timeoutMs?: number;
|
|
295
305
|
/** Optional containing-session cancellation signal. */
|
|
296
306
|
signal?: AbortSignal;
|
|
307
|
+
/** Capture finalized native Pi context in the terminal outcome. Defaults to false. */
|
|
308
|
+
captureContext?: boolean;
|
|
297
309
|
}
|
|
298
310
|
|
|
299
311
|
/** Sole public control interface for one Agent Run. */
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Usage } from "@earendil-works/pi-ai";
|
|
2
|
-
import type { AgentSession } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import type { AgentSession, SessionEntry } from "@earendil-works/pi-coding-agent";
|
|
3
3
|
|
|
4
4
|
function addOptional(first: number | undefined, second: number | undefined): number | undefined {
|
|
5
5
|
return first === undefined && second === undefined ? undefined : (first ?? 0) + (second ?? 0);
|
|
@@ -35,48 +35,138 @@ export function combineAgentRunUsage(usages: readonly (Usage | undefined)[]): Us
|
|
|
35
35
|
);
|
|
36
36
|
}
|
|
37
37
|
|
|
38
|
+
/** Historical data present before a restored Agent Run starts. */
|
|
39
|
+
export interface AgentRunUsageBaseline {
|
|
40
|
+
readonly entryIds: ReadonlySet<string>;
|
|
41
|
+
readonly messages: ReadonlySet<object>;
|
|
42
|
+
/** Stable keys match projected copies created for native context edits. */
|
|
43
|
+
readonly messageKeys: ReadonlySet<string>;
|
|
44
|
+
readonly usage?: Usage;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** Snapshot historical usage before the restored run starts. */
|
|
48
|
+
export function createAgentRunUsageBaseline(session: AgentSession): AgentRunUsageBaseline {
|
|
49
|
+
const entryIds = new Set<string>();
|
|
50
|
+
const messages = new Set<object>();
|
|
51
|
+
const messageKeys = new Set<string>();
|
|
52
|
+
try {
|
|
53
|
+
for (const entry of session.sessionManager.getEntries()) {
|
|
54
|
+
entryIds.add(entry.id);
|
|
55
|
+
if (entry.type === "message") addBaselineMessage(entry.message, messages, messageKeys);
|
|
56
|
+
}
|
|
57
|
+
} catch {
|
|
58
|
+
// Continue with the live session snapshot when test doubles omit session entries.
|
|
59
|
+
}
|
|
60
|
+
try {
|
|
61
|
+
for (const message of session.messages) addBaselineMessage(message, messages, messageKeys);
|
|
62
|
+
} catch {
|
|
63
|
+
// Usage can still be collected from session entries.
|
|
64
|
+
}
|
|
65
|
+
return { entryIds, messages, messageKeys, usage: collectStatsUsage(session) };
|
|
66
|
+
}
|
|
67
|
+
|
|
38
68
|
/**
|
|
39
|
-
* Collect
|
|
40
|
-
* This includes assistant turns, tool-result work, non-message usage entries, compaction,
|
|
41
|
-
* branch summaries, and finalized/live messages that have not reached persistence yet.
|
|
69
|
+
* Collect billed usage created by this Agent Run. A baseline excludes imported session history.
|
|
42
70
|
*/
|
|
43
|
-
export function collectAgentRunUsage(
|
|
71
|
+
export function collectAgentRunUsage(
|
|
72
|
+
session: AgentSession,
|
|
73
|
+
baseline?: AgentRunUsageBaseline,
|
|
74
|
+
): Usage | undefined {
|
|
44
75
|
const knownMessages = new Set<object>();
|
|
76
|
+
const knownMessageKeys = new Set(baseline?.messageKeys);
|
|
77
|
+
const entryUsages = collectEntryUsage(
|
|
78
|
+
session,
|
|
79
|
+
knownMessages,
|
|
80
|
+
knownMessageKeys,
|
|
81
|
+
baseline?.entryIds,
|
|
82
|
+
);
|
|
45
83
|
const usages = [
|
|
46
|
-
...
|
|
47
|
-
...collectLiveMessageUsage(session, knownMessages),
|
|
48
|
-
collectStreamingUsage(session, knownMessages),
|
|
84
|
+
...entryUsages,
|
|
85
|
+
...collectLiveMessageUsage(session, knownMessages, knownMessageKeys, baseline?.messages),
|
|
86
|
+
collectStreamingUsage(session, knownMessages, knownMessageKeys, baseline?.messages),
|
|
49
87
|
];
|
|
50
|
-
|
|
88
|
+
const collected = combineAgentRunUsage(usages);
|
|
89
|
+
if (collected) return collected;
|
|
90
|
+
const currentStats = collectStatsUsage(session);
|
|
91
|
+
return baseline ? subtractUsage(currentStats, baseline.usage) : currentStats;
|
|
51
92
|
}
|
|
52
93
|
|
|
53
|
-
|
|
54
|
-
|
|
94
|
+
interface EntryUsageCollector {
|
|
95
|
+
readonly usages: Usage[];
|
|
96
|
+
readonly knownMessages: Set<object>;
|
|
97
|
+
readonly knownMessageKeys: Set<string>;
|
|
98
|
+
readonly historicalEntryIds?: ReadonlySet<string>;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function collectEntryUsage(
|
|
102
|
+
session: AgentSession,
|
|
103
|
+
knownMessages: Set<object>,
|
|
104
|
+
knownMessageKeys: Set<string>,
|
|
105
|
+
historicalEntryIds?: ReadonlySet<string>,
|
|
106
|
+
): Usage[] {
|
|
107
|
+
const collector: EntryUsageCollector = {
|
|
108
|
+
usages: [],
|
|
109
|
+
knownMessages,
|
|
110
|
+
knownMessageKeys,
|
|
111
|
+
historicalEntryIds,
|
|
112
|
+
};
|
|
55
113
|
try {
|
|
56
114
|
for (const entry of session.sessionManager.getEntries()) {
|
|
57
|
-
|
|
58
|
-
if (isObject(entry.message)) knownMessages.add(entry.message);
|
|
59
|
-
pushUsage(usages, entry.message);
|
|
60
|
-
} else if (
|
|
61
|
-
entry.type === "usage" ||
|
|
62
|
-
entry.type === "compaction" ||
|
|
63
|
-
entry.type === "branch_summary"
|
|
64
|
-
) {
|
|
65
|
-
pushUsage(usages, entry);
|
|
66
|
-
}
|
|
115
|
+
collectEntryUsageItem(entry, collector);
|
|
67
116
|
}
|
|
68
117
|
} catch {
|
|
69
118
|
// Test doubles and older PI versions may not expose session entries.
|
|
70
119
|
}
|
|
71
|
-
return usages;
|
|
120
|
+
return collector.usages;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
function collectEntryUsageItem(entry: SessionEntry, collector: EntryUsageCollector): void {
|
|
124
|
+
const { historicalEntryIds, knownMessages, knownMessageKeys, usages } = collector;
|
|
125
|
+
if (entry.type === "message") {
|
|
126
|
+
if (isObject(entry.message)) knownMessages.add(entry.message);
|
|
127
|
+
const key = historicalEntryIds ? getMessageKey(entry.message) : undefined;
|
|
128
|
+
if (key) knownMessageKeys.add(key);
|
|
129
|
+
if (!historicalEntryIds?.has(entry.id)) pushUsage(usages, entry.message);
|
|
130
|
+
return;
|
|
131
|
+
}
|
|
132
|
+
if (historicalEntryIds?.has(entry.id)) return;
|
|
133
|
+
if (entry.type === "usage" || entry.type === "compaction" || entry.type === "branch_summary") {
|
|
134
|
+
pushUsage(usages, entry);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function addBaselineMessage(
|
|
139
|
+
message: unknown,
|
|
140
|
+
messages: Set<object>,
|
|
141
|
+
messageKeys: Set<string>,
|
|
142
|
+
): void {
|
|
143
|
+
if (isObject(message)) messages.add(message);
|
|
144
|
+
const key = getMessageKey(message);
|
|
145
|
+
if (key) messageKeys.add(key);
|
|
72
146
|
}
|
|
73
147
|
|
|
74
|
-
function collectLiveMessageUsage(
|
|
148
|
+
function collectLiveMessageUsage(
|
|
149
|
+
session: AgentSession,
|
|
150
|
+
knownMessages: Set<object>,
|
|
151
|
+
knownMessageKeys: Set<string>,
|
|
152
|
+
historicalMessages?: ReadonlySet<object>,
|
|
153
|
+
): Usage[] {
|
|
75
154
|
const usages: Usage[] = [];
|
|
76
155
|
try {
|
|
77
156
|
for (const message of session.messages) {
|
|
78
|
-
|
|
157
|
+
const messageKey = historicalMessages ? getMessageKey(message) : undefined;
|
|
158
|
+
if (
|
|
159
|
+
isObject(message) &&
|
|
160
|
+
(knownMessages.has(message) ||
|
|
161
|
+
historicalMessages?.has(message) ||
|
|
162
|
+
(historicalMessages !== undefined &&
|
|
163
|
+
messageKey !== undefined &&
|
|
164
|
+
knownMessageKeys.has(messageKey)))
|
|
165
|
+
) {
|
|
166
|
+
continue;
|
|
167
|
+
}
|
|
79
168
|
if (isObject(message)) knownMessages.add(message);
|
|
169
|
+
if (historicalMessages !== undefined && messageKey) knownMessageKeys.add(messageKey);
|
|
80
170
|
pushUsage(usages, message);
|
|
81
171
|
}
|
|
82
172
|
} catch {
|
|
@@ -88,16 +178,53 @@ function collectLiveMessageUsage(session: AgentSession, knownMessages: Set<objec
|
|
|
88
178
|
function collectStreamingUsage(
|
|
89
179
|
session: AgentSession,
|
|
90
180
|
knownMessages: Set<object>,
|
|
181
|
+
knownMessageKeys: Set<string>,
|
|
182
|
+
historicalMessages?: ReadonlySet<object>,
|
|
91
183
|
): Usage | undefined {
|
|
92
184
|
try {
|
|
93
185
|
const message = session.agent.state.streamingMessage;
|
|
94
|
-
|
|
186
|
+
const messageKey = historicalMessages ? getMessageKey(message) : undefined;
|
|
187
|
+
if (
|
|
188
|
+
isObject(message) &&
|
|
189
|
+
!knownMessages.has(message) &&
|
|
190
|
+
!historicalMessages?.has(message) &&
|
|
191
|
+
!(
|
|
192
|
+
historicalMessages !== undefined &&
|
|
193
|
+
messageKey !== undefined &&
|
|
194
|
+
knownMessageKeys.has(messageKey)
|
|
195
|
+
)
|
|
196
|
+
) {
|
|
197
|
+
return readUsage(message);
|
|
198
|
+
}
|
|
95
199
|
} catch {
|
|
96
200
|
// Continue with the best-effort stats snapshot.
|
|
97
201
|
}
|
|
98
202
|
return undefined;
|
|
99
203
|
}
|
|
100
204
|
|
|
205
|
+
function getMessageKey(value: unknown): string | undefined {
|
|
206
|
+
if (!isObject(value)) return undefined;
|
|
207
|
+
const message = value as Record<string, unknown>;
|
|
208
|
+
if (
|
|
209
|
+
typeof message.role !== "string" ||
|
|
210
|
+
(typeof message.timestamp !== "number" && typeof message.timestamp !== "string")
|
|
211
|
+
) {
|
|
212
|
+
return undefined;
|
|
213
|
+
}
|
|
214
|
+
const usage = normalizeUsage(message.usage);
|
|
215
|
+
if (!usage) return undefined;
|
|
216
|
+
return JSON.stringify([
|
|
217
|
+
message.role,
|
|
218
|
+
message.timestamp,
|
|
219
|
+
message.provider,
|
|
220
|
+
message.model,
|
|
221
|
+
message.toolCallId,
|
|
222
|
+
message.toolName,
|
|
223
|
+
message.stopReason,
|
|
224
|
+
usage,
|
|
225
|
+
]);
|
|
226
|
+
}
|
|
227
|
+
|
|
101
228
|
function collectStatsUsage(session: AgentSession): Usage | undefined {
|
|
102
229
|
try {
|
|
103
230
|
const stats = session.getSessionStats();
|
|
@@ -129,6 +256,29 @@ function pushUsage(usages: Usage[], value: unknown): void {
|
|
|
129
256
|
if (usage) usages.push(usage);
|
|
130
257
|
}
|
|
131
258
|
|
|
259
|
+
function subtractUsage(after: Usage | undefined, before: Usage | undefined): Usage | undefined {
|
|
260
|
+
if (!after) return undefined;
|
|
261
|
+
const difference = (next: number, previous: number | undefined) =>
|
|
262
|
+
Math.max(0, next - (previous ?? 0));
|
|
263
|
+
const usage: Usage = {
|
|
264
|
+
input: difference(after.input, before?.input),
|
|
265
|
+
output: difference(after.output, before?.output),
|
|
266
|
+
cacheRead: difference(after.cacheRead, before?.cacheRead),
|
|
267
|
+
cacheWrite: difference(after.cacheWrite, before?.cacheWrite),
|
|
268
|
+
totalTokens: difference(after.totalTokens, before?.totalTokens),
|
|
269
|
+
cost: {
|
|
270
|
+
input: difference(after.cost.input, before?.cost.input),
|
|
271
|
+
output: difference(after.cost.output, before?.cost.output),
|
|
272
|
+
cacheRead: difference(after.cost.cacheRead, before?.cost.cacheRead),
|
|
273
|
+
cacheWrite: difference(after.cost.cacheWrite, before?.cost.cacheWrite),
|
|
274
|
+
total: difference(after.cost.total, before?.cost.total),
|
|
275
|
+
},
|
|
276
|
+
};
|
|
277
|
+
return usage.input || usage.output || usage.cacheRead || usage.cacheWrite || usage.cost.total
|
|
278
|
+
? usage
|
|
279
|
+
: undefined;
|
|
280
|
+
}
|
|
281
|
+
|
|
132
282
|
function isObject(value: unknown): value is object {
|
|
133
283
|
return typeof value === "object" && value !== null;
|
|
134
284
|
}
|
|
@@ -77,7 +77,7 @@ code_health({ scope: "packages/api/src/index.ts", refresh: true })
|
|
|
77
77
|
Important tool rules:
|
|
78
78
|
|
|
79
79
|
- **Resolve:** new target handles require semantic readiness. A comment or whitespace point is not a symbol; use `code_inspect` there. Handles are session-local and become stale when file contents change. Resolve the symbol again rather than reuse a stale handle. Symbol queries put case-sensitive exact-name matches first, before the display cap. Provider order stays unchanged within exact-name and other matches. An incomplete provider result never selects a target automatically.
|
|
80
|
-
- **Graph:** relations are `references` (default), `callees`, and `implements`. Use `["all"]` for all three. Callee depth is `direct` by default; `deep` includes nested scopes, not transitive calls. Callees match source shape, not symbol identity. Counts include each distinct call site; repeated expressions share one agent-output row with all shown line/column coordinates. Each relation reports its counts and limits once. Provider-limited results have unknown totals; invalid locations are disclosed separately. Callee previews shorten receiver argument lists from syntax without changing grouping by the full expression. Matching previews get local expression numbers so distinct source expressions remain clear. Unavailable references
|
|
80
|
+
- **Graph:** relations are `references` (default), `callees`, and `implements`. Use `["all"]` for all three. Callee depth is `direct` by default; `deep` includes nested scopes, not transitive calls. Callees match source shape, not symbol identity. Counts include each distinct call site; repeated expressions share one agent-output row with all shown line/column coordinates. Each relation reports its counts and limits once. Provider-limited results have unknown totals; invalid locations are disclosed separately. Callee previews shorten receiver argument lists from syntax without changing grouping by the full expression. Matching previews get local expression numbers so distinct source expressions remain clear. Unavailable references and implementations keep the provider reason. If no provider exists, the result names that gap. Unavailable callees keep the provider reason and a source-inspection next step. Ambiguous targets ask for candidate selection, not input correction. Candidate limits retain exact totals, or unknown totals when the provider returns partial data. Agent output and both transcript views disclose omissions. Only shown candidates receive target handles. The human transcript shows the resolved target and per-relation evidence types and status. The expanded view groups up to 20 sites per relation by file, without a duplicate Markdown body. If this display limit hides returned sites, the transcript links to a temporary file with all returned evidence. This file does not include evidence beyond `maxResults`, and its path does not add text to an otherwise complete agent result. Merged read ranges use neutral guidance.
|
|
81
81
|
- **Find:** AST mode requires `kind`: `definition`, `import`, `export`, `call`, `type`, `interface`, `class`, `method`, or `enum`. Semantic mode does not accept `kind`. A supplied `scope` is a non-empty array.
|
|
82
82
|
- **Health:** `include` accepts `diagnostics` and `servers` (both by default); `level` is `summary` (default) or `detailed`. Server inventory and route counts remain workspace-wide, even with a diagnostic scope. A diagnostic snapshot does not prove that the whole workspace is clean. Tsconfig and jsconfig coverage applies only to TypeScript and JavaScript-family files; other-language files have no `Tsconfig` label.
|
|
83
83
|
|
|
@@ -107,7 +107,9 @@ Candidate selection for Graph, Resolve, and Orientation uses one structured tran
|
|
|
107
107
|
|
|
108
108
|
### Refactor checks
|
|
109
109
|
|
|
110
|
-
The planner accepts one target handle or anchor and one operation: `rename_symbol`, `extract_function`, `extract_variable`, `update_imports`, or `delete_dead_code`.
|
|
110
|
+
The planner accepts one target handle or anchor and one operation: `rename_symbol`, `extract_function`, `extract_variable`, `update_imports`, or `delete_dead_code`. Rename, import updates, and dead-code removal depend on the language server and validated edits. Function and variable extraction are currently unavailable for all languages: standard LSP code actions do not provide a safe exact extraction-name contract. Unsupported operations do not fall back to text edits.
|
|
111
|
+
|
|
112
|
+
Rename can discover affected files and repeat the request once after validated same-route enrollment, with a limit of 64 files. A null server document version for an open file is accepted only with a verified request snapshot of synchronized content. Plans retain its content fingerprint and client version; unknown or mismatched state remains unavailable.
|
|
111
113
|
|
|
112
114
|
Plans are held in memory for the current session. Apply accepts only the returned `planId`; it does not create or regenerate a plan. It checks SHA-256 file fingerprints, provider-authorized roots, document versions when available, edit ranges, and overlaps before writing. Changed files require a new plan. A successful apply removes the plan.
|
|
113
115
|
|
|
@@ -115,33 +117,67 @@ Refactors can change several files. If a later write fails, the tool attempts to
|
|
|
115
117
|
|
|
116
118
|
## Language support
|
|
117
119
|
|
|
118
|
-
Install the required language servers yourself. The extension
|
|
120
|
+
The matrix shows built-in LSP routes and implemented AST operations, not a live server test. Install the required language servers yourself. The extension starts available configured commands in trusted projects; it does not download or install servers. A route does not guarantee hover, references, diagnostics, or refactors. Each semantic feature needs a ready server that supports it.
|
|
119
121
|
|
|
120
|
-
Tree-sitter grammars are bundled and parse locally.
|
|
122
|
+
Tree-sitter grammars are bundled and parse locally without an LSP server. Both layers match file extensions without case sensitivity; AST grammar selection does not use a shebang. LSP and AST extension lists are separate.
|
|
121
123
|
|
|
122
|
-
| Language | Default LSP
|
|
123
|
-
|
|
124
|
-
| TypeScript / JavaScript | `typescript-language-server` | `.ts`, `.mts`, `.cts`, `.tsx`, `.js`, `.jsx`, `.mjs`, `.cjs` |
|
|
125
|
-
| Python | `pyright-langserver` | `.py`, `.pyi` |
|
|
126
|
-
| Rust | `rust-analyzer` | `.rs` |
|
|
127
|
-
| Go | `gopls` | `.go` |
|
|
128
|
-
| C / C++ | `clangd` | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`, `.hxx`, `.c++`, `.h++` |
|
|
129
|
-
| Bash | `bash-language-server` | `.sh`, `.bash`, `.zsh`, `.ksh`
|
|
130
|
-
| HTML | `vscode-html-language-server` | `.html`, `.htm`, `.xhtml` |
|
|
131
|
-
| SQL | `sql-language-server` | `.sql` |
|
|
132
|
-
| Ruby | `ruby-lsp` | `.rb`, `.gemspec` |
|
|
133
|
-
| Java | `jdtls` | `.java` |
|
|
134
|
-
| Kotlin | `kotlin-lsp` | `.kt`, `.kts` |
|
|
135
|
-
| R | `R` with the `languageserver` package | `.r` |
|
|
136
|
-
| LaTeX / BibTeX | `texlab` | `.tex`, `.sty`, `.cls` |
|
|
137
|
-
|
|
138
|
-
|
|
124
|
+
| Language | Default LSP command | LSP file extensions | AST file extensions | AST search operations |
|
|
125
|
+
|---|---|---|---|---|
|
|
126
|
+
| TypeScript / JavaScript | `typescript-language-server` | `.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, `.cts`, `.mjs`, `.cjs` | `.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, `.cts`, `.mjs`, `.cjs` | Outline, imports, exports, calls |
|
|
127
|
+
| Python | `pyright-langserver` | `.py`, `.pyi` | `.py`, `.pyi` | Outline, imports, calls |
|
|
128
|
+
| Rust | `rust-analyzer` | `.rs` | `.rs` | Outline, imports, calls |
|
|
129
|
+
| Go | `gopls` | `.go`, `.mod` | `.go` | Outline, imports, calls |
|
|
130
|
+
| C / C++ | `clangd` | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`, `.hxx`, `.c++`, `.h++` | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`, `.hxx`, `.c++`, `.h++` | Outline, imports, calls |
|
|
131
|
+
| Bash / shell | `bash-language-server` | `.sh`, `.bash`, `.zsh`, `.ksh` | `.sh`, `.bash`, `.zsh`, `.ksh` | Outline, calls |
|
|
132
|
+
| HTML | `vscode-html-language-server` | `.html`, `.htm`, `.xhtml` | `.html`, `.htm`, `.xhtml` | Outline |
|
|
133
|
+
| SQL | `sql-language-server` | `.sql` | `.sql` | Outline |
|
|
134
|
+
| Ruby | `ruby-lsp` | `.rb`, `.erb`, `.gemspec` | `.rb`, `.gemspec` | Outline, calls |
|
|
135
|
+
| Java | `jdtls` | `.java` | `.java` | Outline, imports, calls |
|
|
136
|
+
| Kotlin | `kotlin-lsp` | `.kt`, `.kts` | `.kt`, `.kts` | Outline, calls |
|
|
137
|
+
| R | `R` with the `languageserver` package | `.r` | `.r` | Outline, calls |
|
|
138
|
+
| LaTeX / BibTeX | `texlab` | `.tex`, `.bib` | `.tex`, `.sty`, `.cls` | Outline, imports |
|
|
139
|
+
|
|
140
|
+
The AST operation column applies only to the AST extensions in that row:
|
|
141
|
+
|
|
142
|
+
- **Outline** supplies `code_find` kind `definition`. TS/JS, Python, Java, Go, Rust, and C/C++ include nested named declarations and members, not every local binding. Kinds `type`, `interface`, `class`, `method`, and `enum` use common filters while results retain native declaration kinds. For example, a Rust trait matches `interface`, and a Go struct or Java record matches `type`; they do not become classes. Other languages retain their existing extraction limits. HTML outlines contain elements with non-empty `id` attributes. SQL outlines contain supported `CREATE` declarations and shallow table/type members.
|
|
143
|
+
- **Imports** supply kind `import` and match written source targets, not local aliases or resolved files. Supported forms include JS/TS declarations, Python `import`/`from`, Java ordinary/static imports, Go import paths, Rust `use`/`extern crate`/external `mod`, literal C/C++ includes, and LaTeX dependency directives. Conditional directives are source evidence, not proof of active dependencies. CommonJS loader calls, dynamic import calls, computed targets, and C++20 module imports are not collected.
|
|
144
|
+
- **Exports** supply kind `export` from file-level JS/TS export statements. CommonJS assignments and a cross-language public-interface model are not supported.
|
|
145
|
+
- **Calls** supply kind `call` from file-wide call-site queries; graph callees use a separate anchored query. Each distinct site retains its source coordinates, including repeated calls on one line. These are written expressions, not symbol-identity relationships. Rust macro invocations remain syntax evidence; JSX tags and compiler-expanded calls are not collected. HTML, SQL, and LaTeX have no built-in call-site or callee queries.
|
|
146
|
+
- `.mod`, `.erb`, and `.bib` have built-in LSP routes but no AST grammar. `.sty` and `.cls` have AST support but no built-in LSP route. `.h` selects C by default; [project file associations](#cc-file-associations) can select C++ consistently for parsing and the LSP document language ID. `.jsx` selects JavaScript; `.tsx` selects TSX. Shell extensions all select the Bash grammar, not separate Zsh or KornShell grammars.
|
|
147
|
+
|
|
148
|
+
AST search and point syntax inspection can work without LSP. New target handles require semantic readiness, including handles used for `code_graph` callee queries. Workspace and directory inventories can include any file type; inclusion does not establish language support.
|
|
149
|
+
|
|
150
|
+
Unlisted extensions have no built-in route or grammar. A [custom LSP server](../supi-lsp/README.md#custom-server-configuration) can add semantic coverage, but it does not add AST support. See the [AST operation matrix](../supi-tree-sitter/README.md#language-support-matrix) and [LSP route matrix](../supi-lsp/README.md#built-in-route-matrix) for details. The source definitions are the [LSP defaults](../supi-lsp/src/config/defaults.json), [grammar map](../supi-tree-sitter/src/language.ts), [AST operation registry](../supi-tree-sitter/src/operation-support.ts), and [search-kind mapping](src/analysis/search/pattern.ts).
|
|
151
|
+
|
|
152
|
+
### Reference-server verification
|
|
153
|
+
|
|
154
|
+
The [language capability baseline](../../docs/conventions/code-language-baseline.md) has a separate [public-tool acceptance suite](__tests__/acceptance/language-baseline-harness.ts) and required Linux/macOS CI jobs. Its [server and toolchain pins](../../scripts/language-baseline/pins.json) are test combinations, not promises for every installed version. Qualification remains pending until both pinned jobs pass. Parser tests and configured routes do not qualify semantic support.
|
|
155
|
+
|
|
156
|
+
Pyright remains the default Python route. The audited Pyright server does not provide implementation lookup. The Python acceptance case uses an explicit Basedpyright configuration; this is not an automatic fallback. Install Basedpyright yourself and configure it if you need that reference combination:
|
|
157
|
+
|
|
158
|
+
```json
|
|
159
|
+
{
|
|
160
|
+
"lsp": {
|
|
161
|
+
"servers": {
|
|
162
|
+
"python": {
|
|
163
|
+
"command": "basedpyright-langserver",
|
|
164
|
+
"args": ["--stdio"]
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
Basedpyright uses `basedpyright.*` settings rather than most `python.*` settings, and has different diagnostic defaults. SuPi does not translate them. See the [server settings reference](https://docs.basedpyright.com/latest/configuration/language-server-settings/).
|
|
172
|
+
|
|
173
|
+
Developers run `pnpm test:language-baseline:acceptance` with the pinned prerequisites. Missing prerequisites fail the command; they do not produce skipped passes. The CI setup installs test tools on isolated runners, not through the runtime extension.
|
|
139
174
|
|
|
140
175
|
### Search and output limits
|
|
141
176
|
|
|
142
177
|
- An AST search has a 5,000 eligible-file limit and a 10-second deadline shared by file enumeration and analysis. These are not tool-call settings.
|
|
143
178
|
- Below directory roots, AST search excludes hidden entries, dependency/build/cache directories, symlinks, non-regular files, configured `code-intelligence.exclude` paths, and files unsupported by the requested operation. It does **not** read `.gitignore`. Explicit roots are resolved and honored, including excluded paths and symlink roots. See the [scan policy](src/analysis/search/ast-scan.ts) for the exact directory list.
|
|
144
179
|
- An exact file that does not support the requested AST operation is invalid. Results disclose policy exclusions, interrupted scans, provider limits, and omitted matches. No matches do not mean that unsupported files were searched.
|
|
180
|
+
- Syntax recovery retains usable evidence as partial and reports the affected file and available error ranges. Scan limits separate recovered syntax from provider failures, with counts and file examples for each. Partial scans have unknown match totals. A recovered parse does not establish complete absence.
|
|
145
181
|
- Tool text is truncated at Pi's default 2,000 lines or 50 KB. When this occurs, the full text is written to a temporary file and its path is returned. Result-list limits still apply to that full text.
|
|
146
182
|
|
|
147
183
|
## Status and settings
|
|
@@ -168,6 +204,7 @@ Project values override global values, which override defaults. Project configur
|
|
|
168
204
|
| `code-intelligence.overviewEnabled` | `true` | Add the hidden overview; the choice is fixed for the session |
|
|
169
205
|
| `code-intelligence.instructionFileNames` | `["CLAUDE.md", "AGENTS.md"]` | Ordered plain filenames for directory instruction discovery |
|
|
170
206
|
| `code-intelligence.exclude` | `[]` | Gitignore-style patterns for automatic workspace navigation, LSP work, and broad AST searches; not an access control |
|
|
207
|
+
| `code-intelligence.fileAssociations` | `[]` | Ordered C/C++ language rules in trusted project configuration only; edit the JSON file directly |
|
|
171
208
|
| `lsp.servers.<language>.enabled` | Enabled unless `false` | Disable a language server |
|
|
172
209
|
|
|
173
210
|
Example `.pi/supi/config.json`:
|
|
@@ -189,6 +226,25 @@ Example `.pi/supi/config.json`:
|
|
|
189
226
|
|
|
190
227
|
Use `typescript`, `python`, `rust`, `go`, `c`, `ruby`, `java`, `kotlin`, `bash`, `html`, `sql`, `r`, or `latex` for built-in server keys (`cpp` aliases `c`). Server command and routing overrides are defined in the [LSP configuration reference](../supi-lsp/README.md#custom-server-configuration). `.pi-lsp.json` is not read. Only the boolean `true` enables the overview; non-boolean values do not enable it. The shared exclusion list uses gitignore syntax and project-over-global replacement. An explicit project `[]` clears configured patterns. `/supi-settings` shows the config path and says to reload or restart Pi after saving. LSP and AST work use saved exclusions after reload or restart. New workspace observations read the current exclusions. Exact file and explicitly selected directory requests remain available. An old `lsp.exclude` value reports a migration error and is not used.
|
|
191
228
|
|
|
229
|
+
### C/C++ file associations
|
|
230
|
+
|
|
231
|
+
Set ordered rules in the project's `.pi/supi/config.json`:
|
|
232
|
+
|
|
233
|
+
```json
|
|
234
|
+
{
|
|
235
|
+
"code-intelligence": {
|
|
236
|
+
"fileAssociations": [
|
|
237
|
+
{ "pattern": "vendor/**/*.h", "language": "c" },
|
|
238
|
+
{ "pattern": "**/*.h", "language": "cpp" }
|
|
239
|
+
]
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
The first matching rule wins; no match keeps the extension default. Patterns are case-sensitive globs over project-relative paths with `/` separators. They support `*`, `?`, `**`, character classes, and brace alternatives. Rules apply only to existing C-family suffixes and accept only `c` or `cpp`. A rule cannot add an AST grammar or change server routing. Invalid rules fail configuration loading. There is a limit of 64 rules and 512 characters per pattern.
|
|
245
|
+
|
|
246
|
+
Global association values and untrusted project values do not apply. The workspace provider host captures one rule set for AST grammar selection and LSP document language IDs. Restart Pi, or release all sessions that share the host and reload, to use changed rules. This setting has no settings-overlay editor. It does not bypass exclusions or establish compiler flags.
|
|
247
|
+
|
|
192
248
|
Directory orientation checks the path from the workspace root to the focused directory. It selects the first valid configured instruction file per directory, skips files already loaded by Pi or shown on the active branch, and shows at most 200 lines per file. Resolved instruction paths must stay inside the workspace. These snippets are tool output, not additions to Pi's system prompt.
|
|
193
249
|
|
|
194
250
|
## Privacy and security
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
The MIT License (MIT)
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2017-present, Jon Schlinkert.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in
|
|
13
|
+
all copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
21
|
+
THE SOFTWARE.
|