@soederpop/luca 0.0.34 → 0.0.36

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.36",
   "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",
@@ -105,7 +104,7 @@
     "chokidar": "^3.5.3",
     "cli-markdown": "^3.5.0",
     "compromise": "^14.14.5",
-    "contentbase": "^0.1.7",
+    "contentbase": "^0.2.0",
     "cors": "^2.8.5",
     "detect-port": "^1.5.1",
     "dotenv": "^17.2.4",

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-28T00:36:31.608Z
 // 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 = 'acd8dd0'
 export const BUILD_BRANCH = 'main'
-export const BUILD_DATE = '2026-03-26T03:30:23Z'
+export const BUILD_DATE = '2026-03-28T00:36:32Z'

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-26T03:30:20.574Z
+// Generated at: 2026-03-28T00:36:29.946Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -8861,136 +8861,6 @@ setBuildTimeData('features.processManager', {
   }
 });
 
-setBuildTimeData('portExposer', {
-  "id": "portExposer",
-  "description": "Port Exposer Feature Exposes local HTTP services via ngrok with SSL-enabled public URLs. Perfect for development, testing, and sharing local services securely. Features: - SSL-enabled public URLs for local services - Custom subdomains and domains (with paid plans) - Authentication options (basic auth, OAuth) - Regional endpoint selection - Connection state management",
-  "shortcut": "portExposer",
-  "className": "PortExposer",
-  "methods": {
-    "expose": {
-      "description": "Expose the local port via ngrok. Creates an ngrok tunnel to the specified local port and returns the SSL-enabled public URL. Emits `exposed` on success or `error` on failure.",
-      "parameters": {
-        "port": {
-          "type": "number",
-          "description": "Optional port override; falls back to `options.port`"
-        }
-      },
-      "required": [],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Public URL: ${url}`)\n\n// Override port at call time\nconst url2 = await exposer.expose(8080)"
-        }
-      ]
-    },
-    "close": {
-      "description": "Stop exposing the port and close the ngrok tunnel. Tears down the ngrok listener, resets connection state, and emits `closed`. Safe to call when no tunnel is active (no-op).",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<void>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// ... later\nawait exposer.close()\nconsole.log(exposer.isConnected()) // false"
-        }
-      ]
-    },
-    "getPublicUrl": {
-      "description": "Get the current public URL if connected. Returns the live URL from the ngrok listener, or `undefined` if no tunnel is active.",
-      "parameters": {},
-      "required": [],
-      "returns": "string | undefined",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconsole.log(exposer.getPublicUrl()) // 'https://abc123.ngrok.io'"
-        }
-      ]
-    },
-    "isConnected": {
-      "description": "Check if the ngrok tunnel is currently connected.",
-      "parameters": {},
-      "required": [],
-      "returns": "boolean",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconsole.log(exposer.isConnected()) // false\nawait exposer.expose()\nconsole.log(exposer.isConnected()) // true"
-        }
-      ]
-    },
-    "getConnectionInfo": {
-      "description": "Get a snapshot of the current connection information. Returns an object with the tunnel's connected status, public URL, local port, connection timestamp, and session metadata.",
-      "parameters": {},
-      "required": [],
-      "returns": "void",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconst info = exposer.getConnectionInfo()\nconsole.log(info.publicUrl, info.localPort, info.connectedAt)"
-        }
-      ]
-    },
-    "reconnect": {
-      "description": "Close the existing tunnel and re-expose with optionally updated options. Calls `close()` first, merges any new options, then calls `expose()`.",
-      "parameters": {
-        "newOptions": {
-          "type": "Partial<PortExposerOptions>",
-          "description": "Optional partial options to merge before reconnecting"
-        }
-      },
-      "required": [],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// Switch to a different port\nconst newUrl = await exposer.reconnect({ port: 8080 })"
-        }
-      ]
-    },
-    "disable": {
-      "description": "Disable the feature, ensuring the ngrok tunnel is closed first. Overrides the base `disable()` to guarantee that the tunnel is torn down before the feature is marked as disabled.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<this>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nawait exposer.disable()"
-        }
-      ]
-    }
-  },
-  "getters": {},
-  "events": {
-    "exposed": {
-      "name": "exposed",
-      "description": "Event emitted by PortExposer",
-      "arguments": {}
-    },
-    "error": {
-      "name": "error",
-      "description": "Event emitted by PortExposer",
-      "arguments": {}
-    },
-    "closed": {
-      "name": "closed",
-      "description": "Event emitted by PortExposer",
-      "arguments": {}
-    }
-  },
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "// Basic usage\nconst exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Service available at: ${url}`)\n\n// With custom subdomain\nconst exposer = container.feature('portExposer', {\n port: 8080,\n subdomain: 'my-app',\n authToken: 'your-ngrok-token'\n})"
-    }
-  ]
-});
-
 setBuildTimeData('features.googleSheets', {
   "id": "features.googleSheets",
   "description": "Google Sheets feature for reading spreadsheet data as JSON, CSV, or raw arrays. Depends on the googleAuth feature for authentication. Creates a Sheets v4 API client lazily and provides convenient methods for reading tabular data.",
@@ -27573,135 +27443,6 @@ export const introspectionData = [
       }
     }
   },
