luca 3.0.0 → 3.0.2

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 (372) hide show
  1. package/.github/workflows/release.yaml +1 -0
  2. package/CLAUDE.md +10 -2
  3. package/README.md +130 -112
  4. package/assistants/codingAssistant/CORE.md +6 -1
  5. package/assistants/codingAssistant/hooks.ts +1 -1
  6. package/assistants/inkbot/hooks.ts +1 -1
  7. package/assistants/inkbot/tools.ts +1 -1
  8. package/bun.lock +220 -322
  9. package/commands/audit-docs.ts +2 -2
  10. package/commands/build-bootstrap.ts +2 -3
  11. package/commands/build-python-bridge.ts +2 -3
  12. package/commands/build-scaffolds.ts +2 -3
  13. package/commands/bundle-consumer-project.ts +521 -0
  14. package/commands/generate-api-docs.ts +2 -2
  15. package/commands/inkbot.ts +2 -2
  16. package/commands/release.ts +2 -2
  17. package/commands/try-all-challenges.ts +3 -3
  18. package/commands/try-challenge.ts +3 -3
  19. package/dist/agi/container.server.d.ts +2 -2
  20. package/dist/agi/features/assistant.d.ts +2 -2
  21. package/dist/agi/features/assistants-manager.d.ts +1 -1
  22. package/dist/agi/features/autonomous-assistant.d.ts +1 -1
  23. package/dist/agi/features/browser-use.d.ts +1 -1
  24. package/dist/agi/features/claude-code.d.ts +1 -1
  25. package/dist/agi/features/conversation-history.d.ts +2 -2
  26. package/dist/agi/features/conversation.d.ts +1 -1
  27. package/dist/agi/features/docs-reader.d.ts +1 -1
  28. package/dist/agi/features/file-tools.d.ts +1 -1
  29. package/dist/agi/features/luca-coder.d.ts +1 -1
  30. package/dist/agi/features/openai-codex.d.ts +1 -1
  31. package/dist/agi/features/skills-library.d.ts +1 -1
  32. package/dist/clients/civitai/index.d.ts +4 -4
  33. package/dist/clients/client-template.d.ts +4 -4
  34. package/dist/clients/comfyui/index.d.ts +2 -2
  35. package/dist/clients/elevenlabs/index.d.ts +2 -2
  36. package/dist/clients/openai/index.d.ts +2 -2
  37. package/dist/clients/supabase/index.d.ts +3 -3
  38. package/dist/command.d.ts +1 -1
  39. package/dist/node/container.d.ts +1 -1
  40. package/dist/node/features/helpers.d.ts +3 -3
  41. package/dist/node/features/semantic-search.d.ts +1 -1
  42. package/dist/node/features/vm.d.ts +3 -3
  43. package/dist/node.d.ts +1 -1
  44. package/dist/scaffolds/generated.d.ts +1 -1
  45. package/dist/selector.d.ts +1 -1
  46. package/index.html +217 -190
  47. package/luca.console.ts +1 -1
  48. package/package.json +2 -2
  49. package/public/index.html +217 -190
  50. package/public/slides-ai-native.html +1 -1
  51. package/public/slides-intro.html +2 -2
  52. package/scripts/examples/ask-luca-expert.ts +1 -1
  53. package/scripts/examples/assistant-questions.ts +1 -1
  54. package/scripts/examples/excalidraw-expert.ts +1 -1
  55. package/scripts/examples/file-manager.ts +1 -1
  56. package/scripts/examples/ideas.ts +1 -1
  57. package/scripts/examples/interactive-chat.ts +1 -1
  58. package/scripts/examples/opening-a-web-browser.ts +1 -1
  59. package/scripts/examples/telegram-bot.ts +1 -1
  60. package/scripts/examples/using-assistant-with-mcp.ts +1 -1
  61. package/scripts/examples/using-claude-code.ts +1 -1
  62. package/scripts/examples/using-contentdb.ts +2 -2
  63. package/scripts/examples/using-conversations.ts +1 -1
  64. package/scripts/examples/using-disk-cache.ts +1 -1
  65. package/scripts/examples/using-docker-shell.ts +1 -1
  66. package/scripts/examples/using-elevenlabs.ts +1 -1
  67. package/scripts/examples/using-google-calendar.ts +1 -1
  68. package/scripts/examples/using-google-docs.ts +1 -1
  69. package/scripts/examples/using-google-drive.ts +1 -1
  70. package/scripts/examples/using-google-sheets.ts +1 -1
  71. package/scripts/examples/using-nlp.ts +1 -1
  72. package/scripts/examples/using-ollama.ts +1 -1
  73. package/scripts/examples/using-postgres.ts +1 -1
  74. package/scripts/examples/using-runpod.ts +1 -1
  75. package/scripts/examples/using-tts.ts +1 -1
  76. package/scripts/scaffold.ts +5 -5
  77. package/scripts/scratch.ts +1 -1
  78. package/scripts/test-assistant-hooks.ts +1 -1
  79. package/scripts/test-docs-reader.ts +1 -1
  80. package/src/agi/container.server.ts +6 -2
  81. package/src/agi/features/agent-memory.ts +25 -25
  82. package/src/agi/features/assistant.ts +34 -5
  83. package/src/agi/features/assistants-manager.ts +122 -6
  84. package/src/agi/features/autonomous-assistant.ts +1 -1
  85. package/src/agi/features/browser-use.ts +20 -1
  86. package/src/agi/features/claude-code.ts +51 -5
  87. package/src/agi/features/coding-tools.ts +1 -1
  88. package/src/agi/features/conversation-history.ts +181 -4
  89. package/src/agi/features/conversation.ts +186 -15
  90. package/src/agi/features/docs-reader.ts +2 -2
  91. package/src/agi/features/file-tools.ts +49 -2
  92. package/src/agi/features/luca-coder.ts +7 -5
  93. package/src/agi/features/mcp-bridge.ts +532 -0
  94. package/src/agi/features/openai-codex.ts +2 -2
  95. package/src/agi/features/skills-library.ts +131 -52
  96. package/src/agi/lib/token-counter.ts +80 -0
  97. package/src/bootstrap/generated.ts +56 -57
  98. package/src/browser.ts +1 -1
  99. package/src/cli/build-info.ts +2 -2
  100. package/src/cli/cli.ts +2 -2
  101. package/src/clients/civitai/index.ts +5 -5
  102. package/src/clients/client-template.ts +4 -4
  103. package/src/clients/comfyui/index.ts +4 -4
  104. package/src/clients/elevenlabs/index.ts +4 -4
  105. package/src/clients/openai/index.ts +7 -7
  106. package/src/clients/supabase/index.ts +4 -4
  107. package/src/clients/voicebox/index.ts +4 -4
  108. package/src/command.ts +2 -1
  109. package/src/commands/chat.ts +1 -0
  110. package/src/commands/eval.ts +2 -56
  111. package/src/commands/introspect.ts +1 -1
  112. package/src/commands/prompt.ts +41 -9
  113. package/src/container-describer.ts +8 -1
  114. package/src/container.ts +13 -0
  115. package/src/entity.ts +2 -2
  116. package/src/helper.ts +1 -1
  117. package/src/introspection/generated.agi.ts +28563 -27571
  118. package/src/introspection/generated.node.ts +20281 -20194
  119. package/src/introspection/generated.web.ts +605 -584
  120. package/src/introspection/scan.ts +11 -6
  121. package/src/node/container.ts +1 -1
  122. package/src/node/features/content-db.ts +39 -2
  123. package/src/node/features/display-result.ts +57 -0
  124. package/src/node/features/helpers.ts +42 -15
  125. package/src/node/features/python.ts +25 -19
  126. package/src/node/features/repl.ts +1 -1
  127. package/src/node/features/secure-shell.ts +11 -17
  128. package/src/node/features/semantic-search.ts +2 -2
  129. package/src/node/features/transpiler.ts +2 -3
  130. package/src/node/features/ui.ts +5 -0
  131. package/src/node/features/vm.ts +3 -3
  132. package/src/node.ts +3 -3
  133. package/src/python/generated.ts +0 -1
  134. package/src/scaffolds/generated.ts +82 -83
  135. package/src/selector.ts +1 -1
  136. package/src/servers/express.ts +1 -1
  137. package/src/web/features/helpers.ts +22 -0
  138. package/tsconfig.json +12 -12
  139. package/docs/CLI.md +0 -335
  140. package/docs/CNAME +0 -1
  141. package/docs/README.md +0 -60
  142. package/docs/TABLE-OF-CONTENTS.md +0 -183
  143. package/docs/apis/clients/elevenlabs.md +0 -308
  144. package/docs/apis/clients/graph.md +0 -107
  145. package/docs/apis/clients/openai.md +0 -429
  146. package/docs/apis/clients/rest.md +0 -161
  147. package/docs/apis/clients/websocket.md +0 -174
  148. package/docs/apis/features/agi/assistant.md +0 -625
  149. package/docs/apis/features/agi/assistants-manager.md +0 -282
  150. package/docs/apis/features/agi/auto-assistant.md +0 -279
  151. package/docs/apis/features/agi/browser-use.md +0 -802
  152. package/docs/apis/features/agi/claude-code.md +0 -884
  153. package/docs/apis/features/agi/conversation-history.md +0 -364
  154. package/docs/apis/features/agi/conversation.md +0 -548
  155. package/docs/apis/features/agi/docs-reader.md +0 -99
  156. package/docs/apis/features/agi/file-tools.md +0 -163
  157. package/docs/apis/features/agi/luca-coder.md +0 -407
  158. package/docs/apis/features/agi/openai-codex.md +0 -396
  159. package/docs/apis/features/agi/openapi.md +0 -138
  160. package/docs/apis/features/agi/semantic-search.md +0 -387
  161. package/docs/apis/features/agi/skills-library.md +0 -239
  162. package/docs/apis/features/node/container-link.md +0 -192
  163. package/docs/apis/features/node/content-db.md +0 -450
  164. package/docs/apis/features/node/disk-cache.md +0 -379
  165. package/docs/apis/features/node/dns.md +0 -652
  166. package/docs/apis/features/node/docker.md +0 -706
  167. package/docs/apis/features/node/downloader.md +0 -81
  168. package/docs/apis/features/node/esbuild.md +0 -60
  169. package/docs/apis/features/node/file-manager.md +0 -191
  170. package/docs/apis/features/node/fs.md +0 -1217
  171. package/docs/apis/features/node/git.md +0 -371
  172. package/docs/apis/features/node/google-auth.md +0 -193
  173. package/docs/apis/features/node/google-calendar.md +0 -202
  174. package/docs/apis/features/node/google-docs.md +0 -173
  175. package/docs/apis/features/node/google-drive.md +0 -246
  176. package/docs/apis/features/node/google-mail.md +0 -214
  177. package/docs/apis/features/node/google-sheets.md +0 -194
  178. package/docs/apis/features/node/grep.md +0 -292
  179. package/docs/apis/features/node/helpers.md +0 -164
  180. package/docs/apis/features/node/ink.md +0 -334
  181. package/docs/apis/features/node/ipc-socket.md +0 -249
  182. package/docs/apis/features/node/json-tree.md +0 -86
  183. package/docs/apis/features/node/networking.md +0 -316
  184. package/docs/apis/features/node/nlp.md +0 -133
  185. package/docs/apis/features/node/opener.md +0 -97
  186. package/docs/apis/features/node/os.md +0 -146
  187. package/docs/apis/features/node/package-finder.md +0 -392
  188. package/docs/apis/features/node/postgres.md +0 -234
  189. package/docs/apis/features/node/proc.md +0 -399
  190. package/docs/apis/features/node/process-manager.md +0 -305
  191. package/docs/apis/features/node/python.md +0 -604
  192. package/docs/apis/features/node/redis.md +0 -380
  193. package/docs/apis/features/node/repl.md +0 -88
  194. package/docs/apis/features/node/runpod.md +0 -674
  195. package/docs/apis/features/node/secure-shell.md +0 -176
  196. package/docs/apis/features/node/semantic-search.md +0 -408
  197. package/docs/apis/features/node/sqlite.md +0 -233
  198. package/docs/apis/features/node/telegram.md +0 -279
  199. package/docs/apis/features/node/transpiler.md +0 -74
  200. package/docs/apis/features/node/tts.md +0 -133
  201. package/docs/apis/features/node/ui.md +0 -701
  202. package/docs/apis/features/node/vault.md +0 -59
  203. package/docs/apis/features/node/vm.md +0 -75
  204. package/docs/apis/features/node/yaml-tree.md +0 -85
  205. package/docs/apis/features/node/yaml.md +0 -176
  206. package/docs/apis/features/web/asset-loader.md +0 -59
  207. package/docs/apis/features/web/container-link.md +0 -192
  208. package/docs/apis/features/web/esbuild.md +0 -54
  209. package/docs/apis/features/web/helpers.md +0 -164
  210. package/docs/apis/features/web/network.md +0 -44
  211. package/docs/apis/features/web/speech.md +0 -69
  212. package/docs/apis/features/web/vault.md +0 -59
  213. package/docs/apis/features/web/vm.md +0 -75
  214. package/docs/apis/features/web/voice.md +0 -84
  215. package/docs/apis/servers/express.md +0 -171
  216. package/docs/apis/servers/mcp.md +0 -238
  217. package/docs/apis/servers/websocket.md +0 -170
  218. package/docs/bootstrap/CLAUDE.md +0 -101
  219. package/docs/bootstrap/SKILL.md +0 -341
  220. package/docs/bootstrap/templates/about-command.ts +0 -41
  221. package/docs/bootstrap/templates/docs-models.ts +0 -22
  222. package/docs/bootstrap/templates/docs-readme.md +0 -43
  223. package/docs/bootstrap/templates/example-feature.ts +0 -53
  224. package/docs/bootstrap/templates/health-endpoint.ts +0 -15
  225. package/docs/bootstrap/templates/luca-cli.ts +0 -30
  226. package/docs/bootstrap/templates/runme.md +0 -54
  227. package/docs/challenges/caching-proxy.md +0 -16
  228. package/docs/challenges/content-db-round-trip.md +0 -14
  229. package/docs/challenges/custom-command.md +0 -9
  230. package/docs/challenges/file-watcher-pipeline.md +0 -11
  231. package/docs/challenges/grep-audit-report.md +0 -15
  232. package/docs/challenges/multi-feature-dashboard.md +0 -14
  233. package/docs/challenges/process-orchestrator.md +0 -17
  234. package/docs/challenges/rest-api-server-with-client.md +0 -12
  235. package/docs/challenges/script-runner-with-vm.md +0 -11
  236. package/docs/challenges/simple-rest-api.md +0 -15
  237. package/docs/challenges/websocket-serve-and-client.md +0 -11
  238. package/docs/challenges/yaml-config-system.md +0 -14
  239. package/docs/command-system-overhaul.md +0 -94
  240. package/docs/documentation-audit.md +0 -134
  241. package/docs/examples/assistant/CORE.md +0 -18
  242. package/docs/examples/assistant/hooks.ts +0 -3
  243. package/docs/examples/assistant/tools.ts +0 -10
  244. package/docs/examples/assistant-hooks-reference.ts +0 -171
  245. package/docs/examples/assistant-with-process-manager.md +0 -84
  246. package/docs/examples/content-db.md +0 -77
  247. package/docs/examples/disk-cache.md +0 -83
  248. package/docs/examples/docker.md +0 -101
  249. package/docs/examples/downloader.md +0 -70
  250. package/docs/examples/entity.md +0 -124
  251. package/docs/examples/esbuild.md +0 -80
  252. package/docs/examples/feature-as-tool-provider.md +0 -143
  253. package/docs/examples/file-manager.md +0 -82
  254. package/docs/examples/fs.md +0 -83
  255. package/docs/examples/git.md +0 -85
  256. package/docs/examples/google-auth.md +0 -88
  257. package/docs/examples/google-calendar.md +0 -94
  258. package/docs/examples/google-docs.md +0 -82
  259. package/docs/examples/google-drive.md +0 -96
  260. package/docs/examples/google-sheets.md +0 -95
  261. package/docs/examples/grep.md +0 -85
  262. package/docs/examples/ink-blocks.md +0 -75
  263. package/docs/examples/ink-renderer.md +0 -41
  264. package/docs/examples/ink.md +0 -103
  265. package/docs/examples/ipc-socket.md +0 -103
  266. package/docs/examples/json-tree.md +0 -91
  267. package/docs/examples/networking.md +0 -58
  268. package/docs/examples/nlp.md +0 -91
  269. package/docs/examples/opener.md +0 -78
  270. package/docs/examples/os.md +0 -72
  271. package/docs/examples/package-finder.md +0 -89
  272. package/docs/examples/postgres.md +0 -91
  273. package/docs/examples/proc.md +0 -81
  274. package/docs/examples/process-manager.md +0 -79
  275. package/docs/examples/python.md +0 -132
  276. package/docs/examples/repl.md +0 -93
  277. package/docs/examples/runpod.md +0 -119
  278. package/docs/examples/secure-shell.md +0 -92
  279. package/docs/examples/sqlite.md +0 -86
  280. package/docs/examples/structured-output-with-assistants.md +0 -144
  281. package/docs/examples/telegram.md +0 -77
  282. package/docs/examples/tts.md +0 -86
  283. package/docs/examples/ui.md +0 -80
  284. package/docs/examples/vault.md +0 -70
  285. package/docs/examples/vm.md +0 -86
  286. package/docs/examples/websocket-ask-and-reply-example.md +0 -128
  287. package/docs/examples/yaml-tree.md +0 -93
  288. package/docs/examples/yaml.md +0 -104
  289. package/docs/ideas/assistant-factory-pattern.md +0 -142
  290. package/docs/in-memory-fs.md +0 -4
  291. package/docs/introspection-audit.md +0 -49
  292. package/docs/introspection.md +0 -164
  293. package/docs/mcp/readme.md +0 -162
  294. package/docs/models.ts +0 -41
  295. package/docs/philosophy.md +0 -86
  296. package/docs/principles.md +0 -7
  297. package/docs/prompts/audit-codebase-for-failures-to-use-the-container.md +0 -34
  298. package/docs/prompts/check-for-undocumented-features.md +0 -27
  299. package/docs/prompts/mcp-test-easy-command.md +0 -27
  300. package/docs/scaffolds/client.md +0 -149
  301. package/docs/scaffolds/command.md +0 -120
  302. package/docs/scaffolds/endpoint.md +0 -171
  303. package/docs/scaffolds/feature.md +0 -158
  304. package/docs/scaffolds/selector.md +0 -91
  305. package/docs/scaffolds/server.md +0 -196
  306. package/docs/selectors.md +0 -115
  307. package/docs/sessions/custom-command/attempt-log-2.md +0 -195
  308. package/docs/sessions/file-watcher-pipeline/attempt-log-1.md +0 -728
  309. package/docs/sessions/file-watcher-pipeline/attempt-log-2.md +0 -555
  310. package/docs/sessions/grep-audit-report/attempt-log-1.md +0 -289
  311. package/docs/sessions/multi-feature-dashboard/attempt-log-2.md +0 -679
  312. package/docs/sessions/rest-api-server-with-client/attempt-log-1.md +0 -1
  313. package/docs/sessions/rest-api-server-with-client/attempt-log-3.md +0 -920
  314. package/docs/sessions/simple-rest-api/attempt-log-1.md +0 -593
  315. package/docs/sessions/websocket-serve-and-client/attempt-log-2.md +0 -995
  316. package/docs/tutorials/00-bootstrap.md +0 -166
  317. package/docs/tutorials/01-getting-started.md +0 -106
  318. package/docs/tutorials/02-container.md +0 -210
  319. package/docs/tutorials/03-scripts.md +0 -194
  320. package/docs/tutorials/04-features-overview.md +0 -196
  321. package/docs/tutorials/05-state-and-events.md +0 -171
  322. package/docs/tutorials/06-servers.md +0 -157
  323. package/docs/tutorials/07-endpoints.md +0 -198
  324. package/docs/tutorials/08-commands.md +0 -252
  325. package/docs/tutorials/09-clients.md +0 -162
  326. package/docs/tutorials/10-creating-features.md +0 -203
  327. package/docs/tutorials/11-contentbase.md +0 -191
  328. package/docs/tutorials/12-assistants.md +0 -215
  329. package/docs/tutorials/13-introspection.md +0 -157
  330. package/docs/tutorials/14-type-system.md +0 -174
  331. package/docs/tutorials/15-project-patterns.md +0 -222
  332. package/docs/tutorials/16-google-features.md +0 -534
  333. package/docs/tutorials/17-tui-blocks.md +0 -530
  334. package/docs/tutorials/18-semantic-search.md +0 -334
  335. package/docs/tutorials/19-python-sessions.md +0 -401
  336. package/docs/tutorials/20-browser-esm.md +0 -234
  337. package/src/agi/endpoints/ask.ts +0 -60
  338. package/src/agi/endpoints/conversations/[id].ts +0 -45
  339. package/src/agi/endpoints/conversations.ts +0 -31
  340. package/src/agi/endpoints/experts.ts +0 -37
  341. package/test/assistant-hooks.test.ts +0 -306
  342. package/test/assistant.test.ts +0 -81
  343. package/test/bus.test.ts +0 -134
  344. package/test/clients-servers.test.ts +0 -217
  345. package/test/command.test.ts +0 -267
  346. package/test/container-link.test.ts +0 -274
  347. package/test/conversation.test.ts +0 -220
  348. package/test/features.test.ts +0 -160
  349. package/test/fork-and-research.test.ts +0 -450
  350. package/test/integration.test.ts +0 -787
  351. package/test/interceptor-chain.test.ts +0 -61
  352. package/test/node-container.test.ts +0 -121
  353. package/test/python-session.test.ts +0 -105
  354. package/test/rate-limit.test.ts +0 -272
  355. package/test/semantic-search.test.ts +0 -550
  356. package/test/state.test.ts +0 -121
  357. package/test/vm-context.test.ts +0 -146
  358. package/test/vm-loadmodule.test.ts +0 -213
  359. package/test/websocket-ask.test.ts +0 -101
  360. package/test-integration/assistant.test.ts +0 -138
  361. package/test-integration/assistants-manager.test.ts +0 -113
  362. package/test-integration/claude-code.test.ts +0 -98
  363. package/test-integration/conversation-history.test.ts +0 -205
  364. package/test-integration/conversation.test.ts +0 -137
  365. package/test-integration/elevenlabs.test.ts +0 -55
  366. package/test-integration/google-services.test.ts +0 -80
  367. package/test-integration/helpers.ts +0 -89
  368. package/test-integration/memory.test.ts +0 -204
  369. package/test-integration/openai-codex.test.ts +0 -93
  370. package/test-integration/runpod.test.ts +0 -58
  371. package/test-integration/server-endpoints.test.ts +0 -97
  372. package/test-integration/telegram.test.ts +0 -46
