@selesai/code 0.9.10 → 0.9.11

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 (302) hide show
  1. package/CHANGELOG.md +260 -255
  2. package/dist/cli/args.js +13 -2
  3. package/dist/cli/args.test.js +8 -0
  4. package/dist/cli/credential-print.js +4 -4
  5. package/dist/cli.js +0 -0
  6. package/dist/core/agent-session-auto-handoff.test.js +24 -1
  7. package/dist/core/agent-session.d.ts +11 -4
  8. package/dist/core/agent-session.js +96 -35
  9. package/dist/core/compaction/branch-summarization.js +30 -30
  10. package/dist/core/compaction/compaction.js +81 -81
  11. package/dist/core/compaction/utils.js +2 -2
  12. package/dist/core/defaults.d.ts +1 -0
  13. package/dist/core/defaults.js +9 -0
  14. package/dist/core/export-html/template.css +1066 -1066
  15. package/dist/core/export-html/template.html +55 -55
  16. package/dist/core/export-html/template.js +1864 -1864
  17. package/dist/core/export-html/vendor/highlight.min.js +1212 -1212
  18. package/dist/core/export-html/vendor/marked.min.js +78 -78
  19. package/dist/core/extensions/loader.js +108 -35
  20. package/dist/core/extensions/loader.test.d.ts +1 -0
  21. package/dist/core/extensions/loader.test.js +21 -0
  22. package/dist/core/extensions/types.d.ts +12 -2
  23. package/dist/core/keybindings.d.ts +2 -2
  24. package/dist/core/messages.js +7 -7
  25. package/dist/core/model-resolver.d.ts +1 -0
  26. package/dist/core/model-resolver.js +10 -4
  27. package/dist/core/package-manager.js +4 -4
  28. package/dist/core/sdk.d.ts +5 -5
  29. package/dist/core/sdk.js +16 -4
  30. package/dist/core/settings-manager.d.ts +6 -0
  31. package/dist/core/settings-manager.js +22 -0
  32. package/dist/core/tools/bash.d.ts +18 -1
  33. package/dist/core/tools/bash.js +41 -23
  34. package/dist/core/tools/index.d.ts +4 -1
  35. package/dist/core/tools/index.js +9 -1
  36. package/dist/core/tools/powershell.d.ts +15 -0
  37. package/dist/core/tools/powershell.js +38 -0
  38. package/dist/core/tools/powershell.test.d.ts +1 -0
  39. package/dist/core/tools/powershell.test.js +20 -0
  40. package/dist/extensions/context-compaction-reminder.test.ts +82 -82
  41. package/dist/extensions/context-compaction-reminder.ts +28 -28
  42. package/dist/extensions/pi-intercom/LICENSE +21 -21
  43. package/dist/extensions/pi-intercom/broker/client.test.ts +83 -83
  44. package/dist/extensions/pi-intercom/broker/extension.test.ts +387 -387
  45. package/dist/extensions/pi-intercom/broker/framing.test.ts +114 -114
  46. package/dist/extensions/pi-intercom/broker/paths.test.ts +153 -153
  47. package/dist/extensions/pi-intercom/broker/paths.ts +134 -134
  48. package/dist/extensions/pi-intercom/broker/runtime-claim.test.ts +34 -34
  49. package/dist/extensions/pi-intercom/broker/runtime-claim.ts +21 -21
  50. package/dist/extensions/pi-intercom/cwd.test.ts +40 -40
  51. package/dist/extensions/pi-intercom/cwd.ts +31 -31
  52. package/dist/extensions/pi-intercom/extension-api.ts +44 -44
  53. package/dist/extensions/pi-intercom/format-context.test.ts +31 -31
  54. package/dist/extensions/pi-intercom/format-context.ts +32 -32
  55. package/dist/extensions/pi-intercom/test/overlay-width.test.ts +66 -66
  56. package/dist/extensions/pi-intercom/ui/compose.ts +143 -143
  57. package/dist/extensions/pi-intercom/ui/session-list.ts +166 -166
  58. package/dist/extensions/pi-powerline-footer/bash-mode/shell-session.ts +286 -286
  59. package/dist/extensions/pi-powerline-footer/bash-mode/transcript.ts +108 -108
  60. package/dist/extensions/pi-powerline-footer/separators.ts +57 -57
  61. package/dist/extensions/pi-powerline-footer/tests/session-usage.test.ts +47 -47
  62. package/dist/extensions/pi-powerline-footer/tests/tps.test.ts +39 -39
  63. package/dist/extensions/pi-powerline-footer/theme.example.json +24 -24
  64. package/dist/extensions/pi-powerline-footer/theme.json +12 -12
  65. package/dist/extensions/pi-powerline-footer/tps.ts +345 -345
  66. package/dist/extensions/pi-rewind-hook/README.md +245 -245
  67. package/dist/extensions/pi-rewind-hook/index.ts +1445 -1445
  68. package/dist/extensions/pi-rewind-hook/package.json +29 -29
  69. package/dist/extensions/pi-subagents/install.mjs +0 -0
  70. package/dist/extensions/pi-web-agent/package.json +31 -31
  71. package/dist/extensions/pi-web-agent/src/backends/config.ts +205 -205
  72. package/dist/extensions/pi-web-agent/src/backends/doctor.ts +136 -136
  73. package/dist/extensions/pi-web-agent/src/backends/factory.ts +152 -152
  74. package/dist/extensions/pi-web-agent/src/backends/settings-reader.ts +25 -25
  75. package/dist/extensions/pi-web-agent/src/cache/ttl-cache.ts +28 -28
  76. package/dist/extensions/pi-web-agent/src/changelog-notice.ts +136 -136
  77. package/dist/extensions/pi-web-agent/src/commands/web-agent-config.ts +946 -946
  78. package/dist/extensions/pi-web-agent/src/extension.ts +126 -126
  79. package/dist/extensions/pi-web-agent/src/extract/readability.ts +118 -118
  80. package/dist/extensions/pi-web-agent/src/fetch/browser-resolution.ts +199 -199
  81. package/dist/extensions/pi-web-agent/src/fetch/firecrawl-fetch.ts +100 -100
  82. package/dist/extensions/pi-web-agent/src/fetch/headless-fetch.ts +117 -117
  83. package/dist/extensions/pi-web-agent/src/fetch/http-fetch.ts +67 -67
  84. package/dist/extensions/pi-web-agent/src/orchestration/answer-synthesizer.ts +60 -60
  85. package/dist/extensions/pi-web-agent/src/orchestration/candidate-selector.ts +50 -50
  86. package/dist/extensions/pi-web-agent/src/orchestration/direct-url.ts +52 -52
  87. package/dist/extensions/pi-web-agent/src/orchestration/evidence-quality.ts +105 -105
  88. package/dist/extensions/pi-web-agent/src/orchestration/evidence-ranker.ts +45 -45
  89. package/dist/extensions/pi-web-agent/src/orchestration/index.ts +28 -28
  90. package/dist/extensions/pi-web-agent/src/orchestration/query-planner.ts +47 -47
  91. package/dist/extensions/pi-web-agent/src/orchestration/research-orchestrator.ts +376 -376
  92. package/dist/extensions/pi-web-agent/src/orchestration/research-types.ts +64 -64
  93. package/dist/extensions/pi-web-agent/src/orchestration/research-worker.ts +181 -181
  94. package/dist/extensions/pi-web-agent/src/orchestration/source-profile.ts +101 -101
  95. package/dist/extensions/pi-web-agent/src/orchestration/stop-decider.ts +81 -81
  96. package/dist/extensions/pi-web-agent/src/presentation/config-store.ts +210 -210
  97. package/dist/extensions/pi-web-agent/src/presentation/config.ts +75 -75
  98. package/dist/extensions/pi-web-agent/src/presentation/explore-presentation.ts +61 -61
  99. package/dist/extensions/pi-web-agent/src/presentation/fetch-presentation.ts +54 -54
  100. package/dist/extensions/pi-web-agent/src/presentation/search-presentation.ts +41 -41
  101. package/dist/extensions/pi-web-agent/src/presentation/select-view.ts +20 -20
  102. package/dist/extensions/pi-web-agent/src/presentation/types.ts +63 -63
  103. package/dist/extensions/pi-web-agent/src/search/brave.ts +114 -114
  104. package/dist/extensions/pi-web-agent/src/search/duckduckgo.ts +72 -72
  105. package/dist/extensions/pi-web-agent/src/search/searxng.ts +96 -96
  106. package/dist/extensions/pi-web-agent/src/tools/web-explore.ts +71 -71
  107. package/dist/extensions/pi-web-agent/src/tools/web-fetch-headless.ts +31 -31
  108. package/dist/extensions/pi-web-agent/src/tools/web-fetch.ts +31 -31
  109. package/dist/extensions/pi-web-agent/src/tools/web-search.ts +157 -157
  110. package/dist/extensions/pi-web-agent/src/types.ts +88 -88
  111. package/dist/extensions/ponytail/package.json +8 -8
  112. package/dist/extensions/question/batch.ts +103 -103
  113. package/dist/extensions/question/constants.ts +30 -30
  114. package/dist/extensions/question/helpers.ts +58 -58
  115. package/dist/extensions/question/navigation.ts +14 -14
  116. package/dist/extensions/question/package.json +19 -19
  117. package/dist/extensions/question/schemas.ts +43 -43
  118. package/dist/extensions/question/selection-mode.ts +46 -46
  119. package/dist/extensions/question/shortcuts.ts +44 -44
  120. package/dist/extensions/question/types.ts +132 -132
  121. package/dist/extensions/test-resolve-hook-impl.mjs +6 -6
  122. package/dist/extensions/test-resolve-hook.mjs +6 -6
  123. package/dist/extensions/web-agent-onboarding.ts +222 -222
  124. package/dist/extensions/workflow/package.json +17 -17
  125. package/dist/package-manager-cli.js +71 -71
  126. package/dist/rpc-entry.js +0 -0
  127. package/dist/skills/agent-browser/SKILL.md +52 -52
  128. package/dist/skills/batch-grill-me/SKILL.md +19 -19
  129. package/dist/skills/grill-me/SKILL.md +10 -10
  130. package/dist/skills/handoff/SKILL.md +16 -16
  131. package/dist/skills/handoff-text/SKILL.md +14 -14
  132. package/dist/skills/implanger/SKILL.md +69 -69
  133. package/dist/skills/improve-codebase/REFERENCE.md +78 -78
  134. package/dist/skills/improve-codebase/SKILL.md +178 -178
  135. package/dist/skills/planger/SKILL.md +166 -166
  136. package/dist/skills/ponytail/SKILL.md +116 -116
  137. package/dist/skills/ponytail-audit/SKILL.md +42 -42
  138. package/dist/skills/ponytail-debt/SKILL.md +45 -45
  139. package/dist/skills/ponytail-gain/SKILL.md +51 -51
  140. package/dist/skills/ponytail-help/SKILL.md +70 -70
  141. package/dist/skills/ponytail-review/SKILL.md +58 -58
  142. package/dist/skills/selesai-handoff/SKILL.md +20 -20
  143. package/dist/skills/workflow-creation/SKILL.md +73 -73
  144. package/dist/themes/powerline-footer/theme.json +33 -33
  145. package/dist/utils/shell.d.ts +3 -0
  146. package/dist/utils/shell.js +17 -5
  147. package/docs/compaction.md +396 -396
  148. package/docs/containerization.md +111 -111
  149. package/docs/development.md +71 -71
  150. package/docs/docs.json +164 -164
  151. package/docs/environment-variables.md +86 -86
  152. package/docs/index.md +83 -83
  153. package/docs/json.md +82 -82
  154. package/docs/models.md +502 -502
  155. package/docs/packages.md +227 -227
  156. package/docs/plans/subagent-delegation/phase-0-correctness.md +264 -264
  157. package/docs/plans/subagent-delegation/phase-1-behavioral-contract.md +485 -485
  158. package/docs/plans/subagent-delegation/phase-2-context-controls.md +281 -281
  159. package/docs/plans/subagent-delegation/phase-3-advisory-routing.md +361 -361
  160. package/docs/plans/subagent-delegation/phase-4-optional-enforcement.md +380 -380
  161. package/docs/prompt-templates.md +95 -95
  162. package/docs/providers.md +293 -293
  163. package/docs/sdk.md +1144 -1143
  164. package/docs/security.md +59 -59
  165. package/docs/session-format.md +414 -414
  166. package/docs/sessions.md +145 -145
  167. package/docs/shared-host-extensions.md +109 -109
  168. package/docs/shell-aliases.md +13 -13
  169. package/docs/skills.md +231 -231
  170. package/docs/terminal-setup.md +142 -142
  171. package/docs/termux.md +127 -127
  172. package/docs/themes.md +295 -295
  173. package/docs/tmux.md +63 -63
  174. package/docs/tui.md +927 -927
  175. package/docs/windows.md +17 -17
  176. package/examples/README.md +25 -25
  177. package/examples/extensions/README.md +211 -211
  178. package/examples/extensions/auto-commit-on-exit.ts +49 -49
  179. package/examples/extensions/bash-spawn-hook.ts +30 -30
  180. package/examples/extensions/bookmark.ts +50 -50
  181. package/examples/extensions/border-status-editor.ts +150 -150
  182. package/examples/extensions/built-in-tool-renderer.ts +249 -249
  183. package/examples/extensions/claude-rules.ts +86 -86
  184. package/examples/extensions/commands.ts +72 -72
  185. package/examples/extensions/confirm-destructive.ts +59 -59
  186. package/examples/extensions/custom-compaction.ts +130 -130
  187. package/examples/extensions/custom-footer.ts +64 -64
  188. package/examples/extensions/custom-header.ts +73 -73
  189. package/examples/extensions/custom-provider-anthropic/index.ts +610 -610
  190. package/examples/extensions/custom-provider-anthropic/package-lock.json +24 -24
  191. package/examples/extensions/custom-provider-anthropic/package.json +19 -19
  192. package/examples/extensions/custom-provider-gitlab-duo/index.ts +404 -404
  193. package/examples/extensions/custom-provider-gitlab-duo/package.json +16 -16
  194. package/examples/extensions/custom-provider-gitlab-duo/test.ts +82 -82
  195. package/examples/extensions/dirty-repo-guard.ts +56 -56
  196. package/examples/extensions/doom-overlay/README.md +46 -46
  197. package/examples/extensions/doom-overlay/doom/build/doom.js +21 -21
  198. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  199. package/examples/extensions/doom-overlay/doom/build.sh +152 -152
  200. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +72 -72
  201. package/examples/extensions/doom-overlay/doom-component.ts +132 -132
  202. package/examples/extensions/doom-overlay/doom-engine.ts +173 -173
  203. package/examples/extensions/doom-overlay/doom-keys.ts +104 -104
  204. package/examples/extensions/doom-overlay/index.ts +74 -74
  205. package/examples/extensions/doom-overlay/wad-finder.ts +51 -51
  206. package/examples/extensions/dynamic-resources/SKILL.md +8 -8
  207. package/examples/extensions/dynamic-resources/dynamic.json +79 -79
  208. package/examples/extensions/dynamic-resources/dynamic.md +5 -5
  209. package/examples/extensions/dynamic-resources/index.ts +15 -15
  210. package/examples/extensions/dynamic-tools.ts +74 -74
  211. package/examples/extensions/event-bus.ts +43 -43
  212. package/examples/extensions/file-trigger.ts +41 -41
  213. package/examples/extensions/git-checkpoint.ts +53 -53
  214. package/examples/extensions/git-merge-and-resolve.ts +115 -115
  215. package/examples/extensions/github-issue-autocomplete.ts +185 -185
  216. package/examples/extensions/gondolin/index.ts +531 -531
  217. package/examples/extensions/gondolin/package-lock.json +185 -185
  218. package/examples/extensions/gondolin/package.json +19 -19
  219. package/examples/extensions/handoff.ts +199 -199
  220. package/examples/extensions/hello.ts +26 -26
  221. package/examples/extensions/hidden-thinking-label.ts +53 -53
  222. package/examples/extensions/inline-bash.ts +94 -94
  223. package/examples/extensions/input-transform-streaming.ts +39 -39
  224. package/examples/extensions/input-transform.ts +43 -43
  225. package/examples/extensions/interactive-shell.ts +196 -196
  226. package/examples/extensions/mac-system-theme.ts +47 -47
  227. package/examples/extensions/message-renderer.ts +59 -59
  228. package/examples/extensions/minimal-mode.ts +426 -426
  229. package/examples/extensions/modal-editor.ts +85 -85
  230. package/examples/extensions/model-status.ts +31 -31
  231. package/examples/extensions/notify.ts +55 -55
  232. package/examples/extensions/overlay-qa-tests.ts +1450 -1450
  233. package/examples/extensions/overlay-test.ts +153 -153
  234. package/examples/extensions/permission-gate.ts +34 -34
  235. package/examples/extensions/pirate.ts +47 -47
  236. package/examples/extensions/plan-mode/README.md +66 -66
  237. package/examples/extensions/plan-mode/index.ts +390 -390
  238. package/examples/extensions/plan-mode/utils.ts +168 -168
  239. package/examples/extensions/preset.ts +436 -436
  240. package/examples/extensions/project-trust.ts +64 -64
  241. package/examples/extensions/prompt-customizer.ts +97 -97
  242. package/examples/extensions/protected-paths.ts +30 -30
  243. package/examples/extensions/provider-payload.ts +18 -18
  244. package/examples/extensions/qna.ts +122 -122
  245. package/examples/extensions/question.ts +285 -285
  246. package/examples/extensions/questionnaire.ts +448 -448
  247. package/examples/extensions/rainbow-editor.ts +88 -88
  248. package/examples/extensions/reload-runtime.ts +37 -37
  249. package/examples/extensions/rpc-demo.ts +118 -118
  250. package/examples/extensions/sandbox/index.ts +321 -321
  251. package/examples/extensions/sandbox/package-lock.json +92 -92
  252. package/examples/extensions/sandbox/package.json +19 -19
  253. package/examples/extensions/send-user-message.ts +97 -97
  254. package/examples/extensions/session-name.ts +27 -27
  255. package/examples/extensions/shutdown-command.ts +63 -63
  256. package/examples/extensions/snake.ts +343 -343
  257. package/examples/extensions/space-invaders.ts +560 -560
  258. package/examples/extensions/ssh.ts +220 -220
  259. package/examples/extensions/status-line.ts +32 -32
  260. package/examples/extensions/structured-output.ts +65 -65
  261. package/examples/extensions/subagent/README.md +175 -175
  262. package/examples/extensions/subagent/agents/planner.md +37 -37
  263. package/examples/extensions/subagent/agents/reviewer.md +35 -35
  264. package/examples/extensions/subagent/agents/scout.md +50 -50
  265. package/examples/extensions/subagent/agents/worker.md +24 -24
  266. package/examples/extensions/subagent/agents.ts +126 -126
  267. package/examples/extensions/subagent/index.ts +1015 -1015
  268. package/examples/extensions/subagent/prompts/implement-and-review.md +10 -10
  269. package/examples/extensions/subagent/prompts/implement.md +10 -10
  270. package/examples/extensions/subagent/prompts/scout-and-plan.md +9 -9
  271. package/examples/extensions/summarize.ts +209 -209
  272. package/examples/extensions/system-prompt-header.ts +17 -17
  273. package/examples/extensions/tic-tac-toe.ts +1008 -1008
  274. package/examples/extensions/timed-confirm.ts +70 -70
  275. package/examples/extensions/titlebar-spinner.ts +58 -58
  276. package/examples/extensions/todo.ts +297 -297
  277. package/examples/extensions/tool-override.ts +144 -144
  278. package/examples/extensions/tools.ts +146 -146
  279. package/examples/extensions/trigger-compact.ts +50 -50
  280. package/examples/extensions/truncated-tool.ts +195 -195
  281. package/examples/extensions/widget-placement.ts +9 -9
  282. package/examples/extensions/with-deps/index.ts +32 -32
  283. package/examples/extensions/with-deps/package-lock.json +31 -31
  284. package/examples/extensions/with-deps/package.json +22 -22
  285. package/examples/extensions/working-indicator.ts +123 -123
  286. package/examples/extensions/working-message-test.ts +25 -25
  287. package/examples/rpc-extension-ui.ts +632 -632
  288. package/examples/sdk/01-minimal.ts +26 -26
  289. package/examples/sdk/02-custom-model.ts +53 -53
  290. package/examples/sdk/03-custom-prompt.ts +75 -75
  291. package/examples/sdk/04-skills.ts +55 -55
  292. package/examples/sdk/05-tools.ts +48 -48
  293. package/examples/sdk/06-extensions.ts +99 -99
  294. package/examples/sdk/07-context-files.ts +47 -47
  295. package/examples/sdk/08-prompt-templates.ts +51 -51
  296. package/examples/sdk/09-api-keys-and-oauth.ts +52 -52
  297. package/examples/sdk/10-settings.ts +53 -53
  298. package/examples/sdk/11-sessions.ts +52 -52
  299. package/examples/sdk/12-full-control.ts +79 -79
  300. package/examples/sdk/13-session-runtime.ts +67 -67
  301. package/examples/sdk/README.md +144 -144
  302. package/package.json +4 -4
