@soederpop/luca 0.0.34 → 0.0.35

package/bun.lock

@@ -5,7 +5,6 @@
       "name": "@soederpop/luca",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.12.1",
-        "@ngrok/ngrok": "^1.5.1",
         "@openai/codex": "^0.99.0",
         "@resvg/resvg-js": "^2.6.2",
         "@supabase/supabase-js": "^2.95.3",

package/docs/README.md

@@ -25,7 +25,7 @@ Items: 169
     Sections: (none)
     Relationships: (none)
     Documents: 43
-    IDs: examples/postgres, examples/yaml-tree, examples/grep, examples/ink, examples/git, examples/ink-renderer, examples/esbuild, examples/window-manager, examples/process-manager, examples/runpod, examples/google-auth, examples/port-exposer, examples/downloader, examples/secure-shell, examples/vault, examples/window-manager-layouts, examples/ipc-socket, examples/google-sheets, examples/fs, examples/networking, examples/ink-blocks, examples/ui, examples/opener, examples/nlp, examples/disk-cache, examples/assistant/CORE, examples/vm, examples/google-docs, examples/google-calendar, examples/content-db, examples/yaml, examples/package-finder, examples/os, examples/json-tree, examples/google-drive, examples/telegram, examples/file-manager, examples/repl, examples/python, examples/sqlite, examples/tts, examples/docker, examples/proc
+    IDs: examples/postgres, examples/yaml-tree, examples/grep, examples/ink, examples/git, examples/ink-renderer, examples/esbuild, examples/window-manager, examples/process-manager, examples/runpod, examples/google-auth, examples/downloader, examples/secure-shell, examples/vault, examples/window-manager-layouts, examples/ipc-socket, examples/google-sheets, examples/fs, examples/networking, examples/ink-blocks, examples/ui, examples/opener, examples/nlp, examples/disk-cache, examples/assistant/CORE, examples/vm, examples/google-docs, examples/google-calendar, examples/content-db, examples/yaml, examples/package-finder, examples/os, examples/json-tree, examples/google-drive, examples/telegram, examples/file-manager, examples/repl, examples/python, examples/sqlite, examples/tts, examples/docker, examples/proc
 
   Model: Idea
     Prefix: ideas

package/docs/TABLE-OF-CONTENTS.md

@@ -43,7 +43,6 @@
 - [Opener](./examples/opener.md)
 - [os](./examples/os.md)
 - [Package Finder](./examples/package-finder.md)
-- [Port Exposer](./examples/port-exposer.md)
 - [PostgreSQL](./examples/postgres.md)
 - [proc](./examples/proc.md)
 - [Process Manager](./examples/process-manager.md)

package/docs/bootstrap/SKILL.md

@@ -275,7 +275,7 @@ A table of contents for the container. **Run `luca describe <name>` for full doc
 | **AI Assistants** | `assistant`, `assistantsManager`, `conversation`, `conversationHistory`, `fileTools` | Build AI assistants, manage conversations, tool calling. `fileTools` composes lower-level features (`fs`, `grep`) into an assistant-ready tool surface — a good example of how features can define tools for assistants (see `references/examples/feature-as-tool-provider.md`). |
 | **AI Agent Wrappers** | `claudeCode`, `openaiCodex`, `lucaCoder` | Spawn and manage external AI agent CLIs as subprocesses |
 | **Data & Storage** | `sqlite`, `postgres`, `diskCache`, `contentDb`, `redis` | Databases, caching, document management |
-| **Networking** | `networking`, `dns`, `portExposer` | Network utilities, DNS, tunneling |
+| **Networking** | `networking`, `dns` | Network utilities, DNS |
 | **Google Workspace** | `googleAuth`, `googleDrive`, `googleDocs`, `googleSheets`, `googleCalendar`, `googleMail` | OAuth and Google service wrappers |
 | **Dev Tools** | `git`, `docker`, `esbuild`, `vm`, `python`, `packageFinder` | Version control, containers, bundling, sandboxed execution |
 | **Content & NLP** | `docsReader`, `nlp`, `semanticSearch`, `skillsLibrary`, `jsonTree`, `yamlTree` | Document Q&A, text analysis, semantic search, skills, structured file ingestion |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soederpop/luca",
-  "version": "0.0.34",
+  "version": "0.0.35",
   "website": "https://luca.soederpop.com",
   "description": "lightweight universal conversational architecture AKA Le Ultimate Component Architecture AKA Last Universal Common Ancestor, part AI part Human",
   "author": "jon soeder aka the people's champ <jon@soederpop.com>",
@@ -92,7 +92,6 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "@ngrok/ngrok": "^1.5.1",
     "@openai/codex": "^0.99.0",
     "@resvg/resvg-js": "^2.6.2",
     "@supabase/supabase-js": "^2.95.3",

package/scripts/examples/using-assistant-with-mcp.ts

@@ -129,19 +129,16 @@ async function main() {
     }
   }
 
