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,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import type { Assistant } from './assistant.js';
4
- declare module '@soederpop/luca/feature' {
4
+ declare module 'luca/feature' {
5
5
  interface AvailableFeatures {
6
6
  autoAssistant: typeof AutonomousAssistant;
7
7
  }
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
- declare module '@soederpop/luca/feature' {
3
+ declare module 'luca/feature' {
4
4
  interface AvailableFeatures {
5
5
  browserUse: typeof BrowserUse;
6
6
  }
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
- declare module '@soederpop/luca/feature' {
3
+ declare module 'luca/feature' {
4
4
  interface AvailableFeatures {
5
5
  claudeCode: typeof ClaudeCode;
6
6
  }
@@ -1,8 +1,8 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
- import type { DiskCache } from '@soederpop/luca/node/container';
3
+ import type { DiskCache } from 'luca/node/container';
4
4
  import type { Message } from './conversation';
5
- declare module '@soederpop/luca/feature' {
5
+ declare module 'luca/feature' {
6
6
  interface AvailableFeatures {
7
7
  conversationHistory: typeof ConversationHistory;
8
8
  }
@@ -3,7 +3,7 @@ import { Feature } from '../feature.js';
3
3
  import type { OpenAIClient } from '../../clients/openai';
4
4
  import type OpenAI from 'openai';
5
5
  import type { ConversationHistory } from './conversation-history';
6
- declare module '@soederpop/luca/feature' {
6
+ declare module 'luca/feature' {
7
7
  interface AvailableFeatures {
8
8
  conversation: typeof Conversation;
9
9
  }
@@ -2,7 +2,7 @@ import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import type { ContentDb } from '@/node.js';
4
4
  import type Assistant from './assistant.js';
5
- declare module '@soederpop/luca/feature' {
5
+ declare module 'luca/feature' {
6
6
  interface AvailableFeatures {
7
7
  docsReader: typeof DocsReader;
8
8
  }
@@ -1,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import type { Helper } from '../../helper.js';
4
- declare module '@soederpop/luca/feature' {
4
+ declare module 'luca/feature' {
5
5
  interface AvailableFeatures {
6
6
  fileTools: typeof FileTools;
7
7
  }
@@ -1,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import type { Assistant } from './assistant.js';
4
- declare module '@soederpop/luca/feature' {
4
+ declare module 'luca/feature' {
5
5
  interface AvailableFeatures {
6
6
  lucaCoder: typeof LucaCoder;
7
7
  }
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
- declare module '@soederpop/luca/feature' {
3
+ declare module 'luca/feature' {
4
4
  interface AvailableFeatures {
5
5
  openaiCodex: typeof OpenAICodex;
6
6
  }
@@ -2,7 +2,7 @@ import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import type { DocsReader } from './docs-reader.js';
4
4
  import Assistant from './assistant.js';
5
- declare module '@soederpop/luca/feature' {
5
+ declare module 'luca/feature' {
6
6
  interface AvailableFeatures {
7
7
  skillsLibrary: typeof SkillsLibrary;
8
8
  }
@@ -1,9 +1,9 @@
1
- import { type ClientOptions } from "@soederpop/luca/client";
1
+ import { type ClientOptions } from "luca/client";
2
2
  import { RestClient } from "../rest";
3
- import { type ContainerContext } from "@soederpop/luca/container";
4
- import { NodeContainer } from "@soederpop/luca/node/container";
3
+ import { type ContainerContext } from "luca/container";
4
+ import { NodeContainer } from "luca/node/container";
5
5
  import { z } from 'zod';
6
- declare module "@soederpop/luca/client" {
6
+ declare module "luca/client" {
7
7
  interface AvailableClients {
8
8
  civitai: typeof CivitaiClient;
9
9
  }
@@ -1,8 +1,8 @@
1
- import { type ClientOptions, type ClientsInterface } from "@soederpop/luca/client";
1
+ import { type ClientOptions, type ClientsInterface } from "luca/client";
2
2
  import { RestClient } from "./rest";
3
- import { type ContainerContext } from "@soederpop/luca/container";
3
+ import { type ContainerContext } from "luca/container";
4
4
  import { z } from 'zod';
5
- declare module "@soederpop/luca/client" {
5
+ declare module "luca/client" {
6
6
  interface AvailableClients {
7
7
  myClient: typeof MyClient;
8
8
  }
@@ -20,7 +20,7 @@ export declare class MyClient<T extends MyClientState> extends RestClient<T> {
20
20
  static attach(container: Container & ClientsInterface, options?: any): any;
21
21
  constructor(options: ClientOptions, context: ContainerContext);
22
22
  }
23
- declare const _default: new (options: any, context: ContainerContext) => import("@soederpop/luca/client").Client<any, {
23
+ declare const _default: new (options: any, context: ContainerContext) => import("luca/client").Client<any, {
24
24
  name?: string | undefined;
25
25
  _cacheKey?: string | undefined;
26
26
  baseURL?: string | undefined;
@@ -1,7 +1,7 @@
1
1
  import { RestClient } from "../rest";
2
- import type { ContainerContext } from "@soederpop/luca/container";
2
+ import type { ContainerContext } from "luca/container";
3
3
  import { z } from 'zod';
4
- declare module "@soederpop/luca/client" {
4
+ declare module "luca/client" {
5
5
  interface AvailableClients {
6
6
  comfyui: typeof ComfyUIClient;
7
7
  }
@@ -1,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { RestClient } from "../rest";
3
- import type { ContainerContext } from "@soederpop/luca/container";
4
- declare module "@soederpop/luca/client" {
3
+ import type { ContainerContext } from "luca/container";
4
+ declare module "luca/client" {
5
5
  interface AvailableClients {
6
6
  elevenlabs: typeof ElevenLabsClient;
7
7
  }
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
- import { Client } from "@soederpop/luca/client";
3
- import type { ContainerContext } from "@soederpop/luca/container";
2
+ import { Client } from "luca/client";
3
+ import type { ContainerContext } from "luca/container";
4
4
  import OpenAI from "openai";
5
5
  export declare const OpenAIClientStateSchema: z.ZodObject<{
6
6
  connected: z.ZodDefault<z.ZodBoolean>;
@@ -1,8 +1,8 @@
1
- import { Client } from "@soederpop/luca/client";
2
- import type { ContainerContext } from "@soederpop/luca/container";
1
+ import { Client } from "luca/client";
2
+ import type { ContainerContext } from "luca/container";
3
3
  import { z } from "zod";
4
4
  import { type SupabaseClient as SupabaseSDKClient, type RealtimeChannel } from "@supabase/supabase-js";
5
- declare module "@soederpop/luca/client" {
5
+ declare module "luca/client" {
6
6
  interface AvailableClients {
7
7
  supabase: typeof SupabaseClient;
8
8
  }
package/dist/command.d.ts CHANGED
@@ -20,7 +20,7 @@ export type CommandHandler<T = any> = (options: T, context: ContainerContext) =>
20
20
  *
21
21
  * @example
22
22
  * ```typescript
23
- * declare module '@soederpop/luca' {
23
+ * declare module 'luca' {
24
24
  * interface AvailableCommands {
25
25
  * serve: SimpleCommand<typeof argsSchema>
26
26
  * }
@@ -170,7 +170,7 @@ export interface NodeContainer extends ClientsAndServersInterface {
170
170
  *
171
171
  * @example
172
172
  * ```ts
173
- * import container from '@soederpop/luca/node'
173
+ * import container from 'luca/node'
174
174
  *
175
175
  * // File operations
176
176
  * const content = container.fs.readFile('README.md')
@@ -80,17 +80,17 @@ export declare class Helpers extends Feature<HelpersState, HelpersOptions> {
80
80
  get rootDir(): string;
81
81
  /**
82
82
  * Whether to use native `import()` for loading project helpers.
83
- * True only if `@soederpop/luca` is actually resolvable in `node_modules`.
83
+ * True only if `luca` is actually resolvable in `node_modules`.
84
84
  * Warns when `node_modules` exists but the package is missing.
85
85
  */
86
86
  get useNativeImport(): boolean;
87
- /** Prevent repeated warnings about missing @soederpop/luca */
87
+ /** Prevent repeated warnings about missing luca */
88
88
  private _warnedNativeImport;
89
89
  /** Track whether we've seeded the VM with virtual modules */
90
90
  private _vmSeeded;
91
91
  /**
92
92
  * Seeds the VM feature with virtual modules so that project-level files
93
- * can `import` / `require('@soederpop/luca')`, `zod`, etc. without
93
+ * can `import` / `require('luca')`, `zod`, etc. without
94
94
  * needing them in `node_modules`.
95
95
  *
96
96
  * Called automatically when `useNativeImport` is false.
@@ -1,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import { Database } from 'bun:sqlite';
4
- declare module '@soederpop/luca/feature' {
4
+ declare module 'luca/feature' {
5
5
  interface AvailableFeatures {
6
6
  semanticSearch: typeof SemanticSearch;
7
7
  }
@@ -56,17 +56,17 @@ export declare class VM<T extends VMState = VMState, K extends VMOptions = VMOpt
56
56
  * Register a virtual module that will be available to `require()` inside VM-executed code.
57
57
  * Modules registered here take precedence over Node's native resolution.
58
58
  *
59
- * @param id - The module specifier (e.g. `'@soederpop/luca'`, `'zod'`)
59
+ * @param id - The module specifier (e.g. `'luca'`, `'zod'`)
60
60
  * @param exports - The module's exports object
61
61
  *
62
62
  * @example
63
63
  * ```typescript
64
64
  * const vm = container.feature('vm')
65
- * vm.defineModule('@soederpop/luca', { Container, Feature, fs, proc })
65
+ * vm.defineModule('luca', { Container, Feature, fs, proc })
66
66
  * vm.defineModule('zod', { z })
67
67
  *
68
68
  * // Now loadModule can resolve these in user code:
69
- * // import { Container } from '@soederpop/luca' → works
69
+ * // import { Container } from 'luca' → works
70
70
  * ```
71
71
  */
72
72
  defineModule(id: string, exports: any): void;
package/dist/node.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { NodeContainer, Feature } from './node/container';
2
2
  import './introspection/generated.node';
3
3
  export * from './node/container';
4
- declare const servers: import("./server").ServersRegistry, features: import("@soederpop/luca/feature").FeaturesRegistry, clients: import("@soederpop/luca/client").ClientsRegistry;
4
+ declare const servers: import("./server").ServersRegistry, features: import("luca/feature").FeaturesRegistry, clients: import("luca/client").ClientsRegistry;
5
5
  declare const _default: NodeContainer;
6
6
  export default _default;
7
7
  /**
@@ -9,5 +9,5 @@ export interface ScaffoldData {
9
9
  }
10
10
  export declare const scaffolds: Record<string, ScaffoldData>;
11
11
  export declare const assistantFiles: Record<string, string>;
12
- export declare const mcpReadme = "# Luca Development Guide\n\nYou are working in a **luca project**. The luca container provides all capabilities your code needs. Do not install npm packages or import Node.js builtins directly.\n\n## The Contract\n\nEvery capability goes through the container. If you need something that doesn't exist, build it as a feature, client, or server. If it wraps a third-party library, the helper IS the interface \u2014 consumer code never imports the library directly.\n\n## Import Rule\n\nAll consumer code imports from `@soederpop/luca` only:\n\n```ts\nimport { Feature, features, z, FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'\nimport { Client, clients, RestClient, ClientStateSchema } from '@soederpop/luca/client'\nimport { Server, servers, ServerStateSchema } from '@soederpop/luca'\nimport { commands, CommandOptionsSchema } from '@soederpop/luca'\n```\n\nNever import from `fs`, `path`, `crypto`, or other Node builtins. Never import third-party packages in consumer code. If a container feature wraps the functionality, use it.\n\n## Zod v4\n\nThis project uses **Zod v4** \u2014 import `z` from `@soederpop/luca`, never from `'zod'` directly. All option, state, and event schemas use Zod v4 syntax. Key patterns:\n\n```ts\n// Extending base schemas (options, state, events)\nexport const MyStateSchema = FeatureStateSchema.extend({\n count: z.number().default(0).describe('Number of items'),\n label: z.string().optional().describe('Display label'),\n})\n\n// Events use z.tuple() for listener arguments\nexport const MyEventsSchema = FeatureEventsSchema.extend({\n itemAdded: z.tuple([z.string().describe('key'), z.number().describe('index')]),\n})\n\n// Type inference\nexport type MyState = z.infer<typeof MyStateSchema>\n```\n\nZod v4 differences from v3 that matter:\n- `z.string().check(...)` replaces some v3 refinement patterns\n- `.toJSONSchema()` is built-in on any schema \u2014 no external library needed\n- Error customization uses `z.string({ error: \"message\" })` not `.refine()` for simple cases\n- `z.interface()` exists for recursive/lazy object types\n- Do NOT use `z.nativeEnum()` \u2014 use `z.enum()` instead\n\n## Dependencies\n\nIf the project has `node_modules` and a package manager, helper implementations can import third-party libraries internally. If not (e.g. running via the `luca` binary's VM), all code must import only from `@soederpop/luca`.\n\n## Discovering Capabilities\n\nThe container has registries for features, clients, servers, commands, and endpoints. **Do not guess** what is available \u2014 use your MCP tools to discover it:\n\n1. **`find_capability`** \u2014 Overview of all features, clients, and servers with descriptions. Start here.\n2. **`list_registry`** \u2014 List all names in a specific registry (features, clients, servers, commands, endpoints).\n3. **`describe_helper`** \u2014 Full API docs for a specific helper (methods, options, state, events). Call this before writing code that uses a helper.\n4. **`eval`** \u2014 Once you know what you need, prototype calls in the live sandbox before writing them into files.\n\n## Mini Examples\n\n### Feature with composition\n\nFeatures access other features via `this.container.feature(...)`:\n\n```ts\nimport { z } from 'zod'\nimport { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '@soederpop/luca'\nimport { Feature, features } from '@soederpop/luca'\nimport type { ContainerContext } from '@soederpop/luca'\n\nexport const ConfigStateSchema = FeatureStateSchema.extend({\n loaded: z.boolean().default(false).describe('Whether config has been loaded'),\n})\n\nexport const ConfigOptionsSchema = FeatureOptionsSchema.extend({\n filePath: z.string().default('config.json').describe('Path to config file'),\n})\n\nexport const ConfigEventsSchema = FeatureEventsSchema.extend({\n configLoaded: z.tuple([z.record(z.unknown()).describe('parsed config')]),\n})\n\nexport class Config extends Feature<z.infer<typeof ConfigStateSchema>, z.infer<typeof ConfigOptionsSchema>> {\n static override shortcut = 'features.config' as const\n static override stateSchema = ConfigStateSchema\n static override optionsSchema = ConfigOptionsSchema\n static override eventsSchema = ConfigEventsSchema\n static override description = 'Loads and manages project configuration'\n\n /** Load and parse the config file */\n async load() {\n const fs = this.container.feature('fs')\n const raw = await fs.readFile(this.options.filePath)\n const data = JSON.parse(raw)\n this.state.set('loaded', true)\n this.emit('configLoaded', data)\n return data\n }\n}\n\ndeclare module '@soederpop/luca' {\n interface AvailableFeatures { config: typeof Config }\n}\nexport default features.register('config', Config)\n```\n\n### Client with composition\n\nClients access features and other clients via `this.container`:\n\n```ts\nimport { z } from 'zod'\nimport { Client, clients, ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca'\nimport type { ContainerContext } from '@soederpop/luca'\n\nexport const GithubOptionsSchema = ClientOptionsSchema.extend({\n token: z.string().describe('GitHub personal access token'),\n owner: z.string().describe('Repository owner'),\n repo: z.string().describe('Repository name'),\n})\n\nexport const GithubEventsSchema = ClientEventsSchema.extend({\n issuesFetched: z.tuple([z.number().describe('count')]),\n})\n\nexport class GithubClient extends Client<z.infer<typeof ClientStateSchema>, z.infer<typeof GithubOptionsSchema>> {\n static override shortcut = 'clients.github' as const\n static override optionsSchema = GithubOptionsSchema\n static override eventsSchema = GithubEventsSchema\n static override description = 'GitHub API client using container REST client'\n\n /** Fetch open issues */\n async issues() {\n const rest = this.container.client('rest')\n const res = await rest.get(`https://api.github.com/repos/${this.options.owner}/${this.options.repo}/issues`, {\n headers: { Authorization: `token ${this.options.token}` },\n })\n this.emit('issuesFetched', res.data.length)\n return res.data\n }\n}\n\ndeclare module '@soederpop/luca' {\n interface AvailableClients { github: typeof GithubClient }\n}\nexport default clients.register('github', GithubClient)\n```\n\n## Workflow\n\n1. **`find_capability`** \u2014 Search what already exists before writing anything\n2. **`describe_helper`** \u2014 Read the full API docs for the helper you need\n3. **`eval`** \u2014 Prototype and test container API calls in the sandbox\n4. **`scaffold`** \u2014 Generate correct boilerplate when building something new\n5. **Write the file** \u2014 Using the patterns from the scaffold\n\n## Portability\n\nCode that only imports from `@soederpop/luca` can be copied between any luca project. That's the goal. Features, clients, servers, and commands written this way are portable building blocks.\n";
12
+ export declare const mcpReadme = "# Luca Development Guide\n\nYou are working in a **luca project**. The luca container provides all capabilities your code needs. Do not install npm packages or import Node.js builtins directly.\n\n## The Contract\n\nEvery capability goes through the container. If you need something that doesn't exist, build it as a feature, client, or server. If it wraps a third-party library, the helper IS the interface \u2014 consumer code never imports the library directly.\n\n## Import Rule\n\nAll consumer code imports from `luca` only:\n\n```ts\nimport { Feature, features, z, FeatureStateSchema, FeatureOptionsSchema } from 'luca'\nimport { Client, clients, RestClient, ClientStateSchema } from 'luca/client'\nimport { Server, servers, ServerStateSchema } from 'luca'\nimport { commands, CommandOptionsSchema } from 'luca'\n```\n\nNever import from `fs`, `path`, `crypto`, or other Node builtins. Never import third-party packages in consumer code. If a container feature wraps the functionality, use it.\n\n## Zod v4\n\nThis project uses **Zod v4** \u2014 import `z` from `luca`, never from `'zod'` directly. All option, state, and event schemas use Zod v4 syntax. Key patterns:\n\n```ts\n// Extending base schemas (options, state, events)\nexport const MyStateSchema = FeatureStateSchema.extend({\n count: z.number().default(0).describe('Number of items'),\n label: z.string().optional().describe('Display label'),\n})\n\n// Events use z.tuple() for listener arguments\nexport const MyEventsSchema = FeatureEventsSchema.extend({\n itemAdded: z.tuple([z.string().describe('key'), z.number().describe('index')]),\n})\n\n// Type inference\nexport type MyState = z.infer<typeof MyStateSchema>\n```\n\nZod v4 differences from v3 that matter:\n- `z.string().check(...)` replaces some v3 refinement patterns\n- `.toJSONSchema()` is built-in on any schema \u2014 no external library needed\n- Error customization uses `z.string({ error: \"message\" })` not `.refine()` for simple cases\n- `z.interface()` exists for recursive/lazy object types\n- Do NOT use `z.nativeEnum()` \u2014 use `z.enum()` instead\n\n## Dependencies\n\nIf the project has `node_modules` and a package manager, helper implementations can import third-party libraries internally. If not (e.g. running via the `luca` binary's VM), all code must import only from `luca`.\n\n## Discovering Capabilities\n\nThe container has registries for features, clients, servers, commands, and endpoints. **Do not guess** what is available \u2014 use your MCP tools to discover it:\n\n1. **`find_capability`** \u2014 Overview of all features, clients, and servers with descriptions. Start here.\n2. **`list_registry`** \u2014 List all names in a specific registry (features, clients, servers, commands, endpoints).\n3. **`describe_helper`** \u2014 Full API docs for a specific helper (methods, options, state, events). Call this before writing code that uses a helper.\n4. **`eval`** \u2014 Once you know what you need, prototype calls in the live sandbox before writing them into files.\n\n## Mini Examples\n\n### Feature with composition\n\nFeatures access other features via `this.container.feature(...)`:\n\n```ts\nimport { z } from 'zod'\nimport { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from 'luca'\nimport { Feature, features } from 'luca'\nimport type { ContainerContext } from 'luca'\n\nexport const ConfigStateSchema = FeatureStateSchema.extend({\n loaded: z.boolean().default(false).describe('Whether config has been loaded'),\n})\n\nexport const ConfigOptionsSchema = FeatureOptionsSchema.extend({\n filePath: z.string().default('config.json').describe('Path to config file'),\n})\n\nexport const ConfigEventsSchema = FeatureEventsSchema.extend({\n configLoaded: z.tuple([z.record(z.unknown()).describe('parsed config')]),\n})\n\nexport class Config extends Feature<z.infer<typeof ConfigStateSchema>, z.infer<typeof ConfigOptionsSchema>> {\n static override shortcut = 'features.config' as const\n static override stateSchema = ConfigStateSchema\n static override optionsSchema = ConfigOptionsSchema\n static override eventsSchema = ConfigEventsSchema\n static override description = 'Loads and manages project configuration'\n\n /** Load and parse the config file */\n async load() {\n const fs = this.container.feature('fs')\n const raw = await fs.readFile(this.options.filePath)\n const data = JSON.parse(raw)\n this.state.set('loaded', true)\n this.emit('configLoaded', data)\n return data\n }\n}\n\ndeclare module 'luca' {\n interface AvailableFeatures { config: typeof Config }\n}\nexport default features.register('config', Config)\n```\n\n### Client with composition\n\nClients access features and other clients via `this.container`:\n\n```ts\nimport { z } from 'zod'\nimport { Client, clients, ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca'\nimport type { ContainerContext } from 'luca'\n\nexport const GithubOptionsSchema = ClientOptionsSchema.extend({\n token: z.string().describe('GitHub personal access token'),\n owner: z.string().describe('Repository owner'),\n repo: z.string().describe('Repository name'),\n})\n\nexport const GithubEventsSchema = ClientEventsSchema.extend({\n issuesFetched: z.tuple([z.number().describe('count')]),\n})\n\nexport class GithubClient extends Client<z.infer<typeof ClientStateSchema>, z.infer<typeof GithubOptionsSchema>> {\n static override shortcut = 'clients.github' as const\n static override optionsSchema = GithubOptionsSchema\n static override eventsSchema = GithubEventsSchema\n static override description = 'GitHub API client using container REST client'\n\n /** Fetch open issues */\n async issues() {\n const rest = this.container.client('rest')\n const res = await rest.get(`https://api.github.com/repos/${this.options.owner}/${this.options.repo}/issues`, {\n headers: { Authorization: `token ${this.options.token}` },\n })\n this.emit('issuesFetched', res.data.length)\n return res.data\n }\n}\n\ndeclare module 'luca' {\n interface AvailableClients { github: typeof GithubClient }\n}\nexport default clients.register('github', GithubClient)\n```\n\n## Workflow\n\n1. **`find_capability`** \u2014 Search what already exists before writing anything\n2. **`describe_helper`** \u2014 Read the full API docs for the helper you need\n3. **`eval`** \u2014 Prototype and test container API calls in the sandbox\n4. **`scaffold`** \u2014 Generate correct boilerplate when building something new\n5. **Write the file** \u2014 Using the patterns from the scaffold\n\n## Portability\n\nCode that only imports from `luca` can be copied between any luca project. That's the goal. Features, clients, servers, and commands written this way are portable building blocks.\n";
13
13
  //# sourceMappingURL=generated.d.ts.map
@@ -19,7 +19,7 @@ export interface SelectorsInterface {
19
19
  *
20
20
  * @example
21
21
  * ```typescript
22
- * declare module '@soederpop/luca' {
22
+ * declare module 'luca' {
23
23
  * interface AvailableSelectors {
24
24
  * packageInfo: SimpleSelector<typeof argsSchema>
25
25
  * }