@pi-chamber/web 1.0.7 → 1.0.8-rc.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/dist/assets/AgentsSurface-BmHImX8m.js +1 -0
- package/dist/assets/ChoicesArtifact-C71fGOm2.js +1 -0
- package/dist/assets/DiagramView-BZQxoiZu.js +1 -0
- package/dist/assets/{DiffView-BxW6BuOC.js → DiffView-C70pbgk-.js} +6 -6
- package/dist/assets/FileSaveConflictDialog-Cu8c3gBV.js +3 -0
- package/dist/assets/FilesView-nFJYEdRw.js +6 -0
- package/dist/assets/GitHubDetailScaffold-Jvv_tgbl.js +11 -0
- package/dist/assets/GitHubLinkPicker-BXD2ODRi.js +1 -0
- package/dist/assets/GitHubListPrimitives-BWI706F0.js +1 -0
- package/dist/assets/{GitView-DD33ngnM.js → GitView-MIDG5RYW.js} +5 -5
- package/dist/assets/{IssuesSurface-BAY_eyX5.js → IssuesSurface-uNlozeu0.js} +2 -2
- package/dist/assets/{JsonTreeView-DpXbUrAl.js → JsonTreeView-CSLsTriz.js} +1 -1
- package/dist/assets/{MarkdownRendererImpl-Cn63lAmn.js → MarkdownRendererImpl-Cs-7BfWi.js} +3 -3
- package/dist/assets/PatchDiff-axbsnbTJ.js +1 -0
- package/dist/assets/PierreDiffViewer-lwn6w_5w.js +147 -0
- package/dist/assets/PullRequestsSurface-o_AXDjbO.js +2 -0
- package/dist/assets/{SessionSwitcherContent-CscYekC1.js → SessionSwitcherContent-C4CMlcbv.js} +1 -1
- package/dist/assets/SessionSwitcherDropdown-DCBVuCoo.js +2 -0
- package/dist/assets/SessionUnreadDot-DyeIrsro.js +1 -0
- package/dist/assets/SettingsView-BHBpt2Um.js +7 -0
- package/dist/assets/{SettingsWindow-gxjULdm1.js → SettingsWindow-Cb4st5y5.js} +1 -1
- package/dist/assets/{StickyHorizontalScrollbar-DNsbTLS7.js → StickyHorizontalScrollbar-CMbTn5WQ.js} +1 -1
- package/dist/assets/SubagentsArtifact-BzeMEoFP.js +1 -0
- package/dist/assets/ToolOutputDialog-BP2mOWdV.js +8 -0
- package/dist/assets/ToolPartDiffPreview-D49XBR9b.js +1 -0
- package/dist/assets/{VirtualizedFileDiff-BrbPymTL.js → VirtualizedFileDiff-CLgDONEQ.js} +4 -4
- package/dist/assets/{Virtualizer-okhy9Aq3.js → Virtualizer-PxblpQn6.js} +1 -1
- package/dist/assets/VisualFrame-CJrAvWSo.js +22 -0
- package/dist/assets/VisualsArtifact-DqLGgU-Q.js +1 -0
- package/dist/assets/{collapsible-D6qdoq7-.js → collapsible-BeyKtQGB.js} +1 -1
- package/dist/assets/{computeVirtualFileMetrics-G4csGiKs.js → computeVirtualFileMetrics-DmO6H8u6.js} +2 -2
- package/dist/assets/contextFileOpenGuard-DOK251YW.js +1 -0
- package/dist/assets/{fileTreeStatus-Bskhj4qT.js → fileTreeStatus-CnzR7kxA.js} +2 -2
- package/dist/assets/gitStatusPredicates-4kPg2t6j.js +1 -0
- package/dist/assets/githubLink-QvaLfNNT.js +10 -0
- package/dist/assets/{index-I2QYqABE.js → index-B2v0_mez.js} +8 -8
- package/dist/assets/index-D3F4JrPN.css +1 -0
- package/dist/assets/{index-ComwtfT4.js → index-DMX9wT1Z.js} +1 -1
- package/dist/assets/{main-DoiadX0a.js → main-BW9J3Y72.js} +2 -2
- package/dist/assets/main-BirYxac2.js +137 -0
- package/dist/assets/{markdownCore-DczkEluO.js → markdownCore-CxmcPur8.js} +2 -2
- package/dist/assets/miniChat-BRB11eEs.js +2 -0
- package/dist/assets/{mobile-BucKVm1P.js → mobile-DJZYYCuB.js} +2 -2
- package/dist/assets/{nativeFileSave-Cp9i5QGd.js → nativeFileSave-B6QpoPRn.js} +1 -1
- package/dist/assets/pi-session-focus-preference-PWoh3LNA.js +9 -0
- package/dist/assets/{renderDiffWithHighlighter-PL82AR81.js → renderDiffWithHighlighter-C48T6YFJ.js} +1 -1
- package/dist/assets/renderElectronMiniChatApp-N-BQdJl0.js +2 -0
- package/dist/assets/{renderFileWithHighlighter-CYgfbA4F.js → renderFileWithHighlighter-8Kt2MyTN.js} +1 -1
- package/dist/assets/{renderMobileApp-Bp74b_Lo.js → renderMobileApp-B7cT7m5b.js} +3 -3
- package/dist/assets/runtimeEndpointReset-BC6yGnxN.js +62 -0
- package/dist/assets/runtimeSurface-kIEoYsPP.js +1 -0
- package/dist/assets/selection-BTEdLRVK.js +1 -0
- package/dist/assets/useAppFontEffects-EcTZ_I_I.js +225 -0
- package/dist/assets/useGitHubRemoteSearch-DIBHNu8r.js +1 -0
- package/dist/assets/useSwitcherItems-DfLbfX37.js +1 -0
- package/dist/assets/{vendor-aparajita-capacitor-secure-storage-DVZvgYu4.js → vendor-aparajita-capacitor-secure-storage-DUoR8t1G.js} +1 -1
- package/dist/assets/{vendor-base-ui-BCqPBzDj.js → vendor-base-ui-DE6jnTiC.js} +1 -1
- package/dist/assets/{vendor-boot-3SaHYVb1.js → vendor-boot-D-KEJjsM.js} +29 -29
- package/dist/assets/{vendor-capacitor-app-NbQ-WiPS.js → vendor-capacitor-app-CO5jS31X.js} +1 -1
- package/dist/assets/{vendor-capacitor-keyboard-CgrHt8iN.js → vendor-capacitor-keyboard-335osRpd.js} +1 -1
- package/dist/assets/{vendor-capacitor-status-bar-CWt0OF5t.js → vendor-capacitor-status-bar-lB9y4H9d.js} +1 -1
- package/dist/assets/{vendor-codemirror-autocomplete-WThuuUAz.js → vendor-codemirror-autocomplete-BKvJ8PfM.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-angular-BbLGCxF6.js → vendor-codemirror-lang-angular-wjCUD0bM.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-cpp-Cceks-9O.js → vendor-codemirror-lang-cpp-LJzlG8sJ.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-css-D1wpUg3Z.js → vendor-codemirror-lang-css-DoEEdEpW.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-go-Cv0zXHHM.js → vendor-codemirror-lang-go-DexsLPb8.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-html-DbL8oT9H.js → vendor-codemirror-lang-html-h25V-Hp5.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-java-CNugenuC.js → vendor-codemirror-lang-java-D8xoT8cv.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-javascript-Bx_FIyZF.js → vendor-codemirror-lang-javascript-DF3GDYje.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-jinja-DDGjB3Zq.js → vendor-codemirror-lang-jinja-BboTHFdn.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-json-DIvqf9Pb.js → vendor-codemirror-lang-json-DCqvG1nE.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-less-D8r9dGG1.js → vendor-codemirror-lang-less-B8ZrSKJM.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-liquid-B24mguYi.js → vendor-codemirror-lang-liquid-DF9S5m5F.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-markdown-v3yG2sbf.js → vendor-codemirror-lang-markdown-6BNbCEPe.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-php-BcZGalqy.js → vendor-codemirror-lang-php-CQwAz1Hd.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-python-b-JqEwQy.js → vendor-codemirror-lang-python-DQym-8Tx.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-rust-B1uZxDW-.js → vendor-codemirror-lang-rust-DknzOTkO.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-sass-DqPrngKp.js → vendor-codemirror-lang-sass-dB0Rm5HI.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-sql-UyCnpt-k.js → vendor-codemirror-lang-sql-CCQUnnD-.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-vue-xDwYkovV.js → vendor-codemirror-lang-vue-h1M5bF00.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-wast-CF3169p_.js → vendor-codemirror-lang-wast-DWgtlGfu.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-xml-FCtVhuOb.js → vendor-codemirror-lang-xml-DncwoCUY.js} +1 -1
- package/dist/assets/{vendor-codemirror-lang-yaml-g0sPmAnv.js → vendor-codemirror-lang-yaml-C7QkS5ER.js} +1 -1
- package/dist/assets/{vendor-codemirror-language-data-B03xgzP2.js → vendor-codemirror-language-data-BUZIlm3G.js} +2 -2
- package/dist/assets/{vendor-codemirror-search-Dw3Wpu15.js → vendor-codemirror-search-BlDCaCMK.js} +1 -1
- package/dist/assets/{vendor-lezer-cpp-Cu3E-KUI.js → vendor-lezer-cpp-B4JK1BC1.js} +1 -1
- package/dist/assets/{vendor-lezer-css-Cb8vp67u.js → vendor-lezer-css-DRxDmhcy.js} +1 -1
- package/dist/assets/{vendor-lezer-go-BTsIaOm7.js → vendor-lezer-go-DsUgfmxi.js} +1 -1
- package/dist/assets/{vendor-lezer-html-UQMsUwj-.js → vendor-lezer-html-qr9pUPmM.js} +1 -1
- package/dist/assets/{vendor-lezer-java-BIWrFrAx.js → vendor-lezer-java-6UyNiQiB.js} +1 -1
- package/dist/assets/{vendor-lezer-javascript-BH2Etgoy.js → vendor-lezer-javascript-CUdJ0VGA.js} +1 -1
- package/dist/assets/{vendor-lezer-json-CE-QUCwM.js → vendor-lezer-json-BKYAA8Hu.js} +1 -1
- package/dist/assets/{vendor-lezer-lr-HY6Yc0Vr.js → vendor-lezer-lr-DluApmOX.js} +1 -1
- package/dist/assets/{vendor-lezer-markdown-xFL3Evwf.js → vendor-lezer-markdown-B-uzYzYT.js} +1 -1
- package/dist/assets/{vendor-lezer-php-Cr_mQGrG.js → vendor-lezer-php-DI6PNjlz.js} +1 -1
- package/dist/assets/{vendor-lezer-python-BNRFWCb0.js → vendor-lezer-python-Bj232yb5.js} +1 -1
- package/dist/assets/{vendor-lezer-rust-BvfOK5cU.js → vendor-lezer-rust-DlPG_Yau.js} +1 -1
- package/dist/assets/{vendor-lezer-sass-qoxiLisk.js → vendor-lezer-sass-CBsyWB2A.js} +1 -1
- package/dist/assets/{vendor-lezer-xml--x8SSpqU.js → vendor-lezer-xml-C1FmgtmE.js} +1 -1
- package/dist/assets/{vendor-lezer-yaml-BDo1JaEr.js → vendor-lezer-yaml-DpHmjriG.js} +1 -1
- package/dist/assets/{vendor-replit-codemirror-vim-D1Fe7FiY.js → vendor-replit-codemirror-vim-Cvk64got.js} +1 -1
- package/dist/assets/{web-components-CGDpzixf.js → web-components-C_DsTJis.js} +4 -4
- package/dist/index.html +4 -4
- package/dist/mini-chat.html +3 -3
- package/dist/mobile.html +3 -3
- package/package.json +2 -1
- package/plugins/registry.json +7 -0
- package/plugins/subagents/LICENSE +25 -0
- package/plugins/subagents/agents/planner.md +36 -0
- package/plugins/subagents/agents/reviewer.md +34 -0
- package/plugins/subagents/agents/scout.md +49 -0
- package/plugins/subagents/agents/worker.md +23 -0
- package/plugins/subagents/extension.js +631 -0
- package/plugins/subagents/extension.test.js +295 -0
- package/plugins/subagents/package.json +41 -0
- package/plugins/visuals/choices.js +168 -0
- package/plugins/visuals/extension.js +87 -0
- package/plugins/visuals/files.js +74 -0
- package/plugins/visuals/package.json +32 -0
- package/server/index.js +20 -0
- package/server/lib/github/DOCUMENTATION.md +4 -2
- package/server/lib/github/gh-cli.js +35 -9
- package/server/lib/github/gh-cli.test.js +122 -0
- package/server/lib/notifications/pi-notification-watcher.js +3 -0
- package/server/lib/notifications/pi-notification-watcher.test.js +10 -0
- package/server/lib/open-url/DOCUMENTATION.md +1 -1
- package/server/lib/pi/extension-protocol.js +54 -0
- package/server/lib/pi/fixtures/pichamber-gui-demo.ts +12 -13
- package/server/lib/pi/routes-extension-events.test.js +115 -0
- package/server/lib/pi/routes.js +307 -5
- package/server/lib/pi/routes.test.js +296 -1
- package/server/lib/pi/session-daemon/DOCUMENTATION.md +25 -8
- package/server/lib/pi/session-daemon/extension-bridge.js +89 -29
- package/server/lib/pi/session-daemon/extension-config.js +719 -0
- package/server/lib/pi/session-daemon/extension-config.test.js +618 -0
- package/server/lib/pi/session-daemon/extension-controls.js +177 -0
- package/server/lib/pi/session-daemon/extension-controls.test.js +181 -0
- package/server/lib/pi/session-daemon/extension-name.js +6 -0
- package/server/lib/pi/session-daemon/extension-name.test.js +5 -0
- package/server/lib/pi/session-daemon/extension-palette.js +146 -0
- package/server/lib/pi/session-daemon/extension-palette.test.js +107 -0
- package/server/lib/pi/session-daemon/extension-replacements.js +138 -0
- package/server/lib/pi/session-daemon/extension-replacements.test.js +116 -0
- package/server/lib/pi/session-daemon/extension-ui-mode.js +30 -0
- package/server/lib/pi/session-daemon/extension-ui-mode.test.js +34 -0
- package/server/lib/pi/session-daemon/pichamber-ui.js +44 -0
- package/server/lib/pi/session-daemon/plugin-host.js +245 -0
- package/server/lib/pi/session-daemon/plugin-host.test.js +192 -0
- package/server/lib/pi/session-daemon/session-daemon-controls.e2e.test.js +205 -0
- package/server/lib/pi/session-daemon/session-daemon-drafts.e2e.test.js +409 -0
- package/server/lib/pi/session-daemon/session-daemon-extension-config.e2e.test.js +196 -0
- package/server/lib/pi/session-daemon/session-daemon-extensions.test.js +137 -6
- package/server/lib/pi/session-daemon/session-daemon-plugins.e2e.test.js +272 -0
- package/server/lib/pi/session-daemon/session-daemon-providers.e2e.test.js +153 -0
- package/server/lib/pi/session-daemon/session-daemon.js +568 -61
- package/server/lib/pi/session-daemon/session-daemon.test.js +164 -4
- package/server/lib/pi/session-daemon/session-engine-router.js +7 -0
- package/server/lib/pi/session-daemon/session-engine-router.test.js +20 -0
- package/server/lib/pi/session-daemon/supervisor.js +22 -3
- package/server/lib/pi/settings-store.js +14 -0
- package/server/lib/pi/settings-store.test.js +11 -0
- package/server/lib/plugins/DOCUMENTATION.md +186 -0
- package/server/lib/plugins/daemon-sync.js +78 -0
- package/server/lib/plugins/daemon-sync.supervisor.test.js +83 -0
- package/server/lib/plugins/daemon-sync.test.js +96 -0
- package/server/lib/plugins/impact.js +139 -0
- package/server/lib/plugins/impact.test.js +82 -0
- package/server/lib/plugins/manifest.js +195 -0
- package/server/lib/plugins/manifest.test.js +118 -0
- package/server/lib/plugins/registry.js +59 -0
- package/server/lib/plugins/routes.js +92 -0
- package/server/lib/plugins/routes.test.js +219 -0
- package/server/lib/plugins/service.js +161 -0
- package/server/lib/plugins/store.js +261 -0
- package/server/lib/plugins/store.test.js +188 -0
- package/server/lib/plugins/visuals-extension.test.js +237 -0
- package/server/lib/server-browser/DOCUMENTATION.md +32 -7
- package/server/lib/server-browser/browser-tab.js +4 -1
- package/server/lib/server-browser/downloads.js +261 -34
- package/server/lib/server-browser/downloads.test.js +171 -0
- package/server/lib/server-browser/runtime.integration.test.js +47 -0
- package/server/lib/server-browser/runtime.js +16 -0
- package/server/lib/server-browser/server-browser.js +25 -6
- package/server/lib/tunnels/executable-search.js +5 -1
- package/server/lib/tunnels/executable-search.test.js +26 -0
- package/dist/assets/DiagramView-BB-aZobi.js +0 -1
- package/dist/assets/FileSaveConflictDialog-Bzz8FNMq.js +0 -3
- package/dist/assets/FilesView-DECxN8Z0.js +0 -6
- package/dist/assets/GitHubDetailScaffold-CWsWycRd.js +0 -11
- package/dist/assets/GitHubLinkPicker-BVYdg_e8.js +0 -1
- package/dist/assets/GitHubListPrimitives-Dlv3tC4d.js +0 -1
- package/dist/assets/PatchDiff-BklyOEHs.js +0 -1
- package/dist/assets/PierreDiffViewer-wc6cB6qw.js +0 -147
- package/dist/assets/PullRequestsSurface-BZvJkT1I.js +0 -2
- package/dist/assets/SessionSwitcherDropdown-DShvvGwC.js +0 -2
- package/dist/assets/SessionUnreadDot-CbqRq6h_.js +0 -1
- package/dist/assets/SettingsView-DcF-At5E.js +0 -6
- package/dist/assets/ToolOutputDialog-DdMIfrnK.js +0 -8
- package/dist/assets/ToolPartDiffPreview-C6Sm4eVf.js +0 -1
- package/dist/assets/contextFileOpenGuard-UU86YHgI.js +0 -1
- package/dist/assets/gitStatusPredicates-DQEO4Psc.js +0 -1
- package/dist/assets/githubLink-ByPAyFjh.js +0 -10
- package/dist/assets/index-BaLCg7tL.css +0 -1
- package/dist/assets/main-DyFfbllq.js +0 -137
- package/dist/assets/miniChat-Ck6MEZ9Q.js +0 -2
- package/dist/assets/pi-session-focus-preference-Dx0UXPoO.js +0 -9
- package/dist/assets/renderElectronMiniChatApp-Cb7s7dWl.js +0 -2
- package/dist/assets/runtimeEndpointReset-7nWYnKd4.js +0 -62
- package/dist/assets/runtimeSurface-CFwnvks_.js +0 -1
- package/dist/assets/useAppFontEffects-ZTyNwFk6.js +0 -213
- package/dist/assets/useGitHubRemoteSearch-BF3ohpsh.js +0 -1
- package/dist/assets/useSwitcherItems-BJzwyDGX.js +0 -1
|
@@ -0,0 +1,631 @@
|
|
|
1
|
+
// Sub-agents: the agent half. Registers `subagent`, which hands tasks to
|
|
2
|
+
// child `pi --mode json -p --no-session` processes, each with its own
|
|
3
|
+
// context. PiChamber draws the runs from the result's compact `details`.
|
|
4
|
+
//
|
|
5
|
+
// Adapted from the subagent example in @earendil-works/pi-coding-agent
|
|
6
|
+
// (examples/extensions/subagent), MIT License, Copyright (c) Mario Zechner.
|
|
7
|
+
// See ./LICENSE.
|
|
8
|
+
//
|
|
9
|
+
// `pichamber` is PiChamber's handle ({ id, state(directory, sessionId),
|
|
10
|
+
// onStateChange }).
|
|
11
|
+
// The Pi CLI passes none, so the manifest defaults apply (tool on).
|
|
12
|
+
|
|
13
|
+
import { spawn as nodeSpawn } from 'node:child_process';
|
|
14
|
+
import * as fs from 'node:fs';
|
|
15
|
+
import * as os from 'node:os';
|
|
16
|
+
import * as path from 'node:path';
|
|
17
|
+
import { fileURLToPath } from 'node:url';
|
|
18
|
+
import { CONFIG_DIR_NAME, getAgentDir, parseFrontmatter } from '@earendil-works/pi-coding-agent';
|
|
19
|
+
|
|
20
|
+
export const TOOL_NAME = 'subagent';
|
|
21
|
+
export const MAX_PARALLEL_TASKS = 8;
|
|
22
|
+
export const MAX_CONCURRENCY = 4;
|
|
23
|
+
export const OUTPUT_CAP = 50 * 1024;
|
|
24
|
+
export const ERROR_CAP = 2_000;
|
|
25
|
+
export const ACTIVITY_LIMIT = 40;
|
|
26
|
+
export const ACTIVITY_TEXT_CAP = 400;
|
|
27
|
+
export const UPDATE_INTERVAL_MS = 250;
|
|
28
|
+
const KILL_DELAY_MS = 5_000;
|
|
29
|
+
const BUNDLED_AGENTS_DIR = fileURLToPath(new URL('./agents/', import.meta.url));
|
|
30
|
+
const DEFAULT_STATE = Object.freeze({ on: true });
|
|
31
|
+
|
|
32
|
+
// The id PiChamber keys a session's own plugin values by.
|
|
33
|
+
const sessionIdOf = (ctx) => {
|
|
34
|
+
try {
|
|
35
|
+
const id = ctx?.sessionManager?.getSessionId?.();
|
|
36
|
+
return typeof id === 'string' && id.length > 0 ? id : undefined;
|
|
37
|
+
} catch {
|
|
38
|
+
return undefined;
|
|
39
|
+
}
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
const PARAMETERS = {
|
|
43
|
+
type: 'object',
|
|
44
|
+
properties: {
|
|
45
|
+
agent: { type: 'string', description: 'Agent name (single mode)' },
|
|
46
|
+
task: { type: 'string', description: 'Task (single mode)' },
|
|
47
|
+
tasks: {
|
|
48
|
+
type: 'array',
|
|
49
|
+
description: 'Parallel mode: [{agent, task}]',
|
|
50
|
+
items: {
|
|
51
|
+
type: 'object',
|
|
52
|
+
properties: { agent: { type: 'string' }, task: { type: 'string' }, cwd: { type: 'string' } },
|
|
53
|
+
required: ['agent', 'task'],
|
|
54
|
+
},
|
|
55
|
+
},
|
|
56
|
+
chain: {
|
|
57
|
+
type: 'array',
|
|
58
|
+
description: 'Chain mode: [{agent, task}] run in order; {previous} is the prior output',
|
|
59
|
+
items: {
|
|
60
|
+
type: 'object',
|
|
61
|
+
properties: { agent: { type: 'string' }, task: { type: 'string' }, cwd: { type: 'string' } },
|
|
62
|
+
required: ['agent', 'task'],
|
|
63
|
+
},
|
|
64
|
+
},
|
|
65
|
+
agentScope: { type: 'string', enum: ['user', 'project', 'both'], description: 'Default "user". "both" adds project agents.' },
|
|
66
|
+
confirmProjectAgents: { type: 'boolean', description: 'Ask before running project agents. Default true.' },
|
|
67
|
+
cwd: { type: 'string', description: 'Working directory (single mode)' },
|
|
68
|
+
},
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
// ---------------------------------------------------------------- agents
|
|
72
|
+
|
|
73
|
+
const parseToolList = (value) => {
|
|
74
|
+
const raw = Array.isArray(value) ? value : typeof value === 'string' ? value.split(',') : [];
|
|
75
|
+
const tools = raw.filter((t) => typeof t === 'string').map((t) => t.trim()).filter(Boolean);
|
|
76
|
+
return tools.length > 0 ? tools : undefined;
|
|
77
|
+
};
|
|
78
|
+
|
|
79
|
+
/** Read `*.md` agent files from a folder. A bad file is skipped, never fatal. */
|
|
80
|
+
export const loadAgentsFromDir = (dir, source) => {
|
|
81
|
+
let entries;
|
|
82
|
+
try {
|
|
83
|
+
entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
84
|
+
} catch {
|
|
85
|
+
return [];
|
|
86
|
+
}
|
|
87
|
+
const agents = [];
|
|
88
|
+
for (const entry of entries) {
|
|
89
|
+
if (!entry.name.endsWith('.md')) continue;
|
|
90
|
+
if (!entry.isFile() && !entry.isSymbolicLink()) continue;
|
|
91
|
+
const filePath = path.join(dir, entry.name);
|
|
92
|
+
let parsed;
|
|
93
|
+
try {
|
|
94
|
+
parsed = parseFrontmatter(fs.readFileSync(filePath, 'utf-8'));
|
|
95
|
+
} catch {
|
|
96
|
+
continue;
|
|
97
|
+
}
|
|
98
|
+
const { frontmatter, body } = parsed;
|
|
99
|
+
if (typeof frontmatter?.name !== 'string' || typeof frontmatter.description !== 'string') continue;
|
|
100
|
+
agents.push({
|
|
101
|
+
name: frontmatter.name,
|
|
102
|
+
description: frontmatter.description,
|
|
103
|
+
tools: parseToolList(frontmatter.tools),
|
|
104
|
+
model: typeof frontmatter.model === 'string' ? frontmatter.model : undefined,
|
|
105
|
+
systemPrompt: body ?? '',
|
|
106
|
+
source,
|
|
107
|
+
filePath,
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
return agents;
|
|
111
|
+
};
|
|
112
|
+
|
|
113
|
+
const isDirectory = (p) => {
|
|
114
|
+
try {
|
|
115
|
+
return fs.statSync(p).isDirectory();
|
|
116
|
+
} catch {
|
|
117
|
+
return false;
|
|
118
|
+
}
|
|
119
|
+
};
|
|
120
|
+
|
|
121
|
+
const findNearestProjectAgentsDir = (cwd) => {
|
|
122
|
+
if (typeof cwd !== 'string' || cwd.length === 0) return null;
|
|
123
|
+
let current = cwd;
|
|
124
|
+
while (true) {
|
|
125
|
+
const candidate = path.join(current, CONFIG_DIR_NAME, 'agents');
|
|
126
|
+
if (isDirectory(candidate)) return candidate;
|
|
127
|
+
const parent = path.dirname(current);
|
|
128
|
+
if (parent === current) return null;
|
|
129
|
+
current = parent;
|
|
130
|
+
}
|
|
131
|
+
};
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* Bundled agents are the base layer; user agents override them by name, and
|
|
135
|
+
* project agents (scope project/both) override both.
|
|
136
|
+
*/
|
|
137
|
+
export const discoverAgents = (cwd, scope, { userAgentsDir, bundledAgentsDir = BUNDLED_AGENTS_DIR } = {}) => {
|
|
138
|
+
const userDir = userAgentsDir ?? path.join(getAgentDir(), 'agents');
|
|
139
|
+
const projectAgentsDir = findNearestProjectAgentsDir(cwd);
|
|
140
|
+
const map = new Map();
|
|
141
|
+
for (const agent of loadAgentsFromDir(bundledAgentsDir, 'bundled')) map.set(agent.name, agent);
|
|
142
|
+
if (scope !== 'project') for (const agent of loadAgentsFromDir(userDir, 'user')) map.set(agent.name, agent);
|
|
143
|
+
if (scope !== 'user' && projectAgentsDir) {
|
|
144
|
+
for (const agent of loadAgentsFromDir(projectAgentsDir, 'project')) map.set(agent.name, agent);
|
|
145
|
+
}
|
|
146
|
+
return { agents: [...map.values()], projectAgentsDir };
|
|
147
|
+
};
|
|
148
|
+
|
|
149
|
+
// ---------------------------------------------------------------- formatting
|
|
150
|
+
|
|
151
|
+
const clip = (text, max) => (text.length > max ? `${text.slice(0, max)}...` : text);
|
|
152
|
+
|
|
153
|
+
const clipBytes = (text, cap) => {
|
|
154
|
+
const bytes = Buffer.byteLength(text, 'utf8');
|
|
155
|
+
if (bytes <= cap) return { text, omitted: 0 };
|
|
156
|
+
let cut = text.slice(0, cap);
|
|
157
|
+
while (Buffer.byteLength(cut, 'utf8') > cap) cut = cut.slice(0, -1);
|
|
158
|
+
return { text: cut, omitted: bytes - Buffer.byteLength(cut, 'utf8') };
|
|
159
|
+
};
|
|
160
|
+
|
|
161
|
+
const shortenPath = (p) => {
|
|
162
|
+
const home = os.homedir();
|
|
163
|
+
return home && p.startsWith(home) ? `~${p.slice(home.length)}` : p;
|
|
164
|
+
};
|
|
165
|
+
|
|
166
|
+
const readRange = (offset, limit) => {
|
|
167
|
+
if (typeof offset !== 'number' && typeof limit !== 'number') return '';
|
|
168
|
+
const start = typeof offset === 'number' ? offset : 1;
|
|
169
|
+
return typeof limit === 'number' ? `:${start}-${start + limit - 1}` : `:${start}`;
|
|
170
|
+
};
|
|
171
|
+
|
|
172
|
+
/** One-line summary of a child's tool call. */
|
|
173
|
+
export const summarizeToolCall = (name, args = {}) => {
|
|
174
|
+
const a = args && typeof args === 'object' ? args : {};
|
|
175
|
+
const str = (v, fallback) => (typeof v === 'string' && v.length > 0 ? v : fallback);
|
|
176
|
+
switch (name) {
|
|
177
|
+
case 'bash': return `$ ${clip(str(a.command, '...'), 60)}`;
|
|
178
|
+
case 'read': return `read ${shortenPath(str(a.file_path ?? a.path, '...'))}${readRange(a.offset, a.limit)}`;
|
|
179
|
+
case 'write': {
|
|
180
|
+
const lines = str(a.content, '').split('\n').length;
|
|
181
|
+
return `write ${shortenPath(str(a.file_path ?? a.path, '...'))}${lines > 1 ? ` (${lines} lines)` : ''}`;
|
|
182
|
+
}
|
|
183
|
+
case 'edit': return `edit ${shortenPath(str(a.file_path ?? a.path, '...'))}`;
|
|
184
|
+
case 'ls': return `ls ${shortenPath(str(a.path, '.'))}`;
|
|
185
|
+
case 'find': return `find ${str(a.pattern, '*')} in ${shortenPath(str(a.path, '.'))}`;
|
|
186
|
+
case 'grep': return `grep /${str(a.pattern, '')}/ in ${shortenPath(str(a.path, '.'))}`;
|
|
187
|
+
default: {
|
|
188
|
+
let json;
|
|
189
|
+
try {
|
|
190
|
+
json = JSON.stringify(a) ?? '';
|
|
191
|
+
} catch {
|
|
192
|
+
json = '';
|
|
193
|
+
}
|
|
194
|
+
return `${name} ${clip(json, 80)}`;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
};
|
|
198
|
+
|
|
199
|
+
// ---------------------------------------------------------------- runs
|
|
200
|
+
|
|
201
|
+
const emptyUsage = () => ({ input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, contextTokens: 0, turns: 0 });
|
|
202
|
+
|
|
203
|
+
/** A run keeps private process state beside the public, compact fields. */
|
|
204
|
+
const createRun = ({ agent, agentSource = 'unknown', task, step, status = 'queued', model }) => ({
|
|
205
|
+
agent, agentSource, task, step, status, model,
|
|
206
|
+
usage: emptyUsage(),
|
|
207
|
+
activity: [],
|
|
208
|
+
lastText: '',
|
|
209
|
+
stderr: '',
|
|
210
|
+
errorMessage: undefined,
|
|
211
|
+
stopReason: undefined,
|
|
212
|
+
});
|
|
213
|
+
|
|
214
|
+
const isFailed = (run) => run.status === 'failed' || run.status === 'aborted';
|
|
215
|
+
|
|
216
|
+
const runError = (run) => clip(run.errorMessage || run.stderr.trim() || '', ERROR_CAP) || undefined;
|
|
217
|
+
|
|
218
|
+
/** The compact, public shape the UI parses. */
|
|
219
|
+
const publicRun = (run) => {
|
|
220
|
+
const result = {
|
|
221
|
+
agent: run.agent,
|
|
222
|
+
agentSource: run.agentSource,
|
|
223
|
+
task: run.task,
|
|
224
|
+
...(run.step !== undefined ? { step: run.step } : {}),
|
|
225
|
+
status: run.status,
|
|
226
|
+
...(run.model ? { model: run.model } : {}),
|
|
227
|
+
usage: { ...run.usage },
|
|
228
|
+
activity: run.activity.slice(),
|
|
229
|
+
output: clipBytes(run.lastText, OUTPUT_CAP).text,
|
|
230
|
+
};
|
|
231
|
+
if (isFailed(run)) {
|
|
232
|
+
const error = runError(run);
|
|
233
|
+
if (error) result.error = error;
|
|
234
|
+
}
|
|
235
|
+
return result;
|
|
236
|
+
};
|
|
237
|
+
|
|
238
|
+
/** What the model reads for one run (same order as the example). */
|
|
239
|
+
const runOutputForModel = (run) => {
|
|
240
|
+
if (isFailed(run)) return run.errorMessage || run.stderr || run.lastText || '(no output)';
|
|
241
|
+
return run.lastText || '(no output)';
|
|
242
|
+
};
|
|
243
|
+
|
|
244
|
+
const truncateForModel = (output) => {
|
|
245
|
+
const { text, omitted } = clipBytes(output, OUTPUT_CAP);
|
|
246
|
+
return omitted === 0 ? text : `${text}\n\n[Output truncated: ${omitted} bytes omitted.]`;
|
|
247
|
+
};
|
|
248
|
+
|
|
249
|
+
const pushActivity = (run, item) => {
|
|
250
|
+
run.activity.push(item);
|
|
251
|
+
if (run.activity.length > ACTIVITY_LIMIT) run.activity.splice(0, run.activity.length - ACTIVITY_LIMIT);
|
|
252
|
+
};
|
|
253
|
+
|
|
254
|
+
/** Apply one JSON-mode event line from the child. Exported for tests. */
|
|
255
|
+
export const applyChildEvent = (run, event) => {
|
|
256
|
+
if (event?.type !== 'message_end' || !event.message) return false;
|
|
257
|
+
const msg = event.message;
|
|
258
|
+
if (msg.role !== 'assistant') return true;
|
|
259
|
+
run.usage.turns++;
|
|
260
|
+
const usage = msg.usage;
|
|
261
|
+
if (usage) {
|
|
262
|
+
run.usage.input += usage.input || 0;
|
|
263
|
+
run.usage.output += usage.output || 0;
|
|
264
|
+
run.usage.cacheRead += usage.cacheRead || 0;
|
|
265
|
+
run.usage.cacheWrite += usage.cacheWrite || 0;
|
|
266
|
+
run.usage.cost += usage.cost?.total || 0;
|
|
267
|
+
run.usage.contextTokens = usage.totalTokens || 0;
|
|
268
|
+
}
|
|
269
|
+
if (!run.model && msg.model) run.model = msg.model;
|
|
270
|
+
if (msg.stopReason) run.stopReason = msg.stopReason;
|
|
271
|
+
if (msg.errorMessage) run.errorMessage = msg.errorMessage;
|
|
272
|
+
let text = '';
|
|
273
|
+
for (const part of Array.isArray(msg.content) ? msg.content : []) {
|
|
274
|
+
if (part?.type === 'text' && typeof part.text === 'string') {
|
|
275
|
+
if (!text) text = part.text;
|
|
276
|
+
pushActivity(run, { kind: 'text', text: clip(part.text, ACTIVITY_TEXT_CAP) });
|
|
277
|
+
} else if (part?.type === 'toolCall') {
|
|
278
|
+
const name = typeof part.name === 'string' ? part.name : 'tool';
|
|
279
|
+
pushActivity(run, { kind: 'tool', name, text: summarizeToolCall(name, part.arguments) });
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
if (text) run.lastText = text;
|
|
283
|
+
return true;
|
|
284
|
+
};
|
|
285
|
+
|
|
286
|
+
/** Run the example's Pi invocation logic: reuse this process's Pi CLI. */
|
|
287
|
+
export const getPiInvocation = (args) => {
|
|
288
|
+
const currentScript = process.argv[1];
|
|
289
|
+
const isBunVirtualScript = currentScript?.startsWith('/$bunfs/root/');
|
|
290
|
+
if (currentScript && !isBunVirtualScript && fs.existsSync(currentScript)) {
|
|
291
|
+
return { command: process.execPath, args: [currentScript, ...args] };
|
|
292
|
+
}
|
|
293
|
+
const execName = path.basename(process.execPath).toLowerCase();
|
|
294
|
+
if (!/^(node|bun)(\.exe)?$/.test(execName)) return { command: process.execPath, args };
|
|
295
|
+
return { command: 'pi', args };
|
|
296
|
+
};
|
|
297
|
+
|
|
298
|
+
const writePromptToTempFile = async (tmpRoot, agentName, prompt) => {
|
|
299
|
+
const dir = await fs.promises.mkdtemp(path.join(tmpRoot, 'pi-subagent-'));
|
|
300
|
+
const filePath = path.join(dir, `prompt-${agentName.replace(/[^\w.-]+/g, '_')}.md`);
|
|
301
|
+
await fs.promises.writeFile(filePath, prompt, { encoding: 'utf-8', mode: 0o600 });
|
|
302
|
+
return { dir, filePath };
|
|
303
|
+
};
|
|
304
|
+
|
|
305
|
+
/** Coalesce updates to one per interval; `flush` sends the latest at once. */
|
|
306
|
+
export const createThrottle = (send, intervalMs) => {
|
|
307
|
+
let last = 0;
|
|
308
|
+
let timer = null;
|
|
309
|
+
let pending = null;
|
|
310
|
+
const fire = () => {
|
|
311
|
+
timer = null;
|
|
312
|
+
if (!pending) return;
|
|
313
|
+
const value = pending();
|
|
314
|
+
pending = null;
|
|
315
|
+
last = Date.now();
|
|
316
|
+
send(value);
|
|
317
|
+
};
|
|
318
|
+
return {
|
|
319
|
+
push(build) {
|
|
320
|
+
pending = build;
|
|
321
|
+
if (timer) return;
|
|
322
|
+
const wait = intervalMs - (Date.now() - last);
|
|
323
|
+
if (wait <= 0) fire();
|
|
324
|
+
else timer = setTimeout(fire, wait);
|
|
325
|
+
},
|
|
326
|
+
flush(build) {
|
|
327
|
+
if (timer) clearTimeout(timer);
|
|
328
|
+
timer = null;
|
|
329
|
+
pending = build ?? pending;
|
|
330
|
+
fire();
|
|
331
|
+
},
|
|
332
|
+
};
|
|
333
|
+
};
|
|
334
|
+
|
|
335
|
+
const mapWithConcurrencyLimit = async (items, concurrency, fn) => {
|
|
336
|
+
const results = new Array(items.length);
|
|
337
|
+
let next = 0;
|
|
338
|
+
const limit = Math.max(1, Math.min(concurrency, items.length));
|
|
339
|
+
await Promise.all(Array.from({ length: limit }, async () => {
|
|
340
|
+
while (true) {
|
|
341
|
+
const current = next++;
|
|
342
|
+
if (current >= items.length) return;
|
|
343
|
+
results[current] = await fn(items[current], current);
|
|
344
|
+
}
|
|
345
|
+
}));
|
|
346
|
+
return results;
|
|
347
|
+
};
|
|
348
|
+
|
|
349
|
+
/**
|
|
350
|
+
* Build the extension. Tests inject `spawn`, agent folders, the temp root,
|
|
351
|
+
* and timings; the default export uses the real ones.
|
|
352
|
+
*/
|
|
353
|
+
export const createSubagentsExtension = ({
|
|
354
|
+
spawn = nodeSpawn,
|
|
355
|
+
invocation = getPiInvocation,
|
|
356
|
+
bundledAgentsDir = BUNDLED_AGENTS_DIR,
|
|
357
|
+
userAgentsDir,
|
|
358
|
+
tmpRoot = os.tmpdir(),
|
|
359
|
+
updateIntervalMs = UPDATE_INTERVAL_MS,
|
|
360
|
+
killDelayMs = KILL_DELAY_MS,
|
|
361
|
+
} = {}) => {
|
|
362
|
+
const runAgent = async ({ run, agent, defaultCwd, cwd, dispatch, signal, changed }) => {
|
|
363
|
+
if (!agent) return run;
|
|
364
|
+
const args = ['--mode', 'json', '-p', '--no-session'];
|
|
365
|
+
const model = agent.model ?? dispatch.model;
|
|
366
|
+
if (model) args.push('--model', model);
|
|
367
|
+
if (!agent.model && dispatch.thinkingLevel) args.push('--thinking', dispatch.thinkingLevel);
|
|
368
|
+
if (agent.tools?.length) args.push('--tools', agent.tools.join(','));
|
|
369
|
+
run.model = model;
|
|
370
|
+
|
|
371
|
+
let tmp = null;
|
|
372
|
+
try {
|
|
373
|
+
if (agent.systemPrompt.trim()) {
|
|
374
|
+
tmp = await writePromptToTempFile(tmpRoot, agent.name, agent.systemPrompt);
|
|
375
|
+
args.push('--append-system-prompt', tmp.filePath);
|
|
376
|
+
}
|
|
377
|
+
args.push(`Task: ${run.task}`);
|
|
378
|
+
let aborted = false;
|
|
379
|
+
const exitCode = await new Promise((resolveExit) => {
|
|
380
|
+
if (signal?.aborted) {
|
|
381
|
+
aborted = true;
|
|
382
|
+
resolveExit(1);
|
|
383
|
+
return;
|
|
384
|
+
}
|
|
385
|
+
const { command, args: fullArgs } = invocation(args);
|
|
386
|
+
let proc;
|
|
387
|
+
try {
|
|
388
|
+
proc = spawn(command, fullArgs, { cwd: cwd ?? defaultCwd, shell: false, stdio: ['ignore', 'pipe', 'pipe'] });
|
|
389
|
+
} catch (error) {
|
|
390
|
+
run.stderr += error instanceof Error ? error.message : String(error);
|
|
391
|
+
resolveExit(1);
|
|
392
|
+
return;
|
|
393
|
+
}
|
|
394
|
+
run.status = 'running';
|
|
395
|
+
changed();
|
|
396
|
+
let buffer = '';
|
|
397
|
+
const processLine = (line) => {
|
|
398
|
+
if (!line.trim()) return;
|
|
399
|
+
let event;
|
|
400
|
+
try {
|
|
401
|
+
event = JSON.parse(line);
|
|
402
|
+
} catch {
|
|
403
|
+
return;
|
|
404
|
+
}
|
|
405
|
+
if (applyChildEvent(run, event)) changed();
|
|
406
|
+
};
|
|
407
|
+
proc.stdout.on('data', (data) => {
|
|
408
|
+
buffer += data.toString();
|
|
409
|
+
const lines = buffer.split('\n');
|
|
410
|
+
buffer = lines.pop() || '';
|
|
411
|
+
for (const line of lines) processLine(line);
|
|
412
|
+
});
|
|
413
|
+
proc.stderr.on('data', (data) => {
|
|
414
|
+
// Keep a bounded tail; only the first ERROR_CAP chars are reported.
|
|
415
|
+
if (run.stderr.length < ERROR_CAP * 4) run.stderr += data.toString();
|
|
416
|
+
});
|
|
417
|
+
let killTimer = null;
|
|
418
|
+
const onAbort = () => {
|
|
419
|
+
aborted = true;
|
|
420
|
+
proc.kill('SIGTERM');
|
|
421
|
+
killTimer = setTimeout(() => {
|
|
422
|
+
if (proc.exitCode === null && proc.signalCode === null) proc.kill('SIGKILL');
|
|
423
|
+
}, killDelayMs);
|
|
424
|
+
killTimer.unref?.();
|
|
425
|
+
};
|
|
426
|
+
const settle = (code) => {
|
|
427
|
+
if (killTimer) clearTimeout(killTimer);
|
|
428
|
+
signal?.removeEventListener?.('abort', onAbort);
|
|
429
|
+
resolveExit(code);
|
|
430
|
+
};
|
|
431
|
+
proc.on('close', (code) => {
|
|
432
|
+
if (buffer.trim()) processLine(buffer);
|
|
433
|
+
settle(code ?? 0);
|
|
434
|
+
});
|
|
435
|
+
proc.on('error', (error) => {
|
|
436
|
+
run.stderr += error?.message ?? '';
|
|
437
|
+
settle(1);
|
|
438
|
+
});
|
|
439
|
+
signal?.addEventListener?.('abort', onAbort, { once: true });
|
|
440
|
+
});
|
|
441
|
+
if (aborted || run.stopReason === 'aborted') run.status = 'aborted';
|
|
442
|
+
else if (exitCode !== 0 || run.stopReason === 'error') run.status = 'failed';
|
|
443
|
+
else run.status = 'done';
|
|
444
|
+
return run;
|
|
445
|
+
} finally {
|
|
446
|
+
if (tmp) await fs.promises.rm(tmp.dir, { recursive: true, force: true }).catch(() => {});
|
|
447
|
+
}
|
|
448
|
+
};
|
|
449
|
+
|
|
450
|
+
return function subagents(pi, pichamber) {
|
|
451
|
+
let sessionCwd;
|
|
452
|
+
// A composer switch can turn a plugin off for one session only.
|
|
453
|
+
let sessionId;
|
|
454
|
+
const isOn = () => {
|
|
455
|
+
const state = pichamber ? { ...DEFAULT_STATE, ...pichamber.state(sessionCwd, sessionId) } : DEFAULT_STATE;
|
|
456
|
+
return state.on !== false;
|
|
457
|
+
};
|
|
458
|
+
|
|
459
|
+
// Keep the rest of the active tools as they are; only add or remove ours,
|
|
460
|
+
// and only when the session starts or our switch flips, so a tool list the
|
|
461
|
+
// user changed survives unrelated plugin changes.
|
|
462
|
+
let appliedOn;
|
|
463
|
+
const applyActive = ({ force = false } = {}) => {
|
|
464
|
+
try {
|
|
465
|
+
const on = isOn();
|
|
466
|
+
if (!force && on === appliedOn) return;
|
|
467
|
+
appliedOn = on;
|
|
468
|
+
const active = pi.getActiveTools();
|
|
469
|
+
const listed = active.includes(TOOL_NAME);
|
|
470
|
+
if (on && !listed) pi.setActiveTools([...active, TOOL_NAME]);
|
|
471
|
+
if (!on && listed) pi.setActiveTools(active.filter((name) => name !== TOOL_NAME));
|
|
472
|
+
} catch {
|
|
473
|
+
// A runtime that is shutting down has no tools to change.
|
|
474
|
+
}
|
|
475
|
+
};
|
|
476
|
+
|
|
477
|
+
const bundledNames = loadAgentsFromDir(bundledAgentsDir, 'bundled').map((a) => a.name).sort();
|
|
478
|
+
const description = [
|
|
479
|
+
'Hand tasks to sub-agents that work in their own context.',
|
|
480
|
+
'Modes: single (agent + task), parallel (tasks, max 8), chain (in order; {previous} is the prior output).',
|
|
481
|
+
bundledNames.length ? `Agents: ${bundledNames.join(', ')}, plus any in ${shortenPath(userAgentsDir ?? path.join(getAgentDir(), 'agents'))}.` : '',
|
|
482
|
+
`agentScope "both" adds project agents from ${CONFIG_DIR_NAME}/agents.`,
|
|
483
|
+
].filter(Boolean).join(' ');
|
|
484
|
+
|
|
485
|
+
pi.registerTool({
|
|
486
|
+
name: TOOL_NAME,
|
|
487
|
+
label: 'Sub-agents',
|
|
488
|
+
description,
|
|
489
|
+
parameters: PARAMETERS,
|
|
490
|
+
async execute(_toolCallId, params = {}, signal, onUpdate, ctx = {}) {
|
|
491
|
+
if (!isOn()) throw new Error('Sub-agents are off.');
|
|
492
|
+
const defaultCwd = ctx.cwd ?? sessionCwd ?? process.cwd();
|
|
493
|
+
const agentScope = ['user', 'project', 'both'].includes(params.agentScope) ? params.agentScope : 'user';
|
|
494
|
+
const dispatch = {
|
|
495
|
+
model: ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined,
|
|
496
|
+
thinkingLevel: ctx.thinkingLevel,
|
|
497
|
+
};
|
|
498
|
+
const { agents, projectAgentsDir } = discoverAgents(defaultCwd, agentScope, { userAgentsDir, bundledAgentsDir });
|
|
499
|
+
const findAgent = (name) => agents.find((a) => a.name === name);
|
|
500
|
+
const available = agents.map((a) => `${a.name} (${a.source})`).join(', ') || 'none';
|
|
501
|
+
|
|
502
|
+
const hasChain = (params.chain?.length ?? 0) > 0;
|
|
503
|
+
const hasTasks = (params.tasks?.length ?? 0) > 0;
|
|
504
|
+
const hasSingle = Boolean(params.agent && params.task);
|
|
505
|
+
const mode = hasChain ? 'chain' : hasTasks ? 'parallel' : 'single';
|
|
506
|
+
const details = (runs) => ({ mode, agentScope, results: runs.map(publicRun) });
|
|
507
|
+
|
|
508
|
+
if (Number(hasChain) + Number(hasTasks) + Number(hasSingle) !== 1) {
|
|
509
|
+
return {
|
|
510
|
+
content: [{ type: 'text', text: `Invalid parameters. Provide exactly one mode.\nAvailable agents: ${available}` }],
|
|
511
|
+
details: { mode: 'single', agentScope, results: [] },
|
|
512
|
+
};
|
|
513
|
+
}
|
|
514
|
+
|
|
515
|
+
const requested = hasChain ? params.chain : hasTasks ? params.tasks : [{ agent: params.agent, task: params.task, cwd: params.cwd }];
|
|
516
|
+
|
|
517
|
+
if (agentScope !== 'user' && (params.confirmProjectAgents ?? true) && ctx.hasUI && !ctx.isProjectTrusted?.()) {
|
|
518
|
+
const projectAgents = [...new Set(requested.map((r) => r.agent))]
|
|
519
|
+
.map(findAgent)
|
|
520
|
+
.filter((a) => a?.source === 'project');
|
|
521
|
+
if (projectAgents.length > 0) {
|
|
522
|
+
const ok = await ctx.ui.confirm(
|
|
523
|
+
'Run project-local agents?',
|
|
524
|
+
`Agents: ${projectAgents.map((a) => a.name).join(', ')}\nSource: ${projectAgentsDir ?? '(unknown)'}\n\nProject agents are repo-controlled. Only continue for trusted repositories.`,
|
|
525
|
+
);
|
|
526
|
+
if (!ok) {
|
|
527
|
+
return { content: [{ type: 'text', text: 'Canceled: project-local agents not approved.' }], details: details([]) };
|
|
528
|
+
}
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
|
|
532
|
+
if (hasTasks && params.tasks.length > MAX_PARALLEL_TASKS) {
|
|
533
|
+
return {
|
|
534
|
+
content: [{ type: 'text', text: `Too many parallel tasks (${params.tasks.length}). Max is ${MAX_PARALLEL_TASKS}.` }],
|
|
535
|
+
details: details([]),
|
|
536
|
+
};
|
|
537
|
+
}
|
|
538
|
+
|
|
539
|
+
const runs = [];
|
|
540
|
+
const progressText = () => {
|
|
541
|
+
if (mode === 'parallel') {
|
|
542
|
+
const done = runs.filter((r) => r.status !== 'queued' && r.status !== 'running').length;
|
|
543
|
+
const running = runs.filter((r) => r.status === 'running').length;
|
|
544
|
+
return `Parallel: ${done}/${runs.length} done, ${running} running...`;
|
|
545
|
+
}
|
|
546
|
+
return runs[runs.length - 1]?.lastText || '(running...)';
|
|
547
|
+
};
|
|
548
|
+
const snapshot = () => ({ content: [{ type: 'text', text: progressText() }], details: details(runs) });
|
|
549
|
+
const throttle = onUpdate ? createThrottle(onUpdate, updateIntervalMs) : null;
|
|
550
|
+
const changed = () => throttle?.push(snapshot);
|
|
551
|
+
|
|
552
|
+
const newRun = (item, step) => {
|
|
553
|
+
const agent = findAgent(item.agent);
|
|
554
|
+
const run = createRun({ agent: item.agent, agentSource: agent?.source ?? 'unknown', task: item.task, step });
|
|
555
|
+
if (!agent) {
|
|
556
|
+
run.status = 'failed';
|
|
557
|
+
run.errorMessage = `Unknown agent: "${item.agent}". Available agents: ${agents.map((a) => `"${a.name}"`).join(', ') || 'none'}.`;
|
|
558
|
+
}
|
|
559
|
+
return { run, agent };
|
|
560
|
+
};
|
|
561
|
+
const start = ({ run, agent }, item) => runAgent({ run, agent, defaultCwd, cwd: item.cwd, dispatch, signal, changed });
|
|
562
|
+
|
|
563
|
+
try {
|
|
564
|
+
if (mode === 'chain') {
|
|
565
|
+
let previous = '';
|
|
566
|
+
for (let i = 0; i < params.chain.length; i++) {
|
|
567
|
+
const step = params.chain[i];
|
|
568
|
+
const entry = newRun({ ...step, task: step.task.replace(/\{previous\}/g, () => previous) }, i + 1);
|
|
569
|
+
runs.push(entry.run);
|
|
570
|
+
changed();
|
|
571
|
+
await start(entry, step);
|
|
572
|
+
if (isFailed(entry.run)) {
|
|
573
|
+
return {
|
|
574
|
+
content: [{ type: 'text', text: `Chain stopped at step ${i + 1} (${step.agent}): ${runOutputForModel(entry.run)}` }],
|
|
575
|
+
details: details(runs),
|
|
576
|
+
isError: true,
|
|
577
|
+
};
|
|
578
|
+
}
|
|
579
|
+
previous = entry.run.lastText;
|
|
580
|
+
}
|
|
581
|
+
return { content: [{ type: 'text', text: runs[runs.length - 1].lastText || '(no output)' }], details: details(runs) };
|
|
582
|
+
}
|
|
583
|
+
|
|
584
|
+
if (mode === 'parallel') {
|
|
585
|
+
const entries = params.tasks.map((t) => newRun(t));
|
|
586
|
+
runs.push(...entries.map((e) => e.run));
|
|
587
|
+
changed();
|
|
588
|
+
await mapWithConcurrencyLimit(entries, MAX_CONCURRENCY, async (entry, index) => {
|
|
589
|
+
await start(entry, params.tasks[index]);
|
|
590
|
+
changed();
|
|
591
|
+
});
|
|
592
|
+
const ok = runs.filter((r) => !isFailed(r)).length;
|
|
593
|
+
const summaries = runs.map((r) => {
|
|
594
|
+
const status = isFailed(r) ? `failed${r.stopReason && r.stopReason !== 'end' ? ` (${r.stopReason})` : ''}` : 'completed';
|
|
595
|
+
return `### [${r.agent}] ${status}\n\n${truncateForModel(runOutputForModel(r))}`;
|
|
596
|
+
});
|
|
597
|
+
return {
|
|
598
|
+
content: [{ type: 'text', text: `Parallel: ${ok}/${runs.length} succeeded\n\n${summaries.join('\n\n---\n\n')}` }],
|
|
599
|
+
details: details(runs),
|
|
600
|
+
};
|
|
601
|
+
}
|
|
602
|
+
|
|
603
|
+
const entry = newRun(requested[0]);
|
|
604
|
+
runs.push(entry.run);
|
|
605
|
+
await start(entry, requested[0]);
|
|
606
|
+
if (isFailed(entry.run)) {
|
|
607
|
+
const reason = entry.run.status === 'aborted' ? 'aborted' : entry.run.stopReason || 'failed';
|
|
608
|
+
return {
|
|
609
|
+
content: [{ type: 'text', text: `Agent ${reason}: ${runOutputForModel(entry.run)}` }],
|
|
610
|
+
details: details(runs),
|
|
611
|
+
isError: true,
|
|
612
|
+
};
|
|
613
|
+
}
|
|
614
|
+
return { content: [{ type: 'text', text: entry.run.lastText || '(no output)' }], details: details(runs) };
|
|
615
|
+
} finally {
|
|
616
|
+
// Always send the final state, even if the last change was throttled.
|
|
617
|
+
if (runs.length > 0) throttle?.flush(snapshot);
|
|
618
|
+
}
|
|
619
|
+
},
|
|
620
|
+
});
|
|
621
|
+
|
|
622
|
+
pi.on('session_start', (_event, ctx) => {
|
|
623
|
+
sessionCwd = ctx?.cwd;
|
|
624
|
+
sessionId = sessionIdOf(ctx);
|
|
625
|
+
applyActive({ force: true });
|
|
626
|
+
});
|
|
627
|
+
pichamber?.onStateChange(() => applyActive());
|
|
628
|
+
};
|
|
629
|
+
};
|
|
630
|
+
|
|
631
|
+
export default createSubagentsExtension();
|