tide-commander 1.180.0 → 1.182.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +27 -4
  3. package/dist/assets/{AudioPlayer-Cz_qaJt7.js → AudioPlayer-BwhOjJ2c.js} +1 -1
  4. package/dist/assets/{BossLogsModal-DL1RQ_c8.js → BossLogsModal-DAHZQ1pi.js} +1 -1
  5. package/dist/assets/BossSpawnModal-E7SGuXA2.js +1 -0
  6. package/dist/assets/ControlsModal-bAaYejMT.js +1 -0
  7. package/dist/assets/{DockerLogsModal-B6s9FxxT.js → DockerLogsModal-BJx8N4kK.js} +1 -1
  8. package/dist/assets/{EmbeddedEditor-BUKbOOgr.js → EmbeddedEditor-Be-cO4-9.js} +1 -1
  9. package/dist/assets/{FcStdViewer-Bx5hMoK9.js → FcStdViewer-DEwQ08Bb.js} +1 -1
  10. package/dist/assets/{GcodeViewer-CRz3h-C6.js → GcodeViewer-ncf61wWb.js} +1 -1
  11. package/dist/assets/{GlbViewer-DaVg-HwZ.js → GlbViewer-D12gmnGd.js} +1 -1
  12. package/dist/assets/{GmailOAuthSetup-raTkXEzN.js → GmailOAuthSetup-C-GvDGQm.js} +1 -1
  13. package/dist/assets/{GoogleOAuthSetup-oB9PTp3c.js → GoogleOAuthSetup-BDjIAgur.js} +1 -1
  14. package/dist/assets/{IframeModal-BA2IpgVa.js → IframeModal-CCocGfa7.js} +1 -1
  15. package/dist/assets/IntegrationsPanel-CBpaeiJG.js +2 -0
  16. package/dist/assets/{LogViewerModal-wvxDKRNy.js → LogViewerModal-CaN7XU8z.js} +1 -1
  17. package/dist/assets/{MonitoringModal-BAZh_17S.js → MonitoringModal-I3nCNlbU.js} +1 -1
  18. package/dist/assets/{PM2LogsModal-D1CyGphi.js → PM2LogsModal-Bki_LCvj.js} +1 -1
  19. package/dist/assets/RestoreArchivedAreaModal-Ciy6t7et.js +1 -0
  20. package/dist/assets/Scene2DCanvas-DR56E5p7.js +1 -0
  21. package/dist/assets/SceneManager-DKg8ugY_.js +104 -0
  22. package/dist/assets/{SkillsPanel-DHKmED86.js → SkillsPanel-C_dxzS6F.js} +1 -1
  23. package/dist/assets/{SlackMultiInstanceSetup-DeI76a7K.js → SlackMultiInstanceSetup-BwiTMMvL.js} +1 -1
  24. package/dist/assets/SpawnModal-DUMcIHoz.js +1 -0
  25. package/dist/assets/{StatisticsModal-B6Ua3fi6.js → StatisticsModal-BKXcBthy.js} +1 -1
  26. package/dist/assets/{StlViewer-CbcEbSjC.js → StlViewer-DjdLvysP.js} +1 -1
  27. package/dist/assets/{SubordinateAssignmentModal-Dr5Gjs16.js → SubordinateAssignmentModal-Rl4cdHpe.js} +1 -1
  28. package/dist/assets/{ThreeAreaSelector-Dh_fDEGq.js → ThreeAreaSelector-C-9JJ1Hh.js} +1 -1
  29. package/dist/assets/{ThreeViewShortcuts-BVaOMNTJ.js → ThreeViewShortcuts-DL0Hmuj0.js} +1 -1
  30. package/dist/assets/{TriggerManagerPanel-D6oUAmpx.js → TriggerManagerPanel-BtCOoX1g.js} +1 -1
  31. package/dist/assets/{VideoPlayer-DSKjm0Rl.js → VideoPlayer-BoTr9gkT.js} +1 -1
  32. package/dist/assets/{WorkflowEditorPanel-BLMxrEav.js → WorkflowEditorPanel-DlcSaDPD.js} +1 -1
  33. package/dist/assets/{abnfDiagram-VRR7QNED-BLKdtiAT.js → abnfDiagram-VRR7QNED-CEBRXYsw.js} +1 -1
  34. package/dist/assets/{arc-BHCFYdNr.js → arc-COf9R405.js} +1 -1
  35. package/dist/assets/{architectureDiagram-ZJ3FMSHR-CK8TJwVc.js → architectureDiagram-ZJ3FMSHR-DGBRfu4B.js} +1 -1
  36. package/dist/assets/{area-logos-CLcDGHt_.js → area-logos-BRuKyQ5J.js} +1 -1
  37. package/dist/assets/{blockDiagram-677ZJIJ3-BOk8UxeA.js → blockDiagram-677ZJIJ3-CN0t4U2k.js} +1 -1
  38. package/dist/assets/{c4Diagram-LMCZKHZV-CWmx6n3m.js → c4Diagram-LMCZKHZV-Cq0IftW5.js} +1 -1
  39. package/dist/assets/channel-DF_pUJhw.js +1 -0
  40. package/dist/assets/{chunk-2Q5K7J3B-2BAqevAz.js → chunk-2Q5K7J3B-adR2VoGA.js} +1 -1
  41. package/dist/assets/{chunk-32BRIVSS-B1otNrWa.js → chunk-32BRIVSS-B6LCChZq.js} +1 -1
  42. package/dist/assets/{chunk-5VM5RSS4-YCDhdxCC.js → chunk-5VM5RSS4-CcH2c7y_.js} +1 -1
  43. package/dist/assets/{chunk-EX3LRPZG-DDtm7s-z.js → chunk-EX3LRPZG-zBWa-mu2.js} +1 -1
  44. package/dist/assets/{chunk-JWPE2WC7-Vbn7w4Z5.js → chunk-JWPE2WC7-DBQlYiWn.js} +1 -1
  45. package/dist/assets/{chunk-MOJQB5TN-CQ9u77Ko.js → chunk-MOJQB5TN-BjbsCplS.js} +1 -1
  46. package/dist/assets/{chunk-RYQCIY6F-DepOO-2a.js → chunk-RYQCIY6F-B946ZxlN.js} +1 -1
  47. package/dist/assets/{chunk-V7JOEXUC-CUMPiqnf.js → chunk-V7JOEXUC-DEeYHnRT.js} +1 -1
  48. package/dist/assets/{chunk-VR4S4FIN-Dtx2puKW.js → chunk-VR4S4FIN-B_QmrVGt.js} +1 -1
  49. package/dist/assets/{chunk-XXDRQBXY-DflWhtMT.js → chunk-XXDRQBXY-cgYh6YrW.js} +1 -1
  50. package/dist/assets/classDiagram-OUVF2IWQ-CeYNs9YM.js +1 -0
  51. package/dist/assets/classDiagram-v2-EOCWNBFH-CeYNs9YM.js +1 -0
  52. package/dist/assets/{cose-bilkent-JH36ORCC-BPCVBohN.js → cose-bilkent-JH36ORCC-DJUmw0Ip.js} +1 -1
  53. package/dist/assets/{cynefin-VYW2F7L2-DFQe8Pa0.js → cynefin-VYW2F7L2-BUxR220i.js} +1 -1
  54. package/dist/assets/{cynefinDiagram-TSTJHNR4-Zk4bhRmG.js → cynefinDiagram-TSTJHNR4-nYR1MwE2.js} +1 -1
  55. package/dist/assets/{dagre-VKFMJZFB-Bd5Kw9Yw.js → dagre-VKFMJZFB-A5VPim2l.js} +1 -1
  56. package/dist/assets/{diagram-FQU43EPY-B9CcbcB0.js → diagram-FQU43EPY-wdgwDoVg.js} +1 -1
  57. package/dist/assets/{diagram-G47NLZAW-CdAGXxiX.js → diagram-G47NLZAW-CylyJQBQ.js} +1 -1
  58. package/dist/assets/{diagram-NH7WQ7WH-D5Oky8Ra.js → diagram-NH7WQ7WH-BOF1uKhH.js} +1 -1
  59. package/dist/assets/{diagram-OA4YK3LP-CxrBKuWK.js → diagram-OA4YK3LP-B0B5zmh5.js} +1 -1
  60. package/dist/assets/{diagram-WEI45ONY-BV_xqGTJ.js → diagram-WEI45ONY-vKP2IU9q.js} +1 -1
  61. package/dist/assets/{ebnfDiagram-CCIWWBDH-BR8zM3WP.js → ebnfDiagram-CCIWWBDH-DM8hIEJM.js} +1 -1
  62. package/dist/assets/{erDiagram-Q63AITRT-B1O13nas.js → erDiagram-Q63AITRT-iuRH3hWX.js} +1 -1
  63. package/dist/assets/{flowDiagram-23GEKE2U-DTtaohaz.js → flowDiagram-23GEKE2U-CddCUoGB.js} +1 -1
  64. package/dist/assets/{ganttDiagram-NO4QXBWP-CF7GsC2n.js → ganttDiagram-NO4QXBWP-CIfvQLcu.js} +1 -1
  65. package/dist/assets/{gitGraphDiagram-IHSO6WYX-D0RiPHL-.js → gitGraphDiagram-IHSO6WYX-CbW0FQci.js} +1 -1
  66. package/dist/assets/index-B4YklnOy.js +1 -0
  67. package/dist/assets/{index-BddR9Hew.js → index-BmD7ycmn.js} +1 -1
  68. package/dist/assets/index-CIcFjlRX.js +2 -0
  69. package/dist/assets/index-CRhUiTuD.js +5 -0
  70. package/dist/assets/{index-COqQ_1sL.css → index-D1GfjaTN.css} +1 -1
  71. package/dist/assets/index-DHuT10Pa.js +1 -0
  72. package/dist/assets/{index-Dqzs1ikY.js → index-DoJdznbY.js} +1 -1
  73. package/dist/assets/index-Du8eK_OX.js +1 -0
  74. package/dist/assets/index-HYcYan1q.js +19 -0
  75. package/dist/assets/index-HhAZ3SIm.js +2 -0
  76. package/dist/assets/{infoDiagram-FWYZ7A6U-aneMMKcw.js → infoDiagram-FWYZ7A6U-C0it9hLc.js} +1 -1
  77. package/dist/assets/{ishikawaDiagram-FXEZZL3T-DUn2XrMN.js → ishikawaDiagram-FXEZZL3T-pKZnNgqp.js} +1 -1
  78. package/dist/assets/{journeyDiagram-5HDEW3XC-mvoaOTx8.js → journeyDiagram-5HDEW3XC-Ib9FpXdB.js} +1 -1
  79. package/dist/assets/{kanban-definition-HUTT4EX6-BKYcDsJ8.js → kanban-definition-HUTT4EX6-aOTfe6f6.js} +1 -1
  80. package/dist/assets/{linear-BsLXRSOu.js → linear-B_ipWlyx.js} +1 -1
  81. package/dist/assets/main-Bvn8CMZc.css +1 -0
  82. package/dist/assets/{main-CN0vutCJ.js → main-m3NNcAo4.js} +123 -123
  83. package/dist/assets/{mermaid.core-i9VF0Zpk.js → mermaid.core-EY9hyXLz.js} +4 -4
  84. package/dist/assets/{mindmap-definition-LN4V7U3C-DzkNRyrc.js → mindmap-definition-LN4V7U3C-B_p1LOAa.js} +1 -1
  85. package/dist/assets/{pegDiagram-2B236MQR-j0c_f4--.js → pegDiagram-2B236MQR-BgCd9rWg.js} +1 -1
  86. package/dist/assets/pi.ico +0 -0
  87. package/dist/assets/pi.png +0 -0
  88. package/dist/assets/pi.svg +4 -0
  89. package/dist/assets/{pieDiagram-ENE6RG2P-CRd7Wdjw.js → pieDiagram-ENE6RG2P-d8ofNooq.js} +1 -1
  90. package/dist/assets/{quadrantDiagram-ABIIQ3AL-DgG32Ucv.js → quadrantDiagram-ABIIQ3AL-27DPJdZF.js} +1 -1
  91. package/dist/assets/{railroadDiagram-RFXS5EU6-8og5AiqA.js → railroadDiagram-RFXS5EU6-C7S8pppU.js} +1 -1
  92. package/dist/assets/{requirementDiagram-TGXJPOKE-_TyvWq5_.js → requirementDiagram-TGXJPOKE-BbTkDbLO.js} +1 -1
  93. package/dist/assets/{sankeyDiagram-HTMAVEWB-Cda8LUXs.js → sankeyDiagram-HTMAVEWB-lU57KWVw.js} +1 -1
  94. package/dist/assets/{sequenceDiagram-DBY2YBRQ-3VD9Qswm.js → sequenceDiagram-DBY2YBRQ-Bg18P0LT.js} +1 -1
  95. package/dist/assets/{sizeCapture-X5ZJPWSS-DcvxmWDr.js → sizeCapture-X5ZJPWSS-FDhyxAiu.js} +1 -1
  96. package/dist/assets/{stateDiagram-2N3HPSRC-DoJZPzL9.js → stateDiagram-2N3HPSRC-pp9KUH2d.js} +1 -1
  97. package/dist/assets/stateDiagram-v2-6OUMAXLB-BmoS7QDQ.js +1 -0
  98. package/dist/assets/swimlanes-5IMT3BWC-BCUZKORl.js +2 -0
  99. package/dist/assets/swimlanesDiagram-G3AALYLV-Da6QbdiL.js +8 -0
  100. package/dist/assets/{timeline-definition-FHXFAJF6-B7Ze_1_m.js → timeline-definition-FHXFAJF6-BaeOwVlH.js} +1 -1
  101. package/dist/assets/{vennDiagram-L72KCM5P-Br9P67sq.js → vennDiagram-L72KCM5P-BkhqU_hz.js} +1 -1
  102. package/dist/assets/{wardleyDiagram-EHGQE667-D6_zW1Qq.js → wardleyDiagram-EHGQE667-DvPxIC6q.js} +1 -1
  103. package/dist/assets/{web-DjnthuJQ.js → web-BhVPxATx.js} +1 -1
  104. package/dist/assets/{web-Dkft1Ie_.js → web-CR-app3U.js} +1 -1
  105. package/dist/assets/{web-ChLjyxaY.js → web-DOiXCdVs.js} +1 -1
  106. package/dist/assets/{xychartDiagram-FW5EYKEG-bDjV8_Lg.js → xychartDiagram-FW5EYKEG-B9MrBAD_.js} +1 -1
  107. package/dist/build-info.json +1 -1
  108. package/dist/index.html +2 -2
  109. package/dist/locales/de/config.json +5 -0
  110. package/dist/locales/de/terminal.json +1 -0
  111. package/dist/locales/en/config.json +6 -0
  112. package/dist/locales/en/terminal.json +2 -0
  113. package/dist/locales/es/config.json +5 -0
  114. package/dist/locales/es/terminal.json +11 -0
  115. package/dist/locales/fr/config.json +5 -0
  116. package/dist/locales/fr/terminal.json +1 -0
  117. package/dist/locales/hi/config.json +5 -0
  118. package/dist/locales/hi/terminal.json +1 -0
  119. package/dist/locales/it/config.json +5 -0
  120. package/dist/locales/it/terminal.json +1 -0
  121. package/dist/locales/ja/config.json +5 -0
  122. package/dist/locales/ja/terminal.json +1 -0
  123. package/dist/locales/pt/config.json +5 -0
  124. package/dist/locales/pt/terminal.json +1 -0
  125. package/dist/locales/ru/config.json +5 -0
  126. package/dist/locales/ru/terminal.json +1 -0
  127. package/dist/locales/zh-CN/config.json +5 -0
  128. package/dist/locales/zh-CN/terminal.json +1 -0
  129. package/dist/src/packages/server/claude/runner/stdout-pipeline.js +3 -1
  130. package/dist/src/packages/server/claude/session-loader.js +284 -0
  131. package/dist/src/packages/server/data/builtin-skills/boss-instructions.js +4 -2
  132. package/dist/src/packages/server/data/index.js +1 -0
  133. package/dist/src/packages/server/grok/backend.js +7 -10
  134. package/dist/src/packages/server/index.js +61 -34
  135. package/dist/src/packages/server/pi/backend.js +264 -0
  136. package/dist/src/packages/server/pi/index.js +3 -0
  137. package/dist/src/packages/server/pi/json-event-parser.js +275 -0
  138. package/dist/src/packages/server/pi/rpc/pi-rpc-runner.js +391 -0
  139. package/dist/src/packages/server/routes/agents.js +79 -2
  140. package/dist/src/packages/server/routes/files.js +45 -19
  141. package/dist/src/packages/server/runtime/index.js +1 -0
  142. package/dist/src/packages/server/runtime/pi-runner-router.js +105 -0
  143. package/dist/src/packages/server/runtime/pi-runtime-provider.js +12 -0
  144. package/dist/src/packages/server/services/agent-service.js +14 -2
  145. package/dist/src/packages/server/services/global-file-search.js +281 -0
  146. package/dist/src/packages/server/services/prompt-inspection-service.js +15 -0
  147. package/dist/src/packages/server/services/runtime-command-execution.js +4 -2
  148. package/dist/src/packages/server/services/runtime-events.js +18 -3
  149. package/dist/src/packages/server/services/runtime-service.js +19 -3
  150. package/dist/src/packages/server/services/system-prompt-service.js +46 -0
  151. package/dist/src/packages/server/websocket/handler.js +16 -6
  152. package/dist/src/packages/server/websocket/handlers/agent-handler.js +23 -11
  153. package/dist/src/packages/server/websocket/handlers/boss-response-handler.js +4 -4
  154. package/dist/src/packages/server/websocket/listeners/runtime-listeners.js +7 -0
  155. package/dist/src/packages/shared/agent-types.js +60 -5
  156. package/dist/src/packages/shared/file-search.js +49 -0
  157. package/dist/src/packages/shared/types.js +1 -0
  158. package/package.json +1 -1
  159. package/scripts/recover-agents.ts +1 -1
  160. package/dist/assets/BossSpawnModal-HFw-EI4q.js +0 -1
  161. package/dist/assets/ControlsModal-B5x8krS0.js +0 -1
  162. package/dist/assets/IntegrationsPanel-CkpN3tEm.js +0 -2
  163. package/dist/assets/RestoreArchivedAreaModal-ChxxCEBp.js +0 -1
  164. package/dist/assets/Scene2DCanvas-CsWUWMyg.js +0 -1
  165. package/dist/assets/SceneManager-KFc6HxE-.js +0 -104
  166. package/dist/assets/SpawnModal-Dv4942eR.js +0 -1
  167. package/dist/assets/channel-C1UbIsM4.js +0 -1
  168. package/dist/assets/classDiagram-OUVF2IWQ-Dr6eXMS3.js +0 -1
  169. package/dist/assets/classDiagram-v2-EOCWNBFH-Dr6eXMS3.js +0 -1
  170. package/dist/assets/index-B2tBflVO.js +0 -2
  171. package/dist/assets/index-Bxr4AiEk.js +0 -2
  172. package/dist/assets/index-C6jqY5vM.js +0 -1
  173. package/dist/assets/index-Cpz94DKJ.js +0 -1
  174. package/dist/assets/index-DGOAfDCV.js +0 -1
  175. package/dist/assets/index-DYh_qbU4.js +0 -5
  176. package/dist/assets/index-gQjHBiGd.js +0 -19
  177. package/dist/assets/main-DQoNBeOV.css +0 -1
  178. package/dist/assets/stateDiagram-v2-6OUMAXLB-BUtkiS3W.js +0 -1
  179. package/dist/assets/swimlanes-5IMT3BWC-Co7uCoVg.js +0 -2
  180. package/dist/assets/swimlanesDiagram-G3AALYLV-C3seowIK.js +0 -8
