@selesai/code 0.13.4 → 0.13.5

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 (394) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/dist/cli/credential-print.js +4 -4
  3. package/dist/cli.js +0 -0
  4. package/dist/core/compaction/utils.js +2 -2
  5. package/dist/core/export-html/template.css +1066 -1066
  6. package/dist/core/export-html/template.html +55 -55
  7. package/dist/core/export-html/template.js +1864 -1864
  8. package/dist/core/export-html/vendor/highlight.min.js +1212 -1212
  9. package/dist/core/export-html/vendor/marked.min.js +78 -78
  10. package/dist/core/messages.js +7 -7
  11. package/dist/extensions/context-compaction-reminder.test.ts +82 -82
  12. package/dist/extensions/context-compaction-reminder.ts +28 -28
  13. package/dist/extensions/pi-hermes-memory/scripts/check-min-sdk.mjs +0 -0
  14. package/dist/extensions/pi-hermes-memory/tests/run-all.sh +0 -0
  15. package/dist/extensions/pi-intercom/LICENSE +21 -21
  16. package/dist/extensions/pi-intercom/broker/client.test.ts +83 -83
  17. package/dist/extensions/pi-intercom/broker/framing.test.ts +114 -114
  18. package/dist/extensions/pi-intercom/broker/paths.ts +134 -134
  19. package/dist/extensions/pi-intercom/broker/runtime-claim.test.ts +34 -34
  20. package/dist/extensions/pi-intercom/broker/runtime-claim.ts +21 -21
  21. package/dist/extensions/pi-intercom/cwd.test.ts +40 -40
  22. package/dist/extensions/pi-intercom/cwd.ts +31 -31
  23. package/dist/extensions/pi-intercom/format-context.test.ts +31 -31
  24. package/dist/extensions/pi-intercom/format-context.ts +32 -32
  25. package/dist/extensions/pi-intercom/test/overlay-width.test.ts +66 -66
  26. package/dist/extensions/pi-intercom/ui/compose.ts +143 -143
  27. package/dist/extensions/pi-intercom/ui/session-list.ts +166 -166
  28. package/dist/extensions/pi-subagents/install.mjs +0 -0
  29. package/dist/extensions/pi-web-agent/src/backends/settings-reader.ts +25 -25
  30. package/dist/extensions/pi-web-agent/src/cache/ttl-cache.ts +28 -28
  31. package/dist/extensions/pi-web-agent/src/changelog-notice.ts +136 -136
  32. package/dist/extensions/pi-web-agent/src/fetch/browser-resolution.ts +199 -199
  33. package/dist/extensions/pi-web-agent/src/fetch/firecrawl-fetch.ts +100 -100
  34. package/dist/extensions/pi-web-agent/src/fetch/headless-fetch.ts +117 -117
  35. package/dist/extensions/pi-web-agent/src/fetch/http-fetch.ts +67 -67
  36. package/dist/extensions/pi-web-agent/src/orchestration/answer-synthesizer.ts +60 -60
  37. package/dist/extensions/pi-web-agent/src/orchestration/index.ts +28 -28
  38. package/dist/extensions/pi-web-agent/src/orchestration/query-planner.ts +47 -47
  39. package/dist/extensions/pi-web-agent/src/orchestration/stop-decider.ts +81 -81
  40. package/dist/extensions/pi-web-agent/src/presentation/config-store.ts +210 -210
  41. package/dist/extensions/pi-web-agent/src/presentation/config.ts +75 -75
  42. package/dist/extensions/pi-web-agent/src/presentation/fetch-presentation.ts +54 -54
  43. package/dist/extensions/pi-web-agent/src/presentation/select-view.ts +20 -20
  44. package/dist/extensions/pi-web-agent/src/presentation/types.ts +63 -63
  45. package/dist/extensions/pi-web-agent/src/search/brave.ts +114 -114
  46. package/dist/extensions/pi-web-agent/src/search/searxng.ts +96 -96
  47. package/dist/extensions/pi-web-agent/src/tools/web-explore.ts +71 -71
  48. package/dist/extensions/pi-web-agent/src/tools/web-fetch-headless.ts +31 -31
  49. package/dist/extensions/pi-web-agent/src/tools/web-fetch.ts +31 -31
  50. package/dist/extensions/pi-zentui/extensions/zentui/format.ts +7 -1
  51. package/dist/extensions/ponytail/package.json +8 -8
  52. package/dist/extensions/question/constants.ts +30 -30
  53. package/dist/extensions/question/helpers.ts +58 -58
  54. package/dist/extensions/question/navigation.ts +14 -14
  55. package/dist/extensions/question/package.json +19 -19
  56. package/dist/extensions/question/selection-mode.ts +46 -46
  57. package/dist/extensions/question/shortcuts.ts +44 -44
  58. package/dist/extensions/question/types.ts +132 -132
  59. package/dist/extensions/test-resolve-hook-impl.mjs +6 -6
  60. package/dist/extensions/test-resolve-hook.mjs +6 -6
  61. package/dist/extensions/web-agent-onboarding.ts +222 -222
  62. package/dist/package-manager-cli.js +71 -71
  63. package/dist/rpc-entry.js +0 -0
  64. package/dist/skills/improve-codebase/REFERENCE.md +78 -78
  65. package/docs/compaction.md +396 -396
  66. package/docs/containerization.md +111 -111
  67. package/docs/development.md +71 -71
  68. package/docs/docs.json +164 -164
  69. package/docs/environment-variables.md +86 -86
  70. package/docs/index.md +83 -83
  71. package/docs/json.md +82 -82
  72. package/docs/models.md +502 -502
  73. package/docs/packages.md +227 -227
  74. package/docs/plans/subagent-delegation/phase-0-correctness.md +264 -264
  75. package/docs/plans/subagent-delegation/phase-1-behavioral-contract.md +485 -485
  76. package/docs/plans/subagent-delegation/phase-2-context-controls.md +281 -281
  77. package/docs/plans/subagent-delegation/phase-3-advisory-routing.md +361 -361
  78. package/docs/plans/subagent-delegation/phase-4-optional-enforcement.md +380 -380
  79. package/docs/prompt-templates.md +95 -95
  80. package/docs/providers.md +293 -293
  81. package/docs/security.md +59 -59
  82. package/docs/session-format.md +414 -414
  83. package/docs/sessions.md +145 -145
  84. package/docs/shared-host-extensions.md +109 -109
  85. package/docs/shell-aliases.md +13 -13
  86. package/docs/skills.md +231 -231
  87. package/docs/terminal-setup.md +142 -142
  88. package/docs/termux.md +127 -127
  89. package/docs/themes.md +295 -295
  90. package/docs/tmux.md +63 -63
  91. package/docs/tui.md +927 -927
  92. package/docs/windows.md +17 -17
  93. package/examples/README.md +25 -25
  94. package/examples/extensions/README.md +211 -211
  95. package/examples/extensions/auto-commit-on-exit.ts +49 -49
  96. package/examples/extensions/bash-spawn-hook.ts +30 -30
  97. package/examples/extensions/bookmark.ts +50 -50
  98. package/examples/extensions/border-status-editor.ts +150 -150
  99. package/examples/extensions/built-in-tool-renderer.ts +249 -249
  100. package/examples/extensions/claude-rules.ts +86 -86
  101. package/examples/extensions/commands.ts +72 -72
  102. package/examples/extensions/confirm-destructive.ts +59 -59
  103. package/examples/extensions/custom-compaction.ts +130 -130
  104. package/examples/extensions/custom-footer.ts +64 -64
  105. package/examples/extensions/custom-header.ts +73 -73
  106. package/examples/extensions/custom-provider-anthropic/index.ts +610 -610
  107. package/examples/extensions/custom-provider-anthropic/package-lock.json +24 -24
  108. package/examples/extensions/custom-provider-anthropic/package.json +19 -19
  109. package/examples/extensions/custom-provider-gitlab-duo/index.ts +404 -404
  110. package/examples/extensions/custom-provider-gitlab-duo/package.json +16 -16
  111. package/examples/extensions/custom-provider-gitlab-duo/test.ts +82 -82
  112. package/examples/extensions/dirty-repo-guard.ts +56 -56
  113. package/examples/extensions/doom-overlay/README.md +46 -46
  114. package/examples/extensions/doom-overlay/doom/build/doom.js +21 -21
  115. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  116. package/examples/extensions/doom-overlay/doom/build.sh +152 -152
  117. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +72 -72
  118. package/examples/extensions/doom-overlay/doom-component.ts +132 -132
  119. package/examples/extensions/doom-overlay/doom-engine.ts +173 -173
  120. package/examples/extensions/doom-overlay/doom-keys.ts +104 -104
  121. package/examples/extensions/doom-overlay/index.ts +74 -74
  122. package/examples/extensions/doom-overlay/wad-finder.ts +51 -51
  123. package/examples/extensions/dynamic-resources/SKILL.md +8 -8
  124. package/examples/extensions/dynamic-resources/dynamic.json +79 -79
  125. package/examples/extensions/dynamic-resources/dynamic.md +5 -5
  126. package/examples/extensions/dynamic-resources/index.ts +15 -15
  127. package/examples/extensions/dynamic-tools.ts +74 -74
  128. package/examples/extensions/event-bus.ts +43 -43
  129. package/examples/extensions/file-trigger.ts +41 -41
  130. package/examples/extensions/git-checkpoint.ts +53 -53
  131. package/examples/extensions/git-merge-and-resolve.ts +115 -115
  132. package/examples/extensions/github-issue-autocomplete.ts +185 -185
  133. package/examples/extensions/gondolin/index.ts +531 -531
  134. package/examples/extensions/gondolin/package-lock.json +185 -185
  135. package/examples/extensions/gondolin/package.json +19 -19
  136. package/examples/extensions/handoff.ts +199 -199
  137. package/examples/extensions/hello.ts +26 -26
  138. package/examples/extensions/hidden-thinking-label.ts +53 -53
  139. package/examples/extensions/inline-bash.ts +94 -94
  140. package/examples/extensions/input-transform-streaming.ts +39 -39
  141. package/examples/extensions/input-transform.ts +43 -43
  142. package/examples/extensions/interactive-shell.ts +196 -196
  143. package/examples/extensions/mac-system-theme.ts +47 -47
  144. package/examples/extensions/message-renderer.ts +59 -59
  145. package/examples/extensions/minimal-mode.ts +426 -426
  146. package/examples/extensions/modal-editor.ts +85 -85
  147. package/examples/extensions/model-status.ts +31 -31
  148. package/examples/extensions/notify.ts +55 -55
  149. package/examples/extensions/overlay-qa-tests.ts +1450 -1450
  150. package/examples/extensions/overlay-test.ts +153 -153
  151. package/examples/extensions/permission-gate.ts +34 -34
  152. package/examples/extensions/pirate.ts +47 -47
  153. package/examples/extensions/plan-mode/README.md +66 -66
  154. package/examples/extensions/plan-mode/index.ts +390 -390
  155. package/examples/extensions/plan-mode/utils.ts +168 -168
  156. package/examples/extensions/preset.ts +436 -436
  157. package/examples/extensions/project-trust.ts +64 -64
  158. package/examples/extensions/prompt-customizer.ts +97 -97
  159. package/examples/extensions/protected-paths.ts +30 -30
  160. package/examples/extensions/provider-payload.ts +18 -18
  161. package/examples/extensions/qna.ts +122 -122
  162. package/examples/extensions/question.ts +285 -285
  163. package/examples/extensions/questionnaire.ts +448 -448
  164. package/examples/extensions/rainbow-editor.ts +88 -88
  165. package/examples/extensions/reload-runtime.ts +37 -37
  166. package/examples/extensions/rpc-demo.ts +118 -118
  167. package/examples/extensions/sandbox/index.ts +321 -321
  168. package/examples/extensions/sandbox/package-lock.json +92 -92
  169. package/examples/extensions/sandbox/package.json +19 -19
  170. package/examples/extensions/send-user-message.ts +97 -97
  171. package/examples/extensions/session-name.ts +27 -27
  172. package/examples/extensions/shutdown-command.ts +63 -63
  173. package/examples/extensions/snake.ts +343 -343
  174. package/examples/extensions/space-invaders.ts +560 -560
  175. package/examples/extensions/ssh.ts +220 -220
  176. package/examples/extensions/status-line.ts +32 -32
  177. package/examples/extensions/structured-output.ts +65 -65
  178. package/examples/extensions/subagent/README.md +175 -175
  179. package/examples/extensions/subagent/agents/planner.md +37 -37
  180. package/examples/extensions/subagent/agents/reviewer.md +35 -35
  181. package/examples/extensions/subagent/agents/scout.md +50 -50
  182. package/examples/extensions/subagent/agents/worker.md +24 -24
  183. package/examples/extensions/subagent/agents.ts +126 -126
  184. package/examples/extensions/subagent/index.ts +1015 -1015
  185. package/examples/extensions/subagent/prompts/implement-and-review.md +10 -10
  186. package/examples/extensions/subagent/prompts/implement.md +10 -10
  187. package/examples/extensions/subagent/prompts/scout-and-plan.md +9 -9
  188. package/examples/extensions/summarize.ts +209 -209
  189. package/examples/extensions/system-prompt-header.ts +17 -17
  190. package/examples/extensions/tic-tac-toe.ts +1008 -1008
  191. package/examples/extensions/timed-confirm.ts +70 -70
  192. package/examples/extensions/titlebar-spinner.ts +58 -58
  193. package/examples/extensions/todo.ts +297 -297
  194. package/examples/extensions/tool-override.ts +144 -144
  195. package/examples/extensions/tools.ts +146 -146
  196. package/examples/extensions/trigger-compact.ts +50 -50
  197. package/examples/extensions/truncated-tool.ts +195 -195
  198. package/examples/extensions/widget-placement.ts +9 -9
  199. package/examples/extensions/with-deps/index.ts +32 -32
  200. package/examples/extensions/with-deps/package-lock.json +31 -31
  201. package/examples/extensions/with-deps/package.json +22 -22
  202. package/examples/extensions/working-indicator.ts +123 -123
  203. package/examples/extensions/working-message-test.ts +25 -25
  204. package/examples/rpc-extension-ui.ts +632 -632
  205. package/examples/sdk/01-minimal.ts +26 -26
  206. package/examples/sdk/02-custom-model.ts +53 -53
  207. package/examples/sdk/03-custom-prompt.ts +75 -75
  208. package/examples/sdk/04-skills.ts +55 -55
  209. package/examples/sdk/05-tools.ts +48 -48
  210. package/examples/sdk/06-extensions.ts +99 -99
  211. package/examples/sdk/07-context-files.ts +47 -47
  212. package/examples/sdk/08-prompt-templates.ts +51 -51
  213. package/examples/sdk/09-api-keys-and-oauth.ts +52 -52
  214. package/examples/sdk/10-settings.ts +53 -53
  215. package/examples/sdk/11-sessions.ts +52 -52
  216. package/examples/sdk/12-full-control.ts +79 -79
  217. package/examples/sdk/13-session-runtime.ts +67 -67
  218. package/examples/sdk/README.md +144 -144
  219. package/package.json +3 -2
  220. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/bun/cli.d.ts +0 -3
  221. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/bun/register-bedrock.d.ts +0 -2
  222. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/bun/restore-sandbox-env.d.ts +0 -17
  223. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/args.d.ts +0 -57
  224. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/config-selector.d.ts +0 -16
  225. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/file-processor.d.ts +0 -15
  226. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/initial-message.d.ts +0 -18
  227. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/list-models.d.ts +0 -9
  228. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/project-trust.d.ts +0 -10
  229. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/session-picker.d.ts +0 -10
  230. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/startup-ui.d.ts +0 -20
  231. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli.d.ts +0 -3
  232. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/config.d.ts +0 -96
  233. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/agent-session-runtime.d.ts +0 -119
  234. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/agent-session-services.d.ts +0 -85
  235. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/agent-session.d.ts +0 -620
  236. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/auth-guidance.d.ts +0 -5
  237. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/auth-storage.d.ts +0 -56
  238. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/bash-executor.d.ts +0 -32
  239. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/cache-stats.d.ts +0 -49
  240. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/compaction/branch-summarization.d.ts +0 -93
  241. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/compaction/compaction.d.ts +0 -128
  242. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/compaction/index.d.ts +0 -7
  243. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/compaction/utils.d.ts +0 -38
  244. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/defaults.d.ts +0 -3
  245. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/diagnostics.d.ts +0 -15
  246. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/event-bus.d.ts +0 -9
  247. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/exec.d.ts +0 -29
  248. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/experimental.d.ts +0 -2
  249. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/export-html/ansi-to-html.d.ts +0 -22
  250. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/export-html/index.d.ts +0 -37
  251. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/export-html/tool-renderer.d.ts +0 -34
  252. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/extensions/index.d.ts +0 -12
  253. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/extensions/loader.d.ts +0 -23
  254. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/extensions/runner.d.ts +0 -171
  255. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/extensions/types.d.ts +0 -1261
  256. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/extensions/wrapper.d.ts +0 -20
  257. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/footer-data-provider.d.ts +0 -54
  258. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/http-dispatcher.d.ts +0 -22
  259. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/index.d.ts +0 -13
  260. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/keybindings.d.ts +0 -358
  261. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/messages.d.ts +0 -77
  262. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/model-config.d.ts +0 -512
  263. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/model-registry.d.ts +0 -43
  264. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/model-resolver.d.ts +0 -121
  265. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/model-runtime.d.ts +0 -82
  266. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/models-store.d.ts +0 -17
  267. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/output-guard.d.ts +0 -7
  268. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/package-manager.d.ts +0 -210
  269. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/project-trust.d.ts +0 -15
  270. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/prompt-templates.d.ts +0 -54
  271. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/provider-attribution.d.ts +0 -4
  272. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/provider-composer.d.ts +0 -55
  273. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/radius.d.ts +0 -2
  274. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/remote-catalog-provider.d.ts +0 -5
  275. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/resolve-config-value.d.ts +0 -30
  276. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/resource-loader.d.ts +0 -206
  277. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/runtime-credentials.d.ts +0 -15
  278. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/sdk.d.ts +0 -106
  279. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/session-cwd.d.ts +0 -19
  280. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/session-manager.d.ts +0 -356
  281. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/settings-manager.d.ts +0 -297
  282. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/skills.d.ts +0 -60
  283. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/slash-commands.d.ts +0 -15
  284. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/source-info.d.ts +0 -18
  285. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/system-prompt.d.ts +0 -28
  286. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/telemetry.d.ts +0 -3
  287. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/timings.d.ts +0 -10
  288. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/bash.d.ts +0 -68
  289. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/edit-diff.d.ts +0 -106
  290. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/edit.d.ts +0 -51
  291. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/file-mutation-queue.d.ts +0 -6
  292. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/find.d.ts +0 -35
  293. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/grep.d.ts +0 -37
  294. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/index.d.ts +0 -40
  295. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/ls.d.ts +0 -37
  296. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/output-accumulator.d.ts +0 -52
  297. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/path-utils.d.ts +0 -10
  298. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/read.d.ts +0 -35
  299. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/render-utils.d.ts +0 -24
  300. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/tool-definition-wrapper.d.ts +0 -14
  301. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/truncate.d.ts +0 -70
  302. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/tools/write.d.ts +0 -26
  303. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/trust-manager.d.ts +0 -36
  304. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/core/usage-totals.d.ts +0 -19
  305. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/extensions/index.d.ts +0 -3
  306. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/extensions/llama/client.d.ts +0 -61
  307. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/extensions/llama/huggingface.d.ts +0 -23
  308. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/extensions/llama/index.d.ts +0 -3
  309. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/extensions/llama/provider.d.ts +0 -10
  310. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/extensions/llama/ui.d.ts +0 -42
  311. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/index.d.ts +0 -35
  312. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/main.d.ts +0 -12
  313. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/migrations.d.ts +0 -33
  314. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/index.d.ts +0 -9
  315. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/armin.d.ts +0 -34
  316. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/assistant-message.d.ts +0 -22
  317. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/bash-execution.d.ts +0 -34
  318. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/bordered-loader.d.ts +0 -16
  319. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/branch-summary-message.d.ts +0 -16
  320. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/compaction-summary-message.d.ts +0 -16
  321. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/config-selector.d.ts +0 -102
  322. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/countdown-timer.d.ts +0 -14
  323. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/custom-editor.d.ts +0 -21
  324. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/custom-entry.d.ts +0 -19
  325. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/custom-message.d.ts +0 -20
  326. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/daxnuts.d.ts +0 -23
  327. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/diff.d.ts +0 -12
  328. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/dynamic-border.d.ts +0 -15
  329. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/earendil-announcement.d.ts +0 -5
  330. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/extension-editor.d.ts +0 -22
  331. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/extension-input.d.ts +0 -23
  332. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/extension-selector.d.ts +0 -26
  333. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/first-time-setup.d.ts +0 -25
  334. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/footer.d.ts +0 -32
  335. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/index.d.ts +0 -34
  336. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/keybinding-hints.d.ts +0 -13
  337. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/login-dialog.d.ts +0 -52
  338. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/model-selector.d.ts +0 -54
  339. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/oauth-selector.d.ts +0 -33
  340. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/scoped-models-selector.d.ts +0 -42
  341. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/session-selector-search.d.ts +0 -23
  342. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/session-selector.d.ts +0 -95
  343. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/settings-selector.d.ts +0 -77
  344. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/show-images-selector.d.ts +0 -10
  345. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/skill-invocation-message.d.ts +0 -17
  346. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/status-indicator.d.ts +0 -28
  347. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/theme-selector.d.ts +0 -11
  348. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/thinking-selector.d.ts +0 -11
  349. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/tool-execution.d.ts +0 -63
  350. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/tree-selector.d.ts +0 -94
  351. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/trust-selector.d.ts +0 -23
  352. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/user-message-selector.d.ts +0 -30
  353. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/user-message.d.ts +0 -14
  354. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/components/visual-truncate.d.ts +0 -24
  355. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/interactive-mode.d.ts +0 -394
  356. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/model-search.d.ts +0 -12
  357. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/theme/theme-controller.d.ts +0 -29
  358. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/interactive/theme/theme.d.ts +0 -120
  359. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/print-mode.d.ts +0 -28
  360. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/rpc/jsonl.d.ts +0 -17
  361. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/rpc/rpc-client.d.ts +0 -246
  362. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/rpc/rpc-mode.d.ts +0 -20
  363. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/modes/rpc/rpc-types.d.ts +0 -457
  364. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/package-manager-cli.d.ts +0 -8
  365. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/rpc-entry.d.ts +0 -3
  366. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/ansi.d.ts +0 -2
  367. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/changelog.d.ts +0 -22
  368. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/child-process.d.ts +0 -18
  369. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/clipboard-image.d.ts +0 -11
  370. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/clipboard-native.d.ts +0 -11
  371. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/clipboard.d.ts +0 -4
  372. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/deprecation.d.ts +0 -4
  373. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/exif-orientation.d.ts +0 -5
  374. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/frontmatter.d.ts +0 -8
  375. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/fs-watch.d.ts +0 -5
  376. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/git.d.ts +0 -26
  377. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/html.d.ts +0 -7
  378. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-convert.d.ts +0 -10
  379. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-process.d.ts +0 -18
  380. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-resize-core.d.ts +0 -30
  381. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-resize-worker.d.ts +0 -2
  382. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/image-resize.d.ts +0 -16
  383. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/json.d.ts +0 -3
  384. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/mime.d.ts +0 -3
  385. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/open-browser.d.ts +0 -9
  386. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/paths.d.ts +0 -31
  387. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/photon.d.ts +0 -21
  388. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/pi-user-agent.d.ts +0 -2
  389. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/shell.d.ts +0 -31
  390. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/sleep.d.ts +0 -5
  391. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/syntax-highlight.d.ts +0 -12
  392. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/tools-manager.d.ts +0 -3
  393. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/version-check.d.ts +0 -15
  394. package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/utils/windows-self-update.d.ts +0 -3