-  {
-    "id": "portExposer",
-    "description": "Port Exposer Feature Exposes local HTTP services via ngrok with SSL-enabled public URLs. Perfect for development, testing, and sharing local services securely. Features: - SSL-enabled public URLs for local services - Custom subdomains and domains (with paid plans) - Authentication options (basic auth, OAuth) - Regional endpoint selection - Connection state management",
-    "shortcut": "portExposer",
-    "className": "PortExposer",
-    "methods": {
-      "expose": {
-        "description": "Expose the local port via ngrok. Creates an ngrok tunnel to the specified local port and returns the SSL-enabled public URL. Emits `exposed` on success or `error` on failure.",
-        "parameters": {
-          "port": {
-            "type": "number",
-            "description": "Optional port override; falls back to `options.port`"
-          }
-        },
-        "required": [],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Public URL: ${url}`)\n\n// Override port at call time\nconst url2 = await exposer.expose(8080)"
-          }
-        ]
-      },
-      "close": {
-        "description": "Stop exposing the port and close the ngrok tunnel. Tears down the ngrok listener, resets connection state, and emits `closed`. Safe to call when no tunnel is active (no-op).",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<void>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// ... later\nawait exposer.close()\nconsole.log(exposer.isConnected()) // false"
-          }
-        ]
-      },
-      "getPublicUrl": {
-        "description": "Get the current public URL if connected. Returns the live URL from the ngrok listener, or `undefined` if no tunnel is active.",
-        "parameters": {},
-        "required": [],
-        "returns": "string | undefined",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconsole.log(exposer.getPublicUrl()) // 'https://abc123.ngrok.io'"
-          }
-        ]
-      },
-      "isConnected": {
-        "description": "Check if the ngrok tunnel is currently connected.",
-        "parameters": {},
-        "required": [],
-        "returns": "boolean",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconsole.log(exposer.isConnected()) // false\nawait exposer.expose()\nconsole.log(exposer.isConnected()) // true"
-          }
-        ]
-      },
-      "getConnectionInfo": {
-        "description": "Get a snapshot of the current connection information. Returns an object with the tunnel's connected status, public URL, local port, connection timestamp, and session metadata.",
-        "parameters": {},
-        "required": [],
-        "returns": "void",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconst info = exposer.getConnectionInfo()\nconsole.log(info.publicUrl, info.localPort, info.connectedAt)"
-          }
-        ]
-      },
-      "reconnect": {
-        "description": "Close the existing tunnel and re-expose with optionally updated options. Calls `close()` first, merges any new options, then calls `expose()`.",
-        "parameters": {
-          "newOptions": {
-            "type": "Partial<PortExposerOptions>",
-            "description": "Optional partial options to merge before reconnecting"
-          }
-        },
-        "required": [],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// Switch to a different port\nconst newUrl = await exposer.reconnect({ port: 8080 })"
-          }
-        ]
-      },
-      "disable": {
-        "description": "Disable the feature, ensuring the ngrok tunnel is closed first. Overrides the base `disable()` to guarantee that the tunnel is torn down before the feature is marked as disabled.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nawait exposer.disable()"
-          }
-        ]
-      }
-    },
-    "getters": {},
-    "events": {
-      "exposed": {
-        "name": "exposed",
-        "description": "Event emitted by PortExposer",
-        "arguments": {}
-      },
-      "error": {
-        "name": "error",
-        "description": "Event emitted by PortExposer",
-        "arguments": {}
-      },
-      "closed": {
-        "name": "closed",
-        "description": "Event emitted by PortExposer",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "// Basic usage\nconst exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Service available at: ${url}`)\n\n// With custom subdomain\nconst exposer = container.feature('portExposer', {\n port: 8080,\n subdomain: 'my-app',\n authToken: 'your-ngrok-token'\n})"
-      }
-    ]
-  },
   {
     "id": "features.googleSheets",
     "description": "Google Sheets feature for reading spreadsheet data as JSON, CSV, or raw arrays. Depends on the googleAuth feature for authentication. Creates a Sheets v4 API client lazily and provides convenient methods for reading tabular data.",