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.
- package/.github/workflows/release.yaml +1 -0
- package/CLAUDE.md +10 -2
- package/README.md +130 -112
- package/assistants/codingAssistant/CORE.md +6 -1
- package/assistants/codingAssistant/hooks.ts +1 -1
- package/assistants/inkbot/hooks.ts +1 -1
- package/assistants/inkbot/tools.ts +1 -1
- package/bun.lock +220 -322
- package/commands/audit-docs.ts +2 -2
- package/commands/build-bootstrap.ts +2 -3
- package/commands/build-python-bridge.ts +2 -3
- package/commands/build-scaffolds.ts +2 -3
- package/commands/bundle-consumer-project.ts +521 -0
- package/commands/generate-api-docs.ts +2 -2
- package/commands/inkbot.ts +2 -2
- package/commands/release.ts +2 -2
- package/commands/try-all-challenges.ts +3 -3
- package/commands/try-challenge.ts +3 -3
- package/dist/agi/container.server.d.ts +2 -2
- package/dist/agi/features/assistant.d.ts +2 -2
- package/dist/agi/features/assistants-manager.d.ts +1 -1
- package/dist/agi/features/autonomous-assistant.d.ts +1 -1
- package/dist/agi/features/browser-use.d.ts +1 -1
- package/dist/agi/features/claude-code.d.ts +1 -1
- package/dist/agi/features/conversation-history.d.ts +2 -2
- package/dist/agi/features/conversation.d.ts +1 -1
- package/dist/agi/features/docs-reader.d.ts +1 -1
- package/dist/agi/features/file-tools.d.ts +1 -1
- package/dist/agi/features/luca-coder.d.ts +1 -1
- package/dist/agi/features/openai-codex.d.ts +1 -1
- package/dist/agi/features/skills-library.d.ts +1 -1
- package/dist/clients/civitai/index.d.ts +4 -4
- package/dist/clients/client-template.d.ts +4 -4
- package/dist/clients/comfyui/index.d.ts +2 -2
- package/dist/clients/elevenlabs/index.d.ts +2 -2
- package/dist/clients/openai/index.d.ts +2 -2
- package/dist/clients/supabase/index.d.ts +3 -3
- package/dist/command.d.ts +1 -1
- package/dist/node/container.d.ts +1 -1
- package/dist/node/features/helpers.d.ts +3 -3
- package/dist/node/features/semantic-search.d.ts +1 -1
- package/dist/node/features/vm.d.ts +3 -3
- package/dist/node.d.ts +1 -1
- package/dist/scaffolds/generated.d.ts +1 -1
- package/dist/selector.d.ts +1 -1
- package/index.html +217 -190
- package/luca.console.ts +1 -1
- package/package.json +2 -2
- package/public/index.html +217 -190
- package/public/slides-ai-native.html +1 -1
- package/public/slides-intro.html +2 -2
- package/scripts/examples/ask-luca-expert.ts +1 -1
- package/scripts/examples/assistant-questions.ts +1 -1
- package/scripts/examples/excalidraw-expert.ts +1 -1
- package/scripts/examples/file-manager.ts +1 -1
- package/scripts/examples/ideas.ts +1 -1
- package/scripts/examples/interactive-chat.ts +1 -1
- package/scripts/examples/opening-a-web-browser.ts +1 -1
- package/scripts/examples/telegram-bot.ts +1 -1
- package/scripts/examples/using-assistant-with-mcp.ts +1 -1
- package/scripts/examples/using-claude-code.ts +1 -1
- package/scripts/examples/using-contentdb.ts +2 -2
- package/scripts/examples/using-conversations.ts +1 -1
- package/scripts/examples/using-disk-cache.ts +1 -1
- package/scripts/examples/using-docker-shell.ts +1 -1
- package/scripts/examples/using-elevenlabs.ts +1 -1
- package/scripts/examples/using-google-calendar.ts +1 -1
- package/scripts/examples/using-google-docs.ts +1 -1
- package/scripts/examples/using-google-drive.ts +1 -1
- package/scripts/examples/using-google-sheets.ts +1 -1
- package/scripts/examples/using-nlp.ts +1 -1
- package/scripts/examples/using-ollama.ts +1 -1
- package/scripts/examples/using-postgres.ts +1 -1
- package/scripts/examples/using-runpod.ts +1 -1
- package/scripts/examples/using-tts.ts +1 -1
- package/scripts/scaffold.ts +5 -5
- package/scripts/scratch.ts +1 -1
- package/scripts/test-assistant-hooks.ts +1 -1
- package/scripts/test-docs-reader.ts +1 -1
- package/src/agi/container.server.ts +6 -2
- package/src/agi/features/agent-memory.ts +25 -25
- package/src/agi/features/assistant.ts +34 -5
- package/src/agi/features/assistants-manager.ts +122 -6
- package/src/agi/features/autonomous-assistant.ts +1 -1
- package/src/agi/features/browser-use.ts +20 -1
- package/src/agi/features/claude-code.ts +51 -5
- package/src/agi/features/coding-tools.ts +1 -1
- package/src/agi/features/conversation-history.ts +181 -4
- package/src/agi/features/conversation.ts +186 -15
- package/src/agi/features/docs-reader.ts +2 -2
- package/src/agi/features/file-tools.ts +49 -2
- package/src/agi/features/luca-coder.ts +7 -5
- package/src/agi/features/mcp-bridge.ts +532 -0
- package/src/agi/features/openai-codex.ts +2 -2
- package/src/agi/features/skills-library.ts +131 -52
- package/src/agi/lib/token-counter.ts +80 -0
- package/src/bootstrap/generated.ts +56 -57
- package/src/browser.ts +1 -1
- package/src/cli/build-info.ts +2 -2
- package/src/cli/cli.ts +2 -2
- package/src/clients/civitai/index.ts +5 -5
- package/src/clients/client-template.ts +4 -4
- package/src/clients/comfyui/index.ts +4 -4
- package/src/clients/elevenlabs/index.ts +4 -4
- package/src/clients/openai/index.ts +7 -7
- package/src/clients/supabase/index.ts +4 -4
- package/src/clients/voicebox/index.ts +4 -4
- package/src/command.ts +2 -1
- package/src/commands/chat.ts +1 -0
- package/src/commands/eval.ts +2 -56
- package/src/commands/introspect.ts +1 -1
- package/src/commands/prompt.ts +41 -9
- package/src/container-describer.ts +8 -1
- package/src/container.ts +13 -0
- package/src/entity.ts +2 -2
- package/src/helper.ts +1 -1
- package/src/introspection/generated.agi.ts +28563 -27571
- package/src/introspection/generated.node.ts +20281 -20194
- package/src/introspection/generated.web.ts +605 -584
- package/src/introspection/scan.ts +11 -6
- package/src/node/container.ts +1 -1
- package/src/node/features/content-db.ts +39 -2
- package/src/node/features/display-result.ts +57 -0
- package/src/node/features/helpers.ts +42 -15
- package/src/node/features/python.ts +25 -19
- package/src/node/features/repl.ts +1 -1
- package/src/node/features/secure-shell.ts +11 -17
- package/src/node/features/semantic-search.ts +2 -2
- package/src/node/features/transpiler.ts +2 -3
- package/src/node/features/ui.ts +5 -0
- package/src/node/features/vm.ts +3 -3
- package/src/node.ts +3 -3
- package/src/python/generated.ts +0 -1
- package/src/scaffolds/generated.ts +82 -83
- package/src/selector.ts +1 -1
- package/src/servers/express.ts +1 -1
- package/src/web/features/helpers.ts +22 -0
- package/tsconfig.json +12 -12
- package/docs/CLI.md +0 -335
- package/docs/CNAME +0 -1
- package/docs/README.md +0 -60
- package/docs/TABLE-OF-CONTENTS.md +0 -183
- package/docs/apis/clients/elevenlabs.md +0 -308
- package/docs/apis/clients/graph.md +0 -107
- package/docs/apis/clients/openai.md +0 -429
- package/docs/apis/clients/rest.md +0 -161
- package/docs/apis/clients/websocket.md +0 -174
- package/docs/apis/features/agi/assistant.md +0 -625
- package/docs/apis/features/agi/assistants-manager.md +0 -282
- package/docs/apis/features/agi/auto-assistant.md +0 -279
- package/docs/apis/features/agi/browser-use.md +0 -802
- package/docs/apis/features/agi/claude-code.md +0 -884
- package/docs/apis/features/agi/conversation-history.md +0 -364
- package/docs/apis/features/agi/conversation.md +0 -548
- package/docs/apis/features/agi/docs-reader.md +0 -99
- package/docs/apis/features/agi/file-tools.md +0 -163
- package/docs/apis/features/agi/luca-coder.md +0 -407
- package/docs/apis/features/agi/openai-codex.md +0 -396
- package/docs/apis/features/agi/openapi.md +0 -138
- package/docs/apis/features/agi/semantic-search.md +0 -387
- package/docs/apis/features/agi/skills-library.md +0 -239
- package/docs/apis/features/node/container-link.md +0 -192
- package/docs/apis/features/node/content-db.md +0 -450
- package/docs/apis/features/node/disk-cache.md +0 -379
- package/docs/apis/features/node/dns.md +0 -652
- package/docs/apis/features/node/docker.md +0 -706
- package/docs/apis/features/node/downloader.md +0 -81
- package/docs/apis/features/node/esbuild.md +0 -60
- package/docs/apis/features/node/file-manager.md +0 -191
- package/docs/apis/features/node/fs.md +0 -1217
- package/docs/apis/features/node/git.md +0 -371
- package/docs/apis/features/node/google-auth.md +0 -193
- package/docs/apis/features/node/google-calendar.md +0 -202
- package/docs/apis/features/node/google-docs.md +0 -173
- package/docs/apis/features/node/google-drive.md +0 -246
- package/docs/apis/features/node/google-mail.md +0 -214
- package/docs/apis/features/node/google-sheets.md +0 -194
- package/docs/apis/features/node/grep.md +0 -292
- package/docs/apis/features/node/helpers.md +0 -164
- package/docs/apis/features/node/ink.md +0 -334
- package/docs/apis/features/node/ipc-socket.md +0 -249
- package/docs/apis/features/node/json-tree.md +0 -86
- package/docs/apis/features/node/networking.md +0 -316
- package/docs/apis/features/node/nlp.md +0 -133
- package/docs/apis/features/node/opener.md +0 -97
- package/docs/apis/features/node/os.md +0 -146
- package/docs/apis/features/node/package-finder.md +0 -392
- package/docs/apis/features/node/postgres.md +0 -234
- package/docs/apis/features/node/proc.md +0 -399
- package/docs/apis/features/node/process-manager.md +0 -305
- package/docs/apis/features/node/python.md +0 -604
- package/docs/apis/features/node/redis.md +0 -380
- package/docs/apis/features/node/repl.md +0 -88
- package/docs/apis/features/node/runpod.md +0 -674
- package/docs/apis/features/node/secure-shell.md +0 -176
- package/docs/apis/features/node/semantic-search.md +0 -408
- package/docs/apis/features/node/sqlite.md +0 -233
- package/docs/apis/features/node/telegram.md +0 -279
- package/docs/apis/features/node/transpiler.md +0 -74
- package/docs/apis/features/node/tts.md +0 -133
- package/docs/apis/features/node/ui.md +0 -701
- package/docs/apis/features/node/vault.md +0 -59
- package/docs/apis/features/node/vm.md +0 -75
- package/docs/apis/features/node/yaml-tree.md +0 -85
- package/docs/apis/features/node/yaml.md +0 -176
- package/docs/apis/features/web/asset-loader.md +0 -59
- package/docs/apis/features/web/container-link.md +0 -192
- package/docs/apis/features/web/esbuild.md +0 -54
- package/docs/apis/features/web/helpers.md +0 -164
- package/docs/apis/features/web/network.md +0 -44
- package/docs/apis/features/web/speech.md +0 -69
- package/docs/apis/features/web/vault.md +0 -59
- package/docs/apis/features/web/vm.md +0 -75
- package/docs/apis/features/web/voice.md +0 -84
- package/docs/apis/servers/express.md +0 -171
- package/docs/apis/servers/mcp.md +0 -238
- package/docs/apis/servers/websocket.md +0 -170
- package/docs/bootstrap/CLAUDE.md +0 -101
- package/docs/bootstrap/SKILL.md +0 -341
- package/docs/bootstrap/templates/about-command.ts +0 -41
- package/docs/bootstrap/templates/docs-models.ts +0 -22
- package/docs/bootstrap/templates/docs-readme.md +0 -43
- package/docs/bootstrap/templates/example-feature.ts +0 -53
- package/docs/bootstrap/templates/health-endpoint.ts +0 -15
- package/docs/bootstrap/templates/luca-cli.ts +0 -30
- package/docs/bootstrap/templates/runme.md +0 -54
- package/docs/challenges/caching-proxy.md +0 -16
- package/docs/challenges/content-db-round-trip.md +0 -14
- package/docs/challenges/custom-command.md +0 -9
- package/docs/challenges/file-watcher-pipeline.md +0 -11
- package/docs/challenges/grep-audit-report.md +0 -15
- package/docs/challenges/multi-feature-dashboard.md +0 -14
- package/docs/challenges/process-orchestrator.md +0 -17
- package/docs/challenges/rest-api-server-with-client.md +0 -12
- package/docs/challenges/script-runner-with-vm.md +0 -11
- package/docs/challenges/simple-rest-api.md +0 -15
- package/docs/challenges/websocket-serve-and-client.md +0 -11
- package/docs/challenges/yaml-config-system.md +0 -14
- package/docs/command-system-overhaul.md +0 -94
- package/docs/documentation-audit.md +0 -134
- package/docs/examples/assistant/CORE.md +0 -18
- package/docs/examples/assistant/hooks.ts +0 -3
- package/docs/examples/assistant/tools.ts +0 -10
- package/docs/examples/assistant-hooks-reference.ts +0 -171
- package/docs/examples/assistant-with-process-manager.md +0 -84
- package/docs/examples/content-db.md +0 -77
- package/docs/examples/disk-cache.md +0 -83
- package/docs/examples/docker.md +0 -101
- package/docs/examples/downloader.md +0 -70
- package/docs/examples/entity.md +0 -124
- package/docs/examples/esbuild.md +0 -80
- package/docs/examples/feature-as-tool-provider.md +0 -143
- package/docs/examples/file-manager.md +0 -82
- package/docs/examples/fs.md +0 -83
- package/docs/examples/git.md +0 -85
- package/docs/examples/google-auth.md +0 -88
- package/docs/examples/google-calendar.md +0 -94
- package/docs/examples/google-docs.md +0 -82
- package/docs/examples/google-drive.md +0 -96
- package/docs/examples/google-sheets.md +0 -95
- package/docs/examples/grep.md +0 -85
- package/docs/examples/ink-blocks.md +0 -75
- package/docs/examples/ink-renderer.md +0 -41
- package/docs/examples/ink.md +0 -103
- package/docs/examples/ipc-socket.md +0 -103
- package/docs/examples/json-tree.md +0 -91
- package/docs/examples/networking.md +0 -58
- package/docs/examples/nlp.md +0 -91
- package/docs/examples/opener.md +0 -78
- package/docs/examples/os.md +0 -72
- package/docs/examples/package-finder.md +0 -89
- package/docs/examples/postgres.md +0 -91
- package/docs/examples/proc.md +0 -81
- package/docs/examples/process-manager.md +0 -79
- package/docs/examples/python.md +0 -132
- package/docs/examples/repl.md +0 -93
- package/docs/examples/runpod.md +0 -119
- package/docs/examples/secure-shell.md +0 -92
- package/docs/examples/sqlite.md +0 -86
- package/docs/examples/structured-output-with-assistants.md +0 -144
- package/docs/examples/telegram.md +0 -77
- package/docs/examples/tts.md +0 -86
- package/docs/examples/ui.md +0 -80
- package/docs/examples/vault.md +0 -70
- package/docs/examples/vm.md +0 -86
- package/docs/examples/websocket-ask-and-reply-example.md +0 -128
- package/docs/examples/yaml-tree.md +0 -93
- package/docs/examples/yaml.md +0 -104
- package/docs/ideas/assistant-factory-pattern.md +0 -142
- package/docs/in-memory-fs.md +0 -4
- package/docs/introspection-audit.md +0 -49
- package/docs/introspection.md +0 -164
- package/docs/mcp/readme.md +0 -162
- package/docs/models.ts +0 -41
- package/docs/philosophy.md +0 -86
- package/docs/principles.md +0 -7
- package/docs/prompts/audit-codebase-for-failures-to-use-the-container.md +0 -34
- package/docs/prompts/check-for-undocumented-features.md +0 -27
- package/docs/prompts/mcp-test-easy-command.md +0 -27
- package/docs/scaffolds/client.md +0 -149
- package/docs/scaffolds/command.md +0 -120
- package/docs/scaffolds/endpoint.md +0 -171
- package/docs/scaffolds/feature.md +0 -158
- package/docs/scaffolds/selector.md +0 -91
- package/docs/scaffolds/server.md +0 -196
- package/docs/selectors.md +0 -115
- package/docs/sessions/custom-command/attempt-log-2.md +0 -195
- package/docs/sessions/file-watcher-pipeline/attempt-log-1.md +0 -728
- package/docs/sessions/file-watcher-pipeline/attempt-log-2.md +0 -555
- package/docs/sessions/grep-audit-report/attempt-log-1.md +0 -289
- package/docs/sessions/multi-feature-dashboard/attempt-log-2.md +0 -679
- package/docs/sessions/rest-api-server-with-client/attempt-log-1.md +0 -1
- package/docs/sessions/rest-api-server-with-client/attempt-log-3.md +0 -920
- package/docs/sessions/simple-rest-api/attempt-log-1.md +0 -593
- package/docs/sessions/websocket-serve-and-client/attempt-log-2.md +0 -995
- package/docs/tutorials/00-bootstrap.md +0 -166
- package/docs/tutorials/01-getting-started.md +0 -106
- package/docs/tutorials/02-container.md +0 -210
- package/docs/tutorials/03-scripts.md +0 -194
- package/docs/tutorials/04-features-overview.md +0 -196
- package/docs/tutorials/05-state-and-events.md +0 -171
- package/docs/tutorials/06-servers.md +0 -157
- package/docs/tutorials/07-endpoints.md +0 -198
- package/docs/tutorials/08-commands.md +0 -252
- package/docs/tutorials/09-clients.md +0 -162
- package/docs/tutorials/10-creating-features.md +0 -203
- package/docs/tutorials/11-contentbase.md +0 -191
- package/docs/tutorials/12-assistants.md +0 -215
- package/docs/tutorials/13-introspection.md +0 -157
- package/docs/tutorials/14-type-system.md +0 -174
- package/docs/tutorials/15-project-patterns.md +0 -222
- package/docs/tutorials/16-google-features.md +0 -534
- package/docs/tutorials/17-tui-blocks.md +0 -530
- package/docs/tutorials/18-semantic-search.md +0 -334
- package/docs/tutorials/19-python-sessions.md +0 -401
- package/docs/tutorials/20-browser-esm.md +0 -234
- package/src/agi/endpoints/ask.ts +0 -60
- package/src/agi/endpoints/conversations/[id].ts +0 -45
- package/src/agi/endpoints/conversations.ts +0 -31
- package/src/agi/endpoints/experts.ts +0 -37
- package/test/assistant-hooks.test.ts +0 -306
- package/test/assistant.test.ts +0 -81
- package/test/bus.test.ts +0 -134
- package/test/clients-servers.test.ts +0 -217
- package/test/command.test.ts +0 -267
- package/test/container-link.test.ts +0 -274
- package/test/conversation.test.ts +0 -220
- package/test/features.test.ts +0 -160
- package/test/fork-and-research.test.ts +0 -450
- package/test/integration.test.ts +0 -787
- package/test/interceptor-chain.test.ts +0 -61
- package/test/node-container.test.ts +0 -121
- package/test/python-session.test.ts +0 -105
- package/test/rate-limit.test.ts +0 -272
- package/test/semantic-search.test.ts +0 -550
- package/test/state.test.ts +0 -121
- package/test/vm-context.test.ts +0 -146
- package/test/vm-loadmodule.test.ts +0 -213
- package/test/websocket-ask.test.ts +0 -101
- package/test-integration/assistant.test.ts +0 -138
- package/test-integration/assistants-manager.test.ts +0 -113
- package/test-integration/claude-code.test.ts +0 -98
- package/test-integration/conversation-history.test.ts +0 -205
- package/test-integration/conversation.test.ts +0 -137
- package/test-integration/elevenlabs.test.ts +0 -55
- package/test-integration/google-services.test.ts +0 -80
- package/test-integration/helpers.ts +0 -89
- package/test-integration/memory.test.ts +0 -204
- package/test-integration/openai-codex.test.ts +0 -93
- package/test-integration/runpod.test.ts +0 -58
- package/test-integration/server-endpoints.test.ts +0 -97
- 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 '
|
|
4
|
+
declare module 'luca/feature' {
|
|
5
5
|
interface AvailableFeatures {
|
|
6
6
|
autoAssistant: typeof AutonomousAssistant;
|
|
7
7
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { Feature } from '../feature.js';
|
|
3
|
-
import type { DiskCache } from '
|
|
3
|
+
import type { DiskCache } from 'luca/node/container';
|
|
4
4
|
import type { Message } from './conversation';
|
|
5
|
-
declare module '
|
|
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 '
|
|
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 '
|
|
5
|
+
declare module 'luca/feature' {
|
|
6
6
|
interface AvailableFeatures {
|
|
7
7
|
docsReader: typeof DocsReader;
|
|
8
8
|
}
|
|
@@ -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 '
|
|
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 "
|
|
1
|
+
import { type ClientOptions } from "luca/client";
|
|
2
2
|
import { RestClient } from "../rest";
|
|
3
|
-
import { type ContainerContext } from "
|
|
4
|
-
import { NodeContainer } from "
|
|
3
|
+
import { type ContainerContext } from "luca/container";
|
|
4
|
+
import { NodeContainer } from "luca/node/container";
|
|
5
5
|
import { z } from 'zod';
|
|
6
|
-
declare module "
|
|
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 "
|
|
1
|
+
import { type ClientOptions, type ClientsInterface } from "luca/client";
|
|
2
2
|
import { RestClient } from "./rest";
|
|
3
|
-
import { type ContainerContext } from "
|
|
3
|
+
import { type ContainerContext } from "luca/container";
|
|
4
4
|
import { z } from 'zod';
|
|
5
|
-
declare module "
|
|
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("
|
|
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 "
|
|
2
|
+
import type { ContainerContext } from "luca/container";
|
|
3
3
|
import { z } from 'zod';
|
|
4
|
-
declare module "
|
|
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 "
|
|
4
|
-
declare module "
|
|
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 "
|
|
3
|
-
import type { ContainerContext } from "
|
|
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 "
|
|
2
|
-
import type { ContainerContext } from "
|
|
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 "
|
|
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 '
|
|
23
|
+
* declare module 'luca' {
|
|
24
24
|
* interface AvailableCommands {
|
|
25
25
|
* serve: SimpleCommand<typeof argsSchema>
|
|
26
26
|
* }
|
package/dist/node/container.d.ts
CHANGED
|
@@ -170,7 +170,7 @@ export interface NodeContainer extends ClientsAndServersInterface {
|
|
|
170
170
|
*
|
|
171
171
|
* @example
|
|
172
172
|
* ```ts
|
|
173
|
-
* import container from '
|
|
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
|
|
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
|
|
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('
|
|
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.
|
|
@@ -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. `'
|
|
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('
|
|
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 '
|
|
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("
|
|
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
|
|
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
|
package/dist/selector.d.ts
CHANGED