@@ -1,144 +1,144 @@
1
- # SDK Examples
2
-
3
- Programmatic usage of pi-coding-agent via `createAgentSession()` and `createAgentSessionRuntime()`.
4
-
5
- The runtime example shows how to build a recreate function that closes over process-global fixed inputs and recreates cwd-bound services and sessions as the active session cwd changes.
6
-
7
- ## Examples
8
-
9
- | File | Description |
10
- |------|-------------|
11
- | `01-minimal.ts` | Simplest usage with all defaults |
12
- | `02-custom-model.ts` | Select model and thinking level |
13
- | `03-custom-prompt.ts` | Replace or modify system prompt |
14
- | `04-skills.ts` | Discover, filter, or replace skills |
15
- | `05-tools.ts` | Built-in tool allowlists |
16
- | `06-extensions.ts` | Logging, blocking, result modification |
17
- | `07-context-files.ts` | AGENTS.md context files |
18
- | `08-slash-commands.ts` | File-based slash commands |
19
- | `09-api-keys-and-oauth.ts` | API key resolution, OAuth config |
20
- | `10-settings.ts` | Override compaction, retry, terminal settings |
21
- | `11-sessions.ts` | In-memory, persistent, continue, list sessions |
22
- | `12-full-control.ts` | Replace everything, no discovery |
23
- | `13-session-runtime.ts` | Manage runtime-backed session replacement |
24
-
25
- ## Running
26
-
27
- ```bash
28
- cd packages/coding-agent
29
- npx tsx examples/sdk/01-minimal.ts
30
- ```
31
-
32
- ## Quick Reference
33
-
34
- ```typescript
35
- import { getModel } from "@earendil-works/pi-ai";
36
- import {
37
- AuthStorage,
38
- createAgentSession,
39
- DefaultResourceLoader,
40
- ModelRegistry,
41
- SessionManager,
42
- SettingsManager,
43
- } from "@earendil-works/pi-coding-agent";
44
-
45
- // Auth and models setup
46
- const authStorage = AuthStorage.create();
47
- const modelRegistry = ModelRegistry.create(authStorage);
48
-
49
- // Minimal
50
- const { session } = await createAgentSession({ authStorage, modelRegistry });
51
-
52
- // Custom model
53
- const model = getModel("anthropic", "claude-opus-4-5");
54
- const { session } = await createAgentSession({ model, thinkingLevel: "high", authStorage, modelRegistry });
55
-
56
- // Modify prompt
57
- const loader = new DefaultResourceLoader({
58
- systemPromptOverride: (base) => `${base}\n\nBe concise.`,
59
- });
60
- await loader.reload();
61
- const { session } = await createAgentSession({ resourceLoader: loader, authStorage, modelRegistry });
62
-
63
- // Read-only
64
- const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], authStorage, modelRegistry });
65
-
66
- // In-memory
67
- const { session } = await createAgentSession({
68
- sessionManager: SessionManager.inMemory(),
69
- authStorage,
70
- modelRegistry,
71
- });
72
-
73
- // Full control
74
- const customAuth = AuthStorage.create("/my/app/auth.json");
75
- customAuth.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
76
- const customRegistry = ModelRegistry.create(customAuth);
77
-
78
- const resourceLoader = new DefaultResourceLoader({
79
- systemPromptOverride: () => "You are helpful.",
80
- extensionFactories: [myExtension],
81
- skillsOverride: () => ({ skills: [], diagnostics: [] }),
82
- agentsFilesOverride: () => ({ agentsFiles: [] }),
83
- promptsOverride: () => ({ prompts: [], diagnostics: [] }),
84
- });
85
- await resourceLoader.reload();
86
-
87
- const { session } = await createAgentSession({
88
- model,
89
- authStorage: customAuth,
90
- modelRegistry: customRegistry,
91
- resourceLoader,
92
- tools: ["read", "bash", "my_tool"],
93
- customTools: [myTool],
94
- sessionManager: SessionManager.inMemory(),
95
- settingsManager: SettingsManager.inMemory(),
96
- });
97
-
98
- // Run prompts
99
- session.subscribe((event) => {
100
- if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
101
- process.stdout.write(event.assistantMessageEvent.delta);
102
- }
103
- });
104
- await session.prompt("Hello");
105
- ```
106
-
107
- ## Options
108
-
109
- | Option | Default | Description |
110
- |--------|---------|-------------|
111
- | `authStorage` | `AuthStorage.create()` | Credential storage |
112
- | `modelRegistry` | `ModelRegistry.create(authStorage)` | Model registry |
113
- | `cwd` | `process.cwd()` | Working directory |
114
- | `agentDir` | `~/.pi/agent` | Config directory |
115
- | `model` | From settings/first available | Model to use |
116
- | `thinkingLevel` | From settings/"off" | off, low, medium, high |
117
- | `tools` | `["read", "bash", "edit", "write"]` built-ins | Allowlist tool names across built-in, extension, and custom tools |
118
- | `customTools` | `[]` | Additional tool definitions |
119
- | `resourceLoader` | DefaultResourceLoader | Resource loader for extensions, skills, prompts, themes |
120
- | `sessionManager` | `SessionManager.create(cwd)` | Persistence |
121
- | `settingsManager` | `SettingsManager.create(cwd, agentDir)` | Settings overrides |
122
-
123
- ## Events
124
-
125
- ```typescript
126
- session.subscribe((event) => {
127
- switch (event.type) {
128
- case "message_update":
129
- if (event.assistantMessageEvent.type === "text_delta") {
130
- process.stdout.write(event.assistantMessageEvent.delta);
131
- }
132
- break;
133
- case "tool_execution_start":
134
- console.log(`Tool: ${event.toolName}`);
135
- break;
136
- case "tool_execution_end":
137
- console.log(`Result: ${event.result}`);
138
- break;
139
- case "agent_end":
140
- console.log("Done");
141
- break;
142
- }
143
- });
144
- ```
1
+ # SDK Examples
2
+
3
+ Programmatic usage of pi-coding-agent via `createAgentSession()` and `createAgentSessionRuntime()`.
4
+
5
+ The runtime example shows how to build a recreate function that closes over process-global fixed inputs and recreates cwd-bound services and sessions as the active session cwd changes.
6
+
7
+ ## Examples
8
+
9
+ | File | Description |
10
+ |------|-------------|
11
+ | `01-minimal.ts` | Simplest usage with all defaults |
12
+ | `02-custom-model.ts` | Select model and thinking level |
13
+ | `03-custom-prompt.ts` | Replace or modify system prompt |
14
+ | `04-skills.ts` | Discover, filter, or replace skills |
15
+ | `05-tools.ts` | Built-in tool allowlists |
16
+ | `06-extensions.ts` | Logging, blocking, result modification |
17
+ | `07-context-files.ts` | AGENTS.md context files |
18
+ | `08-slash-commands.ts` | File-based slash commands |
19
+ | `09-api-keys-and-oauth.ts` | API key resolution, OAuth config |
20
+ | `10-settings.ts` | Override compaction, retry, terminal settings |
21
+ | `11-sessions.ts` | In-memory, persistent, continue, list sessions |
22
+ | `12-full-control.ts` | Replace everything, no discovery |
23
+ | `13-session-runtime.ts` | Manage runtime-backed session replacement |
24
+
25
+ ## Running
26
+
27
+ ```bash
28
+ cd packages/coding-agent
29
+ npx tsx examples/sdk/01-minimal.ts
30
+ ```
31
+
32
+ ## Quick Reference
33
+
34
+ ```typescript
35
+ import { getModel } from "@earendil-works/pi-ai";
36
+ import {
37
+ AuthStorage,
38
+ createAgentSession,
39
+ DefaultResourceLoader,
40
+ ModelRegistry,
41
+ SessionManager,
42
+ SettingsManager,
43
+ } from "@earendil-works/pi-coding-agent";
44
+
45
+ // Auth and models setup
46
+ const authStorage = AuthStorage.create();
47
+ const modelRegistry = ModelRegistry.create(authStorage);
48
+
49
+ // Minimal
50
+ const { session } = await createAgentSession({ authStorage, modelRegistry });
51
+
52
+ // Custom model
53
+ const model = getModel("anthropic", "claude-opus-4-5");
54
+ const { session } = await createAgentSession({ model, thinkingLevel: "high", authStorage, modelRegistry });
55
+
56
+ // Modify prompt
57
+ const loader = new DefaultResourceLoader({
58
+ systemPromptOverride: (base) => `${base}\n\nBe concise.`,
59
+ });
60
+ await loader.reload();
61
+ const { session } = await createAgentSession({ resourceLoader: loader, authStorage, modelRegistry });
62
+
63
+ // Read-only
64
+ const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], authStorage, modelRegistry });
65
+
66
+ // In-memory
67
+ const { session } = await createAgentSession({
68
+ sessionManager: SessionManager.inMemory(),
69
+ authStorage,
70
+ modelRegistry,
71
+ });
72
+
73
+ // Full control
74
+ const customAuth = AuthStorage.create("/my/app/auth.json");
75
+ customAuth.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
76
+ const customRegistry = ModelRegistry.create(customAuth);
77
+
78
+ const resourceLoader = new DefaultResourceLoader({
79
+ systemPromptOverride: () => "You are helpful.",
80
+ extensionFactories: [myExtension],
81
+ skillsOverride: () => ({ skills: [], diagnostics: [] }),
82
+ agentsFilesOverride: () => ({ agentsFiles: [] }),
83
+ promptsOverride: () => ({ prompts: [], diagnostics: [] }),
84
+ });
85
+ await resourceLoader.reload();
86
+
87
+ const { session } = await createAgentSession({
88
+ model,
89
+ authStorage: customAuth,
90
+ modelRegistry: customRegistry,
91
+ resourceLoader,
92
+ tools: ["read", "bash", "my_tool"],
93
+ customTools: [myTool],
94
+ sessionManager: SessionManager.inMemory(),
95
+ settingsManager: SettingsManager.inMemory(),
96
+ });
97
+
98
+ // Run prompts
99
+ session.subscribe((event) => {
100
+ if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
101
+ process.stdout.write(event.assistantMessageEvent.delta);
102
+ }
103
+ });
104
+ await session.prompt("Hello");
105
+ ```
106
+
107
+ ## Options
108
+
109
+ | Option | Default | Description |
110
+ |--------|---------|-------------|
111
+ | `authStorage` | `AuthStorage.create()` | Credential storage |
112
+ | `modelRegistry` | `ModelRegistry.create(authStorage)` | Model registry |
113
+ | `cwd` | `process.cwd()` | Working directory |
114
+ | `agentDir` | `~/.pi/agent` | Config directory |
115
+ | `model` | From settings/first available | Model to use |
116
+ | `thinkingLevel` | From settings/"off" | off, low, medium, high |
117
+ | `tools` | `["read", "bash", "edit", "write"]` built-ins | Allowlist tool names across built-in, extension, and custom tools |
118
+ | `customTools` | `[]` | Additional tool definitions |
119
+ | `resourceLoader` | DefaultResourceLoader | Resource loader for extensions, skills, prompts, themes |
120
+ | `sessionManager` | `SessionManager.create(cwd)` | Persistence |
121
+ | `settingsManager` | `SettingsManager.create(cwd, agentDir)` | Settings overrides |
122
+
123
+ ## Events
124
+
125
+ ```typescript
126
+ session.subscribe((event) => {
127
+ switch (event.type) {
128
+ case "message_update":
129
+ if (event.assistantMessageEvent.type === "text_delta") {
130
+ process.stdout.write(event.assistantMessageEvent.delta);
131
+ }
132
+ break;
133
+ case "tool_execution_start":
134
+ console.log(`Tool: ${event.toolName}`);
135
+ break;
136
+ case "tool_execution_end":
137
+ console.log(`Result: ${event.result}`);
138
+ break;
139
+ case "agent_end":
140
+ console.log("Done");
141
+ break;
142
+ }
143
+ });
144
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@selesai/code",
3
- "version": "0.13.4",
3
+ "version": "0.13.5",
4
4
  "description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
5
5
  "type": "module",
6
6
  "repository": {
@@ -59,13 +59,13 @@
59
59
  "copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/ && shx mkdir -p dist/defaults && shx cp src/defaults/* dist/defaults/ && shx mkdir -p dist/extensions && node scripts/copy-extensions.mjs && shx mkdir -p dist/themes && shx cp -r src/themes/. dist/themes/ && shx mkdir -p dist/skills && shx cp -r src/skills/. dist/skills/"
60
60
  },
61
61
  "dependencies": {
62
- "acorn": "8.18.0",
63
62
  "@ast-grep/cli": "0.45.0",
64
63
  "@earendil-works/pi-agent-core": "0.84.4",
65
64
  "@earendil-works/pi-ai": "0.84.4",
66
65
  "@earendil-works/pi-tui": "0.84.4",
67
66
  "@mozilla/readability": "^0.6.0",
68
67
  "@silvia-odwyer/photon-node": "0.3.4",
68
+ "acorn": "8.18.0",
69
69
  "better-sqlite3": "^13.0.3",
70
70
  "chalk": "5.6.2",
71
71
  "cheerio": "^1.1.0",
@@ -85,6 +85,7 @@
85
85
  "tsx": "^4.20.0",
86
86
  "typebox": "1.3.7",
87
87
  "undici": "8.9.0",
88
+ "unpdf": "^1.8.1",
88
89
  "yaml": "2.9.0"
89
90
  },
90
91
  "devDependencies": {
@@ -1,3 +0,0 @@
1
- #!/usr/bin/env node
2
- export {};
3
- //# sourceMappingURL=cli.d.ts.map
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=register-bedrock.d.ts.map
@@ -1,17 +0,0 @@
1
- /**
2
- * Workaround for https://github.com/oven-sh/bun/issues/27802
3
- *
4
- * Bun compiled binaries have an empty `process.env` when running inside
5
- * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover
6
- * the environment from `/proc/self/environ`.
7
- *
8
- * Keep this in sync with getBunSandboxEnvValue() in
9
- * packages/ai/src/utils/provider-env.ts. The ai package duplicates the lookup
10
- * for direct consumers that do not go through this coding-agent entrypoint.
11
- */
12
- /**
13
- * Restore environment variables from `/proc/self/environ` when running
14
- * inside a sandbox where Bun's `process.env` is empty.
15
- */
16
- export declare function restoreSandboxEnv(): void;
17
- //# sourceMappingURL=restore-sandbox-env.d.ts.map
@@ -1,57 +0,0 @@
1
- /**
2
- * CLI argument parsing and help display
3
- */
4
- import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
5
- import type { ExtensionFlag } from "../core/extensions/types.ts";
6
- export type Mode = "text" | "json" | "rpc";
7
- export interface Args {
8
- provider?: string;
9
- model?: string;
10
- apiKey?: string;
11
- systemPrompt?: string;
12
- appendSystemPrompt?: string[];
13
- thinking?: ThinkingLevel;
14
- continue?: boolean;
15
- resume?: boolean;
16
- help?: boolean;
17
- version?: boolean;
18
- mode?: Mode;
19
- name?: string;
20
- noSession?: boolean;
21
- session?: string;
22
- sessionId?: string;
23
- fork?: string;
24
- sessionDir?: string;
25
- models?: string[];
26
- tools?: string[];
27
- excludeTools?: string[];
28
- noTools?: boolean;
29
- noBuiltinTools?: boolean;
30
- extensions?: string[];
31
- noExtensions?: boolean;
32
- print?: boolean;
33
- export?: string;
34
- noSkills?: boolean;
35
- skills?: string[];
36
- promptTemplates?: string[];
37
- noPromptTemplates?: boolean;
38
- themes?: string[];
39
- noThemes?: boolean;
40
- noContextFiles?: boolean;
41
- listModels?: string | true;
42
- offline?: boolean;
43
- verbose?: boolean;
44
- projectTrustOverride?: boolean;
45
- messages: string[];
46
- fileArgs: string[];
47
- /** Unknown flags (potentially extension flags) - map of flag name to value */
48
- unknownFlags: Map<string, boolean | string>;
49
- diagnostics: Array<{
50
- type: "warning" | "error";
51
- message: string;
52
- }>;
53
- }
54
- export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
55
- export declare function parseArgs(args: string[]): Args;
56
- export declare function printHelp(extensionFlags?: ExtensionFlag[]): void;
57
- //# sourceMappingURL=args.d.ts.map
@@ -1,16 +0,0 @@
1
- /**
2
- * TUI config selector for `pi config` command
3
- */
4
- import type { SettingsManager } from "../core/settings-manager.ts";
5
- import { type ScopedResolvedPaths } from "../modes/interactive/components/config-selector.ts";
6
- export interface ConfigSelectorOptions {
7
- resolvedPaths: ScopedResolvedPaths;
8
- settingsManager: SettingsManager;
9
- cwd: string;
10
- agentDir: string;
11
- writeScope: "global" | "project";
12
- projectModeAvailable: boolean;
13
- }
14
- /** Show TUI config selector and return when closed */
15
- export declare function selectConfig(options: ConfigSelectorOptions): Promise<void>;
16
- //# sourceMappingURL=config-selector.d.ts.map
@@ -1,15 +0,0 @@
1
- /**
2
- * Process @file CLI arguments into text content and image attachments
3
- */
4
- import type { ImageContent } from "@earendil-works/pi-ai";
5
- export interface ProcessedFiles {
6
- text: string;
7
- images: ImageContent[];
8
- }
9
- export interface ProcessFileOptions {
10
- /** Whether to auto-resize images to 2000x2000 max. Default: true */
11
- autoResizeImages?: boolean;
12
- }
13
- /** Process @file arguments into text content and image attachments */
14
- export declare function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles>;
15
- //# sourceMappingURL=file-processor.d.ts.map
@@ -1,18 +0,0 @@
1
- import type { ImageContent } from "@earendil-works/pi-ai";
2
- import type { Args } from "./args.ts";
3
- export interface InitialMessageInput {
4
- parsed: Args;
5
- fileText?: string;
6
- fileImages?: ImageContent[];
7
- stdinContent?: string;
8
- }
9
- export interface InitialMessageResult {
10
- initialMessage?: string;
11
- initialImages?: ImageContent[];
12
- }
13
- /**
14
- * Combine stdin content, @file text, and the first CLI message into a single
15
- * initial prompt for non-interactive mode.
16
- */
17
- export declare function buildInitialMessage({ parsed, fileText, fileImages, stdinContent }: InitialMessageInput): InitialMessageResult;
18
- //# sourceMappingURL=initial-message.d.ts.map
@@ -1,9 +0,0 @@
1
- /**
2
- * List available models with optional fuzzy search
3
- */
4
- import type { ModelRuntime } from "../core/model-runtime.ts";
5
- /**
6
- * List available models, optionally filtered by search pattern
7
- */
8
- export declare function listModels(modelRuntime: ModelRuntime, searchPattern?: string): Promise<void>;
9
- //# sourceMappingURL=list-models.d.ts.map
@@ -1,10 +0,0 @@
1
- import type { ProjectTrustContext } from "../core/extensions/types.ts";
2
- import type { AppMode } from "../core/project-trust.ts";
3
- import type { SettingsManager } from "../core/settings-manager.ts";
4
- export declare function createProjectTrustContext(options: {
5
- cwd: string;
6
- mode: AppMode;
7
- settingsManager: SettingsManager;
8
- hasUI: boolean;
9
- }): ProjectTrustContext;
10
- //# sourceMappingURL=project-trust.d.ts.map
@@ -1,10 +0,0 @@
1
- /**
2
- * TUI session selector for --resume flag
3
- */
4
- import type { SessionInfo, SessionListProgress } from "../core/session-manager.ts";
5
- import type { SettingsManager } from "../core/settings-manager.ts";
6
- type SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;
7
- /** Show TUI session selector and return selected session path or null if cancelled */
8
- export declare function selectSession(currentSessionsLoader: SessionsLoader, allSessionsLoader: SessionsLoader, settingsManager: SettingsManager): Promise<string | null>;
9
- export {};
10
- //# sourceMappingURL=session-picker.d.ts.map
@@ -1,20 +0,0 @@
1
- import { TUI } from "@earendil-works/pi-tui";
2
- import { SettingsManager } from "../core/settings-manager.ts";
3
- export declare function createStartupTui(settingsManager: SettingsManager): Promise<TUI>;
4
- export declare function startStartupTui(ui: TUI, settingsManager: SettingsManager): void;
5
- /**
6
- * First-time setup runs when all of these hold:
7
- * - this is the official Pi distribution (not a fork/rebrand)
8
- * - experimental features are enabled (PI_EXPERIMENTAL=1)
9
- * - the default agent directory is used (no custom agent dir override)
10
- * - setup was not completed before (settings.json does not exist)
11
- */
12
- export declare function shouldRunFirstTimeSetup(settingsPath?: string): boolean;
13
- export declare function showStartupSelector<T>(settingsManager: SettingsManager, title: string, options: Array<{
14
- label: string;
15
- value: T;
16
- }>): Promise<T | undefined>;
17
- /** Show the first-time setup dialog and persist the result */
18
- export declare function showFirstTimeSetup(settingsManager: SettingsManager): Promise<void>;
19
- export declare function showStartupInput(settingsManager: SettingsManager, title: string, placeholder?: string): Promise<string | undefined>;
20
- //# sourceMappingURL=startup-ui.d.ts.map
@@ -1,3 +0,0 @@
1
- #!/usr/bin/env node
2
- export {};
3
- //# sourceMappingURL=cli.d.ts.map
@@ -1,96 +0,0 @@
1
- /**
2
- * Detect if we're running as a Bun compiled binary.
3
- * Bun binaries have import.meta.url containing "$bunfs", "~BUN", or "%7EBUN" (Bun's virtual filesystem path)
4
- */
5
- export declare const isBunBinary: boolean;
6
- /** Detect if Bun is the runtime (compiled binary or bun run) */
7
- export declare const isBunRuntime: boolean;
8
- export type InstallMethod = "bun-binary" | "npm" | "pnpm" | "yarn" | "bun" | "unknown";
9
- interface SelfUpdateCommandStep {
10
- command: string;
11
- args: string[];
12
- display: string;
13
- }
14
- export interface SelfUpdateCommand extends SelfUpdateCommandStep {
15
- steps?: SelfUpdateCommandStep[];
16
- }
17
- export type SelfUpdatePackageTarget = string | {
18
- packageName: string;
19
- installSpec?: string;
20
- };
21
- export declare function detectInstallMethod(): InstallMethod;
22
- export declare function getSelfUpdateCommand(packageName: string, npmCommand?: string[], updatePackageTarget?: SelfUpdatePackageTarget): SelfUpdateCommand | undefined;
23
- export declare function getSelfUpdateUnavailableInstruction(packageName: string, npmCommand?: string[], updatePackageTarget?: SelfUpdatePackageTarget): string;
24
- export declare function getUpdateInstruction(packageName: string): string;
25
- /**
26
- * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
27
- * - For Bun binary: returns the directory containing the executable
28
- * - For Node.js (dist/): returns __dirname (the dist/ directory)
29
- * - For tsx (src/): returns parent directory (the package root)
30
- */
31
- export declare function getPackageDir(): string;
32
- /**
33
- * Get path to built-in themes directory (shipped with package)
34
- * - For Bun binary: theme/ next to executable
35
- * - For Node.js (dist/): dist/modes/interactive/theme/
36
- * - For tsx (src/): src/modes/interactive/theme/
37
- */
38
- export declare function getThemesDir(): string;
39
- /**
40
- * Get path to HTML export template directory (shipped with package)
41
- * - For Bun binary: export-html/ next to executable
42
- * - For Node.js (dist/): dist/core/export-html/
43
- * - For tsx (src/): src/core/export-html/
44
- */
45
- export declare function getExportTemplateDir(): string;
46
- /** Get path to package.json */
47
- export declare function getPackageJsonPath(): string;
48
- /** Get path to README.md */
49
- export declare function getReadmePath(): string;
50
- /** Get path to docs directory */
51
- export declare function getDocsPath(): string;
52
- /** Get path to examples directory */
53
- export declare function getExamplesPath(): string;
54
- /** Get path to CHANGELOG.md */
55
- export declare function getChangelogPath(): string;
56
- /**
57
- * Get path to built-in interactive assets directory.
58
- * - For Bun binary: assets/ next to executable
59
- * - For Node.js (dist/): dist/modes/interactive/assets/
60
- * - For tsx (src/): src/modes/interactive/assets/
61
- */
62
- export declare function getInteractiveAssetsDir(): string;
63
- /** Get path to a bundled interactive asset */
64
- export declare function getBundledInteractiveAssetPath(name: string): string;
65
- export declare const PACKAGE_NAME: string;
66
- export declare const APP_NAME: string;
67
- export declare const APP_TITLE: string;
68
- export declare const CONFIG_DIR_NAME: string;
69
- export declare const VERSION: string;
70
- export declare const ENV_AGENT_DIR: string;
71
- export declare const ENV_SESSION_DIR: string;
72
- export declare function expandTildePath(path: string): string;
73
- /** Get the share viewer URL for a gist ID */
74
- export declare function getShareViewerUrl(gistId: string): string;
75
- /** Get the agent config directory (e.g., ~/.selesai/agent/) */
76
- export declare function getAgentDir(): string;
77
- /** Get path to user's custom themes directory */
78
- export declare function getCustomThemesDir(): string;
79
- /** Get path to models.json */
80
- export declare function getModelsPath(): string;
81
- /** Get path to auth.json */
82
- export declare function getAuthPath(): string;
83
- /** Get path to settings.json */
84
- export declare function getSettingsPath(): string;
85
- /** Get path to tools directory */
86
- export declare function getToolsDir(): string;
87
- /** Get path to managed binaries directory (fd, rg) */
88
- export declare function getBinDir(): string;
89
- /** Get path to prompt templates directory */
90
- export declare function getPromptsDir(): string;
91
- /** Get path to sessions directory */
92
- export declare function getSessionsDir(): string;
93
- /** Get path to debug log file */
94
- export declare function getDebugLogPath(): string;
95
- export {};
96
- //# sourceMappingURL=config.d.ts.map