luca 3.0.0 → 3.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 (388) 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 +264 -321
  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/social.ts +137 -0
  18. package/commands/try-all-challenges.ts +3 -3
  19. package/commands/try-challenge.ts +3 -3
  20. package/datasets/lora/agentic-loop-session-candidates.jsonl +91 -0
  21. package/datasets/lora/agentic-loop-session-curation-summary.json +123 -0
  22. package/datasets/lora/luca-session-candidates.jsonl +29 -0
  23. package/datasets/lora/luca-session-curation-summary.json +121 -0
  24. package/datasets/lora/review-batch-1.jsonl +30 -0
  25. package/datasets/lora/review-manifest.json +41 -0
  26. package/datasets/lora/review-queue.jsonl +120 -0
  27. package/datasets/lora/review-schema.json +134 -0
  28. package/datasets/lora/review-template.jsonl +2 -0
  29. package/datasets/lora/review-ui.html +725 -0
  30. package/dist/agi/container.server.d.ts +2 -2
  31. package/dist/agi/features/assistant.d.ts +2 -2
  32. package/dist/agi/features/assistants-manager.d.ts +1 -1
  33. package/dist/agi/features/autonomous-assistant.d.ts +1 -1
  34. package/dist/agi/features/browser-use.d.ts +1 -1
  35. package/dist/agi/features/claude-code.d.ts +1 -1
  36. package/dist/agi/features/conversation-history.d.ts +2 -2
  37. package/dist/agi/features/conversation.d.ts +1 -1
  38. package/dist/agi/features/docs-reader.d.ts +1 -1
  39. package/dist/agi/features/file-tools.d.ts +1 -1
  40. package/dist/agi/features/luca-coder.d.ts +1 -1
  41. package/dist/agi/features/openai-codex.d.ts +1 -1
  42. package/dist/agi/features/skills-library.d.ts +1 -1
  43. package/dist/clients/civitai/index.d.ts +4 -4
  44. package/dist/clients/client-template.d.ts +4 -4
  45. package/dist/clients/comfyui/index.d.ts +2 -2
  46. package/dist/clients/elevenlabs/index.d.ts +2 -2
  47. package/dist/clients/openai/index.d.ts +2 -2
  48. package/dist/clients/supabase/index.d.ts +3 -3
  49. package/dist/command.d.ts +1 -1
  50. package/dist/node/container.d.ts +1 -1
  51. package/dist/node/features/helpers.d.ts +3 -3
  52. package/dist/node/features/semantic-search.d.ts +1 -1
  53. package/dist/node/features/vm.d.ts +3 -3
  54. package/dist/node.d.ts +1 -1
  55. package/dist/scaffolds/generated.d.ts +1 -1
  56. package/dist/selector.d.ts +1 -1
  57. package/features/cipher-social.ts +493 -0
  58. package/index.html +217 -190
  59. package/luca.console.ts +1 -1
  60. package/package.json +7 -2
  61. package/public/index.html +217 -190
  62. package/public/slides-ai-native.html +1 -1
  63. package/public/slides-intro.html +2 -2
  64. package/scripts/curate-claude-sessions.ts +561 -0
  65. package/scripts/examples/ask-luca-expert.ts +1 -1
  66. package/scripts/examples/assistant-questions.ts +1 -1
  67. package/scripts/examples/excalidraw-expert.ts +1 -1
  68. package/scripts/examples/file-manager.ts +1 -1
  69. package/scripts/examples/ideas.ts +1 -1
  70. package/scripts/examples/interactive-chat.ts +1 -1
  71. package/scripts/examples/opening-a-web-browser.ts +1 -1
  72. package/scripts/examples/telegram-bot.ts +1 -1
  73. package/scripts/examples/using-assistant-with-mcp.ts +1 -1
  74. package/scripts/examples/using-claude-code.ts +1 -1
  75. package/scripts/examples/using-contentdb.ts +2 -2
  76. package/scripts/examples/using-conversations.ts +1 -1
  77. package/scripts/examples/using-disk-cache.ts +1 -1
  78. package/scripts/examples/using-docker-shell.ts +1 -1
  79. package/scripts/examples/using-elevenlabs.ts +1 -1
  80. package/scripts/examples/using-google-calendar.ts +1 -1
  81. package/scripts/examples/using-google-docs.ts +1 -1
  82. package/scripts/examples/using-google-drive.ts +1 -1
  83. package/scripts/examples/using-google-sheets.ts +1 -1
  84. package/scripts/examples/using-nlp.ts +1 -1
  85. package/scripts/examples/using-ollama.ts +1 -1
  86. package/scripts/examples/using-postgres.ts +1 -1
  87. package/scripts/examples/using-runpod.ts +1 -1
  88. package/scripts/examples/using-tts.ts +1 -1
  89. package/scripts/scaffold.ts +5 -5
  90. package/scripts/scratch.ts +1 -1
  91. package/scripts/test-assistant-hooks.ts +1 -1
  92. package/scripts/test-docs-reader.ts +1 -1
  93. package/src/agi/container.server.ts +6 -2
  94. package/src/agi/features/agent-memory.ts +25 -25
  95. package/src/agi/features/assistant.ts +34 -5
  96. package/src/agi/features/assistants-manager.ts +122 -6
  97. package/src/agi/features/autonomous-assistant.ts +1 -1
  98. package/src/agi/features/browser-use.ts +20 -1
  99. package/src/agi/features/claude-code.ts +51 -5
  100. package/src/agi/features/coding-tools.ts +1 -1
  101. package/src/agi/features/conversation-history.ts +181 -4
  102. package/src/agi/features/conversation.ts +186 -15
  103. package/src/agi/features/docs-reader.ts +2 -2
  104. package/src/agi/features/file-tools.ts +49 -2
  105. package/src/agi/features/luca-coder.ts +7 -5
  106. package/src/agi/features/mcp-bridge.ts +532 -0
  107. package/src/agi/features/openai-codex.ts +2 -2
  108. package/src/agi/features/skills-library.ts +131 -52
  109. package/src/agi/lib/token-counter.ts +80 -0
  110. package/src/bootstrap/generated.ts +56 -57
  111. package/src/browser.ts +1 -1
  112. package/src/cli/build-info.ts +2 -2
  113. package/src/cli/cli.ts +2 -2
  114. package/src/clients/civitai/index.ts +5 -5
  115. package/src/clients/client-template.ts +4 -4
  116. package/src/clients/comfyui/index.ts +4 -4
  117. package/src/clients/elevenlabs/index.ts +4 -4
  118. package/src/clients/openai/index.ts +7 -7
  119. package/src/clients/supabase/index.ts +4 -4
  120. package/src/clients/voicebox/index.ts +4 -4
  121. package/src/command.ts +2 -1
  122. package/src/commands/chat.ts +1 -0
  123. package/src/commands/eval.ts +2 -56
  124. package/src/commands/introspect.ts +1 -1
  125. package/src/commands/prompt.ts +41 -9
  126. package/src/container-describer.ts +8 -1
  127. package/src/container.ts +13 -0
  128. package/src/entity.ts +2 -2
  129. package/src/helper.ts +1 -1
  130. package/src/introspection/generated.agi.ts +29596 -27654
  131. package/src/introspection/generated.node.ts +20284 -19247
  132. package/src/introspection/generated.web.ts +605 -584
  133. package/src/introspection/scan.ts +11 -6
  134. package/src/node/container.ts +9 -1
  135. package/src/node/features/content-db.ts +39 -2
  136. package/src/node/features/display-result.ts +57 -0
  137. package/src/node/features/helpers.ts +46 -7
  138. package/src/node/features/python.ts +25 -19
  139. package/src/node/features/repl.ts +1 -1
  140. package/src/node/features/secure-shell.ts +11 -17
  141. package/src/node/features/semantic-search.ts +2 -2
  142. package/src/node/features/socket-repl.ts +336 -0
  143. package/src/node/features/telnyx-assistant-connector.ts +1206 -0
  144. package/src/node/features/transpiler.ts +2 -3
  145. package/src/node/features/ui.ts +5 -0
  146. package/src/node/features/vm.ts +20 -3
  147. package/src/node.ts +3 -3
  148. package/src/python/generated.ts +0 -1
  149. package/src/scaffolds/generated.ts +82 -83
  150. package/src/selector.ts +1 -1
  151. package/src/servers/express.ts +1 -1
  152. package/src/web/features/helpers.ts +22 -0
  153. package/tsconfig.json +12 -12
  154. package/docs/CLI.md +0 -335
  155. package/docs/CNAME +0 -1
  156. package/docs/README.md +0 -60
  157. package/docs/TABLE-OF-CONTENTS.md +0 -183
  158. package/docs/apis/clients/elevenlabs.md +0 -308
  159. package/docs/apis/clients/graph.md +0 -107
  160. package/docs/apis/clients/openai.md +0 -429
  161. package/docs/apis/clients/rest.md +0 -161
  162. package/docs/apis/clients/websocket.md +0 -174
  163. package/docs/apis/features/agi/assistant.md +0 -625
  164. package/docs/apis/features/agi/assistants-manager.md +0 -282
  165. package/docs/apis/features/agi/auto-assistant.md +0 -279
  166. package/docs/apis/features/agi/browser-use.md +0 -802
  167. package/docs/apis/features/agi/claude-code.md +0 -884
  168. package/docs/apis/features/agi/conversation-history.md +0 -364
  169. package/docs/apis/features/agi/conversation.md +0 -548
  170. package/docs/apis/features/agi/docs-reader.md +0 -99
  171. package/docs/apis/features/agi/file-tools.md +0 -163
  172. package/docs/apis/features/agi/luca-coder.md +0 -407
  173. package/docs/apis/features/agi/openai-codex.md +0 -396
  174. package/docs/apis/features/agi/openapi.md +0 -138
  175. package/docs/apis/features/agi/semantic-search.md +0 -387
  176. package/docs/apis/features/agi/skills-library.md +0 -239
  177. package/docs/apis/features/node/container-link.md +0 -192
  178. package/docs/apis/features/node/content-db.md +0 -450
  179. package/docs/apis/features/node/disk-cache.md +0 -379
  180. package/docs/apis/features/node/dns.md +0 -652
  181. package/docs/apis/features/node/docker.md +0 -706
  182. package/docs/apis/features/node/downloader.md +0 -81
  183. package/docs/apis/features/node/esbuild.md +0 -60
  184. package/docs/apis/features/node/file-manager.md +0 -191
  185. package/docs/apis/features/node/fs.md +0 -1217
  186. package/docs/apis/features/node/git.md +0 -371
  187. package/docs/apis/features/node/google-auth.md +0 -193
  188. package/docs/apis/features/node/google-calendar.md +0 -202
  189. package/docs/apis/features/node/google-docs.md +0 -173
  190. package/docs/apis/features/node/google-drive.md +0 -246
  191. package/docs/apis/features/node/google-mail.md +0 -214
  192. package/docs/apis/features/node/google-sheets.md +0 -194
  193. package/docs/apis/features/node/grep.md +0 -292
  194. package/docs/apis/features/node/helpers.md +0 -164
  195. package/docs/apis/features/node/ink.md +0 -334
  196. package/docs/apis/features/node/ipc-socket.md +0 -249
  197. package/docs/apis/features/node/json-tree.md +0 -86
  198. package/docs/apis/features/node/networking.md +0 -316
  199. package/docs/apis/features/node/nlp.md +0 -133
  200. package/docs/apis/features/node/opener.md +0 -97
  201. package/docs/apis/features/node/os.md +0 -146
  202. package/docs/apis/features/node/package-finder.md +0 -392
  203. package/docs/apis/features/node/postgres.md +0 -234
  204. package/docs/apis/features/node/proc.md +0 -399
  205. package/docs/apis/features/node/process-manager.md +0 -305
  206. package/docs/apis/features/node/python.md +0 -604
  207. package/docs/apis/features/node/redis.md +0 -380
  208. package/docs/apis/features/node/repl.md +0 -88
  209. package/docs/apis/features/node/runpod.md +0 -674
  210. package/docs/apis/features/node/secure-shell.md +0 -176
  211. package/docs/apis/features/node/semantic-search.md +0 -408
  212. package/docs/apis/features/node/sqlite.md +0 -233
  213. package/docs/apis/features/node/telegram.md +0 -279
  214. package/docs/apis/features/node/transpiler.md +0 -74
  215. package/docs/apis/features/node/tts.md +0 -133
  216. package/docs/apis/features/node/ui.md +0 -701
  217. package/docs/apis/features/node/vault.md +0 -59
  218. package/docs/apis/features/node/vm.md +0 -75
  219. package/docs/apis/features/node/yaml-tree.md +0 -85
  220. package/docs/apis/features/node/yaml.md +0 -176
  221. package/docs/apis/features/web/asset-loader.md +0 -59
  222. package/docs/apis/features/web/container-link.md +0 -192
  223. package/docs/apis/features/web/esbuild.md +0 -54
  224. package/docs/apis/features/web/helpers.md +0 -164
  225. package/docs/apis/features/web/network.md +0 -44
  226. package/docs/apis/features/web/speech.md +0 -69
  227. package/docs/apis/features/web/vault.md +0 -59
  228. package/docs/apis/features/web/vm.md +0 -75
  229. package/docs/apis/features/web/voice.md +0 -84
  230. package/docs/apis/servers/express.md +0 -171
  231. package/docs/apis/servers/mcp.md +0 -238
  232. package/docs/apis/servers/websocket.md +0 -170
  233. package/docs/bootstrap/CLAUDE.md +0 -101
  234. package/docs/bootstrap/SKILL.md +0 -341
  235. package/docs/bootstrap/templates/about-command.ts +0 -41
  236. package/docs/bootstrap/templates/docs-models.ts +0 -22
  237. package/docs/bootstrap/templates/docs-readme.md +0 -43
  238. package/docs/bootstrap/templates/example-feature.ts +0 -53
  239. package/docs/bootstrap/templates/health-endpoint.ts +0 -15
  240. package/docs/bootstrap/templates/luca-cli.ts +0 -30
  241. package/docs/bootstrap/templates/runme.md +0 -54
  242. package/docs/challenges/caching-proxy.md +0 -16
  243. package/docs/challenges/content-db-round-trip.md +0 -14
  244. package/docs/challenges/custom-command.md +0 -9
  245. package/docs/challenges/file-watcher-pipeline.md +0 -11
  246. package/docs/challenges/grep-audit-report.md +0 -15
  247. package/docs/challenges/multi-feature-dashboard.md +0 -14
  248. package/docs/challenges/process-orchestrator.md +0 -17
  249. package/docs/challenges/rest-api-server-with-client.md +0 -12
  250. package/docs/challenges/script-runner-with-vm.md +0 -11
  251. package/docs/challenges/simple-rest-api.md +0 -15
  252. package/docs/challenges/websocket-serve-and-client.md +0 -11
  253. package/docs/challenges/yaml-config-system.md +0 -14
  254. package/docs/command-system-overhaul.md +0 -94
  255. package/docs/documentation-audit.md +0 -134
  256. package/docs/examples/assistant/CORE.md +0 -18
  257. package/docs/examples/assistant/hooks.ts +0 -3
  258. package/docs/examples/assistant/tools.ts +0 -10
  259. package/docs/examples/assistant-hooks-reference.ts +0 -171
  260. package/docs/examples/assistant-with-process-manager.md +0 -84
  261. package/docs/examples/content-db.md +0 -77
  262. package/docs/examples/disk-cache.md +0 -83
  263. package/docs/examples/docker.md +0 -101
  264. package/docs/examples/downloader.md +0 -70
  265. package/docs/examples/entity.md +0 -124
  266. package/docs/examples/esbuild.md +0 -80
  267. package/docs/examples/feature-as-tool-provider.md +0 -143
  268. package/docs/examples/file-manager.md +0 -82
  269. package/docs/examples/fs.md +0 -83
  270. package/docs/examples/git.md +0 -85
  271. package/docs/examples/google-auth.md +0 -88
  272. package/docs/examples/google-calendar.md +0 -94
  273. package/docs/examples/google-docs.md +0 -82
  274. package/docs/examples/google-drive.md +0 -96
  275. package/docs/examples/google-sheets.md +0 -95
  276. package/docs/examples/grep.md +0 -85
  277. package/docs/examples/ink-blocks.md +0 -75
  278. package/docs/examples/ink-renderer.md +0 -41
  279. package/docs/examples/ink.md +0 -103
  280. package/docs/examples/ipc-socket.md +0 -103
  281. package/docs/examples/json-tree.md +0 -91
  282. package/docs/examples/networking.md +0 -58
  283. package/docs/examples/nlp.md +0 -91
  284. package/docs/examples/opener.md +0 -78
  285. package/docs/examples/os.md +0 -72
  286. package/docs/examples/package-finder.md +0 -89
  287. package/docs/examples/postgres.md +0 -91
  288. package/docs/examples/proc.md +0 -81
  289. package/docs/examples/process-manager.md +0 -79
  290. package/docs/examples/python.md +0 -132
  291. package/docs/examples/repl.md +0 -93
  292. package/docs/examples/runpod.md +0 -119
  293. package/docs/examples/secure-shell.md +0 -92
  294. package/docs/examples/sqlite.md +0 -86
  295. package/docs/examples/structured-output-with-assistants.md +0 -144
  296. package/docs/examples/telegram.md +0 -77
  297. package/docs/examples/tts.md +0 -86
  298. package/docs/examples/ui.md +0 -80
  299. package/docs/examples/vault.md +0 -70
  300. package/docs/examples/vm.md +0 -86
  301. package/docs/examples/websocket-ask-and-reply-example.md +0 -128
  302. package/docs/examples/yaml-tree.md +0 -93
  303. package/docs/examples/yaml.md +0 -104
  304. package/docs/ideas/assistant-factory-pattern.md +0 -142
  305. package/docs/in-memory-fs.md +0 -4
  306. package/docs/introspection-audit.md +0 -49
  307. package/docs/introspection.md +0 -164
  308. package/docs/mcp/readme.md +0 -162
  309. package/docs/models.ts +0 -41
  310. package/docs/philosophy.md +0 -86
  311. package/docs/principles.md +0 -7
  312. package/docs/prompts/audit-codebase-for-failures-to-use-the-container.md +0 -34
  313. package/docs/prompts/check-for-undocumented-features.md +0 -27
  314. package/docs/prompts/mcp-test-easy-command.md +0 -27
  315. package/docs/scaffolds/client.md +0 -149
  316. package/docs/scaffolds/command.md +0 -120
  317. package/docs/scaffolds/endpoint.md +0 -171
  318. package/docs/scaffolds/feature.md +0 -158
  319. package/docs/scaffolds/selector.md +0 -91
  320. package/docs/scaffolds/server.md +0 -196
  321. package/docs/selectors.md +0 -115
  322. package/docs/sessions/custom-command/attempt-log-2.md +0 -195
  323. package/docs/sessions/file-watcher-pipeline/attempt-log-1.md +0 -728
  324. package/docs/sessions/file-watcher-pipeline/attempt-log-2.md +0 -555
  325. package/docs/sessions/grep-audit-report/attempt-log-1.md +0 -289
  326. package/docs/sessions/multi-feature-dashboard/attempt-log-2.md +0 -679
  327. package/docs/sessions/rest-api-server-with-client/attempt-log-1.md +0 -1
  328. package/docs/sessions/rest-api-server-with-client/attempt-log-3.md +0 -920
  329. package/docs/sessions/simple-rest-api/attempt-log-1.md +0 -593
  330. package/docs/sessions/websocket-serve-and-client/attempt-log-2.md +0 -995
  331. package/docs/tutorials/00-bootstrap.md +0 -166
  332. package/docs/tutorials/01-getting-started.md +0 -106
  333. package/docs/tutorials/02-container.md +0 -210
  334. package/docs/tutorials/03-scripts.md +0 -194
  335. package/docs/tutorials/04-features-overview.md +0 -196
  336. package/docs/tutorials/05-state-and-events.md +0 -171
  337. package/docs/tutorials/06-servers.md +0 -157
  338. package/docs/tutorials/07-endpoints.md +0 -198
  339. package/docs/tutorials/08-commands.md +0 -252
  340. package/docs/tutorials/09-clients.md +0 -162
  341. package/docs/tutorials/10-creating-features.md +0 -203
  342. package/docs/tutorials/11-contentbase.md +0 -191
  343. package/docs/tutorials/12-assistants.md +0 -215
  344. package/docs/tutorials/13-introspection.md +0 -157
  345. package/docs/tutorials/14-type-system.md +0 -174
  346. package/docs/tutorials/15-project-patterns.md +0 -222
  347. package/docs/tutorials/16-google-features.md +0 -534
  348. package/docs/tutorials/17-tui-blocks.md +0 -530
  349. package/docs/tutorials/18-semantic-search.md +0 -334
  350. package/docs/tutorials/19-python-sessions.md +0 -401
  351. package/docs/tutorials/20-browser-esm.md +0 -234
  352. package/index.ts +0 -1
  353. package/src/agi/endpoints/ask.ts +0 -60
  354. package/src/agi/endpoints/conversations/[id].ts +0 -45
  355. package/src/agi/endpoints/conversations.ts +0 -31
  356. package/src/agi/endpoints/experts.ts +0 -37
  357. package/test/assistant-hooks.test.ts +0 -306
  358. package/test/assistant.test.ts +0 -81
  359. package/test/bus.test.ts +0 -134
  360. package/test/clients-servers.test.ts +0 -217
  361. package/test/command.test.ts +0 -267
  362. package/test/container-link.test.ts +0 -274
  363. package/test/conversation.test.ts +0 -220
  364. package/test/features.test.ts +0 -160
  365. package/test/fork-and-research.test.ts +0 -450
  366. package/test/integration.test.ts +0 -787
  367. package/test/interceptor-chain.test.ts +0 -61
  368. package/test/node-container.test.ts +0 -121
  369. package/test/python-session.test.ts +0 -105
  370. package/test/rate-limit.test.ts +0 -272
  371. package/test/semantic-search.test.ts +0 -550
  372. package/test/state.test.ts +0 -121
  373. package/test/vm-context.test.ts +0 -146
  374. package/test/vm-loadmodule.test.ts +0 -213
  375. package/test/websocket-ask.test.ts +0 -101
  376. package/test-integration/assistant.test.ts +0 -138
  377. package/test-integration/assistants-manager.test.ts +0 -113
  378. package/test-integration/claude-code.test.ts +0 -98
  379. package/test-integration/conversation-history.test.ts +0 -205
  380. package/test-integration/conversation.test.ts +0 -137
  381. package/test-integration/elevenlabs.test.ts +0 -55
  382. package/test-integration/google-services.test.ts +0 -80
  383. package/test-integration/helpers.ts +0 -89
  384. package/test-integration/memory.test.ts +0 -204
  385. package/test-integration/openai-codex.test.ts +0 -93
  386. package/test-integration/runpod.test.ts +0 -58
  387. package/test-integration/server-endpoints.test.ts +0 -97
  388. package/test-integration/telegram.test.ts +0 -46
