@schlenkr/ragents 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (788) hide show
  1. package/LICENSE +166 -0
  2. package/README.md +88 -0
  3. package/apps/server/agent-home/settings.json +3 -0
  4. package/apps/server/package.json +29 -0
  5. package/apps/server/src/access-projection.ts +97 -0
  6. package/apps/server/src/access-service.ts +22 -0
  7. package/apps/server/src/access-session.ts +204 -0
  8. package/apps/server/src/api/contracts.ts +203 -0
  9. package/apps/server/src/api/core-methods.ts +163 -0
  10. package/apps/server/src/api/delivery.ts +40 -0
  11. package/apps/server/src/api/reference.ts +146 -0
  12. package/apps/server/src/api/rights.ts +26 -0
  13. package/apps/server/src/chat-attachments.ts +52 -0
  14. package/apps/server/src/chat-context.ts +6 -0
  15. package/apps/server/src/chat-events.ts +185 -0
  16. package/apps/server/src/chat-handler.ts +37 -0
  17. package/apps/server/src/config-definition.ts +80 -0
  18. package/apps/server/src/config-file.ts +324 -0
  19. package/apps/server/src/config.ts +46 -0
  20. package/apps/server/src/data-directory.ts +42 -0
  21. package/apps/server/src/external-access.ts +40 -0
  22. package/apps/server/src/help-files.ts +63 -0
  23. package/apps/server/src/host-resolution-hooks.mjs +31 -0
  24. package/apps/server/src/host-resolution.ts +3 -0
  25. package/apps/server/src/host-version.ts +74 -0
  26. package/apps/server/src/layout.ts +36 -0
  27. package/apps/server/src/main.ts +54 -0
  28. package/apps/server/src/plugin-support/actor-programs/capability-resolver.ts +107 -0
  29. package/apps/server/src/plugin-support/actor-programs/limits.ts +33 -0
  30. package/apps/server/src/plugin-support/actor-programs/operations.ts +19 -0
  31. package/apps/server/src/plugin-support/actor-programs/service.ts +16 -0
  32. package/apps/server/src/plugin-support/agent-tool.ts +60 -0
  33. package/apps/server/src/plugin-support/asset-path.ts +4 -0
  34. package/apps/server/src/plugin-support/await-with-signal.ts +18 -0
  35. package/apps/server/src/plugin-support/chat-display-contract.ts +7 -0
  36. package/apps/server/src/plugin-support/chat-display-policy.ts +55 -0
  37. package/apps/server/src/plugin-support/front-matter.ts +44 -0
  38. package/apps/server/src/plugin-support/http.ts +93 -0
  39. package/apps/server/src/plugin-support/language-server/contract.ts +18 -0
  40. package/apps/server/src/plugin-support/language-server/plugin.ts +32 -0
  41. package/apps/server/src/plugin-support/language-server/snapshot-method.ts +17 -0
  42. package/apps/server/src/plugin-support/language-server/tools.ts +73 -0
  43. package/apps/server/src/plugin-support/model-choice.ts +109 -0
  44. package/apps/server/src/plugin-support/model-upstreams.ts +12 -0
  45. package/apps/server/src/plugin-support/native-typescript-child.ts +78 -0
  46. package/apps/server/src/plugin-support/native-typescript-executor.ts +260 -0
  47. package/apps/server/src/plugin-support/plugin-config.ts +48 -0
  48. package/apps/server/src/plugin-support/plugin-folder.ts +81 -0
  49. package/apps/server/src/plugin-support/plugin-module.ts +14 -0
  50. package/apps/server/src/plugin-support/plugins-root.ts +41 -0
  51. package/apps/server/src/plugin-support/product-model-settings-contract.ts +24 -0
  52. package/apps/server/src/plugin-support/product-model-settings.ts +120 -0
  53. package/apps/server/src/plugin-support/product-start-options.ts +104 -0
  54. package/apps/server/src/plugin-support/prompt.ts +68 -0
  55. package/apps/server/src/plugin-support/provision.ts +85 -0
  56. package/apps/server/src/plugin-support/run-scripts.ts +88 -0
  57. package/apps/server/src/plugin-support/shell-platform.ts +21 -0
  58. package/apps/server/src/plugin-support/skills.ts +97 -0
  59. package/apps/server/src/plugin-support/start-entries-contract.ts +71 -0
  60. package/apps/server/src/plugin-support/start-options-contract.ts +65 -0
  61. package/apps/server/src/plugin-support/system-prompts.ts +138 -0
  62. package/apps/server/src/plugin-support/thinking-level.ts +8 -0
  63. package/apps/server/src/plugin-support/tool-availability.ts +20 -0
  64. package/apps/server/src/plugin-support/workspace-ownership.ts +36 -0
  65. package/apps/server/src/plugin-support/workspace-sandbox-host.ts +213 -0
  66. package/apps/server/src/plugin-support/workspace-tool-naming.ts +11 -0
  67. package/apps/server/src/plugin-support/zip.ts +69 -0
  68. package/apps/server/src/profile/compose.ts +69 -0
  69. package/apps/server/src/profile/plugin-discovery.ts +112 -0
  70. package/apps/server/src/profile/plugin-list.ts +19 -0
  71. package/apps/server/src/profile/provisioning.ts +81 -0
  72. package/apps/server/src/protocol.ts +106 -0
  73. package/apps/server/src/provider.ts +817 -0
  74. package/apps/server/src/ragents/actor-chat-history.ts +111 -0
  75. package/apps/server/src/ragents/chat-projection.ts +55 -0
  76. package/apps/server/src/ragents/chat-text-positions.ts +43 -0
  77. package/apps/server/src/ragents/coordinator.ts +5 -0
  78. package/apps/server/src/ragents/document-store.ts +12 -0
  79. package/apps/server/src/ragents/engine.ts +417 -0
  80. package/apps/server/src/ragents/global-chat.ts +40 -0
  81. package/apps/server/src/ragents/host-services.ts +26 -0
  82. package/apps/server/src/ragents/journal-chat-events.ts +52 -0
  83. package/apps/server/src/ragents/product-runtime.ts +31 -0
  84. package/apps/server/src/ragents/runtime-bridge.ts +7 -0
  85. package/apps/server/src/ragents/session.ts +859 -0
  86. package/apps/server/src/ragents/start-option-state.ts +37 -0
  87. package/apps/server/src/ragents/typescript-tools.ts +182 -0
  88. package/apps/server/src/ragents/workspace-runtime.ts +64 -0
  89. package/apps/server/src/rpc/dispatcher.ts +178 -0
  90. package/apps/server/src/rpc/http-transport.ts +178 -0
  91. package/apps/server/src/rpc/stdio-transport.ts +44 -0
  92. package/apps/server/src/run-preparation-contract.ts +20 -0
  93. package/apps/server/src/run-preparation-input.ts +16 -0
  94. package/apps/server/src/run-preparation.ts +147 -0
  95. package/apps/server/src/run-transfer.ts +264 -0
  96. package/apps/server/src/server.ts +312 -0
  97. package/apps/server/src/settings.ts +209 -0
  98. package/apps/server/src/startup.ts +13 -0
  99. package/apps/server/src/title-compactor.ts +131 -0
  100. package/apps/server/src/title-settings-contract.ts +9 -0
  101. package/apps/server/src/title-settings.ts +67 -0
  102. package/apps/web/package.json +41 -0
  103. package/apps/web/src/AccessContext.tsx +125 -0
  104. package/apps/web/src/App.tsx +315 -0
  105. package/apps/web/src/CanvasShortcuts.tsx +60 -0
  106. package/apps/web/src/DiffCode.tsx +89 -0
  107. package/apps/web/src/HelpDialog.tsx +87 -0
  108. package/apps/web/src/MaterialSettings.tsx +40 -0
  109. package/apps/web/src/Overview.tsx +201 -0
  110. package/apps/web/src/PluginActivation.ts +41 -0
  111. package/apps/web/src/PluginChat.tsx +552 -0
  112. package/apps/web/src/PluginRegistry.tsx +689 -0
  113. package/apps/web/src/RunPreparationChat.tsx +111 -0
  114. package/apps/web/src/RunStore.ts +86 -0
  115. package/apps/web/src/SessionList.tsx +148 -0
  116. package/apps/web/src/SettingsModal.tsx +949 -0
  117. package/apps/web/src/SourceCode.tsx +49 -0
  118. package/apps/web/src/StartOptions.tsx +231 -0
  119. package/apps/web/src/StartSurface.tsx +161 -0
  120. package/apps/web/src/StatusGroup.tsx +18 -0
  121. package/apps/web/src/ThemeSettings.tsx +46 -0
  122. package/apps/web/src/TitleModelSettings.tsx +100 -0
  123. package/apps/web/src/Toolbar.tsx +28 -0
  124. package/apps/web/src/WorkspacePanel.tsx +309 -0
  125. package/apps/web/src/access-session.ts +27 -0
  126. package/apps/web/src/access-token.ts +31 -0
  127. package/apps/web/src/api.ts +368 -0
  128. package/apps/web/src/chat/ChatInputToolbar.tsx +488 -0
  129. package/apps/web/src/chat/ChatMessages.tsx +666 -0
  130. package/apps/web/src/chat/ChatPanel.tsx +61 -0
  131. package/apps/web/src/chat/DetailModeSwitch.tsx +58 -0
  132. package/apps/web/src/chat/Markdown.tsx +104 -0
  133. package/apps/web/src/chat/QuestionCard.tsx +107 -0
  134. package/apps/web/src/chat/StepPopover.tsx +82 -0
  135. package/apps/web/src/chat/WorkingScenes.tsx +235 -0
  136. package/apps/web/src/chat/attachments.ts +53 -0
  137. package/apps/web/src/chat/chat-scroll.ts +41 -0
  138. package/apps/web/src/chat/chat-target.ts +21 -0
  139. package/apps/web/src/chat/requests.ts +23 -0
  140. package/apps/web/src/chat/texts.ts +61 -0
  141. package/apps/web/src/chat/types.ts +26 -0
  142. package/apps/web/src/chat/useAttachmentCapabilities.ts +35 -0
  143. package/apps/web/src/chat/useChat.ts +46 -0
  144. package/apps/web/src/chat/user-location.ts +22 -0
  145. package/apps/web/src/column/ColumnApp.tsx +158 -0
  146. package/apps/web/src/column/ColumnMenu.tsx +37 -0
  147. package/apps/web/src/column/ColumnRunHeader.tsx +43 -0
  148. package/apps/web/src/column/column-location.ts +30 -0
  149. package/apps/web/src/column/host-contract.ts +83 -0
  150. package/apps/web/src/column/host.ts +101 -0
  151. package/apps/web/src/column/use-session-list.ts +42 -0
  152. package/apps/web/src/column.tsx +43 -0
  153. package/apps/web/src/diff-view.css +38 -0
  154. package/apps/web/src/help-samples.ts +11 -0
  155. package/apps/web/src/highlighting.css +74 -0
  156. package/apps/web/src/highlighting.ts +262 -0
  157. package/apps/web/src/lib/format.ts +5 -0
  158. package/apps/web/src/lib/guards.ts +8 -0
  159. package/apps/web/src/lib/http.ts +9 -0
  160. package/apps/web/src/lib/labels.ts +11 -0
  161. package/apps/web/src/lib/local-storage-setting.ts +39 -0
  162. package/apps/web/src/main.tsx +30 -0
  163. package/apps/web/src/material-settings.ts +104 -0
  164. package/apps/web/src/model-settings-events.ts +1 -0
  165. package/apps/web/src/page-opener.tsx +14 -0
  166. package/apps/web/src/panel/LoginForm.tsx +31 -0
  167. package/apps/web/src/panel/OverviewPage.tsx +90 -0
  168. package/apps/web/src/panel/PanelPage.tsx +9 -0
  169. package/apps/web/src/panel/SettingsPage.tsx +102 -0
  170. package/apps/web/src/panel/contract.ts +101 -0
  171. package/apps/web/src/panel/target-state.ts +53 -0
  172. package/apps/web/src/panel.tsx +30 -0
  173. package/apps/web/src/plugin-bootstrap.ts +90 -0
  174. package/apps/web/src/plugin-discovery.ts +5 -0
  175. package/apps/web/src/rpc/client.ts +301 -0
  176. package/apps/web/src/rpc.ts +4 -0
  177. package/apps/web/src/run-overview.ts +34 -0
  178. package/apps/web/src/run-preparation.ts +16 -0
  179. package/apps/web/src/run-read-state.ts +33 -0
  180. package/apps/web/src/settings-contributions.ts +274 -0
  181. package/apps/web/src/theme.ts +135 -0
  182. package/apps/web/src/title-model-settings.ts +51 -0
  183. package/apps/web/src/toolLine.ts +67 -0
  184. package/apps/web/src/ui/ListDetail.tsx +149 -0
  185. package/apps/web/src/ui/SectionLabel.tsx +7 -0
  186. package/apps/web/src/ui/SvgEdge.tsx +39 -0
  187. package/apps/web/src/ui/alert.tsx +75 -0
  188. package/apps/web/src/ui/badge.tsx +51 -0
  189. package/apps/web/src/ui/button.tsx +57 -0
  190. package/apps/web/src/ui/card.tsx +102 -0
  191. package/apps/web/src/ui/checkbox.tsx +26 -0
  192. package/apps/web/src/ui/dialog.tsx +250 -0
  193. package/apps/web/src/ui/dropdown-menu.tsx +265 -0
  194. package/apps/web/src/ui/empty.tsx +103 -0
  195. package/apps/web/src/ui/field.tsx +236 -0
  196. package/apps/web/src/ui/frame.css +4 -0
  197. package/apps/web/src/ui/index.ts +43 -0
  198. package/apps/web/src/ui/input.tsx +19 -0
  199. package/apps/web/src/ui/label.tsx +17 -0
  200. package/apps/web/src/ui/modal-controller.ts +70 -0
  201. package/apps/web/src/ui/modal.tsx +62 -0
  202. package/apps/web/src/ui/popover.tsx +102 -0
  203. package/apps/web/src/ui/progress.tsx +80 -0
  204. package/apps/web/src/ui/radio-group.tsx +35 -0
  205. package/apps/web/src/ui/select.tsx +198 -0
  206. package/apps/web/src/ui/separator.tsx +22 -0
  207. package/apps/web/src/ui/skeleton.tsx +13 -0
  208. package/apps/web/src/ui/spinner.tsx +10 -0
  209. package/apps/web/src/ui/switch.tsx +29 -0
  210. package/apps/web/src/ui/table.tsx +113 -0
  211. package/apps/web/src/ui/tabs.tsx +79 -0
  212. package/apps/web/src/ui/tailwind.css +21 -0
  213. package/apps/web/src/ui/textarea.tsx +17 -0
  214. package/apps/web/src/ui/theme.css +300 -0
  215. package/apps/web/src/ui/toggle-group.tsx +87 -0
  216. package/apps/web/src/ui/toggle.tsx +42 -0
  217. package/apps/web/src/ui/tooltip.tsx +63 -0
  218. package/apps/web/src/ui/useFileInput.ts +50 -0
  219. package/apps/web/src/virtual-plugins.d.ts +3 -0
  220. package/apps/web/src/vite-env.d.ts +1 -0
  221. package/package.json +82 -0
  222. package/packages/agent/package.json +64 -0
  223. package/packages/agent/src/config.ts +161 -0
  224. package/packages/agent/src/core/agent-session-runtime.ts +548 -0
  225. package/packages/agent/src/core/agent-session-services.ts +224 -0
  226. package/packages/agent/src/core/agent-session.ts +3357 -0
  227. package/packages/agent/src/core/auth-guidance.ts +18 -0
  228. package/packages/agent/src/core/auth-storage.ts +271 -0
  229. package/packages/agent/src/core/bash-executor.ts +156 -0
  230. package/packages/agent/src/core/compaction/branch-summarization.ts +372 -0
  231. package/packages/agent/src/core/compaction/compaction.ts +875 -0
  232. package/packages/agent/src/core/compaction/index.ts +7 -0
  233. package/packages/agent/src/core/compaction/utils.ts +174 -0
  234. package/packages/agent/src/core/defaults.ts +3 -0
  235. package/packages/agent/src/core/diagnostics.ts +15 -0
  236. package/packages/agent/src/core/event-bus.ts +33 -0
  237. package/packages/agent/src/core/exec.ts +107 -0
  238. package/packages/agent/src/core/experimental.ts +3 -0
  239. package/packages/agent/src/core/extensions/index.ts +149 -0
  240. package/packages/agent/src/core/extensions/loader.ts +709 -0
  241. package/packages/agent/src/core/extensions/runner.ts +1132 -0
  242. package/packages/agent/src/core/extensions/types.ts +1460 -0
  243. package/packages/agent/src/core/extensions/wrapper.ts +45 -0
  244. package/packages/agent/src/core/footer-data-provider.ts +388 -0
  245. package/packages/agent/src/core/http-dispatcher.ts +106 -0
  246. package/packages/agent/src/core/index.ts +78 -0
  247. package/packages/agent/src/core/messages.ts +195 -0
  248. package/packages/agent/src/core/model-config.ts +287 -0
  249. package/packages/agent/src/core/model-registry.ts +126 -0
  250. package/packages/agent/src/core/model-resolver.ts +675 -0
  251. package/packages/agent/src/core/model-runtime.ts +517 -0
  252. package/packages/agent/src/core/output-guard.ts +108 -0
  253. package/packages/agent/src/core/package-manager.ts +2441 -0
  254. package/packages/agent/src/core/prompt-templates.ts +284 -0
  255. package/packages/agent/src/core/provider-composer.ts +549 -0
  256. package/packages/agent/src/core/resolve-config-value.ts +287 -0
  257. package/packages/agent/src/core/resource-loader.ts +946 -0
  258. package/packages/agent/src/core/runtime-credentials.ts +48 -0
  259. package/packages/agent/src/core/sdk.ts +358 -0
  260. package/packages/agent/src/core/session-cwd.ts +59 -0
  261. package/packages/agent/src/core/session-manager.ts +1623 -0
  262. package/packages/agent/src/core/settings-manager.ts +1212 -0
  263. package/packages/agent/src/core/skills.ts +487 -0
  264. package/packages/agent/src/core/slash-commands.ts +41 -0
  265. package/packages/agent/src/core/source-info.ts +40 -0
  266. package/packages/agent/src/core/system-prompt.ts +147 -0
  267. package/packages/agent/src/core/timings.ts +50 -0
  268. package/packages/agent/src/core/tools/bash.ts +314 -0
  269. package/packages/agent/src/core/tools/edit-diff.ts +704 -0
  270. package/packages/agent/src/core/tools/edit.ts +222 -0
  271. package/packages/agent/src/core/tools/file-mutation-queue.ts +61 -0
  272. package/packages/agent/src/core/tools/index.ts +130 -0
  273. package/packages/agent/src/core/tools/output-accumulator.ts +222 -0
  274. package/packages/agent/src/core/tools/path-utils.ts +118 -0
  275. package/packages/agent/src/core/tools/read.ts +195 -0
  276. package/packages/agent/src/core/tools/tool-definition-wrapper.ts +45 -0
  277. package/packages/agent/src/core/tools/truncate.ts +276 -0
  278. package/packages/agent/src/core/tools/write.ts +90 -0
  279. package/packages/agent/src/core/trust-manager.ts +244 -0
  280. package/packages/agent/src/index.ts +287 -0
  281. package/packages/agent/src/utils/ansi.ts +60 -0
  282. package/packages/agent/src/utils/child-process.ts +137 -0
  283. package/packages/agent/src/utils/exif-orientation.ts +183 -0
  284. package/packages/agent/src/utils/frontmatter.ts +39 -0
  285. package/packages/agent/src/utils/fs-watch.ts +30 -0
  286. package/packages/agent/src/utils/git.ts +226 -0
  287. package/packages/agent/src/utils/image-convert.ts +49 -0
  288. package/packages/agent/src/utils/image-process.ts +119 -0
  289. package/packages/agent/src/utils/image-resize-core.ts +164 -0
  290. package/packages/agent/src/utils/image-resize-worker.ts +42 -0
  291. package/packages/agent/src/utils/image-resize.ts +123 -0
  292. package/packages/agent/src/utils/json.ts +6 -0
  293. package/packages/agent/src/utils/mime.ts +116 -0
  294. package/packages/agent/src/utils/paths.ts +118 -0
  295. package/packages/agent/src/utils/photon.ts +139 -0
  296. package/packages/agent/src/utils/shell.ts +225 -0
  297. package/packages/agent/src/utils/sleep.ts +18 -0
  298. package/packages/agent/src/utils/tools-manager.ts +63 -0
  299. package/packages/agent-core/package.json +32 -0
  300. package/packages/agent-core/src/agent-loop.ts +877 -0
  301. package/packages/agent-core/src/agent.ts +598 -0
  302. package/packages/agent-core/src/index.ts +4 -0
  303. package/packages/agent-core/src/types.ts +455 -0
  304. package/packages/agent-core/src/uuid.ts +54 -0
  305. package/packages/ai/package.json +46 -0
  306. package/packages/ai/src/api/ai-sdk-messages.ts +102 -0
  307. package/packages/ai/src/api/ai-sdk-transport.ts +53 -0
  308. package/packages/ai/src/api/ai-sdk.lazy.ts +4 -0
  309. package/packages/ai/src/api/ai-sdk.ts +273 -0
  310. package/packages/ai/src/api/lazy.ts +75 -0
  311. package/packages/ai/src/api/openrouter-images.lazy.ts +10 -0
  312. package/packages/ai/src/api/openrouter-images.ts +98 -0
  313. package/packages/ai/src/api/simple-options.ts +77 -0
  314. package/packages/ai/src/api/transform-messages.ts +185 -0
  315. package/packages/ai/src/api-registry.ts +226 -0
  316. package/packages/ai/src/auth/context.ts +45 -0
  317. package/packages/ai/src/auth/credential-store.ts +51 -0
  318. package/packages/ai/src/auth/helpers.ts +47 -0
  319. package/packages/ai/src/auth/resolve.ts +139 -0
  320. package/packages/ai/src/auth/types.ts +220 -0
  321. package/packages/ai/src/compat/extension-oauth-types.ts +45 -0
  322. package/packages/ai/src/env-api-keys.ts +24 -0
  323. package/packages/ai/src/image-models.generated.ts +533 -0
  324. package/packages/ai/src/images-models.ts +274 -0
  325. package/packages/ai/src/index.ts +33 -0
  326. package/packages/ai/src/models-store.ts +38 -0
  327. package/packages/ai/src/models.generated.ts +6 -0
  328. package/packages/ai/src/models.ts +705 -0
  329. package/packages/ai/src/oauth.ts +10 -0
  330. package/packages/ai/src/providers/all.ts +64 -0
  331. package/packages/ai/src/providers/faux.ts +539 -0
  332. package/packages/ai/src/providers/openrouter-images.ts +14 -0
  333. package/packages/ai/src/providers/openrouter.models.ts +6050 -0
  334. package/packages/ai/src/providers/openrouter.ts +15 -0
  335. package/packages/ai/src/session-resources.ts +24 -0
  336. package/packages/ai/src/types.ts +692 -0
  337. package/packages/ai/src/utils/abort-signals.ts +41 -0
  338. package/packages/ai/src/utils/deferred-tools.ts +39 -0
  339. package/packages/ai/src/utils/diagnostics.ts +45 -0
  340. package/packages/ai/src/utils/error-body.ts +129 -0
  341. package/packages/ai/src/utils/estimate.ts +146 -0
  342. package/packages/ai/src/utils/event-stream.ts +88 -0
  343. package/packages/ai/src/utils/hash.ts +13 -0
  344. package/packages/ai/src/utils/headers.ts +18 -0
  345. package/packages/ai/src/utils/json-parse.ts +124 -0
  346. package/packages/ai/src/utils/node-http-proxy.ts +112 -0
  347. package/packages/ai/src/utils/overflow.ts +165 -0
  348. package/packages/ai/src/utils/provider-env.ts +52 -0
  349. package/packages/ai/src/utils/retry.ts +101 -0
  350. package/packages/ai/src/utils/sanitize-unicode.ts +25 -0
  351. package/packages/ai/src/utils/typebox-helpers.ts +24 -0
  352. package/packages/ai/src/utils/validation.ts +383 -0
  353. package/packages/ragents/package.json +31 -0
  354. package/packages/ragents/src/access.ts +54 -0
  355. package/packages/ragents/src/agents/actor-input.ts +191 -0
  356. package/packages/ragents/src/agents/catalog.ts +220 -0
  357. package/packages/ragents/src/agents/delivery.ts +187 -0
  358. package/packages/ragents/src/agents/live.ts +71 -0
  359. package/packages/ragents/src/agents/plugins.ts +130 -0
  360. package/packages/ragents/src/agents/scheduler.ts +1048 -0
  361. package/packages/ragents/src/agents/schemas.ts +64 -0
  362. package/packages/ragents/src/agents/tool-orientation.ts +12 -0
  363. package/packages/ragents/src/agents/tools.ts +709 -0
  364. package/packages/ragents/src/agents/toolset.ts +324 -0
  365. package/packages/ragents/src/agents/turn.ts +65 -0
  366. package/packages/ragents/src/agents/workspace-tools.ts +11 -0
  367. package/packages/ragents/src/agents/workspaces.ts +15 -0
  368. package/packages/ragents/src/domain/draft.ts +11 -0
  369. package/packages/ragents/src/domain/driver.ts +56 -0
  370. package/packages/ragents/src/domain/event-semantics.ts +668 -0
  371. package/packages/ragents/src/domain/event-validation.ts +620 -0
  372. package/packages/ragents/src/domain/events.ts +236 -0
  373. package/packages/ragents/src/domain/json-patch.ts +77 -0
  374. package/packages/ragents/src/domain/json.ts +86 -0
  375. package/packages/ragents/src/domain/model.ts +267 -0
  376. package/packages/ragents/src/domain/plugin-state.ts +33 -0
  377. package/packages/ragents/src/domain/portable-id.ts +9 -0
  378. package/packages/ragents/src/domain/projection.ts +506 -0
  379. package/packages/ragents/src/domain/schema-errors.ts +56 -0
  380. package/packages/ragents/src/domain/vocabulary.ts +37 -0
  381. package/packages/ragents/src/drivers/agent-runtime.ts +1503 -0
  382. package/packages/ragents/src/drivers/agent.ts +108 -0
  383. package/packages/ragents/src/drivers/attachments.ts +56 -0
  384. package/packages/ragents/src/drivers/skill-preload.ts +205 -0
  385. package/packages/ragents/src/drivers/types.ts +77 -0
  386. package/packages/ragents/src/http/contracts.ts +80 -0
  387. package/packages/ragents/src/http/methods.ts +150 -0
  388. package/packages/ragents/src/index.ts +161 -0
  389. package/packages/ragents/src/plugin-host.ts +1184 -0
  390. package/packages/ragents/src/plugin-types.ts +373 -0
  391. package/packages/ragents/src/rpc/contract.ts +76 -0
  392. package/packages/ragents/src/rpc/contribution.ts +67 -0
  393. package/packages/ragents/src/rpc/peer.ts +208 -0
  394. package/packages/ragents/src/rpc/protocol.ts +129 -0
  395. package/packages/ragents/src/runtime/artifacts.ts +95 -0
  396. package/packages/ragents/src/runtime/canonical-hash.ts +5 -0
  397. package/packages/ragents/src/runtime/canonical-json.ts +41 -0
  398. package/packages/ragents/src/runtime/command.ts +35 -0
  399. package/packages/ragents/src/runtime/decisions/actions.ts +77 -0
  400. package/packages/ragents/src/runtime/decisions/actors.ts +283 -0
  401. package/packages/ragents/src/runtime/decisions/artifacts.ts +28 -0
  402. package/packages/ragents/src/runtime/decisions/inputs.ts +79 -0
  403. package/packages/ragents/src/runtime/decisions/subscriptions.ts +135 -0
  404. package/packages/ragents/src/runtime/decisions/turns.ts +166 -0
  405. package/packages/ragents/src/runtime/domain-error.ts +10 -0
  406. package/packages/ragents/src/runtime/durable-fs.ts +13 -0
  407. package/packages/ragents/src/runtime/failures.ts +18 -0
  408. package/packages/ragents/src/runtime/guards.ts +196 -0
  409. package/packages/ragents/src/runtime/journal-storage.ts +228 -0
  410. package/packages/ragents/src/runtime/journal.ts +952 -0
  411. package/packages/ragents/src/runtime/orchestration.ts +711 -0
  412. package/packages/ragents/src/runtime/serial-queue.ts +13 -0
  413. package/packages/ragents/src/runtime/services.ts +15 -0
  414. package/packages/ragents/src/runtime/stop.ts +186 -0
  415. package/packages/ragents/src/script/driver.ts +18 -0
  416. package/packages/ragents/src/script/mediators.ts +386 -0
  417. package/packages/ragents/src/script/programs.ts +10 -0
  418. package/packages/ragents/src/script/std.ts +27 -0
  419. package/packages/ragents/src/script/types.ts +6 -0
  420. package/packages/ragents/src/typescript/async-compiler.ts +322 -0
  421. package/packages/ragents/src/typescript/build-contract.ts +14 -0
  422. package/packages/ragents/src/typescript/compiler-worker.ts +52 -0
  423. package/packages/ragents/src/typescript/compiler.ts +304 -0
  424. package/packages/ragents/src/typescript/index.ts +48 -0
  425. package/packages/ragents/src/typescript/native-executor.ts +40 -0
  426. package/packages/ragents/src/typescript/native-program.ts +5 -0
  427. package/packages/ragents/src/typescript/run-context.ts +199 -0
  428. package/packages/ragents/src/typescript/schema.ts +176 -0
  429. package/packages/ragents/src/typescript/snippet.ts +121 -0
  430. package/packages/workspace-executor/package.json +25 -0
  431. package/packages/workspace-executor/src/context.ts +123 -0
  432. package/packages/workspace-executor/src/executor.ts +134 -0
  433. package/packages/workspace-executor/src/git-config-environment.ts +10 -0
  434. package/packages/workspace-executor/src/index.ts +52 -0
  435. package/packages/workspace-executor/src/language-server/adapters/fsharp.ts +59 -0
  436. package/packages/workspace-executor/src/language-server/adapters/index.ts +7 -0
  437. package/packages/workspace-executor/src/language-server/adapters/roslyn.ts +54 -0
  438. package/packages/workspace-executor/src/language-server/adapters/typescript.ts +46 -0
  439. package/packages/workspace-executor/src/language-server/contract.ts +23 -0
  440. package/packages/workspace-executor/src/language-server/diagnostics.ts +62 -0
  441. package/packages/workspace-executor/src/language-server/host.ts +409 -0
  442. package/packages/workspace-executor/src/language-server/json-rpc.ts +103 -0
  443. package/packages/workspace-executor/src/language-server/roots.ts +29 -0
  444. package/packages/workspace-executor/src/language-server/session.ts +442 -0
  445. package/packages/workspace-executor/src/language-server/solution.ts +13 -0
  446. package/packages/workspace-executor/src/managed-process.ts +329 -0
  447. package/packages/workspace-executor/src/paths.ts +43 -0
  448. package/packages/workspace-executor/src/run-marker.ts +6 -0
  449. package/packages/workspace-executor/src/safe-environment.ts +47 -0
  450. package/packages/workspace-executor/src/sandbox-tools.ts +258 -0
  451. package/packages/workspace-executor/src/session-ident.ts +37 -0
  452. package/packages/workspace-executor/src/shell-platform.ts +11 -0
  453. package/packages/workspace-executor/src/tools.ts +28 -0
  454. package/plugins/package.json +8 -0
  455. package/plugins/ragents.activity/server/index.ts +9 -0
  456. package/plugins/ragents.activity/web/ActivityHeader.tsx +58 -0
  457. package/plugins/ragents.activity/web/activity.ts +144 -0
  458. package/plugins/ragents.activity/web/index.tsx +13 -0
  459. package/plugins/ragents.actor-programs/client-ui/DataTable.tsx +100 -0
  460. package/plugins/ragents.actor-programs/client-ui/FilePicker.tsx +65 -0
  461. package/plugins/ragents.actor-programs/client-ui/FlowDiagram.tsx +234 -0
  462. package/plugins/ragents.actor-programs/client-ui/FlowDiagramRenderer.tsx +85 -0
  463. package/plugins/ragents.actor-programs/client-ui/Form.tsx +126 -0
  464. package/plugins/ragents.actor-programs/client-ui/Layout.tsx +27 -0
  465. package/plugins/ragents.actor-programs/client-ui/MessageList.tsx +30 -0
  466. package/plugins/ragents.actor-programs/client-ui/Viewers.tsx +41 -0
  467. package/plugins/ragents.actor-programs/client-ui/WorkflowDiagram.tsx +14 -0
  468. package/plugins/ragents.actor-programs/client-ui/contracts.d.ts +84 -0
  469. package/plugins/ragents.actor-programs/client-ui/file-contracts.d.ts +19 -0
  470. package/plugins/ragents.actor-programs/client-ui/file-selection.ts +24 -0
  471. package/plugins/ragents.actor-programs/client-ui/flow-diagram-contracts.d.ts +27 -0
  472. package/plugins/ragents.actor-programs/client-ui/flow-diagram.css +23 -0
  473. package/plugins/ragents.actor-programs/client-ui/form-contracts.d.ts +38 -0
  474. package/plugins/ragents.actor-programs/client-ui/frame-layout.ts +4 -0
  475. package/plugins/ragents.actor-programs/client-ui/index.tsx +81 -0
  476. package/plugins/ragents.actor-programs/client-ui/layout-contracts.d.ts +33 -0
  477. package/plugins/ragents.actor-programs/client-ui/message-list-contracts.d.ts +33 -0
  478. package/plugins/ragents.actor-programs/client-ui/table-contracts.d.ts +35 -0
  479. package/plugins/ragents.actor-programs/client-ui/viewer-contracts.d.ts +37 -0
  480. package/plugins/ragents.actor-programs/client-ui/workflow-diagram-contracts.d.ts +10 -0
  481. package/plugins/ragents.actor-programs/contract.ts +180 -0
  482. package/plugins/ragents.actor-programs/parameter-types.ts +3 -0
  483. package/plugins/ragents.actor-programs/prompt.hbs +79 -0
  484. package/plugins/ragents.actor-programs/server/agent-tools.ts +31 -0
  485. package/plugins/ragents.actor-programs/server/app-project.ts +284 -0
  486. package/plugins/ragents.actor-programs/server/authoring-contracts.ts +10 -0
  487. package/plugins/ragents.actor-programs/server/client-compiler.ts +174 -0
  488. package/plugins/ragents.actor-programs/server/client-contracts.ts +187 -0
  489. package/plugins/ragents.actor-programs/server/client-runtime.ts +16 -0
  490. package/plugins/ragents.actor-programs/server/controls-template.ts +118 -0
  491. package/plugins/ragents.actor-programs/server/controls-tool.ts +48 -0
  492. package/plugins/ragents.actor-programs/server/index.ts +51 -0
  493. package/plugins/ragents.actor-programs/server/methods.ts +72 -0
  494. package/plugins/ragents.actor-programs/server/project-diagnostics.ts +138 -0
  495. package/plugins/ragents.actor-programs/server/prompts.ts +21 -0
  496. package/plugins/ragents.actor-programs/server/routes.ts +235 -0
  497. package/plugins/ragents.actor-programs/server/runtime-libraries.ts +4 -0
  498. package/plugins/ragents.actor-programs/server/runtime.ts +721 -0
  499. package/plugins/ragents.actor-programs/server/tailwind.ts +22 -0
  500. package/plugins/ragents.actor-programs/server/templates.ts +400 -0
  501. package/plugins/ragents.actor-programs/server/tool-contributor.ts +29 -0
  502. package/plugins/ragents.actor-programs/summary.hbs +17 -0
  503. package/plugins/ragents.actor-programs/web/ActorViewFrame.tsx +463 -0
  504. package/plugins/ragents.actor-programs/web/AppsPanel.tsx +436 -0
  505. package/plugins/ragents.actor-programs/web/EmbeddedApps.tsx +116 -0
  506. package/plugins/ragents.actor-programs/web/ExpandIcon.tsx +5 -0
  507. package/plugins/ragents.actor-programs/web/FullscreenHost.tsx +31 -0
  508. package/plugins/ragents.actor-programs/web/FunctionForm.tsx +102 -0
  509. package/plugins/ragents.actor-programs/web/ProgramSource.tsx +81 -0
  510. package/plugins/ragents.actor-programs/web/api.ts +353 -0
  511. package/plugins/ragents.actor-programs/web/bridge.ts +122 -0
  512. package/plugins/ragents.actor-programs/web/chat-state.ts +37 -0
  513. package/plugins/ragents.actor-programs/web/context.ts +30 -0
  514. package/plugins/ragents.actor-programs/web/function-call.ts +28 -0
  515. package/plugins/ragents.actor-programs/web/function-input.ts +40 -0
  516. package/plugins/ragents.actor-programs/web/index.tsx +96 -0
  517. package/plugins/ragents.actor-programs/web/invocations.ts +43 -0
  518. package/plugins/ragents.actor-programs/web/program-state.ts +68 -0
  519. package/plugins/ragents.actor-programs/web/state-revision.ts +16 -0
  520. package/plugins/ragents.actor-programs/workflow/index.ts +202 -0
  521. package/plugins/ragents.actor-programs/workflow/prompt-reader.ts +15 -0
  522. package/plugins/ragents.ask/ask.hbs +4 -0
  523. package/plugins/ragents.ask/contract.ts +17 -0
  524. package/plugins/ragents.ask/server/answer-method.ts +15 -0
  525. package/plugins/ragents.ask/server/ask-service.ts +152 -0
  526. package/plugins/ragents.ask/server/ask-tool.ts +39 -0
  527. package/plugins/ragents.ask/server/contract.ts +22 -0
  528. package/plugins/ragents.ask/server/index.ts +26 -0
  529. package/plugins/ragents.ask/server/tool-contributor.ts +11 -0
  530. package/plugins/ragents.ask/web/QuestionSection.tsx +47 -0
  531. package/plugins/ragents.ask/web/api.ts +6 -0
  532. package/plugins/ragents.ask/web/constants.ts +1 -0
  533. package/plugins/ragents.ask/web/index.tsx +50 -0
  534. package/plugins/ragents.browser/provision.ts +48 -0
  535. package/plugins/ragents.browser/server/browser.ts +393 -0
  536. package/plugins/ragents.browser/server/contract.ts +36 -0
  537. package/plugins/ragents.browser/server/index.ts +35 -0
  538. package/plugins/ragents.browser/server/tools.ts +197 -0
  539. package/plugins/ragents.browser/skills/browser-testing/SKILL.md +36 -0
  540. package/plugins/ragents.documents/contract.ts +33 -0
  541. package/plugins/ragents.documents/prompt.hbs +18 -0
  542. package/plugins/ragents.documents/server/config.ts +14 -0
  543. package/plugins/ragents.documents/server/document-write-tool.ts +45 -0
  544. package/plugins/ragents.documents/server/files-route.ts +137 -0
  545. package/plugins/ragents.documents/server/index.ts +38 -0
  546. package/plugins/ragents.documents/server/show-document-tool.ts +73 -0
  547. package/plugins/ragents.documents/server/store.ts +35 -0
  548. package/plugins/ragents.documents/server/tool-contributor.ts +16 -0
  549. package/plugins/ragents.documents/web/DocumentViewer.tsx +450 -0
  550. package/plugins/ragents.documents/web/api.ts +8 -0
  551. package/plugins/ragents.documents/web/index.tsx +279 -0
  552. package/plugins/ragents.lsp-fsharp/provision.ts +74 -0
  553. package/plugins/ragents.lsp-fsharp/server/index.ts +16 -0
  554. package/plugins/ragents.lsp-fsharp/web/index.tsx +7 -0
  555. package/plugins/ragents.lsp-roslyn/provision.ts +54 -0
  556. package/plugins/ragents.lsp-roslyn/server/index.ts +15 -0
  557. package/plugins/ragents.lsp-roslyn/web/api.ts +10 -0
  558. package/plugins/ragents.lsp-roslyn/web/index.tsx +7 -0
  559. package/plugins/ragents.lsp-roslyn/web/language-server-plugin.tsx +236 -0
  560. package/plugins/ragents.lsp-typescript/server/index.ts +7 -0
  561. package/plugins/ragents.lsp-typescript/web/index.tsx +7 -0
  562. package/plugins/ragents.model-relay/server/config.ts +37 -0
  563. package/plugins/ragents.model-relay/server/index.ts +31 -0
  564. package/plugins/ragents.model-relay/server/relay.ts +213 -0
  565. package/plugins/ragents.orchestration/canvas.hbs +50 -0
  566. package/plugins/ragents.orchestration/contract.ts +322 -0
  567. package/plugins/ragents.orchestration/orchestration.hbs +105 -0
  568. package/plugins/ragents.orchestration/server/canvas-tool.ts +248 -0
  569. package/plugins/ragents.orchestration/server/index.ts +64 -0
  570. package/plugins/ragents.orchestration/server/run-stop-tool.ts +30 -0
  571. package/plugins/ragents.orchestration/tiled-layout.ts +47 -0
  572. package/plugins/ragents.orchestration/web/ActorCanvasControls.tsx +159 -0
  573. package/plugins/ragents.orchestration/web/ActorChat.tsx +56 -0
  574. package/plugins/ragents.orchestration/web/ActorChatControls.tsx +64 -0
  575. package/plugins/ragents.orchestration/web/ActorChatPreview.tsx +36 -0
  576. package/plugins/ragents.orchestration/web/ActorNet.tsx +607 -0
  577. package/plugins/ragents.orchestration/web/ActorPopout.tsx +36 -0
  578. package/plugins/ragents.orchestration/web/ActorShortcut.tsx +76 -0
  579. package/plugins/ragents.orchestration/web/ActorTile.tsx +22 -0
  580. package/plugins/ragents.orchestration/web/CanvasStartup.tsx +14 -0
  581. package/plugins/ragents.orchestration/web/CanvasTiles.tsx +47 -0
  582. package/plugins/ragents.orchestration/web/CardSizeSettings.tsx +42 -0
  583. package/plugins/ragents.orchestration/web/Center.tsx +576 -0
  584. package/plugins/ragents.orchestration/web/DocumentsSection.tsx +37 -0
  585. package/plugins/ragents.orchestration/web/ExecutionsPanel.tsx +109 -0
  586. package/plugins/ragents.orchestration/web/FlowInspector.tsx +932 -0
  587. package/plugins/ragents.orchestration/web/JournalStatus.tsx +87 -0
  588. package/plugins/ragents.orchestration/web/MaterialBody.tsx +104 -0
  589. package/plugins/ragents.orchestration/web/ScriptActorCard.tsx +56 -0
  590. package/plugins/ragents.orchestration/web/StopRunButton.tsx +52 -0
  591. package/plugins/ragents.orchestration/web/TiledCanvas.tsx +281 -0
  592. package/plugins/ragents.orchestration/web/ZoomSettings.tsx +38 -0
  593. package/plugins/ragents.orchestration/web/actor-conversation.ts +64 -0
  594. package/plugins/ragents.orchestration/web/actor-header-settings.ts +41 -0
  595. package/plugins/ragents.orchestration/web/api.ts +33 -0
  596. package/plugins/ragents.orchestration/web/canvas-layout-storage.ts +39 -0
  597. package/plugins/ragents.orchestration/web/canvas-layout.ts +326 -0
  598. package/plugins/ragents.orchestration/web/canvas-scene.ts +311 -0
  599. package/plugins/ragents.orchestration/web/canvas-stage.ts +21 -0
  600. package/plugins/ragents.orchestration/web/canvas-startup.ts +36 -0
  601. package/plugins/ragents.orchestration/web/canvas-view-settings.ts +48 -0
  602. package/plugins/ragents.orchestration/web/card-size-settings.ts +36 -0
  603. package/plugins/ragents.orchestration/web/column/AddresseeControl.tsx +116 -0
  604. package/plugins/ragents.orchestration/web/column/ColumnSettings.tsx +50 -0
  605. package/plugins/ragents.orchestration/web/column/RunColumn.tsx +370 -0
  606. package/plugins/ragents.orchestration/web/column/column-actors.ts +38 -0
  607. package/plugins/ragents.orchestration/web/column/column-settings.ts +47 -0
  608. package/plugins/ragents.orchestration/web/column/column-state.ts +59 -0
  609. package/plugins/ragents.orchestration/web/column/sheet-status.ts +30 -0
  610. package/plugins/ragents.orchestration/web/constants.ts +10 -0
  611. package/plugins/ragents.orchestration/web/contract.ts +25 -0
  612. package/plugins/ragents.orchestration/web/executions.ts +124 -0
  613. package/plugins/ragents.orchestration/web/format.ts +4 -0
  614. package/plugins/ragents.orchestration/web/index.tsx +182 -0
  615. package/plugins/ragents.orchestration/web/keyboard-navigation.ts +55 -0
  616. package/plugins/ragents.orchestration/web/material-layout.ts +14 -0
  617. package/plugins/ragents.orchestration/web/run-view.ts +199 -0
  618. package/plugins/ragents.orchestration/web/tile-docking.ts +99 -0
  619. package/plugins/ragents.orchestration/web/tiled-view-settings.ts +76 -0
  620. package/plugins/ragents.orchestration/web/useCanvasMeasurements.ts +78 -0
  621. package/plugins/ragents.orchestration/web/zoom-settings.ts +28 -0
  622. package/plugins/ragents.overseer/contract.ts +165 -0
  623. package/plugins/ragents.overseer/server/api.ts +82 -0
  624. package/plugins/ragents.overseer/server/coordinator-prompt.ts +13 -0
  625. package/plugins/ragents.overseer/server/index.ts +71 -0
  626. package/plugins/ragents.overseer/server/orientation.ts +33 -0
  627. package/plugins/ragents.overseer/server/quick-answer.ts +54 -0
  628. package/plugins/ragents.overseer/server/reset-method.ts +5 -0
  629. package/plugins/ragents.overseer/server/run-directory.ts +49 -0
  630. package/plugins/ragents.overseer/server/settings-method.ts +8 -0
  631. package/plugins/ragents.overseer/server/settings.ts +83 -0
  632. package/plugins/ragents.overseer/server/user-location.ts +96 -0
  633. package/plugins/ragents.overseer/web/ModelSettings.tsx +70 -0
  634. package/plugins/ragents.overseer/web/chat-display.ts +10 -0
  635. package/plugins/ragents.overseer/web/index.tsx +208 -0
  636. package/plugins/ragents.overseer/web/model-settings.ts +61 -0
  637. package/plugins/ragents.overseer/web/quick-answers.ts +64 -0
  638. package/plugins/ragents.processes/contract.ts +61 -0
  639. package/plugins/ragents.processes/server/index.ts +36 -0
  640. package/plugins/ragents.processes/server/methods.ts +39 -0
  641. package/plugins/ragents.processes/server/observer.ts +179 -0
  642. package/plugins/ragents.processes/server/process-table.ts +395 -0
  643. package/plugins/ragents.processes/server/snapshot.ts +63 -0
  644. package/plugins/ragents.processes/server/terminator.ts +164 -0
  645. package/plugins/ragents.processes/web/ProcessHeader.tsx +157 -0
  646. package/plugins/ragents.processes/web/index.tsx +23 -0
  647. package/plugins/ragents.processes/web/processes.ts +75 -0
  648. package/plugins/ragents.product/model-settings-contract.ts +10 -0
  649. package/plugins/ragents.product/preamble.hbs +9 -0
  650. package/plugins/ragents.product/server/config.ts +73 -0
  651. package/plugins/ragents.product/server/index.ts +117 -0
  652. package/plugins/ragents.product/server/relay.ts +118 -0
  653. package/plugins/ragents.product/server/runtime.ts +30 -0
  654. package/plugins/ragents.product/web/ModelControl.tsx +81 -0
  655. package/plugins/ragents.product/web/ProductModelSettings.tsx +131 -0
  656. package/plugins/ragents.product/web/SystemPromptControl.tsx +136 -0
  657. package/plugins/ragents.product/web/index.tsx +29 -0
  658. package/plugins/ragents.product/web/model-settings.ts +39 -0
  659. package/plugins/ragents.product/web/start-options.tsx +12 -0
  660. package/plugins/ragents.profile-distribution/contract.ts +38 -0
  661. package/plugins/ragents.profile-distribution/server/archive.ts +159 -0
  662. package/plugins/ragents.profile-distribution/server/config.ts +27 -0
  663. package/plugins/ragents.profile-distribution/server/index.ts +93 -0
  664. package/plugins/ragents.profile-distribution/server/web.ts +48 -0
  665. package/plugins/ragents.reference/examples.ts +33 -0
  666. package/plugins/ragents.reference/run-scripts/balcony-wizard/RUN.md +27 -0
  667. package/plugins/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/package.json +10 -0
  668. package/plugins/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/src/client.tsx +80 -0
  669. package/plugins/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/src/conversation.ts +82 -0
  670. package/plugins/ragents.reference/run-scripts/balcony-wizard/actors/balcony-app/tests/conversation.test.ts +154 -0
  671. package/plugins/ragents.reference/run-scripts/balcony-wizard/package.json +9 -0
  672. package/plugins/ragents.reference/run-scripts/balcony-wizard/src/server.ts +32 -0
  673. package/plugins/ragents.reference/run-scripts/balcony-wizard/tests/program.test.ts +59 -0
  674. package/plugins/ragents.reference/run-scripts/conversation-circle/RUN.md +14 -0
  675. package/plugins/ragents.reference/run-scripts/conversation-circle/package.json +9 -0
  676. package/plugins/ragents.reference/run-scripts/conversation-circle/src/server.ts +87 -0
  677. package/plugins/ragents.reference/run-scripts/conversation-circle/tests/helpers.ts +26 -0
  678. package/plugins/ragents.reference/run-scripts/conversation-circle/tests/program.test.ts +32 -0
  679. package/plugins/ragents.reference/run-scripts/learning-afternoon/RUN.md +24 -0
  680. package/plugins/ragents.reference/run-scripts/learning-afternoon/package.json +10 -0
  681. package/plugins/ragents.reference/run-scripts/learning-afternoon/prompts/experiment.md +1 -0
  682. package/plugins/ragents.reference/run-scripts/learning-afternoon/prompts/helper.md +5 -0
  683. package/plugins/ragents.reference/run-scripts/learning-afternoon/prompts/quiz.md +1 -0
  684. package/plugins/ragents.reference/run-scripts/learning-afternoon/src/client.tsx +27 -0
  685. package/plugins/ragents.reference/run-scripts/learning-afternoon/src/server.ts +127 -0
  686. package/plugins/ragents.reference/run-scripts/learning-afternoon/src/state.ts +38 -0
  687. package/plugins/ragents.reference/run-scripts/learning-afternoon/src/view.tsx +42 -0
  688. package/plugins/ragents.reference/run-scripts/learning-afternoon/src/workflow.ts +38 -0
  689. package/plugins/ragents.reference/run-scripts/learning-afternoon/tests/program.test.ts +223 -0
  690. package/plugins/ragents.reference/run-scripts/moderated-round/RUN.md +12 -0
  691. package/plugins/ragents.reference/run-scripts/moderated-round/package.json +9 -0
  692. package/plugins/ragents.reference/run-scripts/moderated-round/src/server.ts +60 -0
  693. package/plugins/ragents.reference/run-scripts/moderated-round/tests/helpers.ts +26 -0
  694. package/plugins/ragents.reference/run-scripts/moderated-round/tests/program.test.ts +24 -0
  695. package/plugins/ragents.reference/run-scripts/shared-actor-list/RUN.md +18 -0
  696. package/plugins/ragents.reference/run-scripts/shared-actor-list/actors/shared-list/package.json +16 -0
  697. package/plugins/ragents.reference/run-scripts/shared-actor-list/actors/shared-list/src/client.tsx +39 -0
  698. package/plugins/ragents.reference/run-scripts/shared-actor-list/actors/shared-list/src/contract.ts +15 -0
  699. package/plugins/ragents.reference/run-scripts/shared-actor-list/actors/shared-list/src/server.ts +14 -0
  700. package/plugins/ragents.reference/run-scripts/shared-actor-list/actors/shared-list/tests/program.test.ts +13 -0
  701. package/plugins/ragents.reference/run-scripts/shared-actor-list/package.json +9 -0
  702. package/plugins/ragents.reference/run-scripts/shared-actor-list/src/server.ts +65 -0
  703. package/plugins/ragents.reference/run-scripts/shared-actor-list/tests/helpers.ts +26 -0
  704. package/plugins/ragents.reference/run-scripts/shared-actor-list/tests/program.test.ts +42 -0
  705. package/plugins/ragents.reference/run-scripts/word-game/RUN.md +25 -0
  706. package/plugins/ragents.reference/run-scripts/word-game/package.json +11 -0
  707. package/plugins/ragents.reference/run-scripts/word-game/src/client.tsx +27 -0
  708. package/plugins/ragents.reference/run-scripts/word-game/src/contract.ts +23 -0
  709. package/plugins/ragents.reference/run-scripts/word-game/src/server.ts +106 -0
  710. package/plugins/ragents.reference/run-scripts/word-game/src/state.ts +22 -0
  711. package/plugins/ragents.reference/run-scripts/word-game/src/view.tsx +54 -0
  712. package/plugins/ragents.reference/run-scripts/word-game/tests/program.test.ts +253 -0
  713. package/plugins/ragents.reference/server/index.ts +12 -0
  714. package/plugins/ragents.reference/skills/100-shared-actor-list/SKILL.md +12 -0
  715. package/plugins/ragents.reference/skills/110-all-card-slots/SKILL.md +12 -0
  716. package/plugins/ragents.reference/skills/120-canvas-conversation-circle/SKILL.md +12 -0
  717. package/plugins/ragents.reference/skills/130-canvas-pipeline-with-approval/SKILL.md +12 -0
  718. package/plugins/ragents.reference/skills/140-canvas-team-tree-and-topic-grid/SKILL.md +12 -0
  719. package/plugins/ragents.reference/skills/150-editorial-workbench/SKILL.md +12 -0
  720. package/plugins/ragents.reference/skills/160-learning-companion/SKILL.md +12 -0
  721. package/plugins/ragents.reference/skills/170-photo-collection/SKILL.md +12 -0
  722. package/plugins/ragents.reference/skills/180-decision-workbench/SKILL.md +12 -0
  723. package/plugins/ragents.reference/skills/190-review-queue/SKILL.md +12 -0
  724. package/plugins/ragents.reference/skills/20-circle-of-four/SKILL.md +12 -0
  725. package/plugins/ragents.reference/skills/200-typescript-diagnostics/SKILL.md +12 -0
  726. package/plugins/ragents.reference/skills/210-moderator-handover/SKILL.md +12 -0
  727. package/plugins/ragents.reference/skills/220-actor-approval-list/SKILL.md +12 -0
  728. package/plugins/ragents.reference/skills/230-shared-state-views/SKILL.md +12 -0
  729. package/plugins/ragents.reference/skills/240-live-result-list/SKILL.md +12 -0
  730. package/plugins/ragents.reference/skills/250-balcony-wizard/SKILL.md +12 -0
  731. package/plugins/ragents.reference/skills/30-llm-without-runtime-knowledge/SKILL.md +12 -0
  732. package/plugins/ragents.reference/skills/35-actor-input-fifo/SKILL.md +12 -0
  733. package/plugins/ragents.reference/skills/40-subscription-matrix/SKILL.md +12 -0
  734. package/plugins/ragents.reference/skills/50-subscription-removal/SKILL.md +12 -0
  735. package/plugins/ragents.reference/skills/60-stop-in-the-circle/SKILL.md +12 -0
  736. package/plugins/ragents.reference/skills/65-artifact-least-privilege/SKILL.md +12 -0
  737. package/plugins/ragents.reference/skills/70-headless-counter/SKILL.md +12 -0
  738. package/plugins/ragents.reference/skills/75-lsp-demo/SKILL.md +12 -0
  739. package/plugins/ragents.reference/skills/80-actor-text-analysis/SKILL.md +12 -0
  740. package/plugins/ragents.reference/skills/90-actor-notes/SKILL.md +12 -0
  741. package/plugins/ragents.reference/skills/95-hello-world/SKILL.md +12 -0
  742. package/plugins/ragents.reference/skills/decision-brief/SKILL.md +33 -0
  743. package/plugins/ragents.reference/skills/learning-sprint/SKILL.md +33 -0
  744. package/plugins/ragents.reference/walkthroughs.ts +219 -0
  745. package/plugins/ragents.reference/web/StartGuides.tsx +89 -0
  746. package/plugins/ragents.reference/web/index.tsx +10 -0
  747. package/plugins/ragents.todo/contract.ts +60 -0
  748. package/plugins/ragents.todo/server/index.ts +10 -0
  749. package/plugins/ragents.todo/server/todo-tool.ts +70 -0
  750. package/plugins/ragents.todo/server/tool-contributor.ts +9 -0
  751. package/plugins/ragents.todo/web/TodoSection.tsx +47 -0
  752. package/plugins/ragents.todo/web/index.ts +12 -0
  753. package/plugins/ragents.transcript/server/index.ts +20 -0
  754. package/plugins/ragents.transcript/server/transcript.ts +78 -0
  755. package/plugins/ragents.watch/contract.ts +48 -0
  756. package/plugins/ragents.watch/server/condition.ts +56 -0
  757. package/plugins/ragents.watch/server/contract.ts +4 -0
  758. package/plugins/ragents.watch/server/functions.ts +62 -0
  759. package/plugins/ragents.watch/server/index.ts +39 -0
  760. package/plugins/ragents.watch/server/observation.ts +69 -0
  761. package/plugins/ragents.watch/server/service.ts +294 -0
  762. package/plugins/ragents.workspace/client/transport.ts +13 -0
  763. package/plugins/ragents.workspace/client/workspace-client.ts +247 -0
  764. package/plugins/ragents.workspace/contract.ts +182 -0
  765. package/plugins/ragents.workspace/prompt.hbs +14 -0
  766. package/plugins/ragents.workspace/server/binding.ts +92 -0
  767. package/plugins/ragents.workspace/server/browse-route.ts +134 -0
  768. package/plugins/ragents.workspace/server/clients.ts +161 -0
  769. package/plugins/ragents.workspace/server/index.ts +91 -0
  770. package/plugins/ragents.workspace/server/runtime.ts +170 -0
  771. package/plugins/ragents.workspace/web/FileBrowser.tsx +271 -0
  772. package/plugins/ragents.workspace/web/WorkspaceBinding.tsx +216 -0
  773. package/plugins/ragents.workspace/web/api.ts +8 -0
  774. package/plugins/ragents.workspace/web/file-icons.tsx +94 -0
  775. package/plugins/ragents.workspace/web/index.tsx +37 -0
  776. package/ragents.config.core.ts +65 -0
  777. package/ragents.config.developer.ts +46 -0
  778. package/scripts/agent/agent-cli.ts +461 -0
  779. package/scripts/agent/journal.ts +125 -0
  780. package/scripts/package/build-package.ts +249 -0
  781. package/scripts/package/host-links.d.mts +1 -0
  782. package/scripts/package/host-links.mjs +39 -0
  783. package/scripts/package/publish-package.ts +129 -0
  784. package/scripts/package/ragents.mjs +59 -0
  785. package/scripts/provision/run-provision.ts +72 -0
  786. package/scripts/remote/connect.ts +265 -0
  787. package/scripts/remote/start.ts +91 -0
  788. package/scripts/workspace-client/run-workspace-client.ts +112 -0