@@ -0,0 +1,264 @@
1
+ /**
2
+ * Pi coding agent CLI Backend (headless mode)
3
+ *
4
+ * Spawns: pi --mode json -p [--session id | --fork id] [--model pattern] [--thinking level] <prompt>
5
+ * Large prompts go through a temp file passed as an @file argument (pi does
6
+ * not read the prompt from stdin; @file contents are included in the message).
7
+ *
8
+ * IMPORTANT: `which pi` can resolve to unrelated binaries (e.g. anaconda ships
9
+ * a python packaging tool named `pi`), so installation detection validates that
10
+ * the resolved target actually belongs to @earendil-works/pi-coding-agent.
11
+ */
12
+ import { execSync } from 'child_process';
13
+ import * as fs from 'fs';
14
+ import * as os from 'os';
15
+ import * as path from 'path';
16
+ import { PiJsonEventParser } from './json-event-parser.js';
17
+ import { TIDE_COMMANDER_APPENDED_PROMPT } from '../prompts/tide-commander.js';
18
+ import { getSystemPrompt, isEchoPromptEnabled } from '../services/system-prompt-service.js';
19
+ import { consumeInstructionsDirty, isBareSlashCommand } from '../services/instruction-refresh.js';
20
+ import { loadAreas } from '../data/index.js';
21
+ import { createLogger } from '../utils/logger.js';
22
+ const log = createLogger('PiBackend');
23
+ /** Prompt size above which we switch from argv to a temp @file (argv safety). */
24
+ const PROMPT_FILE_THRESHOLD = 4000;
25
+ export function buildPiPrompt(config) {
26
+ const userPrompt = config.prompt?.trim() || 'Continue the task.';
27
+ // Bare slash commands must reach the CLI verbatim.
28
+ if (isBareSlashCommand(userPrompt)) {
29
+ return userPrompt;
30
+ }
31
+ const echoedUserPrompt = isEchoPromptEnabled()
32
+ ? userPrompt + '\n\n---\n\n' + userPrompt
33
+ : userPrompt;
34
+ // On resume the instruction block is already in session history — only
35
+ // re-inject when an instruction source was dirtied mid-session.
36
+ const refreshInstructions = consumeInstructionsDirty(config.agentId);
37
+ if (config.sessionId && !refreshInstructions) {
38
+ return echoedUserPrompt;
39
+ }
40
+ const injectedSections = [];
41
+ const systemLevelPrompt = getSystemPrompt().trim();
42
+ if (systemLevelPrompt) {
43
+ injectedSections.push(`## System-Level Custom Prompt\n${systemLevelPrompt}`);
44
+ }
45
+ if (config.agentId) {
46
+ const areas = loadAreas();
47
+ const agentArea = areas.find(a => a.assignedAgentIds.includes(config.agentId));
48
+ const areaPrompt = agentArea?.prompt?.trim();
49
+ if (areaPrompt) {
50
+ injectedSections.push(`## Area-Level Prompt (${agentArea.name})\n${areaPrompt}`);
51
+ }
52
+ }
53
+ const customPrompt = config.customAgent?.definition?.prompt?.trim();
54
+ if (customPrompt) {
55
+ injectedSections.push(`## Agent Instructions\n${customPrompt}`);
56
+ }
57
+ const systemPrompt = config.systemPrompt?.trim();
58
+ if (systemPrompt) {
59
+ injectedSections.push(`## System Context\n${systemPrompt}`);
60
+ }
61
+ injectedSections.push(TIDE_COMMANDER_APPENDED_PROMPT);
62
+ return [
63
+ 'Follow all instructions below for this task.',
64
+ ...injectedSections,
65
+ '## User Request',
66
+ echoedUserPrompt,
67
+ ].join('\n\n');
68
+ }
69
+ export function shouldPassPiModel(model) {
70
+ if (!model)
71
+ return false;
72
+ // Reject other providers' model values that may leak across provider
73
+ // switches. Pi accepts 'provider/id' patterns and fuzzy names; TC-specific
74
+ // '[1m]' suffixes and Codex/Grok ids would error out.
75
+ if (model.includes('[1m]') ||
76
+ model.startsWith('gpt-5.6-') ||
77
+ model.startsWith('grok-')) {
78
+ return false;
79
+ }
80
+ return true;
81
+ }
82
+ /** Map Tide effort labels to pi thinking levels (off|minimal|low|medium|high|xhigh). */
83
+ export function piThinkingLevelForEffort(effort) {
84
+ const effortMap = {
85
+ low: 'low',
86
+ medium: 'medium',
87
+ high: 'high',
88
+ xHigh: 'xhigh',
89
+ max: 'xhigh',
90
+ };
91
+ return effortMap[effort] || effort.toLowerCase();
92
+ }
93
+ /** True when the file at `p` is the real pi coding agent entrypoint. */
94
+ function isPiCodingAgentBinary(p) {
95
+ try {
96
+ const real = fs.realpathSync(p);
97
+ if (real.includes('pi-coding-agent'))
98
+ return true;
99
+ // Standalone (bun-compiled) installs: accept executables that are not
100
+ // scripts of some other interpreter (e.g. anaconda's python `pi` tool).
101
+ const fd = fs.openSync(real, 'r');
102
+ const buf = Buffer.alloc(64);
103
+ fs.readSync(fd, buf, 0, 64, 0);
104
+ fs.closeSync(fd);
105
+ const head = buf.toString('utf-8');
106
+ if (head.startsWith('#!')) {
107
+ return head.includes('node') || head.includes('bun');
108
+ }
109
+ // Non-script executable (ELF/Mach-O standalone build) — assume pi.
110
+ return true;
111
+ }
112
+ catch {
113
+ return false;
114
+ }
115
+ }
116
+ export class PiBackend {
117
+ name = 'pi';
118
+ // ONE PiBackend serves every Pi agent — parser state (stream uuids,
119
+ // accumulated text, usage) must be per agent.
120
+ parsers = new Map();
121
+ parserFor(agentId) {
122
+ const key = agentId || '__default';
123
+ let parser = this.parsers.get(key);
124
+ if (!parser) {
125
+ parser = new PiJsonEventParser();
126
+ this.parsers.set(key, parser);
127
+ }
128
+ return parser;
129
+ }
130
+ /** Temp prompt files created for this process; cleaned on next buildArgs. */
131
+ lastPromptFile;
132
+ cachedInstallPath;
133
+ buildArgs(config) {
134
+ // Clean previous prompt file if any (best-effort)
135
+ this.cleanupPromptFile();
136
+ const prompt = buildPiPrompt(config);
137
+ const args = ['--mode', 'json', '-p'];
138
+ if (shouldPassPiModel(config.model)) {
139
+ args.push('--model', config.model);
140
+ }
141
+ if (config.effort) {
142
+ args.push('--thinking', piThinkingLevelForEffort(config.effort));
143
+ }
144
+ // Session resume / fork
145
+ if (config.sessionId) {
146
+ if (config.forkSession) {
147
+ // Fork the source session into a NEW session file (first run of a fork).
148
+ args.push('--fork', config.sessionId);
149
+ }
150
+ else {
151
+ args.push('--session', config.sessionId);
152
+ }
153
+ }
154
+ // Prompt delivery: argv for small prompts, temp @file for large ones
155
+ // (pi includes @file contents in the initial message; it does not read stdin).
156
+ if (prompt.length > PROMPT_FILE_THRESHOLD) {
157
+ const promptFile = path.join(os.tmpdir(), `tide-pi-prompt-${config.agentId || 'anon'}-${Date.now()}.md`);
158
+ fs.writeFileSync(promptFile, prompt, 'utf-8');
159
+ this.lastPromptFile = promptFile;
160
+ args.push(`@${promptFile}`);
161
+ log.log(`buildArgs: prompt via @file (${prompt.length} chars) sessionId=${config.sessionId ? 'yes' : 'no'}`);
162
+ }
163
+ else {
164
+ args.push(prompt);
165
+ log.log(`buildArgs: prompt via argv (${prompt.length} chars) sessionId=${config.sessionId ? 'yes' : 'no'}`);
166
+ }
167
+ return args;
168
+ }
169
+ parseEvent(rawEvent, agentId) {
170
+ const events = this.parserFor(agentId).parseEvent(rawEvent);
171
+ if (events.length === 0)
172
+ return null;
173
+ return events.length === 1 ? events[0] : events;
174
+ }
175
+ extractSessionId(rawEvent) {
176
+ const event = rawEvent;
177
+ if (event?.type === 'session' && typeof event.id === 'string' && event.id) {
178
+ return event.id;
179
+ }
180
+ return null;
181
+ }
182
+ getExecutablePath() {
183
+ const envBinary = process.env.PI_BINARY;
184
+ if (envBinary && fs.existsSync(envBinary)) {
185
+ return envBinary;
186
+ }
187
+ return this.detectInstallation() || 'pi';
188
+ }
189
+ detectInstallation() {
190
+ if (this.cachedInstallPath !== undefined) {
191
+ return this.cachedInstallPath;
192
+ }
193
+ this.cachedInstallPath = this.detectInstallationUncached();
194
+ return this.cachedInstallPath;
195
+ }
196
+ detectInstallationUncached() {
197
+ const homeDir = os.homedir();
198
+ const candidates = [];
199
+ // nvm-managed npm globals (preferred install channel for pi)
200
+ const nvmVersionsDir = path.join(homeDir, '.nvm', 'versions', 'node');
201
+ try {
202
+ for (const version of fs.readdirSync(nvmVersionsDir)) {
203
+ candidates.push(path.join(nvmVersionsDir, version, 'bin', 'pi'));
204
+ }
205
+ }
206
+ catch {
207
+ // no nvm
208
+ }
209
+ candidates.push(path.join(homeDir, '.local', 'bin', 'pi'), '/usr/local/bin/pi', '/usr/bin/pi');
210
+ // PATH entries last — `which -a` may surface unrelated `pi` binaries first.
211
+ try {
212
+ const whichAll = execSync('which -a pi', { encoding: 'utf-8', timeout: 5000 })
213
+ .split('\n')
214
+ .map((line) => line.trim())
215
+ .filter(Boolean);
216
+ candidates.push(...whichAll);
217
+ }
218
+ catch {
219
+ // not on PATH
220
+ }
221
+ for (const candidate of candidates) {
222
+ if (fs.existsSync(candidate) && isPiCodingAgentBinary(candidate)) {
223
+ return candidate;
224
+ }
225
+ }
226
+ return null;
227
+ }
228
+ getExtraEnv() {
229
+ return {};
230
+ }
231
+ /**
232
+ * Prompt is passed via argv / temp @file, not stdin.
233
+ */
234
+ requiresStdinInput() {
235
+ return false;
236
+ }
237
+ /**
238
+ * Mark as stdin-closed so mid-run follow-ups queue until the process exits,
239
+ * then respawn with --session (same delivery path as Codex/OpenCode/Grok).
240
+ */
241
+ shouldCloseStdinAfterPrompt() {
242
+ return true;
243
+ }
244
+ supportsSessionResume() {
245
+ return true;
246
+ }
247
+ formatStdinInput(_prompt) {
248
+ // Not used (requiresStdinInput=false).
249
+ return '';
250
+ }
251
+ cleanupPromptFile() {
252
+ if (!this.lastPromptFile)
253
+ return;
254
+ try {
255
+ if (fs.existsSync(this.lastPromptFile)) {
256
+ fs.unlinkSync(this.lastPromptFile);
257
+ }
258
+ }
259
+ catch {
260
+ // best-effort
261
+ }
262
+ this.lastPromptFile = undefined;
263
+ }
264
+ }
@@ -0,0 +1,3 @@
1
+ export { PiBackend, buildPiPrompt } from './backend.js';
2
+ export { PiJsonEventParser } from './json-event-parser.js';
3
+ export const PI_PROVIDER_NAME = 'pi';
@@ -0,0 +1,275 @@
1
+ /**
2
+ * Pi coding agent JSON event parser.
3
+ * Maps NDJSON events from `pi --mode json -p …` to StandardEvent.
4
+ *
5
+ * Pi's stream (docs/json.md in @earendil-works/pi-coding-agent):
6
+ * - {"type":"session", id, cwd, …} → session header (id handled by backend.extractSessionId)
7
+ * - agent_start / turn_start / turn_end / agent_end → run + LLM-call lifecycle
8
+ * - message_start/message_update/message_end → assistant message with assistantMessageEvent deltas
9
+ * assistantMessageEvent: text_start/text_delta/text_end,
10
+ * thinking_start/thinking_delta/thinking_end, toolcall_start/toolcall_delta/toolcall_end
11
+ * - tool_execution_start / tool_execution_update / tool_execution_end
12
+ *
13
+ * One agentic run spans several turn_start/turn_end pairs (one per LLM call);
14
+ * step_complete is emitted on agent_end only. Deltas stream token-by-token, so
15
+ * we mint a stable uuid per (message, contentIndex) block for client merging.
16
+ */
17
+ import { createLogger } from '../utils/logger.js';
18
+ const log = createLogger('PiParser');
19
+ // Pi uses lowercase tool names; normalize to Claude's capitalized format so
20
+ // frontend rendering (TOOL_ICONS, recognizedTools, etc.) works correctly.
21
+ const TOOL_NAME_MAP = {
22
+ bash: 'Bash',
23
+ read: 'Read',
24
+ write: 'Write',
25
+ edit: 'Edit',
26
+ multiedit: 'MultiEdit',
27
+ glob: 'Glob',
28
+ grep: 'Grep',
29
+ ls: 'LS',
30
+ find: 'Find',
31
+ todowrite: 'TodoWrite',
32
+ webfetch: 'WebFetch',
33
+ websearch: 'WebSearch',
34
+ // pi-web-access extension tools
35
+ web_search: 'WebSearch',
36
+ fetch_content: 'WebFetch',
37
+ get_search_content: 'WebFetch',
38
+ };
39
+ function normalizeToolName(raw) {
40
+ return TOOL_NAME_MAP[raw.toLowerCase()] || raw;
41
+ }
42
+ function extractResultText(result) {
43
+ if (typeof result === 'string')
44
+ return result;
45
+ if (!result || !Array.isArray(result.content))
46
+ return '';
47
+ return result.content
48
+ .filter((c) => c?.type === 'text' && typeof c.text === 'string')
49
+ .map((c) => c.text)
50
+ .join('\n');
51
+ }
52
+ export class PiJsonEventParser {
53
+ /** Session id from the stream header — attached to init events. */
54
+ sessionId;
55
+ /** Increments per assistant message so stream uuids never collide across turns. */
56
+ messageCounter = 0;
57
+ /** Last assistant text of the run — becomes step_complete.resultText. */
58
+ lastTextContent = '';
59
+ lastThinkingContent = '';
60
+ textEventEmittedInRun = false;
61
+ /** Open streaming uuids (by contentIndex) awaiting their *_end finalize. */
62
+ openTextStreams = new Map();
63
+ openThinkingStreams = new Map();
64
+ /** Usage from the last assistant message_end (context accounting + cost). */
65
+ lastUsage;
66
+ lastErrorMessage;
67
+ parseEvent(rawEvent) {
68
+ const event = rawEvent;
69
+ if (!event || typeof event !== 'object' || !event.type) {
70
+ return [];
71
+ }
72
+ log.debug(`parseEvent: type=${event.type}`);
73
+ switch (event.type) {
74
+ case 'session':
75
+ // Session header — id is also consumed by backend.extractSessionId.
76
+ if (typeof event.id === 'string' && event.id) {
77
+ this.sessionId = event.id;
78
+ }
79
+ return [];
80
+ case 'agent_start':
81
+ return [{ type: 'init', sessionId: this.sessionId, model: 'pi' }];
82
+ case 'message_start':
83
+ return this.parseMessageStart(event);
84
+ case 'message_update':
85
+ return this.parseMessageUpdate(event);
86
+ case 'message_end':
87
+ return this.parseMessageEnd(event);
88
+ case 'tool_execution_start':
89
+ return this.parseToolStart(event);
90
+ case 'tool_execution_end':
91
+ return this.parseToolEnd(event);
92
+ case 'agent_end':
93
+ return this.parseAgentEnd();
94
+ case 'compaction_start':
95
+ return [{ type: 'compacting' }];
96
+ case 'auto_retry_start':
97
+ return [{
98
+ type: 'text',
99
+ text: `(Pi auto-retry: ${event.errorMessage || 'transient error'})`,
100
+ isStreaming: false,
101
+ uuid: `pi-retry-${this.messageCounter}-${Date.now()}`,
102
+ }];
103
+ // Lifecycle/no-op events for the UI. `response` is the RPC-mode command
104
+ // acknowledgment envelope (handled by the RPC runner, not the UI stream).
105
+ case 'turn_start':
106
+ case 'turn_end':
107
+ case 'tool_execution_update':
108
+ case 'queue_update':
109
+ case 'compaction_end':
110
+ case 'auto_retry_end':
111
+ case 'response':
112
+ return [];
113
+ default:
114
+ log.log(`parseEvent: unknown event type '${event.type}' - skipping`);
115
+ return [];
116
+ }
117
+ }
118
+ streamUuid(kind, contentIndex) {
119
+ return `pi-${kind}-${this.messageCounter}-${contentIndex}`;
120
+ }
121
+ parseMessageStart(event) {
122
+ if (event.message?.role === 'assistant') {
123
+ this.messageCounter++;
124
+ this.openTextStreams.clear();
125
+ this.openThinkingStreams.clear();
126
+ }
127
+ return [];
128
+ }
129
+ parseMessageUpdate(event) {
130
+ const ame = event.assistantMessageEvent;
131
+ if (!ame?.type)
132
+ return [];
133
+ const idx = ame.contentIndex ?? 0;
134
+ switch (ame.type) {
135
+ case 'text_delta': {
136
+ if (!ame.delta)
137
+ return [];
138
+ const uuid = this.streamUuid('text', idx);
139
+ this.openTextStreams.set(idx, uuid);
140
+ this.lastTextContent += ame.delta;
141
+ this.textEventEmittedInRun = true;
142
+ return [{ type: 'text', text: ame.delta, isStreaming: true, uuid }];
143
+ }
144
+ case 'thinking_delta': {
145
+ if (!ame.delta)
146
+ return [];
147
+ const uuid = this.streamUuid('thinking', idx);
148
+ this.openThinkingStreams.set(idx, uuid);
149
+ return [{ type: 'thinking', text: ame.delta, isStreaming: true, uuid }];
150
+ }
151
+ case 'text_start': {
152
+ // Reset the text accumulator for this block.
153
+ this.lastTextContent = '';
154
+ return [];
155
+ }
156
+ case 'text_end': {
157
+ const uuid = this.openTextStreams.get(idx) ?? this.streamUuid('text', idx);
158
+ this.openTextStreams.delete(idx);
159
+ const full = ame.content?.text ?? this.lastTextContent;
160
+ if (!full)
161
+ return [];
162
+ this.lastTextContent = full;
163
+ this.textEventEmittedInRun = true;
164
+ return [{ type: 'text', text: full, isStreaming: false, uuid }];
165
+ }
166
+ case 'thinking_end': {
167
+ const uuid = this.openThinkingStreams.get(idx) ?? this.streamUuid('thinking', idx);
168
+ this.openThinkingStreams.delete(idx);
169
+ const full = ame.content?.thinking ?? '';
170
+ if (!full)
171
+ return [];
172
+ this.lastThinkingContent = full;
173
+ return [{ type: 'thinking', text: full, isStreaming: false, uuid }];
174
+ }
175
+ // Tool-call arg streaming is covered by tool_execution_start.
176
+ case 'thinking_start':
177
+ case 'toolcall_start':
178
+ case 'toolcall_delta':
179
+ case 'toolcall_end':
180
+ return [];
181
+ default:
182
+ return [];
183
+ }
184
+ }
185
+ parseMessageEnd(event) {
186
+ const message = event.message;
187
+ if (message?.role !== 'assistant')
188
+ return [];
189
+ const events = [];
190
+ if (message.stopReason === 'error' && message.errorMessage) {
191
+ this.lastErrorMessage = message.errorMessage;
192
+ events.push({ type: 'error', errorMessage: message.errorMessage });
193
+ }
194
+ // Track usage for context accounting; input+cacheRead approximates context.
195
+ if (message.usage && (message.usage.input || message.usage.output || message.usage.totalTokens)) {
196
+ this.lastUsage = message.usage;
197
+ events.push({
198
+ type: 'usage_snapshot',
199
+ model: message.model,
200
+ tokens: {
201
+ input: message.usage.input || 0,
202
+ output: message.usage.output || 0,
203
+ cacheCreation: message.usage.cacheWrite || 0,
204
+ cacheRead: message.usage.cacheRead || 0,
205
+ },
206
+ });
207
+ }
208
+ return events;
209
+ }
210
+ parseToolStart(event) {
211
+ const toolName = normalizeToolName(event.toolName || 'unknown');
212
+ const toolStart = {
213
+ type: 'tool_start',
214
+ toolName,
215
+ toolInput: event.args,
216
+ };
217
+ if (event.toolCallId) {
218
+ toolStart.toolUseId = event.toolCallId;
219
+ toolStart.uuid = event.toolCallId;
220
+ }
221
+ return [toolStart];
222
+ }
223
+ parseToolEnd(event) {
224
+ const toolName = normalizeToolName(event.toolName || 'unknown');
225
+ let output = extractResultText(event.result);
226
+ if (event.isError && output) {
227
+ output = `Error: ${output}`;
228
+ }
229
+ const toolResult = {
230
+ type: 'tool_result',
231
+ toolName,
232
+ toolOutput: output,
233
+ };
234
+ if (event.toolCallId) {
235
+ toolResult.toolUseId = event.toolCallId;
236
+ toolResult.uuid = event.toolCallId;
237
+ }
238
+ return [toolResult];
239
+ }
240
+ parseAgentEnd() {
241
+ const events = [];
242
+ const stepComplete = {
243
+ type: 'step_complete',
244
+ };
245
+ if (this.lastUsage) {
246
+ stepComplete.tokens = {
247
+ input: this.lastUsage.input || 0,
248
+ output: this.lastUsage.output || 0,
249
+ cacheCreation: this.lastUsage.cacheWrite || 0,
250
+ cacheRead: this.lastUsage.cacheRead || 0,
251
+ };
252
+ stepComplete.cost = this.lastUsage.cost?.total;
253
+ }
254
+ if (this.lastTextContent) {
255
+ stepComplete.resultText = this.lastTextContent;
256
+ }
257
+ else if (this.lastErrorMessage) {
258
+ stepComplete.resultText = `(Pi error: ${this.lastErrorMessage})`;
259
+ }
260
+ else if (this.lastThinkingContent && !this.textEventEmittedInRun) {
261
+ // Thinking-only run — surface a marker so the terminal isn't blank.
262
+ stepComplete.resultText = '(Empty response: thinking only)';
263
+ }
264
+ events.push(stepComplete);
265
+ // Reset for the next run (respawn reuses the parser instance).
266
+ this.lastTextContent = '';
267
+ this.lastThinkingContent = '';
268
+ this.textEventEmittedInRun = false;
269
+ this.lastUsage = undefined;
270
+ this.lastErrorMessage = undefined;
271
+ this.openTextStreams.clear();
272
+ this.openThinkingStreams.clear();
273
+ return events;
274
+ }
275
+ }