@@ -1,274 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach } from 'bun:test'
2
- import { NodeContainer } from '../src/node/container'
3
- import { MessageTypes, type LinkMessage, type ContainerLink } from '../src/node/features/container-link'
4
-
5
- // Local helper for tests — mirrors the protocol message format
6
- let _testMsgCounter = 0
7
- function createTestMessage<T = any>(type: string, data?: T, token?: string): LinkMessage<T> {
8
- return {
9
- type: type as any,
10
- id: `test-${Date.now()}-${++_testMsgCounter}`,
11
- timestamp: Date.now(),
12
- ...(token != null ? { token } : {}),
13
- ...(data != null ? { data } : {}),
14
- }
15
- }
16
-
17
- // Helper: connect and register using Bun's native WebSocket
18
- async function connectAndRegister(port: number, uuid: string, opts?: { url?: string; capabilities?: string[]; meta?: Record<string, any> }) {
19
- const ws = new WebSocket(`ws://localhost:${port}`)
20
-
21
- const token = await new Promise<string>((resolve, reject) => {
22
- ws.onopen = () => {
23
- ws.send(JSON.stringify(createTestMessage(MessageTypes.register, {
24
- uuid,
25
- url: opts?.url,
26
- capabilities: opts?.capabilities,
27
- meta: opts?.meta,
28
- })))
29
- }
30
- ws.onmessage = (event: MessageEvent) => {
31
- const msg = JSON.parse(event.data)
32
- if (msg.type === 'registered') resolve(msg.data.token)
33
- if (msg.type === 'error') reject(new Error(msg.data?.message))
34
- }
35
- ws.onerror = () => reject(new Error('WS error'))
36
- setTimeout(() => reject(new Error('Registration timeout')), 3000)
37
- })
38
-
39
- return { ws, token }
40
- }
41
-
42
- function closeWs(ws: WebSocket): Promise<void> {
43
- return new Promise((resolve) => {
44
- if (ws.readyState === WebSocket.CLOSED) { resolve(); return }
45
- ws.onclose = () => resolve()
46
- ws.close()
47
- setTimeout(resolve, 200)
48
- })
49
- }
50
-
51
- describe('link message construction', () => {
52
- it('generates unique ids', () => {
53
- const a = createTestMessage(MessageTypes.ping)
54
- const b = createTestMessage(MessageTypes.ping)
55
- expect(a.id).not.toBe(b.id)
56
- })
57
-
58
- it('sets timestamp', () => {
59
- const before = Date.now()
60
- const msg = createTestMessage(MessageTypes.eval, { code: '1+1' })
61
- expect(msg.timestamp).toBeGreaterThanOrEqual(before)
62
- expect(msg.timestamp).toBeLessThanOrEqual(Date.now())
63
- })
64
-
65
- it('includes type and data', () => {
66
- const msg = createTestMessage(MessageTypes.event, { eventName: 'click', data: { x: 1 } }, 'tok123')
67
- expect(msg.type).toBe('event')
68
- expect(msg.data).toEqual({ eventName: 'click', data: { x: 1 } })
69
- expect(msg.token).toBe('tok123')
70
- })
71
-
72
- it('omits token when not provided', () => {
73
- const msg = createTestMessage(MessageTypes.ping)
74
- expect(msg.token).toBeUndefined()
75
- })
76
- })
77
-
78
- describe('ContainerLink (node-side)', () => {
79
- let container: NodeContainer
80
- let link: ContainerLink
81
- let port: number
82
- const openSockets: WebSocket[] = []
83
-
84
- beforeEach(async () => {
85
- container = new NodeContainer({ cwd: process.cwd() })
86
- const networking = container.feature('networking')
87
- port = await networking.findOpenPort(9100)
88
- link = container.feature('containerLink', { enable: true, port }) as ContainerLink
89
- })
90
-
91
- afterEach(async () => {
92
- for (const ws of openSockets) {
93
- await closeWs(ws).catch(() => {})
94
- }
95
- openSockets.length = 0
96
- await link.stop().catch(() => {})
97
- })
98
-
99
- it('instantiates with correct defaults', () => {
100
- expect(link).toBeDefined()
101
- expect(link.isListening).toBe(false)
102
- expect(link.connectionCount).toBe(0)
103
- })
104
-
105
- it('generates unique tokens', () => {
106
- const tokens = new Set<string>()
107
- for (let i = 0; i < 100; i++) {
108
- tokens.add(link.generateToken())
109
- }
110
- expect(tokens.size).toBe(100)
111
- })
112
-
113
- it('tokens are 64 hex chars', () => {
114
- const token = link.generateToken()
115
- expect(token).toMatch(/^[0-9a-f]{64}$/)
116
- })
117
-
118
- it('reports listening after start', async () => {
119
- await link.start()
120
- expect(link.isListening).toBe(true)
121
- })
122
-
123
- it('accepts connection and performs registration handshake', async () => {
124
- await link.start()
125
- const { ws, token } = await connectAndRegister(port, 'test-web-container', {
126
- url: 'http://localhost:3000',
127
- capabilities: ['eval'],
128
- meta: { name: 'test' },
129
- })
130
- openSockets.push(ws)
131
-
132
- expect(token).toBeTruthy()
133
- expect(link.connectionCount).toBe(1)
134
-
135
- const connections = link.getConnections()
136
- expect(connections).toHaveLength(1)
137
- expect(connections[0].uuid).toBe('test-web-container')
138
- })
139
-
140
- it('rejects eval messages from web containers', async () => {
141
- await link.start()
142
- const { ws, token } = await connectAndRegister(port, 'attacker')
143
- openSockets.push(ws)
144
-
145
- const errorMsg = await new Promise<any>((resolve, reject) => {
146
- ws.onmessage = (event: MessageEvent) => {
147
- const msg = JSON.parse(event.data)
148
- if (msg.type === 'error') resolve(msg)
149
- }
150
-
151
- ws.send(JSON.stringify(createTestMessage(MessageTypes.eval, {
152
- code: 'process.exit(1)',
153
- requestId: 'evil-123',
154
- }, token)))
155
-
156
- setTimeout(() => reject(new Error('Timeout')), 3000)
157
- })
158
-
159
- expect(errorMsg.type).toBe('error')
160
- expect(errorMsg.data.message).toContain('not permitted')
161
- })
162
-
163
- it('eval sends code and resolves with result', async () => {
164
- await link.start()
165
- const { ws, token } = await connectAndRegister(port, 'eval-target')
166
- openSockets.push(ws)
167
-
168
- // Simulate web container responding to evals
169
- ws.onmessage = (event: MessageEvent) => {
170
- const msg = JSON.parse(event.data)
171
- if (msg.type === 'eval') {
172
- ws.send(JSON.stringify(createTestMessage(MessageTypes.evalResult, {
173
- requestId: msg.data.requestId,
174
- result: 42,
175
- }, token)))
176
- }
177
- }
178
-
179
- const result = await link.eval('eval-target', '21 * 2')
180
- expect(result).toBe(42)
181
- })
182
-
183
- it('eval rejects when container not found', async () => {
184
- await link.start()
185
- await expect(link.eval('nonexistent', '1+1')).rejects.toThrow('No connection found')
186
- })
187
-
188
- it('eval rejects on timeout', async () => {
189
- await link.start()
190
- const { ws } = await connectAndRegister(port, 'slow-container')
191
- openSockets.push(ws)
192
-
193
- // Don't respond to eval — should timeout
194
- await expect(link.eval('slow-container', '1+1', undefined, 200)).rejects.toThrow('timed out')
195
- })
196
-
197
- it('disconnect removes a specific client', async () => {
198
- await link.start()
199
- const { ws } = await connectAndRegister(port, 'to-disconnect')
200
- openSockets.push(ws)
201
-
202
- expect(link.connectionCount).toBe(1)
203
- link.disconnect('to-disconnect', 'test')
204
- await new Promise(r => setTimeout(r, 50))
205
- expect(link.connectionCount).toBe(0)
206
- })
207
-
208
- it('emits connection and disconnection events', async () => {
209
- await link.start()
210
- const events: string[] = []
211
- link.on('connection', (uuid: string) => events.push(`connect:${uuid}`))
212
- link.on('disconnection', (uuid: string) => events.push(`disconnect:${uuid}`))
213
-
214
- const { ws } = await connectAndRegister(port, 'event-test')
215
-
216
- expect(events).toContain('connect:event-test')
217
-
218
- await closeWs(ws)
219
- await new Promise(r => setTimeout(r, 50))
220
- expect(events).toContain('disconnect:event-test')
221
- })
222
-
223
- it('handles structured events from web containers', async () => {
224
- await link.start()
225
- const { ws, token } = await connectAndRegister(port, 'event-sender')
226
- openSockets.push(ws)
227
-
228
- const receivedEvent = new Promise<any>((resolve) => {
229
- link.on('event', (uuid: string, eventName: string, data: any) => {
230
- resolve({ uuid, eventName, data })
231
- })
232
- })
233
-
234
- ws.send(JSON.stringify(createTestMessage(MessageTypes.event, {
235
- eventName: 'userClick',
236
- data: { x: 100, y: 200 },
237
- }, token)))
238
-
239
- const evt = await receivedEvent
240
- expect(evt.uuid).toBe('event-sender')
241
- expect(evt.eventName).toBe('userClick')
242
- expect(evt.data).toEqual({ x: 100, y: 200 })
243
- })
244
-
245
- it('registration without uuid returns error', async () => {
246
- await link.start()
247
- const ws = new WebSocket(`ws://localhost:${port}`)
248
- openSockets.push(ws)
249
-
250
- const errorMsg = await new Promise<any>((resolve, reject) => {
251
- ws.onopen = () => {
252
- ws.send(JSON.stringify(createTestMessage(MessageTypes.register, {})))
253
- }
254
- ws.onmessage = (event: MessageEvent) => {
255
- const msg = JSON.parse(event.data)
256
- if (msg.type === 'error') resolve(msg)
257
- }
258
- ws.onerror = () => reject(new Error('WS error'))
259
- setTimeout(() => reject(new Error('Timeout')), 3000)
260
- })
261
-
262
- expect(errorMsg.data.message).toContain('uuid')
263
- })
264
-
265
- it('stop cleans up server and connections', async () => {
266
- await link.start()
267
- const { ws } = await connectAndRegister(port, 'cleanup-test')
268
- openSockets.push(ws)
269
-
270
- await link.stop()
271
- expect(link.isListening).toBe(false)
272
- expect(link.connectionCount).toBe(0)
273
- })
274
- })
@@ -1,220 +0,0 @@
1
- import { describe, it, expect, beforeEach } from 'bun:test'
2
- import { AGIContainer } from '../src/agi/container.server'
3
- import type { Conversation } from '../src/agi/features/conversation'
4
-
5
- function makeConversation(opts: Record<string, any> = {}): Conversation {
6
- const container = new AGIContainer()
7
- return container.feature('conversation', { model: 'gpt-5', ...opts }) as Conversation
8
- }
9
-
10
- describe('Conversation', () => {
11
- describe('state', () => {
12
- it('initializes with empty messages when no history provided', () => {
13
- const conv = makeConversation()
14
- expect(conv.messages).toEqual([])
15
- })
16
-
17
- it('seeds message history from options', () => {
18
- const history = [{ role: 'system', content: 'You are helpful.' }]
19
- const conv = makeConversation({ history })
20
- expect(conv.messages).toHaveLength(1)
21
- expect(conv.messages[0]).toEqual(history[0])
22
- })
23
-
24
- it('uses provided model', () => {
25
- const conv = makeConversation({ model: 'gpt-4.1' })
26
- expect(conv.model).toBe('gpt-4.1')
27
- })
28
-
29
- it('isStreaming is false initially', () => {
30
- const conv = makeConversation()
31
- expect(conv.isStreaming).toBe(false)
32
- })
33
- })
34
-
35
- describe('pushMessage', () => {
36
- it('appends to messages', () => {
37
- const conv = makeConversation()
38
- conv.pushMessage({ role: 'user', content: 'hello' })
39
- expect(conv.messages).toHaveLength(1)
40
- expect(conv.messages[0]!.role).toBe('user')
41
- })
42
-
43
- it('does not mutate prior messages array', () => {
44
- const conv = makeConversation()
45
- const before = conv.messages
46
- conv.pushMessage({ role: 'user', content: 'hi' })
47
- expect(conv.messages).not.toBe(before)
48
- })
49
- })
50
-
51
- describe('tools', () => {
52
- it('starts with no tools', () => {
53
- const conv = makeConversation()
54
- expect(conv.availableTools).toHaveLength(0)
55
- })
56
-
57
- it('addTool registers a tool', () => {
58
- const conv = makeConversation()
59
- conv.addTool('greet', {
60
- description: 'Says hello',
61
- parameters: { type: 'object', properties: {} },
62
- handler: async () => 'hello',
63
- })
64
- expect(conv.availableTools).toContain('greet')
65
- })
66
-
67
- it('removeTool deregisters a tool', () => {
68
- const conv = makeConversation()
69
- conv.addTool('greet', {
70
- description: 'Says hello',
71
- parameters: { type: 'object', properties: {} },
72
- handler: async () => 'hello',
73
- })
74
- conv.removeTool('greet')
75
- expect(conv.availableTools).not.toContain('greet')
76
- })
77
-
78
- it('updateTools merges without replacing unrelated tools', () => {
79
- const conv = makeConversation()
80
- conv.addTool('a', { description: 'A', parameters: { type: 'object', properties: {} }, handler: async () => 'a' })
81
- conv.updateTools({ b: { description: 'B', parameters: { type: 'object', properties: {} }, handler: async () => 'b' } })
82
- expect(conv.availableTools).toContain('a')
83
- expect(conv.availableTools).toContain('b')
84
- })
85
-
86
- it('construction-time tools are available immediately', () => {
87
- const conv = makeConversation({
88
- tools: {
89
- ping: { description: 'Ping', parameters: { type: 'object', properties: {} }, handler: async () => 'pong' }
90
- }
91
- })
92
- expect(conv.availableTools).toContain('ping')
93
- })
94
- })
95
-
96
- describe('estimateTokens', () => {
97
- it('returns a near-zero baseline for empty messages', () => {
98
- const conv = makeConversation()
99
- expect(conv.estimateTokens()).toBeLessThan(10)
100
- })
101
-
102
- it('returns a positive number when messages exist', () => {
103
- const conv = makeConversation({
104
- history: [{ role: 'user', content: 'What is the capital of France?' }]
105
- })
106
- expect(conv.estimateTokens()).toBeGreaterThan(0)
107
- })
108
-
109
- it('increases as more messages are added', () => {
110
- const conv = makeConversation()
111
- conv.pushMessage({ role: 'user', content: 'Hello' })
112
- const first = conv.estimateTokens()
113
- conv.pushMessage({ role: 'assistant', content: 'Hi there, how can I help you today?' })
114
- const second = conv.estimateTokens()
115
- expect(second).toBeGreaterThan(first)
116
- })
117
- })
118
-
119
- describe('stub()', () => {
120
- it('exact string match returns the stub response', async () => {
121
- const conv = makeConversation()
122
- conv.stub('ping', 'pong')
123
- const result = await conv.ask('ping')
124
- expect(result).toBe('pong')
125
- })
126
-
127
- it('substring match triggers the stub', async () => {
128
- const conv = makeConversation()
129
- conv.stub('weather', 'Sunny and 72°F.')
130
- const result = await conv.ask('what is the weather today?')
131
- expect(result).toBe('Sunny and 72°F.')
132
- })
133
-
134
- it('regex match triggers the stub', async () => {
135
- const conv = makeConversation()
136
- conv.stub(/hello/i, 'Hey there!')
137
- const result = await conv.ask('HELLO')
138
- expect(result).toBe('Hey there!')
139
- })
140
-
141
- it('function response is called on each match', async () => {
142
- const conv = makeConversation()
143
- let callCount = 0
144
- conv.stub('count', () => `call ${++callCount}`)
145
- expect(await conv.ask('count')).toBe('call 1')
146
- expect(await conv.ask('count')).toBe('call 2')
147
- })
148
-
149
- it('first matching stub wins', async () => {
150
- const conv = makeConversation()
151
- conv.stub('hello', 'first')
152
- conv.stub('hello', 'second')
153
- expect(await conv.ask('hello')).toBe('first')
154
- })
155
-
156
- it('appends user and assistant messages to history', async () => {
157
- const conv = makeConversation()
158
- conv.stub('hi', 'hello back')
159
- await conv.ask('hi')
160
- expect(conv.messages).toHaveLength(2)
161
- expect(conv.messages[0]).toMatchObject({ role: 'user', content: 'hi' })
162
- expect(conv.messages[1]).toMatchObject({ role: 'assistant', content: 'hello back' })
163
- })
164
-
165
- it('isStreaming is false after the call resolves', async () => {
166
- const conv = makeConversation()
167
- conv.stub('test', 'response')
168
- await conv.ask('test')
169
- expect(conv.isStreaming).toBe(false)
170
- })
171
-
172
- it('emits chunk events for each word', async () => {
173
- const conv = makeConversation()
174
- conv.stub('go', 'one two three')
175
- const chunks: string[] = []
176
- conv.on('chunk', (delta: string) => chunks.push(delta))
177
- await conv.ask('go')
178
- expect(chunks.join('')).toBe('one two three')
179
- })
180
-
181
- it('emits preview events with accumulating text', async () => {
182
- const conv = makeConversation()
183
- conv.stub('go', 'alpha beta')
184
- const previews: string[] = []
185
- conv.on('preview', (text: string) => previews.push(text))
186
- await conv.ask('go')
187
- expect(previews.at(-1)).toBe('alpha beta')
188
- // Each preview should be longer than or equal to the previous
189
- for (let i = 1; i < previews.length; i++) {
190
- expect(previews[i]!.length).toBeGreaterThanOrEqual(previews[i - 1]!.length)
191
- }
192
- })
193
-
194
- it('emits turnStart and turnEnd events', async () => {
195
- const conv = makeConversation()
196
- conv.stub('x', 'y')
197
- const events: string[] = []
198
- conv.on('turnStart', () => events.push('turnStart'))
199
- conv.on('turnEnd', () => events.push('turnEnd'))
200
- await conv.ask('x')
201
- expect(events).toEqual(['turnStart', 'turnEnd'])
202
- })
203
-
204
- it('emits response event with the full text', async () => {
205
- const conv = makeConversation()
206
- conv.stub('question', 'the answer')
207
- let emitted = ''
208
- conv.on('response', (text: string) => { emitted = text })
209
- await conv.ask('question')
210
- expect(emitted).toBe('the answer')
211
- })
212
-
213
- it('stub is chainable', () => {
214
- const conv = makeConversation()
215
- const result = conv.stub('a', 'A').stub('b', 'B')
216
- expect(result).toBe(conv)
217
- expect(conv.availableTools).toHaveLength(0) // stubs don't affect tools
218
- })
219
- })
220
- })
@@ -1,160 +0,0 @@
1
- import { NodeContainer } from '../src/node/container'
2
-
3
- describe('Features', () => {
4
- describe('feature registry', () => {
5
- it('has core features registered', () => {
6
- const c = new NodeContainer()
7
- const available = c.features.available
8
- expect(available).toContain('fs')
9
- expect(available).toContain('git')
10
- expect(available).toContain('proc')
11
- expect(available).toContain('os')
12
- expect(available).toContain('networking')
13
- expect(available).toContain('ui')
14
- expect(available).toContain('vm')
15
- expect(available).toContain('yaml')
16
- })
17
-
18
- it('features.has() works', () => {
19
- const c = new NodeContainer()
20
- expect(c.features.has('fs')).toBe(true)
21
- expect(c.features.has('os')).toBe(true)
22
- expect(c.features.has('totally_fake')).toBe(false)
23
- })
24
-
25
- it('features.lookup() returns a constructor', () => {
26
- const c = new NodeContainer()
27
- const FSClass = c.features.lookup('fs')
28
- expect(typeof FSClass).toBe('function')
29
- })
30
- })
31
-
32
- describe('core features are auto-enabled', () => {
33
- it('has fs, git, proc, os, networking, ui, vm enabled', () => {
34
- const c = new NodeContainer()
35
- expect(c.enabledFeatureIds).toContain('fs')
36
- expect(c.enabledFeatureIds).toContain('git')
37
- expect(c.enabledFeatureIds).toContain('proc')
38
- expect(c.enabledFeatureIds).toContain('os')
39
- expect(c.enabledFeatureIds).toContain('networking')
40
- expect(c.enabledFeatureIds).toContain('ui')
41
- expect(c.enabledFeatureIds).toContain('vm')
42
- })
43
- })
44
-
45
- describe('feature caching', () => {
46
- it('same args return same instance', () => {
47
- const c = new NodeContainer()
48
- const a = c.feature('yaml')
49
- const b = c.feature('yaml')
50
- expect(a.uuid).toBe(b.uuid)
51
- })
52
-
53
- it('different containers return different instances', () => {
54
- const c1 = new NodeContainer()
55
- const c2 = new NodeContainer()
56
- const a = c1.feature('yaml')
57
- const b = c2.feature('yaml')
58
- expect(a.uuid).not.toBe(b.uuid)
59
- })
60
- })
61
-
62
- describe('feature instances', () => {
63
- it('feature has a uuid', () => {
64
- const c = new NodeContainer()
65
- const yaml = c.feature('yaml')
66
- expect(yaml.uuid).toBeDefined()
67
- expect(typeof yaml.uuid).toBe('string')
68
- })
69
-
70
- it('feature has state', () => {
71
- const c = new NodeContainer()
72
- const yaml = c.feature('yaml')
73
- expect(yaml.state).toBeDefined()
74
- expect(typeof yaml.state.get).toBe('function')
75
- })
76
-
77
- it('feature has access to container', () => {
78
- const c = new NodeContainer()
79
- const yaml = c.feature('yaml')
80
- expect(yaml.container.uuid).toBe(c.uuid)
81
- })
82
-
83
- it('feature has event bus', () => {
84
- const c = new NodeContainer()
85
- const yaml = c.feature('yaml')
86
- expect(typeof yaml.on).toBe('function')
87
- expect(typeof yaml.emit).toBe('function')
88
- })
89
- })
90
-
91
- describe('OS feature', () => {
92
- it('provides platform info', () => {
93
- const c = new NodeContainer()
94
- expect(c.os.platform).toBe(process.platform)
95
- })
96
-
97
- it('provides arch', () => {
98
- const c = new NodeContainer()
99
- expect(c.os.arch).toBe(process.arch)
100
- })
101
-
102
- it('provides homedir', () => {
103
- const c = new NodeContainer()
104
- expect(typeof c.os.homedir).toBe('string')
105
- expect(c.os.homedir.length).toBeGreaterThan(0)
106
- })
107
-
108
- it('provides cpuCount', () => {
109
- const c = new NodeContainer()
110
- expect(c.os.cpuCount).toBeGreaterThan(0)
111
- })
112
-
113
- it('provides hostname', () => {
114
- const c = new NodeContainer()
115
- expect(typeof c.os.hostname).toBe('string')
116
- })
117
- })
118
-
119
- describe('FS feature', () => {
120
- it('can check if a path exists', () => {
121
- const c = new NodeContainer()
122
- expect(c.fs.exists(process.cwd())).toBe(true)
123
- expect(c.fs.exists('/surely/this/does/not/exist_abc123')).toBe(false)
124
- })
125
- })
126
-
127
- describe('VM feature', () => {
128
- it('can run simple expressions', async () => {
129
- const c = new NodeContainer()
130
- const result = await c.vm.run('1 + 2 + 3')
131
- expect(result).toBe(6)
132
- })
133
-
134
- it('can run code with context variables', async () => {
135
- const c = new NodeContainer()
136
- const result = await c.vm.run('x * y', { x: 6, y: 7 })
137
- expect(result).toBe(42)
138
- })
139
- })
140
-
141
- describe('Networking feature', () => {
142
- it('can find an open port', async () => {
143
- const c = new NodeContainer()
144
- const port = await c.networking.findOpenPort(30000)
145
- expect(port).toBeGreaterThanOrEqual(30000)
146
- })
147
- })
148
-
149
- describe('YAML feature', () => {
150
- it('can stringify and parse', () => {
151
- const c = new NodeContainer()
152
- const yaml = c.feature('yaml')
153
- const data = { name: 'luca', version: 1 }
154
- const str = yaml.stringify(data)
155
- expect(typeof str).toBe('string')
156
- const parsed = yaml.parse(str)
157
- expect(parsed).toEqual(data)
158
- })
159
- })
160
- })