@@ -1,134 +1,134 @@
1
- import { chmodSync, mkdirSync, readFileSync } from "fs";
2
- import { isAbsolute, join, resolve } from "path";
3
- import { getAgentDir } from "@selesai/code";
4
-
5
- export const INTERCOM_DIR_MODE = 0o700;
6
- export const INTERCOM_RUNTIME_FILE_MODE = 0o600;
7
- export const INTERCOM_TCP_HOST = "127.0.0.1";
8
- export const INTERCOM_PROTOCOL_NAME = "pi-intercom";
9
- export const INTERCOM_PROTOCOL_VERSION = 1;
10
-
11
- export interface BrokerTcpEndpoint {
12
- transport: "tcp";
13
- host: string;
14
- port: number;
15
- stateId?: string;
16
- }
17
-
18
- export type BrokerConnectTarget = string | BrokerTcpEndpoint;
19
-
20
- function sanitizePipeSegment(value: string): string {
21
- return value
22
- .replace(/[^a-zA-Z0-9]+/g, "-")
23
- .replace(/^-+|-+$/g, "")
24
- .toLowerCase() || "default";
25
- }
26
-
27
- export function getAgentDirPath(
28
- env: NodeJS.ProcessEnv = process.env,
29
- cwd: string = process.cwd(),
30
- ): string {
31
- const configured = env.SELESAI_CODING_AGENT_DIR?.trim();
32
- if (!configured) {
33
- return getAgentDir();
34
- }
35
-
36
- return isAbsolute(configured) ? configured : resolve(cwd, configured);
37
- }
38
-
39
- export function getIntercomDirPath(agentDir: string = getAgentDirPath()): string {
40
- return join(agentDir, "intercom");
41
- }
42
-
43
- export function shouldUseWindowsTcpTransport(
44
- platform: NodeJS.Platform = process.platform,
45
- env: NodeJS.ProcessEnv = process.env,
46
- ): boolean {
47
- if (platform !== "win32") {
48
- return false;
49
- }
50
-
51
- const transport = env.PI_INTERCOM_TRANSPORT?.trim().toLowerCase();
52
- if (transport === "tcp") {
53
- return true;
54
- }
55
-
56
- const legacyOptIn = env.PI_INTERCOM_TCP?.trim().toLowerCase();
57
- return legacyOptIn === "1" || legacyOptIn === "true";
58
- }
59
-
60
- export function getBrokerPortFilePath(intercomDir: string = getIntercomDirPath()): string {
61
- return join(intercomDir, "broker.port.json");
62
- }
63
-
64
- export function getBrokerSocketPath(
65
- platform: NodeJS.Platform = process.platform,
66
- agentDir: string = getAgentDirPath(),
67
- ): string {
68
- if (platform === "win32") {
69
- return `\\\\.\\pipe\\pi-intercom-${sanitizePipeSegment(agentDir)}`;
70
- }
71
-
72
- return join(getIntercomDirPath(agentDir), "broker.sock");
73
- }
74
-
75
- export function getBrokerConnectTarget(
76
- platform: NodeJS.Platform = process.platform,
77
- env: NodeJS.ProcessEnv = process.env,
78
- intercomDir: string = getIntercomDirPath(getAgentDirPath(env)),
79
- ): BrokerConnectTarget {
80
- if (shouldUseWindowsTcpTransport(platform, env)) {
81
- const endpointFile = getBrokerPortFilePath(intercomDir);
82
- const raw = readFileSync(endpointFile, "utf-8");
83
- const parsed: unknown = JSON.parse(raw);
84
- if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
85
- throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}: expected a JSON object`);
86
- }
87
- const endpoint = parsed as Record<string, unknown>;
88
- if (
89
- endpoint.transport !== "tcp"
90
- || endpoint.host !== INTERCOM_TCP_HOST
91
- || typeof endpoint.port !== "number"
92
- || !Number.isSafeInteger(endpoint.port)
93
- || endpoint.port <= 0
94
- || endpoint.port > 65535
95
- || typeof endpoint.stateId !== "string"
96
- || endpoint.stateId.length === 0
97
- ) {
98
- throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}`);
99
- }
100
- return { transport: "tcp", host: endpoint.host, port: endpoint.port, stateId: endpoint.stateId };
101
- }
102
-
103
- return getBrokerSocketPath(platform, getAgentDirPath(env));
104
- }
105
-
106
- export function getBrokerListenTarget(
107
- platform: NodeJS.Platform = process.platform,
108
- env: NodeJS.ProcessEnv = process.env,
109
- ): BrokerConnectTarget {
110
- if (shouldUseWindowsTcpTransport(platform, env)) {
111
- return { transport: "tcp", host: INTERCOM_TCP_HOST, port: 0 };
112
- }
113
-
114
- return getBrokerSocketPath(platform, getAgentDirPath(env));
115
- }
116
-
117
- export function ensureIntercomRuntimeDir(
118
- intercomDir: string = getIntercomDirPath(),
119
- platform: NodeJS.Platform = process.platform,
120
- ): void {
121
- mkdirSync(intercomDir, { recursive: true, mode: INTERCOM_DIR_MODE });
122
- if (platform !== "win32") {
123
- chmodSync(intercomDir, INTERCOM_DIR_MODE);
124
- }
125
- }
126
-
127
- export function restrictIntercomRuntimeFile(
128
- filePath: string,
129
- platform: NodeJS.Platform = process.platform,
130
- ): void {
131
- if (platform !== "win32") {
132
- chmodSync(filePath, INTERCOM_RUNTIME_FILE_MODE);
133
- }
134
- }
1
+ import { chmodSync, mkdirSync, readFileSync } from "fs";
2
+ import { isAbsolute, join, resolve } from "path";
3
+ import { getAgentDir } from "@selesai/code";
4
+
5
+ export const INTERCOM_DIR_MODE = 0o700;
6
+ export const INTERCOM_RUNTIME_FILE_MODE = 0o600;
7
+ export const INTERCOM_TCP_HOST = "127.0.0.1";
8
+ export const INTERCOM_PROTOCOL_NAME = "pi-intercom";
9
+ export const INTERCOM_PROTOCOL_VERSION = 1;
10
+
11
+ export interface BrokerTcpEndpoint {
12
+ transport: "tcp";
13
+ host: string;
14
+ port: number;
15
+ stateId?: string;
16
+ }
17
+
18
+ export type BrokerConnectTarget = string | BrokerTcpEndpoint;
19
+
20
+ function sanitizePipeSegment(value: string): string {
21
+ return value
22
+ .replace(/[^a-zA-Z0-9]+/g, "-")
23
+ .replace(/^-+|-+$/g, "")
24
+ .toLowerCase() || "default";
25
+ }
26
+
27
+ export function getAgentDirPath(
28
+ env: NodeJS.ProcessEnv = process.env,
29
+ cwd: string = process.cwd(),
30
+ ): string {
31
+ const configured = env.SELESAI_CODING_AGENT_DIR?.trim();
32
+ if (!configured) {
33
+ return getAgentDir();
34
+ }
35
+
36
+ return isAbsolute(configured) ? configured : resolve(cwd, configured);
37
+ }
38
+
39
+ export function getIntercomDirPath(agentDir: string = getAgentDirPath()): string {
40
+ return join(agentDir, "intercom");
41
+ }
42
+
43
+ export function shouldUseWindowsTcpTransport(
44
+ platform: NodeJS.Platform = process.platform,
45
+ env: NodeJS.ProcessEnv = process.env,
46
+ ): boolean {
47
+ if (platform !== "win32") {
48
+ return false;
49
+ }
50
+
51
+ const transport = env.PI_INTERCOM_TRANSPORT?.trim().toLowerCase();
52
+ if (transport === "tcp") {
53
+ return true;
54
+ }
55
+
56
+ const legacyOptIn = env.PI_INTERCOM_TCP?.trim().toLowerCase();
57
+ return legacyOptIn === "1" || legacyOptIn === "true";
58
+ }
59
+
60
+ export function getBrokerPortFilePath(intercomDir: string = getIntercomDirPath()): string {
61
+ return join(intercomDir, "broker.port.json");
62
+ }
63
+
64
+ export function getBrokerSocketPath(
65
+ platform: NodeJS.Platform = process.platform,
66
+ agentDir: string = getAgentDirPath(),
67
+ ): string {
68
+ if (platform === "win32") {
69
+ return `\\\\.\\pipe\\pi-intercom-${sanitizePipeSegment(agentDir)}`;
70
+ }
71
+
72
+ return join(getIntercomDirPath(agentDir), "broker.sock");
73
+ }
74
+
75
+ export function getBrokerConnectTarget(
76
+ platform: NodeJS.Platform = process.platform,
77
+ env: NodeJS.ProcessEnv = process.env,
78
+ intercomDir: string = getIntercomDirPath(getAgentDirPath(env)),
79
+ ): BrokerConnectTarget {
80
+ if (shouldUseWindowsTcpTransport(platform, env)) {
81
+ const endpointFile = getBrokerPortFilePath(intercomDir);
82
+ const raw = readFileSync(endpointFile, "utf-8");
83
+ const parsed: unknown = JSON.parse(raw);
84
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
85
+ throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}: expected a JSON object`);
86
+ }
87
+ const endpoint = parsed as Record<string, unknown>;
88
+ if (
89
+ endpoint.transport !== "tcp"
90
+ || endpoint.host !== INTERCOM_TCP_HOST
91
+ || typeof endpoint.port !== "number"
92
+ || !Number.isSafeInteger(endpoint.port)
93
+ || endpoint.port <= 0
94
+ || endpoint.port > 65535
95
+ || typeof endpoint.stateId !== "string"
96
+ || endpoint.stateId.length === 0
97
+ ) {
98
+ throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}`);
99
+ }
100
+ return { transport: "tcp", host: endpoint.host, port: endpoint.port, stateId: endpoint.stateId };
101
+ }
102
+
103
+ return getBrokerSocketPath(platform, getAgentDirPath(env));
104
+ }
105
+
106
+ export function getBrokerListenTarget(
107
+ platform: NodeJS.Platform = process.platform,
108
+ env: NodeJS.ProcessEnv = process.env,
109
+ ): BrokerConnectTarget {
110
+ if (shouldUseWindowsTcpTransport(platform, env)) {
111
+ return { transport: "tcp", host: INTERCOM_TCP_HOST, port: 0 };
112
+ }
113
+
114
+ return getBrokerSocketPath(platform, getAgentDirPath(env));
115
+ }
116
+
117
+ export function ensureIntercomRuntimeDir(
118
+ intercomDir: string = getIntercomDirPath(),
119
+ platform: NodeJS.Platform = process.platform,
120
+ ): void {
121
+ mkdirSync(intercomDir, { recursive: true, mode: INTERCOM_DIR_MODE });
122
+ if (platform !== "win32") {
123
+ chmodSync(intercomDir, INTERCOM_DIR_MODE);
124
+ }
125
+ }
126
+
127
+ export function restrictIntercomRuntimeFile(
128
+ filePath: string,
129
+ platform: NodeJS.Platform = process.platform,
130
+ ): void {
131
+ if (platform !== "win32") {
132
+ chmodSync(filePath, INTERCOM_RUNTIME_FILE_MODE);
133
+ }
134
+ }
@@ -1,34 +1,34 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import path from "node:path";
4
- import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
5
- import { tmpdir } from "node:os";
6
- import { assertNoLiveBroker } from "./runtime-claim.ts";
7
-
8
- test("broker startup refuses to replace a live broker PID", () => {
9
- const directory = mkdtempSync(path.join(tmpdir(), "pi-intercom-runtime-"));
10
- const pidPath = path.join(directory, "broker.pid");
11
- try {
12
- writeFileSync(pidPath, `${process.pid}\n`);
13
- assert.throws(
14
- () => assertNoLiveBroker(pidPath),
15
- new RegExp(`Refusing to replace live intercom broker process ${process.pid}`),
16
- );
17
- } finally {
18
- rmSync(directory, { recursive: true, force: true });
19
- }
20
- });
21
-
22
- test("broker startup tolerates absent, invalid, and stale PID files", () => {
23
- const directory = mkdtempSync(path.join(tmpdir(), "pi-intercom-runtime-"));
24
- const pidPath = path.join(directory, "broker.pid");
25
- try {
26
- assert.doesNotThrow(() => assertNoLiveBroker(pidPath));
27
- writeFileSync(pidPath, "invalid\n");
28
- assert.doesNotThrow(() => assertNoLiveBroker(pidPath));
29
- writeFileSync(pidPath, "2147483647\n");
30
- assert.doesNotThrow(() => assertNoLiveBroker(pidPath));
31
- } finally {
32
- rmSync(directory, { recursive: true, force: true });
33
- }
34
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import path from "node:path";
4
+ import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
5
+ import { tmpdir } from "node:os";
6
+ import { assertNoLiveBroker } from "./runtime-claim.ts";
7
+
8
+ test("broker startup refuses to replace a live broker PID", () => {
9
+ const directory = mkdtempSync(path.join(tmpdir(), "pi-intercom-runtime-"));
10
+ const pidPath = path.join(directory, "broker.pid");
11
+ try {
12
+ writeFileSync(pidPath, `${process.pid}\n`);
13
+ assert.throws(
14
+ () => assertNoLiveBroker(pidPath),
15
+ new RegExp(`Refusing to replace live intercom broker process ${process.pid}`),
16
+ );
17
+ } finally {
18
+ rmSync(directory, { recursive: true, force: true });
19
+ }
20
+ });
21
+
22
+ test("broker startup tolerates absent, invalid, and stale PID files", () => {
23
+ const directory = mkdtempSync(path.join(tmpdir(), "pi-intercom-runtime-"));
24
+ const pidPath = path.join(directory, "broker.pid");
25
+ try {
26
+ assert.doesNotThrow(() => assertNoLiveBroker(pidPath));
27
+ writeFileSync(pidPath, "invalid\n");
28
+ assert.doesNotThrow(() => assertNoLiveBroker(pidPath));
29
+ writeFileSync(pidPath, "2147483647\n");
30
+ assert.doesNotThrow(() => assertNoLiveBroker(pidPath));
31
+ } finally {
32
+ rmSync(directory, { recursive: true, force: true });
33
+ }
34
+ });
@@ -1,21 +1,21 @@
1
- import { existsSync, readFileSync } from "node:fs";
2
-
3
- export function assertNoLiveBroker(pidPath: string): void {
4
- if (!existsSync(pidPath)) return;
5
-
6
- let pid: number;
7
- try {
8
- pid = Number.parseInt(readFileSync(pidPath, "utf8").trim(), 10);
9
- } catch {
10
- return;
11
- }
12
- if (!Number.isSafeInteger(pid) || pid <= 0) return;
13
-
14
- try {
15
- process.kill(pid, 0);
16
- } catch (error) {
17
- if ((error as NodeJS.ErrnoException).code === "ESRCH") return;
18
- throw error;
19
- }
20
- throw new Error(`Refusing to replace live intercom broker process ${pid}`);
21
- }
1
+ import { existsSync, readFileSync } from "node:fs";
2
+
3
+ export function assertNoLiveBroker(pidPath: string): void {
4
+ if (!existsSync(pidPath)) return;
5
+
6
+ let pid: number;
7
+ try {
8
+ pid = Number.parseInt(readFileSync(pidPath, "utf8").trim(), 10);
9
+ } catch {
10
+ return;
11
+ }
12
+ if (!Number.isSafeInteger(pid) || pid <= 0) return;
13
+
14
+ try {
15
+ process.kill(pid, 0);
16
+ } catch (error) {
17
+ if ((error as NodeJS.ErrnoException).code === "ESRCH") return;
18
+ throw error;
19
+ }
20
+ throw new Error(`Refusing to replace live intercom broker process ${pid}`);
21
+ }
@@ -1,40 +1,40 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { mkdtempSync, rmSync, symlinkSync, mkdirSync, realpathSync } from "node:fs";
4
- import { tmpdir } from "node:os";
5
- import { join } from "node:path";
6
- import { normalizeCwd, sameCwd } from "./cwd.ts";
7
-
8
- test("sameCwd collapses a trailing slash", () => {
9
- assert.equal(sameCwd("/usr/local", "/usr/local/"), true);
10
- });
11
-
12
- test("sameCwd collapses lexical '.' and '..' segments", () => {
13
- assert.equal(sameCwd("/usr/local/../local/./bin", "/usr/local/bin"), true);
14
- });
15
-
16
- test("sameCwd treats genuinely different directories as different", () => {
17
- assert.equal(sameCwd("/usr/local", "/usr/lib"), false);
18
- });
19
-
20
- test("sameCwd collapses a symlink to its real target", () => {
21
- const base = mkdtempSync(join(tmpdir(), "cwd-symlink-"));
22
- try {
23
- const real = join(base, "real");
24
- const link = join(base, "link");
25
- mkdirSync(real);
26
- symlinkSync(real, link);
27
- // Reached via the symlink vs its canonical path — must compare equal.
28
- assert.equal(sameCwd(link, real), true);
29
- // And normalizeCwd resolves the link to the real path.
30
- assert.equal(normalizeCwd(link), realpathSync(real));
31
- } finally {
32
- rmSync(base, { recursive: true, force: true });
33
- }
34
- });
35
-
36
- test("normalizeCwd falls back to the resolved path for a nonexistent dir", () => {
37
- // realpathSync throws for a missing dir; normalizeCwd must still collapse the
38
- // lexical variants rather than throw.
39
- assert.equal(normalizeCwd("/no/such/dir/../dir"), "/no/such/dir");
40
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { mkdtempSync, rmSync, symlinkSync, mkdirSync, realpathSync } from "node:fs";
4
+ import { tmpdir } from "node:os";
5
+ import { join } from "node:path";
6
+ import { normalizeCwd, sameCwd } from "./cwd.ts";
7
+
8
+ test("sameCwd collapses a trailing slash", () => {
9
+ assert.equal(sameCwd("/usr/local", "/usr/local/"), true);
10
+ });
11
+
12
+ test("sameCwd collapses lexical '.' and '..' segments", () => {
13
+ assert.equal(sameCwd("/usr/local/../local/./bin", "/usr/local/bin"), true);
14
+ });
15
+
16
+ test("sameCwd treats genuinely different directories as different", () => {
17
+ assert.equal(sameCwd("/usr/local", "/usr/lib"), false);
18
+ });
19
+
20
+ test("sameCwd collapses a symlink to its real target", () => {
21
+ const base = mkdtempSync(join(tmpdir(), "cwd-symlink-"));
22
+ try {
23
+ const real = join(base, "real");
24
+ const link = join(base, "link");
25
+ mkdirSync(real);
26
+ symlinkSync(real, link);
27
+ // Reached via the symlink vs its canonical path — must compare equal.
28
+ assert.equal(sameCwd(link, real), true);
29
+ // And normalizeCwd resolves the link to the real path.
30
+ assert.equal(normalizeCwd(link), realpathSync(real));
31
+ } finally {
32
+ rmSync(base, { recursive: true, force: true });
33
+ }
34
+ });
35
+
36
+ test("normalizeCwd falls back to the resolved path for a nonexistent dir", () => {
37
+ // realpathSync throws for a missing dir; normalizeCwd must still collapse the
38
+ // lexical variants rather than throw.
39
+ assert.equal(normalizeCwd("/no/such/dir/../dir"), "/no/such/dir");
40
+ });
@@ -1,31 +1,31 @@
1
- import { resolve } from "node:path";
2
- import { realpathSync } from "node:fs";
3
-
4
- // Normalize a cwd for same-directory comparison. A raw string match ("a === b")
5
- // hides genuine same-directory peers when two cwd strings differ only by a
6
- // trailing slash, a "."/".." segment, or a symlink (e.g. macOS /tmp <->
7
- // /private/tmp). resolve() collapses the lexical variants; realpathSync()
8
- // collapses symlinks (best-effort: falls back to the resolved path if the
9
- // directory no longer exists). Memoized — the set of distinct cwd strings is
10
- // small and stable, so repeat comparisons are free after warmup.
11
- const normalizeCache = new Map<string, string>();
12
-
13
- export function normalizeCwd(cwd: string): string {
14
- const cached = normalizeCache.get(cwd);
15
- if (cached !== undefined) {
16
- return cached;
17
- }
18
- const resolved = resolve(cwd);
19
- let normalized: string;
20
- try {
21
- normalized = realpathSync(resolved);
22
- } catch {
23
- normalized = resolved;
24
- }
25
- normalizeCache.set(cwd, normalized);
26
- return normalized;
27
- }
28
-
29
- export function sameCwd(a: string, b: string): boolean {
30
- return normalizeCwd(a) === normalizeCwd(b);
31
- }
1
+ import { resolve } from "node:path";
2
+ import { realpathSync } from "node:fs";
3
+
4
+ // Normalize a cwd for same-directory comparison. A raw string match ("a === b")
5
+ // hides genuine same-directory peers when two cwd strings differ only by a
6
+ // trailing slash, a "."/".." segment, or a symlink (e.g. macOS /tmp <->
7
+ // /private/tmp). resolve() collapses the lexical variants; realpathSync()
8
+ // collapses symlinks (best-effort: falls back to the resolved path if the
9
+ // directory no longer exists). Memoized — the set of distinct cwd strings is
10
+ // small and stable, so repeat comparisons are free after warmup.
11
+ const normalizeCache = new Map<string, string>();
12
+
13
+ export function normalizeCwd(cwd: string): string {
14
+ const cached = normalizeCache.get(cwd);
15
+ if (cached !== undefined) {
16
+ return cached;
17
+ }
18
+ const resolved = resolve(cwd);
19
+ let normalized: string;
20
+ try {
21
+ normalized = realpathSync(resolved);
22
+ } catch {
23
+ normalized = resolved;
24
+ }
25
+ normalizeCache.set(cwd, normalized);
26
+ return normalized;
27
+ }
28
+
29
+ export function sameCwd(a: string, b: string): boolean {
30
+ return normalizeCwd(a) === normalizeCwd(b);
31
+ }
@@ -1,44 +1,44 @@
1
- import type { SessionInfo } from "./types.ts";
2
-
3
- export const INTERCOM_EXTENSION_REGISTER_EVENT = "intercom:extension-register";
4
- export const INTERCOM_EXTENSION_REGISTRY_READY_EVENT = "intercom:extension-registry-ready";
5
-
6
- export interface IntercomExtensionOwner {
7
- sessionId: string;
8
- epoch: string;
9
- }
10
-
11
- export interface IntercomExtensionState {
12
- revision: number;
13
- payload: unknown;
14
- }
15
-
16
- export type IntercomExtensionEvent =
17
- | { type: "connection"; connected: boolean; supported: boolean }
18
- | { type: "owner"; owner?: IntercomExtensionOwner }
19
- | { type: "message"; fromSessionId: string; owner?: IntercomExtensionOwner; payload: unknown }
20
- | { type: "state"; state: IntercomExtensionState }
21
- | { type: "state_result"; committed: boolean; revision: number; reason?: string }
22
- | { type: "session_joined"; session: SessionInfo }
23
- | { type: "session_left"; sessionId: string }
24
- | { type: "presence_update"; session: SessionInfo };
25
-
26
- export interface IntercomExtensionChannel {
27
- readonly namespace: string;
28
- snapshot(): {
29
- connected: boolean;
30
- supported: boolean;
31
- owner?: IntercomExtensionOwner;
32
- state?: IntercomExtensionState;
33
- };
34
- publish(payload: unknown, options?: { audience?: "owner" | "capable"; ownerOnly?: boolean }): void;
35
- commitState(payload: unknown, expectedRevision?: number): void;
36
- listSessions(): Promise<SessionInfo[]>;
37
- }
38
-
39
- export interface IntercomExtensionRegistration {
40
- namespace: string;
41
- ownerEligible: boolean;
42
- onEvent(event: IntercomExtensionEvent): void;
43
- onReady(channel: IntercomExtensionChannel): void;
44
- }
1
+ import type { SessionInfo } from "./types.ts";
2
+
3
+ export const INTERCOM_EXTENSION_REGISTER_EVENT = "intercom:extension-register";
4
+ export const INTERCOM_EXTENSION_REGISTRY_READY_EVENT = "intercom:extension-registry-ready";
5
+
6
+ export interface IntercomExtensionOwner {
7
+ sessionId: string;
8
+ epoch: string;
9
+ }
10
+
11
+ export interface IntercomExtensionState {
12
+ revision: number;
13
+ payload: unknown;
14
+ }
15
+
16
+ export type IntercomExtensionEvent =
17
+ | { type: "connection"; connected: boolean; supported: boolean }
18
+ | { type: "owner"; owner?: IntercomExtensionOwner }
19
+ | { type: "message"; fromSessionId: string; owner?: IntercomExtensionOwner; payload: unknown }
20
+ | { type: "state"; state: IntercomExtensionState }
21
+ | { type: "state_result"; committed: boolean; revision: number; reason?: string }
22
+ | { type: "session_joined"; session: SessionInfo }
23
+ | { type: "session_left"; sessionId: string }
24
+ | { type: "presence_update"; session: SessionInfo };
25
+
26
+ export interface IntercomExtensionChannel {
27
+ readonly namespace: string;
28
+ snapshot(): {
29
+ connected: boolean;
30
+ supported: boolean;
31
+ owner?: IntercomExtensionOwner;
32
+ state?: IntercomExtensionState;
33
+ };
34
+ publish(payload: unknown, options?: { audience?: "owner" | "capable"; ownerOnly?: boolean }): void;
35
+ commitState(payload: unknown, expectedRevision?: number): void;
36
+ listSessions(): Promise<SessionInfo[]>;
37
+ }
38
+
39
+ export interface IntercomExtensionRegistration {
40
+ namespace: string;
41
+ ownerEligible: boolean;
42
+ onEvent(event: IntercomExtensionEvent): void;
43
+ onReady(channel: IntercomExtensionChannel): void;
44
+ }