@@ -0,0 +1,709 @@
1
+ /**
2
+ * Extension loader - loads TypeScript extension modules using jiti.
3
+ *
4
+ */
5
+
6
+ import * as fs from "node:fs";
7
+ import { createRequire } from "node:module";
8
+ import * as path from "node:path";
9
+ import { fileURLToPath } from "node:url";
10
+ import * as _bundledAgentCore from "@aicontainer/agent-core";
11
+ import * as _bundledAi from "@aicontainer/ai";
12
+ import * as _bundledAiOauth from "@aicontainer/ai/oauth";
13
+ import * as _bundledAiProviders from "@aicontainer/ai/providers/all";
14
+ import { createJiti } from "jiti/static";
15
+ // Static imports of packages that extensions may use.
16
+ // These MUST be static so Bun bundles them into the compiled binary.
17
+ // The virtualModules option then makes them available to extensions.
18
+ import * as _bundledTypebox from "typebox";
19
+ import * as _bundledTypeboxCompile from "typebox/compile";
20
+ import * as _bundledTypeboxValue from "typebox/value";
21
+ import { CONFIG_DIR_NAME, getAgentDir, isBunBinary } from "../../config.ts";
22
+ // NOTE: This import works because loader.ts exports are NOT re-exported from index.ts,
23
+ // avoiding a circular dependency. Extensions can import from @aicontainer/agent.
24
+ import * as _bundledCodingAgent from "../../index.ts";
25
+ import { resolvePath } from "../../utils/paths.ts";
26
+ import { createEventBus, type EventBus } from "../event-bus.ts";
27
+ import type { ExecOptions } from "../exec.ts";
28
+ import { execCommand } from "../exec.ts";
29
+ import { createSyntheticSourceInfo } from "../source-info.ts";
30
+ import { time } from "../timings.ts";
31
+ import type {
32
+ Extension,
33
+ ExtensionAPI,
34
+ ExtensionFactory,
35
+ ExtensionFactorySettlementObserver,
36
+ ExtensionRuntime,
37
+ LoadExtensionsResult,
38
+ ProviderConfig,
39
+ RegisteredCommand,
40
+ ToolDefinition,
41
+ } from "./types.ts";
42
+
43
+ /** Modules available to extensions via virtualModules (for compiled Bun binary) */
44
+ const VIRTUAL_MODULES: Record<string, unknown> = {
45
+ typebox: _bundledTypebox,
46
+ "typebox/compile": _bundledTypeboxCompile,
47
+ "typebox/value": _bundledTypeboxValue,
48
+ "@sinclair/typebox": _bundledTypebox,
49
+ "@sinclair/typebox/compile": _bundledTypeboxCompile,
50
+ "@sinclair/typebox/value": _bundledTypeboxValue,
51
+ "@aicontainer/agent-core": _bundledAgentCore,
52
+ "@aicontainer/ai": _bundledAi,
53
+ "@aicontainer/ai/oauth": _bundledAiOauth,
54
+ "@aicontainer/ai/providers/all": _bundledAiProviders,
55
+ "@aicontainer/agent": _bundledCodingAgent,
56
+ };
57
+
58
+ const require = createRequire(import.meta.url);
59
+
60
+ /**
61
+ * Get aliases for jiti (used in Node.js/development mode).
62
+ * In Bun binary mode, virtualModules is used instead.
63
+ */
64
+ let _aliases: Record<string, string> | null = null;
65
+
66
+ function abortReason(signal: AbortSignal): Error {
67
+ return signal.reason instanceof Error ? signal.reason : new Error("Extension creation was aborted.");
68
+ }
69
+
70
+ function awaitWithSignal<T>(operation: Promise<T>, signal: AbortSignal | undefined): Promise<T> {
71
+ if (!signal) {
72
+ return operation;
73
+ }
74
+ if (signal.aborted) {
75
+ return Promise.reject(abortReason(signal));
76
+ }
77
+
78
+ return new Promise<T>((resolve, reject) => {
79
+ const abort = () => reject(abortReason(signal));
80
+ signal.addEventListener("abort", abort, { once: true });
81
+ operation.then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
82
+ });
83
+ }
84
+
85
+ function getAliases(): Record<string, string> {
86
+ if (_aliases) return _aliases;
87
+
88
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
89
+ const packageIndex = path.resolve(__dirname, "../..", "index.js");
90
+
91
+ const typeboxEntry = require.resolve("typebox");
92
+ const typeboxCompileEntry = require.resolve("typebox/compile");
93
+ const typeboxValueEntry = require.resolve("typebox/value");
94
+
95
+ const packagesRoot = path.resolve(__dirname, "../../../../");
96
+ const resolveWorkspaceOrImport = (workspaceRelativePath: string, specifier: string): string => {
97
+ const workspacePath = path.join(packagesRoot, workspaceRelativePath);
98
+ if (fs.existsSync(workspacePath)) {
99
+ return workspacePath;
100
+ }
101
+ return fileURLToPath(import.meta.resolve(specifier));
102
+ };
103
+
104
+ const codingAgentEntry = packageIndex;
105
+ const agentCoreEntry = resolveWorkspaceOrImport("agent/dist/index.js", "@aicontainer/agent-core");
106
+ const aiEntry = resolveWorkspaceOrImport("ai/dist/index.js", "@aicontainer/ai");
107
+ const aiOauthEntry = resolveWorkspaceOrImport("ai/dist/oauth.js", "@aicontainer/ai/oauth");
108
+ const aiProvidersEntry = resolveWorkspaceOrImport("ai/dist/providers/all.js", "@aicontainer/ai/providers/all");
109
+
110
+ _aliases = {
111
+ "@aicontainer/agent": codingAgentEntry,
112
+ "@aicontainer/agent-core": agentCoreEntry,
113
+ "@aicontainer/ai/providers/all": aiProvidersEntry,
114
+ "@aicontainer/ai/oauth": aiOauthEntry,
115
+ "@aicontainer/ai": aiEntry,
116
+ typebox: typeboxEntry,
117
+ "typebox/compile": typeboxCompileEntry,
118
+ "typebox/value": typeboxValueEntry,
119
+ "@sinclair/typebox": typeboxEntry,
120
+ "@sinclair/typebox/compile": typeboxCompileEntry,
121
+ "@sinclair/typebox/value": typeboxValueEntry,
122
+ };
123
+
124
+ return _aliases;
125
+ }
126
+
127
+ type HandlerFn = (...args: unknown[]) => Promise<unknown>;
128
+
129
+ let extensionCacheCwd: string | undefined;
130
+ let extensionCacheGeneration = 0;
131
+ const extensionCache = new Map<string, ExtensionFactory>();
132
+
133
+ interface ExtensionCacheToken {
134
+ cwd: string;
135
+ generation: number;
136
+ }
137
+
138
+ export function clearExtensionCache(): void {
139
+ extensionCache.clear();
140
+ extensionCacheCwd = undefined;
141
+ extensionCacheGeneration++;
142
+ }
143
+
144
+ function useExtensionCacheCwd(cwd: string): ExtensionCacheToken {
145
+ const resolvedCwd = resolvePath(cwd);
146
+ if (extensionCacheCwd !== undefined && extensionCacheCwd !== resolvedCwd) {
147
+ clearExtensionCache();
148
+ }
149
+ extensionCacheCwd = resolvedCwd;
150
+ return { cwd: resolvedCwd, generation: extensionCacheGeneration };
151
+ }
152
+
153
+ /**
154
+ * Create a runtime with throwing stubs for action methods.
155
+ * Runner.bindCore() replaces these with real implementations.
156
+ */
157
+ export function createExtensionRuntime(): ExtensionRuntime {
158
+ const notInitialized = () => {
159
+ throw new Error("Extension runtime not initialized. Action methods cannot be called during extension loading.");
160
+ };
161
+ const state: { staleMessage?: string } = {};
162
+ const assertActive = () => {
163
+ if (state.staleMessage) {
164
+ throw new Error(state.staleMessage);
165
+ }
166
+ };
167
+
168
+ const runtime: ExtensionRuntime = {
169
+ sendMessage: notInitialized,
170
+ sendUserMessage: notInitialized,
171
+ appendEntry: notInitialized,
172
+ setSessionName: notInitialized,
173
+ getSessionName: notInitialized,
174
+ setLabel: notInitialized,
175
+ getActiveTools: notInitialized,
176
+ getAllTools: notInitialized,
177
+ setActiveTools: notInitialized,
178
+ // registerTool() is valid during extension load; refresh is only needed post-bind.
179
+ refreshTools: () => {},
180
+ getCommands: notInitialized,
181
+ setModel: () => Promise.reject(new Error("Extension runtime not initialized")),
182
+ getThinkingLevel: notInitialized,
183
+ setThinkingLevel: notInitialized,
184
+ flagValues: new Map(),
185
+ pendingProviderRegistrations: [],
186
+ assertActive,
187
+ invalidate: (message) => {
188
+ state.staleMessage ??=
189
+ message ??
190
+ "This extension ctx is stale after session replacement or reload. Do not use a captured extension or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().";
191
+ },
192
+ // Pre-bind: queue registrations so bindCore() can flush them once the
193
+ // model registry is available. bindCore() replaces both with direct calls.
194
+ registerProvider: (name, config, extensionPath = "<unknown>") => {
195
+ runtime.pendingProviderRegistrations.push({ name, config, extensionPath });
196
+ },
197
+ unregisterProvider: (name) => {
198
+ runtime.pendingProviderRegistrations = runtime.pendingProviderRegistrations.filter((r) => r.name !== name);
199
+ },
200
+ };
201
+
202
+ return runtime;
203
+ }
204
+
205
+ /**
206
+ * Create the ExtensionAPI for an extension.
207
+ * Registration methods write to the extension object.
208
+ * Action methods delegate to the shared runtime.
209
+ */
210
+ function createExtensionAPI(
211
+ extension: Extension,
212
+ runtime: ExtensionRuntime,
213
+ cwd: string,
214
+ eventBus: EventBus,
215
+ ): ExtensionAPI {
216
+ const api = {
217
+ // Registration methods - write to extension
218
+ on(event: string, handler: HandlerFn): void {
219
+ runtime.assertActive();
220
+ const list = extension.handlers.get(event) ?? [];
221
+ list.push(handler);
222
+ extension.handlers.set(event, list);
223
+ },
224
+
225
+ registerTool(tool: ToolDefinition): void {
226
+ runtime.assertActive();
227
+ extension.tools.set(tool.name, {
228
+ definition: tool,
229
+ sourceInfo: extension.sourceInfo,
230
+ });
231
+ runtime.refreshTools();
232
+ },
233
+
234
+ registerCommand(name: string, options: Omit<RegisteredCommand, "name" | "sourceInfo">): void {
235
+ runtime.assertActive();
236
+ extension.commands.set(name, {
237
+ name,
238
+ sourceInfo: extension.sourceInfo,
239
+ ...options,
240
+ });
241
+ },
242
+
243
+
244
+ registerFlag(
245
+ name: string,
246
+ options: { description?: string; type: "boolean" | "string"; default?: boolean | string },
247
+ ): void {
248
+ runtime.assertActive();
249
+ extension.flags.set(name, { name, extensionPath: extension.path, ...options });
250
+ if (options.default !== undefined && !runtime.flagValues.has(name)) {
251
+ runtime.flagValues.set(name, options.default);
252
+ }
253
+ },
254
+
255
+ // Flag access - checks extension registered it, reads from runtime
256
+ getFlag(name: string): boolean | string | undefined {
257
+ runtime.assertActive();
258
+ if (!extension.flags.has(name)) return undefined;
259
+ return runtime.flagValues.get(name);
260
+ },
261
+
262
+ // Action methods - delegate to shared runtime
263
+ sendMessage(message, options): void {
264
+ runtime.assertActive();
265
+ runtime.sendMessage(message, options);
266
+ },
267
+
268
+ sendUserMessage(content, options): void {
269
+ runtime.assertActive();
270
+ runtime.sendUserMessage(content, options);
271
+ },
272
+
273
+ appendEntry(customType: string, data?: unknown): void {
274
+ runtime.assertActive();
275
+ runtime.appendEntry(customType, data);
276
+ },
277
+
278
+ setSessionName(name: string): void {
279
+ runtime.assertActive();
280
+ runtime.setSessionName(name);
281
+ },
282
+
283
+ getSessionName(): string | undefined {
284
+ runtime.assertActive();
285
+ return runtime.getSessionName();
286
+ },
287
+
288
+ setLabel(entryId: string, label: string | undefined): void {
289
+ runtime.assertActive();
290
+ runtime.setLabel(entryId, label);
291
+ },
292
+
293
+ exec(command: string, args: string[], options?: ExecOptions) {
294
+ runtime.assertActive();
295
+ return execCommand(command, args, options?.cwd ?? cwd, options);
296
+ },
297
+
298
+ getActiveTools(): string[] {
299
+ runtime.assertActive();
300
+ return runtime.getActiveTools();
301
+ },
302
+
303
+ getAllTools() {
304
+ runtime.assertActive();
305
+ return runtime.getAllTools();
306
+ },
307
+
308
+ setActiveTools(toolNames: string[]): void {
309
+ runtime.assertActive();
310
+ runtime.setActiveTools(toolNames);
311
+ },
312
+
313
+ getCommands() {
314
+ runtime.assertActive();
315
+ return runtime.getCommands();
316
+ },
317
+
318
+ setModel(model) {
319
+ runtime.assertActive();
320
+ return runtime.setModel(model);
321
+ },
322
+
323
+ getThinkingLevel() {
324
+ runtime.assertActive();
325
+ return runtime.getThinkingLevel();
326
+ },
327
+
328
+ setThinkingLevel(level) {
329
+ runtime.assertActive();
330
+ runtime.setThinkingLevel(level);
331
+ },
332
+
333
+ registerProvider(name: string, config: ProviderConfig) {
334
+ runtime.assertActive();
335
+ runtime.registerProvider(name, config, extension.path);
336
+ },
337
+
338
+ unregisterProvider(name: string) {
339
+ runtime.assertActive();
340
+ runtime.unregisterProvider(name, extension.path);
341
+ },
342
+
343
+ events: eventBus,
344
+ } as ExtensionAPI;
345
+
346
+ return api;
347
+ }
348
+
349
+ function isCurrentCacheToken(cacheToken: ExtensionCacheToken | undefined): cacheToken is ExtensionCacheToken {
350
+ return (
351
+ cacheToken !== undefined &&
352
+ extensionCacheCwd === cacheToken.cwd &&
353
+ extensionCacheGeneration === cacheToken.generation
354
+ );
355
+ }
356
+
357
+ async function loadExtensionModule(extensionPath: string, cacheToken?: ExtensionCacheToken) {
358
+ if (isCurrentCacheToken(cacheToken)) {
359
+ const cachedFactory = extensionCache.get(extensionPath);
360
+ if (cachedFactory) {
361
+ return cachedFactory;
362
+ }
363
+ }
364
+
365
+ const jiti = createJiti(import.meta.url, {
366
+ moduleCache: false,
367
+ // In Bun binary: use virtualModules for bundled packages (no filesystem resolution)
368
+ // Also disable tryNative so jiti handles ALL imports (not just the entry point)
369
+ // In Node.js/dev: use aliases to resolve to node_modules paths
370
+ ...(isBunBinary ? { virtualModules: VIRTUAL_MODULES, tryNative: false } : { alias: getAliases() }),
371
+ });
372
+
373
+ const module = await jiti.import(extensionPath, { default: true });
374
+ const factory = module as ExtensionFactory;
375
+ if (typeof factory !== "function") {
376
+ return undefined;
377
+ }
378
+ if (isCurrentCacheToken(cacheToken)) {
379
+ extensionCache.set(extensionPath, factory);
380
+ }
381
+ return factory;
382
+ }
383
+
384
+ /**
385
+ * Create an Extension object with empty collections.
386
+ */
387
+ function createExtension(extensionPath: string, resolvedPath: string): Extension {
388
+ const source =
389
+ extensionPath.startsWith("<") && extensionPath.endsWith(">")
390
+ ? extensionPath.slice(1, -1).split(":")[0] || "temporary"
391
+ : "local";
392
+ const baseDir = extensionPath.startsWith("<") ? undefined : path.dirname(resolvedPath);
393
+
394
+ return {
395
+ path: extensionPath,
396
+ resolvedPath,
397
+ sourceInfo: createSyntheticSourceInfo(extensionPath, { source, baseDir }),
398
+ handlers: new Map(),
399
+ tools: new Map(),
400
+
401
+ commands: new Map(),
402
+ flags: new Map(),
403
+
404
+ };
405
+ }
406
+
407
+ async function loadExtension(
408
+ extensionPath: string,
409
+ cwd: string,
410
+ eventBus: EventBus,
411
+ runtime: ExtensionRuntime,
412
+ cacheToken?: ExtensionCacheToken,
413
+ signal?: AbortSignal,
414
+ onFactorySettlement?: ExtensionFactorySettlementObserver,
415
+ ): Promise<{ extension: Extension | null; error: string | null }> {
416
+ const resolvedPath = resolvePath(extensionPath, cwd, { normalizeUnicodeSpaces: true });
417
+
418
+ try {
419
+ const factory = await awaitWithSignal(loadExtensionModule(resolvedPath, cacheToken), signal);
420
+ time(`${extensionPath} module import`, "extensions");
421
+ if (!factory) {
422
+ return { extension: null, error: `Extension does not export a valid factory function: ${extensionPath}` };
423
+ }
424
+
425
+ const extension = createExtension(extensionPath, resolvedPath);
426
+ const api = createExtensionAPI(extension, runtime, cwd, eventBus);
427
+ const factorySettlement = Promise.resolve(factory(api, { signal: signal ?? new AbortController().signal }));
428
+ onFactorySettlement?.(factorySettlement);
429
+ await awaitWithSignal(factorySettlement, signal);
430
+ time(`${extensionPath} factory`, "extensions");
431
+
432
+ return { extension, error: null };
433
+ } catch (err) {
434
+ if (signal?.aborted) {
435
+ runtime.invalidate("Extension creation was aborted.");
436
+ throw abortReason(signal);
437
+ }
438
+ const message = err instanceof Error ? err.message : String(err);
439
+ return { extension: null, error: `Failed to load extension: ${message}` };
440
+ }
441
+ }
442
+
443
+ /**
444
+ * Create an Extension from an inline factory function.
445
+ */
446
+ export async function loadExtensionFromFactory(
447
+ factory: ExtensionFactory,
448
+ cwd: string,
449
+ eventBus: EventBus,
450
+ runtime: ExtensionRuntime,
451
+ extensionPath = "<inline>",
452
+ signal?: AbortSignal,
453
+ onFactorySettlement?: ExtensionFactorySettlementObserver,
454
+ ): Promise<Extension> {
455
+ const extension = createExtension(extensionPath, extensionPath);
456
+ const resolvedCwd = resolvePath(cwd);
457
+ const api = createExtensionAPI(extension, runtime, resolvedCwd, eventBus);
458
+ try {
459
+ const factorySettlement = Promise.resolve(factory(api, { signal: signal ?? new AbortController().signal }));
460
+ onFactorySettlement?.(factorySettlement);
461
+ await awaitWithSignal(factorySettlement, signal);
462
+ } catch (error) {
463
+ if (signal?.aborted) {
464
+ runtime.invalidate("Extension creation was aborted.");
465
+ }
466
+ throw error;
467
+ }
468
+ time(`${extensionPath} factory`, "extensions");
469
+ return extension;
470
+ }
471
+
472
+ /**
473
+ * Load extensions from paths.
474
+ */
475
+ async function loadExtensionsInternal(
476
+ paths: string[],
477
+ cwd: string,
478
+ eventBus?: EventBus,
479
+ runtime?: ExtensionRuntime,
480
+ useCache = false,
481
+ signal?: AbortSignal,
482
+ onFactorySettlement?: ExtensionFactorySettlementObserver,
483
+ ): Promise<LoadExtensionsResult> {
484
+ const extensions: Extension[] = [];
485
+ const errors: Array<{ path: string; error: string }> = [];
486
+ const cacheToken = useCache ? useExtensionCacheCwd(cwd) : undefined;
487
+ const resolvedCwd = cacheToken?.cwd ?? resolvePath(cwd);
488
+ const resolvedEventBus = eventBus ?? createEventBus();
489
+ const resolvedRuntime = runtime ?? createExtensionRuntime();
490
+ if (signal?.aborted) {
491
+ resolvedRuntime.invalidate("Extension creation was aborted.");
492
+ throw abortReason(signal);
493
+ }
494
+
495
+ for (const extPath of paths) {
496
+ const { extension, error } = await loadExtension(
497
+ extPath,
498
+ resolvedCwd,
499
+ resolvedEventBus,
500
+ resolvedRuntime,
501
+ cacheToken,
502
+ signal,
503
+ onFactorySettlement,
504
+ );
505
+
506
+ if (error) {
507
+ errors.push({ path: extPath, error });
508
+ continue;
509
+ }
510
+
511
+ if (extension) {
512
+ extensions.push(extension);
513
+ }
514
+ }
515
+ if (signal?.aborted) {
516
+ resolvedRuntime.invalidate("Extension creation was aborted.");
517
+ throw abortReason(signal);
518
+ }
519
+
520
+ return {
521
+ extensions,
522
+ errors,
523
+ runtime: resolvedRuntime,
524
+ };
525
+ }
526
+
527
+ export async function loadExtensions(
528
+ paths: string[],
529
+ cwd: string,
530
+ eventBus?: EventBus,
531
+ runtime?: ExtensionRuntime,
532
+ signal?: AbortSignal,
533
+ onFactorySettlement?: ExtensionFactorySettlementObserver,
534
+ ): Promise<LoadExtensionsResult> {
535
+ return loadExtensionsInternal(paths, cwd, eventBus, runtime, false, signal, onFactorySettlement);
536
+ }
537
+
538
+ export async function loadExtensionsCached(
539
+ paths: string[],
540
+ cwd: string,
541
+ eventBus?: EventBus,
542
+ runtime?: ExtensionRuntime,
543
+ signal?: AbortSignal,
544
+ onFactorySettlement?: ExtensionFactorySettlementObserver,
545
+ ): Promise<LoadExtensionsResult> {
546
+ return loadExtensionsInternal(paths, cwd, eventBus, runtime, true, signal, onFactorySettlement);
547
+ }
548
+
549
+ interface AgentManifest {
550
+ extensions?: string[];
551
+ themes?: string[];
552
+ skills?: string[];
553
+ prompts?: string[];
554
+ }
555
+
556
+ function readAgentManifest(packageJsonPath: string): AgentManifest | null {
557
+ try {
558
+ const content = fs.readFileSync(packageJsonPath, "utf-8");
559
+ const pkg = JSON.parse(content);
560
+ if (pkg.agent && typeof pkg.agent === "object") {
561
+ return pkg.agent as AgentManifest;
562
+ }
563
+ return null;
564
+ } catch {
565
+ return null;
566
+ }
567
+ }
568
+
569
+ function isExtensionFile(name: string): boolean {
570
+ return name.endsWith(".ts") || name.endsWith(".js");
571
+ }
572
+
573
+ /**
574
+ * Resolve extension entry points from a directory.
575
+ *
576
+ * Checks for:
577
+ * 1. package.json with "agent.extensions" field -> returns declared paths
578
+ * 2. index.ts or index.js -> returns the index file
579
+ *
580
+ * Returns resolved paths or null if no entry points found.
581
+ */
582
+ function resolveExtensionEntries(dir: string): string[] | null {
583
+ // Check for package.json with "agent" field first
584
+ const packageJsonPath = path.join(dir, "package.json");
585
+ if (fs.existsSync(packageJsonPath)) {
586
+ const manifest = readAgentManifest(packageJsonPath);
587
+ if (manifest?.extensions?.length) {
588
+ const entries: string[] = [];
589
+ for (const extPath of manifest.extensions) {
590
+ const resolvedExtPath = path.resolve(dir, extPath);
591
+ if (fs.existsSync(resolvedExtPath)) {
592
+ entries.push(resolvedExtPath);
593
+ }
594
+ }
595
+ if (entries.length > 0) {
596
+ return entries;
597
+ }
598
+ }
599
+ }
600
+
601
+ // Check for index.ts or index.js
602
+ const indexTs = path.join(dir, "index.ts");
603
+ const indexJs = path.join(dir, "index.js");
604
+ if (fs.existsSync(indexTs)) {
605
+ return [indexTs];
606
+ }
607
+ if (fs.existsSync(indexJs)) {
608
+ return [indexJs];
609
+ }
610
+
611
+ return null;
612
+ }
613
+
614
+ /**
615
+ * Discover extensions in a directory.
616
+ *
617
+ * Discovery rules:
618
+ * 1. Direct files: `extensions/*.ts` or `*.js` -> load
619
+ * 2. Subdirectory with index: `extensions/* /index.ts` or `index.js` -> load
620
+ * 3. Subdirectory with package.json: `extensions/* /package.json` with "agent" field -> load what it declares
621
+ *
622
+ * No recursion beyond one level. Complex packages must use package.json manifest.
623
+ */
624
+ function discoverExtensionsInDir(dir: string): string[] {
625
+ if (!fs.existsSync(dir)) {
626
+ return [];
627
+ }
628
+
629
+ const discovered: string[] = [];
630
+
631
+ try {
632
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
633
+
634
+ for (const entry of entries) {
635
+ const entryPath = path.join(dir, entry.name);
636
+
637
+ // 1. Direct files: *.ts or *.js
638
+ if ((entry.isFile() || entry.isSymbolicLink()) && isExtensionFile(entry.name)) {
639
+ discovered.push(entryPath);
640
+ continue;
641
+ }
642
+
643
+ // 2 & 3. Subdirectories
644
+ if (entry.isDirectory() || entry.isSymbolicLink()) {
645
+ const entries = resolveExtensionEntries(entryPath);
646
+ if (entries) {
647
+ discovered.push(...entries);
648
+ }
649
+ }
650
+ }
651
+ } catch {
652
+ return [];
653
+ }
654
+
655
+ return discovered;
656
+ }
657
+
658
+ /**
659
+ * Discover and load extensions from standard locations.
660
+ */
661
+ export async function discoverAndLoadExtensions(
662
+ configuredPaths: string[],
663
+ cwd: string,
664
+ agentDir: string = getAgentDir(),
665
+ eventBus?: EventBus,
666
+ ): Promise<LoadExtensionsResult> {
667
+ const resolvedCwd = resolvePath(cwd);
668
+ const resolvedAgentDir = resolvePath(agentDir);
669
+ const allPaths: string[] = [];
670
+ const seen = new Set<string>();
671
+
672
+ const addPaths = (paths: string[]) => {
673
+ for (const p of paths) {
674
+ const resolved = path.resolve(p);
675
+ if (!seen.has(resolved)) {
676
+ seen.add(resolved);
677
+ allPaths.push(p);
678
+ }
679
+ }
680
+ };
681
+
682
+ // 1. Project-local extensions: cwd/${CONFIG_DIR_NAME}/extensions/
683
+ const localExtDir = path.join(resolvedCwd, CONFIG_DIR_NAME, "extensions");
684
+ addPaths(discoverExtensionsInDir(localExtDir));
685
+
686
+ // 2. Global extensions: agentDir/extensions/
687
+ const globalExtDir = path.join(resolvedAgentDir, "extensions");
688
+ addPaths(discoverExtensionsInDir(globalExtDir));
689
+
690
+ // 3. Explicitly configured paths
691
+ for (const p of configuredPaths) {
692
+ const resolved = resolvePath(p, resolvedCwd, { normalizeUnicodeSpaces: true });
693
+ if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
694
+ // Check for package.json with agent manifest or index.ts
695
+ const entries = resolveExtensionEntries(resolved);
696
+ if (entries) {
697
+ addPaths(entries);
698
+ continue;
699
+ }
700
+ // No explicit entries - discover individual files in directory
701
+ addPaths(discoverExtensionsInDir(resolved));
702
+ continue;
703
+ }
704
+
705
+ addPaths([resolved]);
706
+ }
707
+
708
+ return loadExtensions(allPaths, resolvedCwd, eventBus);
709
+ }