@@ -12,8 +12,8 @@ import { AssistantsManager } from './features/assistants-manager';
12
12
  import { DocsReader } from './features/docs-reader';
13
13
  import { SkillsLibrary } from './features/skills-library';
14
14
  import { BrowserUse } from './features/browser-use';
15
- import { SemanticSearch } from '@soederpop/luca/node/features/semantic-search';
16
- import { ContentDb } from '@soederpop/luca/node/features/content-db';
15
+ import { SemanticSearch } from 'luca/node/features/semantic-search';
16
+ import { ContentDb } from 'luca/node/features/content-db';
17
17
  import { FileTools } from './features/file-tools';
18
18
  import { LucaCoder } from './features/luca-coder';
19
19
  import type { ConversationTool } from './features/conversation';
@@ -1,10 +1,10 @@
1
1
  import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import type { Conversation, ConversationTool, ContentPart, AskOptions } from './conversation';
4
- import type { ContentDb } from '@soederpop/luca/node';
4
+ import type { ContentDb } from 'luca/node';
5
5
  import type { ConversationHistory, ConversationMeta } from './conversation-history';
6
6
  import { InterceptorChain, type InterceptorFn, type InterceptorPoints, type InterceptorPoint } from '../lib/interceptor-chain.js';
7
- declare module '@soederpop/luca/feature' {
7
+ declare module 'luca/feature' {
8
8
  interface AvailableFeatures {
9
9
  assistant: typeof Assistant;
10
10
  }
@@ -2,7 +2,7 @@ import { z } from 'zod';
2
2
  import { Feature } from '../feature.js';
3
3
  import type { Assistant } from './assistant.js';
4
4
  import type { InterceptorFn, InterceptorPoint, InterceptorPoints } from '../lib/interceptor-chain.js';
5
- declare module '@soederpop/luca/feature' {
5
+ declare module 'luca/feature' {
6
6
  interface AvailableFeatures {
7
7
  assistantsManager: typeof AssistantsManager;
8
8
  }
@@ -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
  * }