-  // ── Phase 1b: Expose MCP Servers via ngrok ─────────────────────────────
+  // ── Phase 1b: Build local MCP Server URLs ──────────────────────────────
 
   const publicUrls: Record<string, string> = {}
-  const exposers: Array<{ close(): Promise<void> }> = []
 
   for (const def of MCP_SERVERS) {
     const entry = serverMap[def.tag]!
     if (entry.status === 'running' || entry.status === 'external') {
-      const exposer = container.feature('portExposer', { port: def.port, enable: true })
-      const url = await exposer.expose()
+      const url = `http://localhost:${def.port}`
       publicUrls[def.tag] = `${url}/mcp`
       entry.publicUrl = url
-      exposers.push(exposer)
     }
   }
 
@@ -496,7 +493,6 @@ async function main() {
     useInput(
       (input, key) => {
         if (key.ctrl && input === 'c') {
-          for (const e of exposers) e.close().catch(() => {})
           pm.killAll()
           exit()
         }
@@ -553,7 +549,6 @@ async function main() {
   await ink.render(h(App))
   await ink.waitUntilExit()
 
-  for (const e of exposers) await e.close().catch(() => {})
   pm.killAll()
 }
 

package/scripts/test-linux-binary.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# CI-style test: cross-compile luca for Linux and verify it runs in a Docker container
+# Usage: bash scripts/test-linux-binary.sh
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+DIST_DIR="$PROJECT_DIR/dist"
+LINUX_BINARY="$DIST_DIR/luca-linux"
+
+echo "=== Cross-compiling luca for linux-arm64 ==="
+cd "$PROJECT_DIR"
+
+# Run the pre-compile build steps (introspection, scaffolds, etc.)
+bun run build:introspection
+bun run build:scaffolds
+bun run build:bootstrap
+bun run build:python-bridge
+bash scripts/stamp-build.sh
+
+# Cross-compile for linux arm64 (matches Docker on Apple Silicon)
+bun build ./src/cli/cli.ts --compile --target=bun-linux-arm64 --outfile "$LINUX_BINARY" --external node-llama-cpp
+
+echo ""
+echo "=== Built linux binary: $(file "$LINUX_BINARY") ==="
+echo ""
+
+# Create a minimal Dockerfile inline
+DOCKER_TAG="luca-linux-test"
+
+docker build -t "$DOCKER_TAG" -f - "$DIST_DIR" <<'DOCKERFILE'
+FROM debian:bookworm-slim
+RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates && rm -rf /var/lib/apt/lists/*
+WORKDIR /app
+COPY luca-linux /usr/local/bin/luca
+RUN chmod +x /usr/local/bin/luca
+DOCKERFILE
+
+echo ""
+echo "=== Running smoke tests in Docker container ==="
+echo ""
+
+PASS=0
+FAIL=0
+
+run_test() {
+  local description="$1"
+  shift
+  echo -n "  TEST: $description ... "
+  if output=$(docker run --rm "$DOCKER_TAG" "$@" 2>&1); then
+    echo "PASS"
+    PASS=$((PASS + 1))
+  else
+    echo "FAIL"
+    echo "    Output: $output"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+# Basic smoke tests
+run_test "binary executes"          luca --version
+run_test "help flag works"          luca --help
+run_test "eval runs JS expression"  luca eval "1 + 1"
+run_test "describe features"        luca describe features
+run_test "container basics via eval" luca eval "container.uuid"
+
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+
+# Cleanup
+docker rmi "$DOCKER_TAG" > /dev/null 2>&1 || true
+rm -f "$LINUX_BINARY"
+
+if [ "$FAIL" -gt 0 ]; then
+  echo "FAILED"
+  exit 1
+fi
+
+echo "ALL TESTS PASSED"

package/src/bootstrap/generated.ts

@@ -1,5 +1,5 @@
 // Auto-generated bootstrap content
-// Generated at: 2026-03-26T03:30:22.249Z
+// Generated at: 2026-03-27T03:29:28.307Z
 // Source: docs/bootstrap/*.md, docs/bootstrap/templates/*, docs/examples/*.md, docs/tutorials/*.md
 //
 // Do not edit manually. Run: luca build-bootstrap
@@ -282,7 +282,7 @@ A table of contents for the container. **Run \`luca describe <name>\` for full d
 | **AI Assistants** | \`assistant\`, \`assistantsManager\`, \`conversation\`, \`conversationHistory\`, \`fileTools\` | Build AI assistants, manage conversations, tool calling. \`fileTools\` composes lower-level features (\`fs\`, \`grep\`) into an assistant-ready tool surface — a good example of how features can define tools for assistants (see \`references/examples/feature-as-tool-provider.md\`). |
 | **AI Agent Wrappers** | \`claudeCode\`, \`openaiCodex\`, \`lucaCoder\` | Spawn and manage external AI agent CLIs as subprocesses |
 | **Data & Storage** | \`sqlite\`, \`postgres\`, \`diskCache\`, \`contentDb\`, \`redis\` | Databases, caching, document management |
-| **Networking** | \`networking\`, \`dns\`, \`portExposer\` | Network utilities, DNS, tunneling |
+| **Networking** | \`networking\`, \`dns\` | Network utilities, DNS |
 | **Google Workspace** | \`googleAuth\`, \`googleDrive\`, \`googleDocs\`, \`googleSheets\`, \`googleCalendar\`, \`googleMail\` | OAuth and Google service wrappers |
 | **Dev Tools** | \`git\`, \`docker\`, \`esbuild\`, \`vm\`, \`python\`, \`packageFinder\` | Version control, containers, bundling, sandboxed execution |
 | **Content & NLP** | \`docsReader\`, \`nlp\`, \`semanticSearch\`, \`skillsLibrary\`, \`jsonTree\`, \`yamlTree\` | Document Q&A, text analysis, semantic search, skills, structured file ingestion |
@@ -2684,96 +2684,6 @@ console.log('Done')
 ## Summary
 
 The ask/reply protocol gives you awaitable request/response over WebSocket without leaving the Luca helper API. The client calls \`ask(type, data)\` and gets back a promise. The server's message handler gets \`reply()\` and \`replyError()\` injected on any message that carries a \`requestId\`. The server can also \`ask()\` a specific client. Timeouts, error propagation, and cleanup of pending requests on disconnect are all handled automatically.
-`,
-  "port-exposer.md": `---
-title: "Port Exposer"
-tags: [portExposer, ngrok, networking, tunnel]
-lastTested: null
-lastTestPassed: null
----
-
-# portExposer
-
-Exposes local HTTP services via ngrok with SSL-enabled public URLs. Useful for development, testing webhooks, and sharing local services with external consumers.
-
-## Overview
-
-The \`portExposer\` feature creates an ngrok tunnel from a local port to a public HTTPS URL. It supports custom subdomains, regional endpoints, basic auth, and OAuth (features that require a paid ngrok plan). Requires ngrok to be installed or available as a dependency, and optionally an auth token for premium features.
-
-## Enabling the Feature
-
-\`\`\`ts
-const exposer = container.feature('portExposer', {
-  port: 3000,
-  enable: true
-})
-console.log('Port Exposer enabled:', exposer.state.get('enabled'))
-\`\`\`
-
-## Exploring the API
-
-\`\`\`ts
-const docs = container.features.describe('portExposer')
-console.log(docs)
-\`\`\`
-
-## Checking Connection State
-
-\`\`\`ts
-const exposer = container.feature('portExposer', { port: 3000 })
-console.log('Connected:', exposer.isConnected())
-\`\`\`
-
-## Exposing a Port
-
-Create a tunnel and get the public URL.
-
-\`\`\`ts skip
-const url = await exposer.expose()
-console.log('Public URL:', url)
-console.log('Connected:', exposer.isConnected())
-\`\`\`
-
-The returned URL is an HTTPS endpoint that forwards traffic to \`localhost:3000\`. The tunnel remains active until \`close()\` is called or the process exits.
-
-## Getting Connection Info
-
-Retrieve a snapshot of the current tunnel state.
-
-\`\`\`ts skip
-await exposer.expose()
-const info = exposer.getConnectionInfo()
-console.log('Public URL:', info.publicUrl)
-console.log('Local port:', info.localPort)
-console.log('Connected at:', info.connectedAt)
-\`\`\`
-
-## Reconnecting with New Options
-
-Close the existing tunnel and re-expose with different settings.
-
-\`\`\`ts skip
-const url1 = await exposer.expose()
-console.log('First URL:', url1)
-
-const url2 = await exposer.reconnect({ port: 8080 })
-console.log('New URL (port 8080):', url2)
-\`\`\`
-
-The \`reconnect\` method calls \`close()\` internally, merges the new options, then calls \`expose()\` again.
-
-## Closing the Tunnel
-
-\`\`\`ts skip
-await exposer.close()
-console.log('Tunnel closed:', !exposer.isConnected())
-\`\`\`
-
-Calling \`close()\` when no tunnel is active is a safe no-op. The \`disable()\` method also closes the tunnel before disabling the feature.
-
-## Summary
-
-The \`portExposer\` feature wraps ngrok to expose local ports as public HTTPS endpoints. It supports connection lifecycle management, reconnection with new options, and event-driven notifications for tunnel state changes. Requires ngrok to be installed.
 `,
   "secure-shell.md": `---
 title: "Secure Shell"

package/src/cli/build-info.ts

@@ -1,4 +1,4 @@
 // Generated at compile time — do not edit manually
-export const BUILD_SHA = 'd3e8b52'
+export const BUILD_SHA = 'd0aa900'
 export const BUILD_BRANCH = 'main'
-export const BUILD_DATE = '2026-03-26T03:30:23Z'
+export const BUILD_DATE = '2026-03-27T03:29:29Z'