@evandu/super-pi-server 0.0.0-stage → 0.1.260
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 +250 -3
- package/agents/code-auditor.md +64 -0
- package/agents/code-designer.md +64 -0
- package/agents/coder.md +24 -0
- package/agents/critic.md +24 -0
- package/agents/document-organizer.md +48 -0
- package/agents/patcher.md +27 -0
- package/agents/planner.md +30 -0
- package/agents/project-leader.md +28 -0
- package/agents/reviewer.md +27 -0
- package/agents/scout.md +27 -0
- package/agents/solution-designer.md +62 -0
- package/agents/super-pi-documents/index.ts +92 -0
- package/agents/super-pi-feishu/index.ts +88 -0
- package/agents/super-pi-knowledge/index.ts +70 -0
- package/agents/super-pi-managed-model/index.ts +9 -0
- package/agents/super-pi-memory/index.ts +75 -0
- package/agents/super-pi-native-tools/index.ts +1 -0
- package/agents/super-pi-task/core.ts +2262 -0
- package/agents/super-pi-task/index.ts +814 -0
- package/agents/super-pi-task/workflow-schema.ts +34 -0
- package/agents/super-pi-web/index.ts +32 -0
- package/agents/verifier.md +25 -0
- package/assets/fonts/LICENSE +92 -0
- package/assets/fonts/NotoSansSC-Bold.otf +0 -0
- package/assets/fonts/NotoSansSC-Regular.otf +0 -0
- package/assets/knowledge-model/README.md +37 -0
- package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/config.json +31 -0
- package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/onnx/model_quantized.onnx +0 -0
- package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/special_tokens_map.json +7 -0
- package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/tokenizer.json +21278 -0
- package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/tokenizer_config.json +15 -0
- package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/vocab.txt +21128 -0
- package/bin/npm-prefix.d.ts +1 -0
- package/bin/npm-prefix.js +10 -0
- package/bin/super-pi.js +349 -0
- package/dist/client/.super-pi-client-sources.json +82 -0
- package/dist/client/assets/CodeMirrorEditor-mi9rGUce.js +2 -0
- package/dist/client/assets/GitDiffEditor-CpoDDQrA.css +1 -0
- package/dist/client/assets/GitDiffEditor-FQBfGxOY.js +29 -0
- package/dist/client/assets/diff-ChtP43wD.js +1 -0
- package/dist/client/assets/dist-AW5lyI3I.js +1 -0
- package/dist/client/assets/dist-B3-a6uF0.js +7 -0
- package/dist/client/assets/dist-BGxkyh6e.js +1 -0
- package/dist/client/assets/dist-BJxfd7yb.js +11 -0
- package/dist/client/assets/dist-BRVQKlcp.js +1 -0
- package/dist/client/assets/dist-BV64A9Ji.js +1 -0
- package/dist/client/assets/dist-BXAOrsjq.js +1 -0
- package/dist/client/assets/dist-CKF2Jksy.js +1 -0
- package/dist/client/assets/dist-CX_Hm4GS.js +1 -0
- package/dist/client/assets/dist-Cus6_oaF.js +2 -0
- package/dist/client/assets/dist-Cx00EZKR.js +23 -0
- package/dist/client/assets/dist-D71y2EI1.js +1 -0
- package/dist/client/assets/dist-D978o95T.js +5 -0
- package/dist/client/assets/dist-Dc1MBGAG.js +1 -0
- package/dist/client/assets/dist-Dds-qLxY.js +9 -0
- package/dist/client/assets/dist-DeD9copn.js +1 -0
- package/dist/client/assets/dist-DuvGReu-.js +6 -0
- package/dist/client/assets/dist-Dvb0SqcK.js +2 -0
- package/dist/client/assets/dist-J6XWqRpB.js +3 -0
- package/dist/client/assets/dist-QzbOCAU6.js +1 -0
- package/dist/client/assets/dist-moiMRpw_.js +1 -0
- package/dist/client/assets/dist-scBkrwv-.js +2 -0
- package/dist/client/assets/dockerfile-BDePf5PZ.js +1 -0
- package/dist/client/assets/index-Cn7hdrDw.js +350 -0
- package/dist/client/assets/index-UfzqdECL.css +1 -0
- package/dist/client/assets/powershell-D8WpQPaX.js +1 -0
- package/dist/client/assets/properties-C357ku5U.js +1 -0
- package/dist/client/assets/rolldown-runtime-XKyaHtl9.js +1 -0
- package/dist/client/assets/ruby-ChfNwlCY.js +1 -0
- package/dist/client/assets/shell-DwuoZtxw.js +1 -0
- package/dist/client/assets/swift-DKB6_1j6.js +1 -0
- package/dist/client/assets/toml-BPTmHmyx.js +1 -0
- package/dist/client/favicon.ico +0 -0
- package/dist/client/favicon.png +0 -0
- package/dist/client/favicon.svg +10 -0
- package/dist/client/index.html +18 -0
- package/dist/extension.d.ts +15 -0
- package/dist/extension.js +126 -0
- package/dist/server/active-memory.d.ts +247 -0
- package/dist/server/active-memory.js +669 -0
- package/dist/server/agents.d.ts +245 -0
- package/dist/server/agents.js +701 -0
- package/dist/server/application/catalog-service.d.ts +98 -0
- package/dist/server/application/catalog-service.js +245 -0
- package/dist/server/application/conversation-service.d.ts +245 -0
- package/dist/server/application/conversation-service.js +654 -0
- package/dist/server/application/document-service.d.ts +68 -0
- package/dist/server/application/document-service.js +120 -0
- package/dist/server/application/extension-ui-service.d.ts +44 -0
- package/dist/server/application/extension-ui-service.js +135 -0
- package/dist/server/application/feishu-service.d.ts +179 -0
- package/dist/server/application/feishu-service.js +358 -0
- package/dist/server/application/group-chat-service.d.ts +75 -0
- package/dist/server/application/group-chat-service.js +953 -0
- package/dist/server/application/group-execution.d.ts +15 -0
- package/dist/server/application/group-execution.js +77 -0
- package/dist/server/application/project-service.d.ts +464 -0
- package/dist/server/application/project-service.js +2523 -0
- package/dist/server/application/provider-service.d.ts +174 -0
- package/dist/server/application/provider-service.js +510 -0
- package/dist/server/application/run-service.d.ts +547 -0
- package/dist/server/application/run-service.js +2683 -0
- package/dist/server/application/scheduled-task-service.d.ts +184 -0
- package/dist/server/application/scheduled-task-service.js +391 -0
- package/dist/server/application/session-orchestrator-service.d.ts +388 -0
- package/dist/server/application/session-orchestrator-service.js +1146 -0
- package/dist/server/application/session-reminder-service.d.ts +59 -0
- package/dist/server/application/session-reminder-service.js +141 -0
- package/dist/server/application/session-watchdog.d.ts +171 -0
- package/dist/server/application/session-watchdog.js +284 -0
- package/dist/server/application/workspace-service.d.ts +52 -0
- package/dist/server/application/workspace-service.js +186 -0
- package/dist/server/application/worktree-service.d.ts +13 -0
- package/dist/server/application/worktree-service.js +76 -0
- package/dist/server/browser-access.d.ts +34 -0
- package/dist/server/browser-access.js +89 -0
- package/dist/server/capability.d.ts +105 -0
- package/dist/server/capability.js +170 -0
- package/dist/server/command-handler.d.ts +93 -0
- package/dist/server/command-handler.js +540 -0
- package/dist/server/content-search.d.ts +16 -0
- package/dist/server/content-search.js +235 -0
- package/dist/server/conversation-usage.d.ts +22 -0
- package/dist/server/conversation-usage.js +43 -0
- package/dist/server/documents.d.ts +152 -0
- package/dist/server/documents.js +998 -0
- package/dist/server/engineering-learning.d.ts +30 -0
- package/dist/server/engineering-learning.js +106 -0
- package/dist/server/exec-service.d.ts +45 -0
- package/dist/server/exec-service.js +167 -0
- package/dist/server/explicit-file-open.d.ts +34 -0
- package/dist/server/explicit-file-open.js +105 -0
- package/dist/server/failure-text.d.ts +18 -0
- package/dist/server/failure-text.js +44 -0
- package/dist/server/feishu-cli.d.ts +223 -0
- package/dist/server/feishu-cli.js +464 -0
- package/dist/server/file-changes.d.ts +119 -0
- package/dist/server/file-changes.js +280 -0
- package/dist/server/file-diff.d.ts +41 -0
- package/dist/server/file-diff.js +97 -0
- package/dist/server/file-index.d.ts +100 -0
- package/dist/server/file-index.js +296 -0
- package/dist/server/file-name-index.d.ts +160 -0
- package/dist/server/file-name-index.js +411 -0
- package/dist/server/files.d.ts +269 -0
- package/dist/server/files.js +748 -0
- package/dist/server/git.d.ts +245 -0
- package/dist/server/git.js +903 -0
- package/dist/server/http-server.d.ts +45 -0
- package/dist/server/http-server.js +3830 -0
- package/dist/server/index.d.ts +1 -0
- package/dist/server/index.js +485 -0
- package/dist/server/inline-thinking.d.ts +90 -0
- package/dist/server/inline-thinking.js +181 -0
- package/dist/server/json-comments.d.ts +14 -0
- package/dist/server/json-comments.js +71 -0
- package/dist/server/knowledge-embedding-worker.d.ts +1 -0
- package/dist/server/knowledge-embedding-worker.js +27 -0
- package/dist/server/knowledge-vectors.d.ts +150 -0
- package/dist/server/knowledge-vectors.js +385 -0
- package/dist/server/knowledge.d.ts +273 -0
- package/dist/server/knowledge.js +848 -0
- package/dist/server/length-continuation.d.ts +83 -0
- package/dist/server/length-continuation.js +118 -0
- package/dist/server/logging.d.ts +32 -0
- package/dist/server/logging.js +185 -0
- package/dist/server/managed-http-tunnel.d.ts +6 -0
- package/dist/server/managed-http-tunnel.js +85 -0
- package/dist/server/managed-http.d.ts +4 -0
- package/dist/server/managed-http.js +85 -0
- package/dist/server/managed-model-adapter.d.ts +17 -0
- package/dist/server/managed-model-adapter.js +75 -0
- package/dist/server/managed-model-gateway.d.ts +49 -0
- package/dist/server/managed-model-gateway.js +73 -0
- package/dist/server/managed-servers.d.ts +55 -0
- package/dist/server/managed-servers.js +396 -0
- package/dist/server/managed-ssh.d.ts +26 -0
- package/dist/server/managed-ssh.js +73 -0
- package/dist/server/manager-vault.d.ts +11 -0
- package/dist/server/manager-vault.js +67 -0
- package/dist/server/memory-recall.d.ts +25 -0
- package/dist/server/memory-recall.js +45 -0
- package/dist/server/memory.d.ts +67 -0
- package/dist/server/memory.js +216 -0
- package/dist/server/message-media.d.ts +7 -0
- package/dist/server/message-media.js +54 -0
- package/dist/server/model-context-window.d.ts +186 -0
- package/dist/server/model-context-window.js +444 -0
- package/dist/server/model-filter.d.ts +23 -0
- package/dist/server/model-filter.js +48 -0
- package/dist/server/models-store.d.ts +36 -0
- package/dist/server/models-store.js +132 -0
- package/dist/server/native-tool-settings.d.ts +25 -0
- package/dist/server/native-tool-settings.js +41 -0
- package/dist/server/native-tools-extension.d.ts +2 -0
- package/dist/server/native-tools-extension.js +39 -0
- package/dist/server/native-tools-service.d.ts +39 -0
- package/dist/server/native-tools-service.js +240 -0
- package/dist/server/persistence/app-state-repository.d.ts +65 -0
- package/dist/server/persistence/app-state-repository.js +1 -0
- package/dist/server/persistence/json-state-repository.d.ts +14 -0
- package/dist/server/persistence/json-state-repository.js +43 -0
- package/dist/server/persistence/open-state-store.d.ts +3 -0
- package/dist/server/persistence/open-state-store.js +35 -0
- package/dist/server/persistence/rename.d.ts +22 -0
- package/dist/server/persistence/rename.js +44 -0
- package/dist/server/persistence/sqlite-state-repository.d.ts +12 -0
- package/dist/server/persistence/sqlite-state-repository.js +264 -0
- package/dist/server/pi-command.d.ts +94 -0
- package/dist/server/pi-command.js +265 -0
- package/dist/server/pi-native.d.ts +12 -0
- package/dist/server/pi-native.js +16 -0
- package/dist/server/pi-session-events.d.ts +158 -0
- package/dist/server/pi-session-events.js +373 -0
- package/dist/server/pi-session-pool.d.ts +233 -0
- package/dist/server/pi-session-pool.js +382 -0
- package/dist/server/pi-session.d.ts +642 -0
- package/dist/server/pi-session.js +655 -0
- package/dist/server/presentations/schema.d.ts +120 -0
- package/dist/server/presentations/schema.js +128 -0
- package/dist/server/provider-network.d.ts +16 -0
- package/dist/server/provider-network.js +106 -0
- package/dist/server/provider-proxy.d.ts +18 -0
- package/dist/server/provider-proxy.js +200 -0
- package/dist/server/providers.d.ts +333 -0
- package/dist/server/providers.js +989 -0
- package/dist/server/remote-bootstrap.d.ts +17 -0
- package/dist/server/remote-bootstrap.js +119 -0
- package/dist/server/rpc-channel.d.ts +131 -0
- package/dist/server/rpc-channel.js +135 -0
- package/dist/server/runtime.d.ts +1393 -0
- package/dist/server/runtime.js +3286 -0
- package/dist/server/scheduled-tasks.d.ts +101 -0
- package/dist/server/scheduled-tasks.js +138 -0
- package/dist/server/server-context.d.ts +119 -0
- package/dist/server/server-context.js +1 -0
- package/dist/server/session-cwd.d.ts +19 -0
- package/dist/server/session-cwd.js +58 -0
- package/dist/server/session-ledger.d.ts +67 -0
- package/dist/server/session-ledger.js +76 -0
- package/dist/server/session-memory-scope.d.ts +4 -0
- package/dist/server/session-memory-scope.js +30 -0
- package/dist/server/session-repository.d.ts +100 -0
- package/dist/server/session-repository.js +246 -0
- package/dist/server/session-tree-scope.d.ts +125 -0
- package/dist/server/session-tree-scope.js +337 -0
- package/dist/server/skills.d.ts +23 -0
- package/dist/server/skills.js +190 -0
- package/dist/server/store.d.ts +1062 -0
- package/dist/server/store.js +3305 -0
- package/dist/server/subagent-runs.d.ts +185 -0
- package/dist/server/subagent-runs.js +383 -0
- package/dist/server/subagents.d.ts +200 -0
- package/dist/server/subagents.js +619 -0
- package/dist/server/task-tool.d.ts +282 -0
- package/dist/server/task-tool.js +507 -0
- package/dist/server/tavily.d.ts +32 -0
- package/dist/server/tavily.js +136 -0
- package/dist/server/team-context.d.ts +12 -0
- package/dist/server/team-context.js +180 -0
- package/dist/server/terminal.d.ts +163 -0
- package/dist/server/terminal.js +557 -0
- package/dist/server/thinking-level-discovery.d.ts +38 -0
- package/dist/server/thinking-level-discovery.js +183 -0
- package/dist/server/time-zone.d.ts +20 -0
- package/dist/server/time-zone.js +32 -0
- package/dist/server/tool-calls.d.ts +130 -0
- package/dist/server/tool-calls.js +341 -0
- package/dist/server/tool-llm.d.ts +72 -0
- package/dist/server/tool-llm.js +146 -0
- package/dist/server/tool-registry.d.ts +129 -0
- package/dist/server/tool-registry.js +249 -0
- package/dist/server/tool-runner.d.ts +112 -0
- package/dist/server/tool-runner.js +306 -0
- package/dist/server/turn-failure.d.ts +48 -0
- package/dist/server/turn-failure.js +148 -0
- package/dist/server/types.d.ts +2315 -0
- package/dist/server/types.js +11 -0
- package/dist/server/update-status.d.ts +14 -0
- package/dist/server/update-status.js +69 -0
- package/dist/server/update.d.ts +46 -0
- package/dist/server/update.js +104 -0
- package/dist/server/upload.d.ts +35 -0
- package/dist/server/upload.js +177 -0
- package/dist/server/version.d.ts +33 -0
- package/dist/server/version.js +111 -0
- package/dist/server/web.d.ts +27 -0
- package/dist/server/web.js +183 -0
- package/dist/server/workflow-engine.d.ts +47 -0
- package/dist/server/workflow-engine.js +255 -0
- package/dist/server/workflow.d.ts +329 -0
- package/dist/server/workflow.js +469 -0
- package/dist/server/workspace-file-indexes.d.ts +2 -0
- package/dist/server/workspace-file-indexes.js +61 -0
- package/dist/server/workspace-file-operations.d.ts +36 -0
- package/dist/server/workspace-file-operations.js +281 -0
- package/dist/server/workspace-file-response.d.ts +7 -0
- package/dist/server/workspace-file-response.js +79 -0
- package/dist/server/ws-server.d.ts +149 -0
- package/dist/server/ws-server.js +640 -0
- package/dist/shared/agent-order.d.ts +44 -0
- package/dist/shared/agent-order.js +50 -0
- package/dist/shared/archive-decisions.d.ts +44 -0
- package/dist/shared/archive-decisions.js +98 -0
- package/dist/shared/background-task.d.ts +25 -0
- package/dist/shared/background-task.js +183 -0
- package/dist/shared/child-session-lock.d.ts +37 -0
- package/dist/shared/child-session-lock.js +59 -0
- package/dist/shared/content-search.d.ts +22 -0
- package/dist/shared/content-search.js +1 -0
- package/dist/shared/conversation-title.d.ts +4 -0
- package/dist/shared/conversation-title.js +4 -0
- package/dist/shared/file-mentions.d.ts +17 -0
- package/dist/shared/file-mentions.js +91 -0
- package/dist/shared/git-commit.d.ts +11 -0
- package/dist/shared/git-commit.js +1 -0
- package/dist/shared/git-graph.d.ts +42 -0
- package/dist/shared/git-graph.js +30 -0
- package/dist/shared/group-chat.d.ts +132 -0
- package/dist/shared/group-chat.js +6 -0
- package/dist/shared/managed-servers.d.ts +36 -0
- package/dist/shared/managed-servers.js +1 -0
- package/dist/shared/message-media.d.ts +12 -0
- package/dist/shared/message-media.js +27 -0
- package/dist/shared/model-window-label.d.ts +39 -0
- package/dist/shared/model-window-label.js +55 -0
- package/dist/shared/native-tools.d.ts +43 -0
- package/dist/shared/native-tools.js +1 -0
- package/dist/shared/pi-cache-warming.d.ts +9 -0
- package/dist/shared/pi-cache-warming.js +4 -0
- package/dist/shared/project-overview.d.ts +107 -0
- package/dist/shared/project-overview.js +92 -0
- package/dist/shared/project-presentation.d.ts +55 -0
- package/dist/shared/project-presentation.js +111 -0
- package/dist/shared/provider-network.d.ts +30 -0
- package/dist/shared/provider-network.js +1 -0
- package/dist/shared/session-reporting.d.ts +40 -0
- package/dist/shared/session-reporting.js +97 -0
- package/dist/shared/session-search.d.ts +14 -0
- package/dist/shared/session-search.js +1 -0
- package/dist/shared/team-context-view.d.ts +33 -0
- package/dist/shared/team-context-view.js +49 -0
- package/dist/shared/team-context.d.ts +59 -0
- package/dist/shared/team-context.js +3 -0
- package/dist/shared/terminal-protocol.d.ts +71 -0
- package/dist/shared/terminal-protocol.js +1 -0
- package/dist/shared/thinking-levels.d.ts +53 -0
- package/dist/shared/thinking-levels.js +85 -0
- package/dist/shared/tool-glyph.d.ts +7 -0
- package/dist/shared/tool-glyph.js +19 -0
- package/dist/shared/transcript-order.d.ts +7 -0
- package/dist/shared/transcript-order.js +12 -0
- package/dist/shared/update-status.d.ts +28 -0
- package/dist/shared/update-status.js +1 -0
- package/dist/shared/workspace-file-preview.d.ts +4 -0
- package/dist/shared/workspace-file-preview.js +28 -0
- package/package.json +450 -4
- package/scripts/diagnose.mjs +603 -0
- package/scripts/patch-brace-expansion.mjs +260 -0
- package/scripts/restart-server.mjs +104 -0
- package/skills/presentation/SKILL.md +30 -0
- package/skills/presentation/references/data.md +10 -0
- package/skills/presentation/references/quality.md +12 -0
- package/skills/presentation/references/story.md +12 -0
- package/skills/presentation/references/templates-and-editing.md +11 -0
- package/skills/presentation/references/visual-system.md +10 -0
- package/skills/super-pi-agent-development/SKILL.md +25 -0
- package/skills/super-pi-development/SKILL.md +31 -0
- package/skills/super-pi-tool-development/SKILL.md +39 -0
|
@@ -0,0 +1,382 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* THE SESSION POOL: one live Pi session per conversation, kept across turns.
|
|
3
|
+
*
|
|
4
|
+
* WHAT IT OWNS. A conversation's Pi session, its fingerprint, and the rule that decides when the live
|
|
5
|
+
* session has gone stale and must be thrown away. Everything that can make a session stale is a
|
|
6
|
+
* FINGERPRINT (see `pi-session.ts`): the agent's prompt, the tool allowlist, the mounted extensions,
|
|
7
|
+
* the workspace, the model. Pi decides all of those when a session is created and cannot change any of
|
|
8
|
+
* them afterwards, so a session whose fingerprint no longer matches the conversation's current
|
|
9
|
+
* requirements is not "slightly wrong" - it is the wrong session, and the only honest response is to
|
|
10
|
+
* replace it.
|
|
11
|
+
*
|
|
12
|
+
* WHY THE POOL IS EXPLICIT ABOUT EVICTING. A session holds a model client, a session file handle and a
|
|
13
|
+
* conversation context. Left alone, a server that has seen fifty conversations would hold fifty of
|
|
14
|
+
* them, and the ones nobody is using would be the ones costing the most memory. So an idle session is
|
|
15
|
+
* evicted after a while, and the conversation's context is not lost with it: Pi writes the transcript
|
|
16
|
+
* to disk, and the next session for that conversation is rebuilt from that file.
|
|
17
|
+
*
|
|
18
|
+
* THE REVERT CASE. `revert` truncates the transcript on disk. A live session's in-memory context does
|
|
19
|
+
* NOT change, and nothing in Pi would notice: the model would keep answering from history the user
|
|
20
|
+
* has withdrawn. So a revert must EVICT the session, and the next turn rebuilds from the truncated
|
|
21
|
+
* file. This is the one case where eviction is not an optimization but a correctness requirement.
|
|
22
|
+
*/
|
|
23
|
+
import { existsSync } from "node:fs";
|
|
24
|
+
import { join } from "node:path";
|
|
25
|
+
import { createPiSession, sameFingerprint, superPiExtensionPaths, superPiSkillPaths, } from "./pi-session.js";
|
|
26
|
+
/** How long an idle session survives before it is evicted. */
|
|
27
|
+
const IDLE_EVICTION_MS = 10 * 60_000;
|
|
28
|
+
const MAX_LIVE_SESSIONS = Math.max(4, Number.parseInt(process.env.SUPER_PI_MAX_LIVE_SESSIONS ?? "32", 10) || 32);
|
|
29
|
+
/**
|
|
30
|
+
* The environment variable the session's credential travels in.
|
|
31
|
+
*
|
|
32
|
+
* THE SAME NAME THE EXTENSION READS, written out rather than imported: `agents/` is loaded by Pi's
|
|
33
|
+
* module loader and `src/` by tsc, so an import across the two would resolve differently under each.
|
|
34
|
+
* `scripts/task-tool.test.mjs` asserts that the two copies agree.
|
|
35
|
+
*/
|
|
36
|
+
const CAPABILITY_ENV = "SUPER_PI_TASK_CAPABILITY";
|
|
37
|
+
const TOOLS_CAPABILITY_ENV = "SUPER_PI_TOOLS_CAPABILITY";
|
|
38
|
+
/**
|
|
39
|
+
* The pool.
|
|
40
|
+
*
|
|
41
|
+
* One instance per server. It is deliberately not a general-purpose pool: the sessions it holds differ
|
|
42
|
+
* from each other in their agent, their tools and their workspace, so there is nothing to share between
|
|
43
|
+
* them and no reason to try.
|
|
44
|
+
*/
|
|
45
|
+
export class PiSessionPool {
|
|
46
|
+
sessionDir;
|
|
47
|
+
repositoryRoot;
|
|
48
|
+
agentDir;
|
|
49
|
+
onSessionDestroyed;
|
|
50
|
+
factory;
|
|
51
|
+
mintCapability;
|
|
52
|
+
modelEpoch;
|
|
53
|
+
mintExtensionTokens;
|
|
54
|
+
sessions = new Map();
|
|
55
|
+
constructor(
|
|
56
|
+
/** Where Pi keeps its session files. */
|
|
57
|
+
sessionDir,
|
|
58
|
+
/** The repository root, for locating Super Pi's own extensions. */
|
|
59
|
+
repositoryRoot,
|
|
60
|
+
/** Pi's global configuration directory, when it is not Pi's own default. */
|
|
61
|
+
agentDir,
|
|
62
|
+
/**
|
|
63
|
+
* Called when a session is destroyed, so the caller can release whatever the session was holding.
|
|
64
|
+
*
|
|
65
|
+
* A session holds a capability: the token its extension read out of the environment when it was
|
|
66
|
+
* loaded. When the session goes, that token must go with it - a credential whose holder no longer
|
|
67
|
+
* exists is exactly the shape the capability model exists to prevent. The pool does not know what a
|
|
68
|
+
* capability is, so it says WHEN and the caller says WHAT.
|
|
69
|
+
*/
|
|
70
|
+
onSessionDestroyed,
|
|
71
|
+
/**
|
|
72
|
+
* How a session is built. Injectable so a test can drive a session without a real Pi behind it.
|
|
73
|
+
*/
|
|
74
|
+
factory = createPiSession,
|
|
75
|
+
/**
|
|
76
|
+
* Mints the credential the session's extension will hold. Injected rather than imported so the pool
|
|
77
|
+
* does not have to know what a capability is - it needs to know WHEN one is needed, and the caller
|
|
78
|
+
* knows what one looks like.
|
|
79
|
+
*/
|
|
80
|
+
mintCapability = () => "",
|
|
81
|
+
/**
|
|
82
|
+
* How many times the set of models Pi knows about has changed.
|
|
83
|
+
*
|
|
84
|
+
* Injected rather than imported for the same reason the capability minting is: the pool needs to
|
|
85
|
+
* know WHEN a session is stale, and the caller knows what changed. A provider added through the
|
|
86
|
+
* settings window makes every live session unable to reach the new model, and the next turn is
|
|
87
|
+
* where that gets fixed.
|
|
88
|
+
*/
|
|
89
|
+
modelEpoch = () => 0,
|
|
90
|
+
/**
|
|
91
|
+
* Mints the OTHER per-session credentials the extensions need, at the moment the session is born.
|
|
92
|
+
*
|
|
93
|
+
* WHY A SECOND CALLBACK AND NOT PART OF THE CAPABILITY. The memory and knowledge extensions each
|
|
94
|
+
* need their own credential - the memory one even carries per-caller flags (read-only for a
|
|
95
|
+
* sub-agent) that a single session capability cannot express. The one-shot path has always minted
|
|
96
|
+
* them per turn; the SESSION path minted none, so those two extensions returned before registering
|
|
97
|
+
* a single tool or injecting a single line of prompt, and both features were absent in production -
|
|
98
|
+
* the SDK session path is the default backend, and only the test scripts use the one-shot path
|
|
99
|
+
* (ledger TEST-039).
|
|
100
|
+
*
|
|
101
|
+
* They are minted HERE, where the session is born, for the same reason the capability is: the
|
|
102
|
+
* extension reads its environment ONCE, when it is loaded, so a token minted per turn would be
|
|
103
|
+
* replaced before the second turn and the extension would still be holding the first turn's value.
|
|
104
|
+
*/
|
|
105
|
+
mintExtensionTokens = () => ({})) {
|
|
106
|
+
this.sessionDir = sessionDir;
|
|
107
|
+
this.repositoryRoot = repositoryRoot;
|
|
108
|
+
this.agentDir = agentDir;
|
|
109
|
+
this.onSessionDestroyed = onSessionDestroyed;
|
|
110
|
+
this.factory = factory;
|
|
111
|
+
this.mintCapability = mintCapability;
|
|
112
|
+
this.modelEpoch = modelEpoch;
|
|
113
|
+
this.mintExtensionTokens = mintExtensionTokens;
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* The session for a conversation, built if there is none and REPLACED if the live one is stale.
|
|
117
|
+
*
|
|
118
|
+
* The fingerprint comparison is what makes a stale session impossible to use: it happens BEFORE the
|
|
119
|
+
* session is handed out, not after, so a caller can never accidentally run a turn on a session whose
|
|
120
|
+
* tool allowlist has changed.
|
|
121
|
+
*/
|
|
122
|
+
async acquire(request) {
|
|
123
|
+
await this.evictOverflow(request.conversationId);
|
|
124
|
+
const fingerprint = this.fingerprintOf(request);
|
|
125
|
+
const existing = this.sessions.get(request.conversationId);
|
|
126
|
+
if (existing) {
|
|
127
|
+
if (sameFingerprint(existing.fingerprint, fingerprint)) {
|
|
128
|
+
if (process.env.SUPER_PI_TRACE_LATENCY === "1")
|
|
129
|
+
console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.reused`);
|
|
130
|
+
existing.lastUsedAt = Date.now();
|
|
131
|
+
// A session that is still being built is joined, not rebuilt: two sends arriving together must
|
|
132
|
+
// not produce two sessions, and the second one would be a duplicate model client talking to the
|
|
133
|
+
// same conversation.
|
|
134
|
+
if (existing.building)
|
|
135
|
+
return existing.building;
|
|
136
|
+
// THE MODEL AND THE LEVEL ARE APPLIED HERE, TO THE LIVE SESSION. They are not in the
|
|
137
|
+
// fingerprint because Pi can change them in place, and rebuilding the session to honour a
|
|
138
|
+
// change would replay the whole transcript - the single most expensive thing this runtime does.
|
|
139
|
+
// A person who picks a different model in the picker pays a few milliseconds here instead of
|
|
140
|
+
// waiting for their entire history to be re-read on the next message.
|
|
141
|
+
await this.applyModelAndLevel(existing.session, request);
|
|
142
|
+
return existing.session;
|
|
143
|
+
}
|
|
144
|
+
// STALE. The conversation's requirements changed underneath the live session, so it is thrown away
|
|
145
|
+
// BEFORE the new one is built, and not after - a session that is being disposed of while the new
|
|
146
|
+
// one starts would have two contexts for one conversation.
|
|
147
|
+
await this.evict(request.conversationId);
|
|
148
|
+
if (process.env.SUPER_PI_TRACE_LATENCY === "1")
|
|
149
|
+
console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.rebuild`);
|
|
150
|
+
}
|
|
151
|
+
// THE CREDENTIAL IS MINTED HERE, WHERE THE SESSION IS BORN. The capability travels in the
|
|
152
|
+
// extension's environment, and the extension reads its environment when it is LOADED - which happens
|
|
153
|
+
// once per session. A token minted per TURN would be replaced before the second turn of the
|
|
154
|
+
// conversation, and the extension would still be holding the first turn's value: the server would
|
|
155
|
+
// (correctly) refuse it, and delegation would break after the first message.
|
|
156
|
+
//
|
|
157
|
+
// So the token belongs to the SESSION, and it is minted exactly when the session is created. The
|
|
158
|
+
// server separately requires that a turn is RUNNING for the token to be usable, which is what keeps a
|
|
159
|
+
// longer-lived token from being a weaker credential than a per-turn one.
|
|
160
|
+
const capability = this.mintCapability(request.conversationId);
|
|
161
|
+
const extensionEnv = { ...request.extensionEnv, [CAPABILITY_ENV]: capability, [TOOLS_CAPABILITY_ENV]: capability, ...await this.mintExtensionTokens(request.conversationId) };
|
|
162
|
+
const building = this.build({ ...request, extensionEnv }, fingerprint);
|
|
163
|
+
if (process.env.SUPER_PI_TRACE_LATENCY === "1")
|
|
164
|
+
console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.build.begin`);
|
|
165
|
+
this.sessions.set(request.conversationId, { session: undefined, fingerprint, lastUsedAt: Date.now(), building });
|
|
166
|
+
try {
|
|
167
|
+
const session = await building;
|
|
168
|
+
if (process.env.SUPER_PI_TRACE_LATENCY === "1")
|
|
169
|
+
console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.build.end`);
|
|
170
|
+
const entry = this.sessions.get(request.conversationId);
|
|
171
|
+
if (entry) {
|
|
172
|
+
entry.session = session;
|
|
173
|
+
entry.building = undefined;
|
|
174
|
+
}
|
|
175
|
+
return session;
|
|
176
|
+
}
|
|
177
|
+
catch (error) {
|
|
178
|
+
// A failed build must not leave a broken entry behind: the next turn would find it and treat the
|
|
179
|
+
// failure as "the session exists", and every later turn would fail the same way with no reason.
|
|
180
|
+
this.sessions.delete(request.conversationId);
|
|
181
|
+
// And a failed build must not leave a CREDENTIAL behind either: the session it belonged to was
|
|
182
|
+
// never born, so the token is a credential with no owner.
|
|
183
|
+
this.onSessionDestroyed?.(request.conversationId);
|
|
184
|
+
throw error;
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
/** Keep an accidental session fan-out from retaining one full transcript context per conversation. */
|
|
188
|
+
async evictOverflow(exceptConversationId) {
|
|
189
|
+
if (this.sessions.size < MAX_LIVE_SESSIONS)
|
|
190
|
+
return;
|
|
191
|
+
const candidates = [...this.sessions.entries()]
|
|
192
|
+
.filter(([id, entry]) => id !== exceptConversationId && !entry.building && entry.session?.isIdle !== false)
|
|
193
|
+
.sort((a, b) => a[1].lastUsedAt - b[1].lastUsedAt);
|
|
194
|
+
while (this.sessions.size >= MAX_LIVE_SESSIONS && candidates.length) {
|
|
195
|
+
const [conversationId] = candidates.shift();
|
|
196
|
+
if (process.env.SUPER_PI_TRACE_LATENCY === "1")
|
|
197
|
+
console.warn(`[super-pi latency] conversation=${conversationId} phase=session.max-live-evict`);
|
|
198
|
+
await this.evict(conversationId);
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
async build(request, fingerprint) {
|
|
202
|
+
const creation = {
|
|
203
|
+
cwd: request.cwd,
|
|
204
|
+
sessionId: request.conversationId,
|
|
205
|
+
sessionDir: this.sessionDir,
|
|
206
|
+
...(request.sessionFile ? { sessionFile: request.sessionFile } : {}),
|
|
207
|
+
extensionPaths: superPiExtensionPaths(this.repositoryRoot),
|
|
208
|
+
skillPaths: superPiSkillPaths(this.repositoryRoot),
|
|
209
|
+
extensionEnv: request.extensionEnv,
|
|
210
|
+
...(request.systemPromptFile ? { systemPromptFile: request.systemPromptFile } : {}),
|
|
211
|
+
...(request.systemPromptMode ? { systemPromptMode: request.systemPromptMode } : {}),
|
|
212
|
+
...(request.tools ? { tools: request.tools } : {}),
|
|
213
|
+
...(request.excludeTools ? { excludeTools: request.excludeTools } : {}),
|
|
214
|
+
...(request.model ? { model: request.model } : {}),
|
|
215
|
+
...(request.thinkingLevel ? { thinkingLevel: request.thinkingLevel } : {}),
|
|
216
|
+
...(this.agentDir ? { agentDir: this.agentDir } : {}),
|
|
217
|
+
};
|
|
218
|
+
return this.factory(creation);
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* Puts a live session on the model and level the conversation is asking for.
|
|
222
|
+
*
|
|
223
|
+
* Best-effort in the way that matters: a session that cannot change its model is still a working
|
|
224
|
+
* session, and refusing the message because Pi declined a model switch would be a worse answer than
|
|
225
|
+
* running on the model that is loaded. So the failure is a warning, and the turn goes on.
|
|
226
|
+
*
|
|
227
|
+
* The comparison is against what the session is ALREADY running, because Pi can report its model in
|
|
228
|
+
* two shapes (an id or a provider/id pair) and a mismatch on shape alone would mean re-setting the
|
|
229
|
+
* model on every single turn.
|
|
230
|
+
*/
|
|
231
|
+
async applyModelAndLevel(session, request) {
|
|
232
|
+
const wanted = request.model;
|
|
233
|
+
if (wanted && session.setModel) {
|
|
234
|
+
const running = session.model;
|
|
235
|
+
const same = running?.provider === wanted.provider && (running?.id ?? running?.id) === wanted.modelId;
|
|
236
|
+
if (!same) {
|
|
237
|
+
try {
|
|
238
|
+
// THE WHOLE MODEL, NOT THE PAIR. Pi's `setModel` puts what it is given straight into the
|
|
239
|
+
// agent's state, so a `{provider, id}` pair would not be a shorthand for a model - it would BE
|
|
240
|
+
// the model the agent runs on, with no `api` and no `contextWindow`. Measured: with the whole
|
|
241
|
+
// model the session reports `api=bedrock-converse-stream`, `contextWindow=1000000` and the
|
|
242
|
+
// thinking levels `[off, minimal, low, medium, high]`; with the pair the api and the context
|
|
243
|
+
// window are null and the levels collapse to `[off]`, which is what the picker shows.
|
|
244
|
+
//
|
|
245
|
+
// The pair is still the fallback, because a session that cannot resolve a model should still
|
|
246
|
+
// be able to run the one it has.
|
|
247
|
+
const whole = session.resolveModel?.(wanted.provider, wanted.modelId);
|
|
248
|
+
await session.setModel(whole ?? { provider: wanted.provider, id: wanted.modelId });
|
|
249
|
+
if (process.env.SUPER_PI_TRACE_LATENCY === "1")
|
|
250
|
+
console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.model-applied model=${wanted.provider}/${wanted.modelId} whole=${whole ? "yes" : "no"}`);
|
|
251
|
+
}
|
|
252
|
+
catch (error) {
|
|
253
|
+
console.warn(`PiSessionPool: conversation ${request.conversationId} asked for ${wanted.provider}/${wanted.modelId} and Pi declined: ${error instanceof Error ? error.message : String(error)}. The turn will run on the model already loaded.`);
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
if (request.thinkingLevel && session.setThinkingLevel) {
|
|
258
|
+
try {
|
|
259
|
+
session.setThinkingLevel(request.thinkingLevel);
|
|
260
|
+
}
|
|
261
|
+
catch (error) {
|
|
262
|
+
console.warn(`PiSessionPool: conversation ${request.conversationId} asked for thinking level ${request.thinkingLevel} and Pi declined: ${error instanceof Error ? error.message : String(error)}.`);
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
fingerprintOf(request) {
|
|
267
|
+
// The model and the thinking level are NOT here, and that is deliberate: Pi changes both on a
|
|
268
|
+
// live session, so they are applied to it rather than forcing a rebuild that would replay the whole
|
|
269
|
+
// transcript. The session is still CREATED with them (see `build`) - it just is not thrown away
|
|
270
|
+
// when they change.
|
|
271
|
+
return {
|
|
272
|
+
cwd: request.cwd,
|
|
273
|
+
agentId: request.agentId,
|
|
274
|
+
tools: request.tools,
|
|
275
|
+
excludeTools: request.excludeTools,
|
|
276
|
+
extensions: superPiExtensionPaths(this.repositoryRoot),
|
|
277
|
+
modelEpoch: this.modelEpoch(),
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
/**
|
|
281
|
+
* The live session for a conversation, without building one.
|
|
282
|
+
*
|
|
283
|
+
* Absent when there is none - including when the session is still being built, because a session
|
|
284
|
+
* that is not ready cannot be steered into.
|
|
285
|
+
*/
|
|
286
|
+
get(conversationId) {
|
|
287
|
+
const entry = this.sessions.get(conversationId);
|
|
288
|
+
return entry && !entry.building ? entry.session : undefined;
|
|
289
|
+
}
|
|
290
|
+
/**
|
|
291
|
+
* Whether a conversation has a live session, without building one.
|
|
292
|
+
*
|
|
293
|
+
* Used by the paths that need to know whether a session EXISTS - `revert` has to know whether there is
|
|
294
|
+
* an in-memory context to invalidate - and by the tests.
|
|
295
|
+
*/
|
|
296
|
+
has(conversationId) {
|
|
297
|
+
return this.sessions.has(conversationId);
|
|
298
|
+
}
|
|
299
|
+
/**
|
|
300
|
+
* Throws away a conversation's session.
|
|
301
|
+
*
|
|
302
|
+
* The reason this is a PUBLIC operation and not an internal detail is that the callers are the ones
|
|
303
|
+
* that know WHY the session is stale. `revert` calls it because the disk changed under the session;
|
|
304
|
+
* a configuration change calls it because the requirements changed. The pool does not second-guess
|
|
305
|
+
* either - it disposes what it is told to dispose.
|
|
306
|
+
*/
|
|
307
|
+
async evict(conversationId) {
|
|
308
|
+
const entry = this.sessions.get(conversationId);
|
|
309
|
+
if (!entry)
|
|
310
|
+
return;
|
|
311
|
+
this.sessions.delete(conversationId);
|
|
312
|
+
// The credential the session was holding dies with it, in every path - including the one where the
|
|
313
|
+
// build is still running, because a session that finishes building after its eviction would
|
|
314
|
+
// otherwise come back holding a token the server has already forgotten.
|
|
315
|
+
this.onSessionDestroyed?.(conversationId);
|
|
316
|
+
if (entry.building) {
|
|
317
|
+
// The build is still running. Awaiting it before disposing is what guarantees the session is
|
|
318
|
+
// actually released rather than leaked - a session that finishes building after the eviction has
|
|
319
|
+
// no owner left to dispose it.
|
|
320
|
+
const session = await entry.building.catch(() => undefined);
|
|
321
|
+
if (session)
|
|
322
|
+
await this.closeSession(session);
|
|
323
|
+
return;
|
|
324
|
+
}
|
|
325
|
+
try {
|
|
326
|
+
if (entry.session)
|
|
327
|
+
await this.closeSession(entry.session);
|
|
328
|
+
}
|
|
329
|
+
catch (error) {
|
|
330
|
+
console.warn(`Super Pi: disposing the Pi session of ${conversationId} threw: ${error instanceof Error ? error.message : "unknown error"}`);
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
/**
|
|
334
|
+
* Throws away every session that has not been used for a while.
|
|
335
|
+
*
|
|
336
|
+
* The conversation is not lost: Pi wrote the transcript to disk, and the next turn rebuilds the
|
|
337
|
+
* session from that file. What is lost is the in-memory context, which is exactly what an idle
|
|
338
|
+
* conversation does not need.
|
|
339
|
+
*/
|
|
340
|
+
async evictIdle(now = Date.now()) {
|
|
341
|
+
for (const [conversationId, entry] of [...this.sessions]) {
|
|
342
|
+
if (entry.session?.isIdle !== false && now - entry.lastUsedAt >= IDLE_EVICTION_MS)
|
|
343
|
+
await this.evict(conversationId);
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
/** Throws away every session. Used at shutdown. */
|
|
347
|
+
async disposeAll() {
|
|
348
|
+
for (const conversationId of [...this.sessions.keys()])
|
|
349
|
+
await this.evict(conversationId);
|
|
350
|
+
}
|
|
351
|
+
async closeSession(session) {
|
|
352
|
+
try {
|
|
353
|
+
await session.extensionRunner?.emit?.({ type: "session_shutdown", reason: "quit" });
|
|
354
|
+
}
|
|
355
|
+
finally {
|
|
356
|
+
session.dispose();
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
/** The conversations with a live session. */
|
|
360
|
+
get conversationIds() {
|
|
361
|
+
return [...this.sessions.keys()];
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
/**
|
|
365
|
+
* Where Super Pi's repository root is, found from the compiled server's own location.
|
|
366
|
+
*
|
|
367
|
+
* The extensions are mounted by PATH, and Pi resolves a relative path against the CONVERSATION's
|
|
368
|
+
* workspace rather than the server's directory - so the path has to be absolute, and it has to be
|
|
369
|
+
* derived from something that is the same in every way the server runs (built to `dist/server/`, or run
|
|
370
|
+
* from `src/server/` under tsx). `import.meta.dirname` is that thing.
|
|
371
|
+
*/
|
|
372
|
+
export function repositoryRootFrom(from = import.meta.dirname) {
|
|
373
|
+
return join(from, "..", "..");
|
|
374
|
+
}
|
|
375
|
+
/** Whether Super Pi's own extensions are present on disk. */
|
|
376
|
+
export function extensionsAvailable(repositoryRoot) {
|
|
377
|
+
return superPiExtensionPaths(repositoryRoot).length > 0;
|
|
378
|
+
}
|
|
379
|
+
/** Whether the extension directory exists at all, for a clearer failure message. */
|
|
380
|
+
export function extensionDirectoryExists(repositoryRoot) {
|
|
381
|
+
return existsSync(join(repositoryRoot, "agents", "super-pi-task", "index.ts"));
|
|
382
|
+
}
|