@soederpop/luca 0.0.28 → 0.0.30

package/src/node/features/ink.ts

@@ -128,7 +128,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * Exposed so consumers don't need a separate react import.
    * Lazy-loaded — first access triggers the import.
    */
-  get React() {
+  get React(): typeof import('react') {
     // return a promise the first time, but for ergonomics we also
     // expose a sync getter that throws if react hasn't loaded yet.
     if (this._reactModule) return this._reactModule
@@ -151,7 +151,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * const { Box, Text } = ink.components
    * ```
    */
-  async loadModules() {
+  async loadModules(): Promise<this> {
     await Promise.all([this._getInk(), this._getReact()])
     return this
   }
@@ -163,7 +163,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * const { Box, Text, Static, Spacer } = ink.components
    * ```
    */
-  get components() {
+  get components(): { Box: typeof import('ink').Box; Text: typeof import('ink').Text; Static: typeof import('ink').Static; Transform: typeof import('ink').Transform; Newline: typeof import('ink').Newline; Spacer: typeof import('ink').Spacer } {
     const ink = this._inkModule
     if (!ink) {
       throw new Error(
@@ -188,7 +188,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * const { useInput, useApp, useFocus } = ink.hooks
    * ```
    */
-  get hooks() {
+  get hooks(): { useInput: typeof import('ink').useInput; useApp: typeof import('ink').useApp; useStdin: typeof import('ink').useStdin; useStdout: typeof import('ink').useStdout; useStderr: typeof import('ink').useStderr; useFocus: typeof import('ink').useFocus; useFocusManager: typeof import('ink').useFocusManager; useCursor: typeof import('ink').useCursor } {
     const ink = this._inkModule
     if (!ink) {
       throw new Error(
@@ -211,7 +211,7 @@ export class Ink extends Feature<InkState, InkOptions> {
   /**
    * The Ink measureElement utility.
    */
-  get measureElement() {
+  get measureElement(): typeof import('ink').measureElement {
     const ink = this._inkModule
     if (!ink) {
       throw new Error('Ink not loaded yet.')
@@ -229,7 +229,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * @param options - Ink render options (stdout, stdin, debug, etc.)
    * @returns The Ink instance with rerender, unmount, waitUntilExit, clear
    */
-  async render(node: any, options: Record<string, any> = {}) {
+  async render(node: any, options: Record<string, any> = {}): Promise<any> {
     const ink = await this._getInk()
     await this._getReact()
 
@@ -280,7 +280,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * ink.rerender(React.createElement(Text, null, 'Updated!'))
    * ```
    */
-  rerender(node: any) {
+  rerender(node: any): void {
     if (!this._instance) {
       throw new Error('No mounted ink app. Call render() first.')
     }
@@ -304,7 +304,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * console.log(ink.isMounted) // false
    * ```
    */
-  unmount() {
+  unmount(): void {
     if (this._instance) {
       this._instance.unmount()
       this.setState({ mounted: false })
@@ -351,7 +351,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * ink.clear()
    * ```
    */
-  clear() {
+  clear(): void {
     if (this._instance) {
       this._instance.clear()
     }
@@ -367,7 +367,7 @@ export class Ink extends Feature<InkState, InkOptions> {
   /**
    * The raw ink render instance if you need low-level access.
    */
-  get instance() {
+  get instance(): any | null {
     return this._instance
   }
 
@@ -387,7 +387,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * )
    * ```
    */
-  registerBlock(name: string, component: Function) {
+  registerBlock(name: string, component: Function): this {
     this._blocks.set(name, component)
     return this
   }
@@ -407,7 +407,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * await ink.renderBlock('Greeting', { name: 'Jon' })
    * ```
    */
-  async renderBlock(name: string, data?: Record<string, any>) {
+  async renderBlock(name: string, data?: Record<string, any>): Promise<void> {
     const component = this._blocks.get(name)
     if (!component) {
       throw new Error(`No block registered with name "${name}". Available: ${[...this._blocks.keys()].join(', ') || '(none)'}`)
@@ -450,7 +450,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * await renderAsync('AsyncChart', { url: 'https://api.example.com/data' })
    * ```
    */
-  async renderBlockAsync(name: string, data?: Record<string, any>, options?: { timeout?: number }) {
+  async renderBlockAsync(name: string, data?: Record<string, any>, options?: { timeout?: number }): Promise<void> {
     const component = this._blocks.get(name)
     if (!component) {
       throw new Error(`No block registered with name "${name}". Available: ${[...this._blocks.keys()].join(', ') || '(none)'}`)

package/src/node/features/ipc-socket.ts

@@ -139,7 +139,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    *
    * @returns True if the socket is configured as a client
    */
-  get isClient() {
+  get isClient(): boolean {
     return this.state.get('mode') === 'client'
   }
 
@@ -148,14 +148,14 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    *
    * @returns True if the socket is configured as a server
    */
-  get isServer() {
+  get isServer(): boolean {
     return this.state.get('mode') === 'server'
   }
 
   /**
    * Returns the number of currently connected clients (server mode).
    */
-  get clientCount() {
+  get clientCount(): number {
     return this.clients.size
   }
 
@@ -326,7 +326,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    * 
    * @returns The active Socket connection, or undefined if not connected
    */
-  get connection() {
+  get connection(): Socket | undefined {
     return this._connection
   }
 
@@ -337,7 +337,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    * @param exclude - Optional client ID to exclude from broadcast
    * @returns This instance for method chaining
    */
-  broadcast(message: any, exclude?: string) {
+  broadcast(message: any, exclude?: string): this {
     const envelope = JSON.stringify({
       data: message,
       id: this.container.utils.uuid()
@@ -377,7 +377,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    *
    * @param message - The message to send
    */
-  async send(message: any) {
+  async send(message: any): Promise<void> {
     if(!this._connection) {
       throw new Error("No connection.")
     }
@@ -449,7 +449,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    * @param data - The reply payload
    * @param clientId - Target client (server mode; for client mode, omit)
    */
-  reply(requestId: string, data: any, clientId?: string) {
+  reply(requestId: string, data: any, clientId?: string): void {
     const envelope = JSON.stringify({
       id: this.container.utils.uuid(),
       data,
@@ -557,7 +557,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
   /**
    * Disconnects the client and stops any reconnection attempts.
    */
-  disconnect() {
+  disconnect(): void {
     this._reconnect.enabled = false
     if (this._reconnect.timer) {
       clearTimeout(this._reconnect.timer)

package/src/node/features/networking.ts

@@ -249,11 +249,11 @@ export class Networking extends Feature<NetworkingState, NetworkingOptions> {
     return this._binCache[name]
   }
 
-  get proc() {
+  get proc(): ReturnType<typeof this.container.feature<'proc'>> {
     return this.container.feature('proc')
   }
 
-  get os() {
+  get os(): ReturnType<typeof this.container.feature<'os'>> {
     return this.container.feature('os')
   }
   
@@ -630,7 +630,7 @@ export class Networking extends Feature<NetworkingState, NetworkingOptions> {
   /**
    * Optional nmap wrapper for users that already have nmap installed.
    */
-  get nmap() {
+  get nmap(): { isAvailable: () => Promise<boolean>; scan: (target: string, args?: string[]) => Promise<{ hosts: NmapHost[]; raw: string }>; quickScan: (cidr: string) => Promise<{ hosts: NmapHost[]; raw: string }>; fullScan: (target: string) => Promise<{ hosts: NmapHost[]; raw: string }> } {
     return {
       isAvailable: async () => this.isNmapAvailable(),
       scan: async (target: string, args: string[] = []) => this.runNmapScan(target, args),

package/src/node/features/os.ts

@@ -48,7 +48,7 @@ export class OS extends Feature {
    * console.log(`Running on ${arch} architecture`)
    * ```
    */
-  get arch() {
+  get arch(): string {
     return os.arch()
   }
   
@@ -63,7 +63,7 @@ export class OS extends Feature {
    * console.log(`Temp directory: ${tempDir}`)
    * ```
    */
-  get tmpdir() {
+  get tmpdir(): string {
     return os.tmpdir()
   }
   
@@ -78,7 +78,7 @@ export class OS extends Feature {
    * console.log(`User home: ${home}`)
    * ```
    */
-  get homedir() {
+  get homedir(): string {
     return os.homedir()
   }
   
@@ -93,7 +93,7 @@ export class OS extends Feature {
    * console.log(`System has ${cores} CPU cores`)
    * ```
    */
-  get cpuCount() {
+  get cpuCount(): number {
     return os.cpus().length
   }
 
@@ -108,7 +108,7 @@ export class OS extends Feature {
    * console.log(`Hostname: ${hostname}`)
    * ```
    */
-  get hostname() {
+  get hostname(): string {
     return os.hostname()
   }
 
@@ -125,7 +125,7 @@ export class OS extends Feature {
    * }
    * ```
    */
-  get platform() {
+  get platform(): string {
     return os.platform()
   }
   
@@ -142,7 +142,7 @@ export class OS extends Feature {
    * })
    * ```
    */
-  get networkInterfaces() {
+  get networkInterfaces(): NodeJS.Dict<os.NetworkInterfaceInfo[]> {
     return os.networkInterfaces()
   }
   

package/src/node/features/package-finder.ts

@@ -148,7 +148,7 @@ export class PackageFinder<
    * }, '/project/node_modules/lodash/package.json');
    * ```
    */
-  addPackage(manifest: PartialManifest, path: string) {
+  addPackage(manifest: PartialManifest, path: string): void {
     const { name } = manifest
     
     if (!this.packages[name]) {
@@ -179,7 +179,7 @@ export class PackageFinder<
    * });
    * ```
    */
-  get duplicates() {
+  get duplicates(): string[] {
     return Object.keys(
       pickBy(this.packages, (packages) => packages.length > 1)
     )
@@ -199,7 +199,7 @@ export class PackageFinder<
    * console.log(`Found ${finder.packageNames.length} unique packages`);
    * ```
    */
-  async start() {
+  async start(): Promise<this | undefined> {
     if (this.isStarted) {
       return this;
     }
@@ -234,7 +234,7 @@ export class PackageFinder<
    * console.log(`Scanned ${finder.manifests.length} packages`);
    * ```
    */
-  async scan(options: { exclude?: string | string[] } = {}) {
+  async scan(options: { exclude?: string | string[] } = {}): Promise<this> {
     const packageFolders = await this.findAllPackageFolders()
     const manifestPaths = packageFolders.map((folder) => `${folder}/package.json`)
 
@@ -256,7 +256,7 @@ export class PackageFinder<
    * 
    * @returns True if the finder has been started and scanning is complete
    */
-  get isStarted() {
+  get isStarted(): boolean {
     return !!this.state.get("started");
   }
  
@@ -271,7 +271,7 @@ export class PackageFinder<
    * console.log(`Found ${names.length} unique packages`);
    * ```
    */
-  get packageNames() {
+  get packageNames(): string[] {
     return Object.keys(this.packages)
   }
   
@@ -294,7 +294,7 @@ export class PackageFinder<
    * });
    * ```
    */
-  get scopes() {
+  get scopes(): string[] {
     return Array.from(
       new Set(this.packageNames.filter(p => p.startsWith('@')).map(p => p.split('/')[0]))
     )
@@ -317,7 +317,7 @@ export class PackageFinder<
    * }
    * ```
    */
-  findByName(name: string) {
+  findByName(name: string): PartialManifest | undefined {
     return this.find((i) => i.name === name)  
   }
 
@@ -340,7 +340,7 @@ export class PackageFinder<
    * });
    * ```
    */
-  findDependentsOf(packageName: string) {
+  findDependentsOf(packageName: string): PartialManifest[] {
     return this.filter(({ dependencies = {}, devDependencies = {} }) => {
       return packageName in dependencies || packageName in devDependencies
     })
@@ -361,7 +361,7 @@ export class PackageFinder<
    * const utility = finder.find(pkg => pkg.description?.includes('utility'));
    * ```
    */
-  find(filter: (manifest: PartialManifest) => boolean) {
+  find(filter: (manifest: PartialManifest) => boolean): PartialManifest | undefined {
     return this.manifests.find(filter)
   }
   
@@ -383,7 +383,7 @@ export class PackageFinder<
    * const scoped = finder.filter(pkg => pkg.name.startsWith('@'));
    * ```
    */
-  filter(filter: (manifest: PartialManifest) => boolean) {
+  filter(filter: (manifest: PartialManifest) => boolean): PartialManifest[] {
     return this.manifests.filter(filter)
   }
 
@@ -404,7 +404,7 @@ export class PackageFinder<
    * const unscoped = finder.exclude(pkg => pkg.name.startsWith('@'));
    * ```
    */
-  exclude(filter: (manifest: PartialManifest) => boolean) {
+  exclude(filter: (manifest: PartialManifest) => boolean): PartialManifest[] {
     return this.manifests.filter((m) => !filter(m))
   }
 
@@ -428,7 +428,7 @@ export class PackageFinder<
    * }, {});
    * ```
    */
-  get manifests() {
+  get manifests(): (PartialManifest & { __path: string })[] {
     return Object.values(this.packages).flat()
   }
   
@@ -452,7 +452,7 @@ export class PackageFinder<
    *   });
    * ```
    */
-  get counts() {
+  get counts(): Record<string, number> {
     return mapValues(this.packages, (packages) => packages.length)
   }
 
@@ -489,7 +489,7 @@ export class PackageFinder<
     return results;
   }
 
-  async findLocalPackageFolders() {
+  async findLocalPackageFolders(): Promise<string[]> {
 	  const cmd = "find . -name package.json"
 	  const result = this.container.proc.exec(cmd)
 	  const all = result.split("\n").filter(Boolean).map((path: string) => this.container.paths.dirname(path))

package/src/node/features/proc.ts

@@ -233,7 +233,7 @@ export class ChildProcess extends Feature {
    * Useful when callers need streaming access to stdout/stderr and
    * direct lifecycle control (for example, cancellation via kill()).
    */
-  spawn(command: string, args: string[] = [], options: RawSpawnOptions = {}) {
+  spawn(command: string, args: string[] = [], options: RawSpawnOptions = {}): import('child_process').ChildProcess {
     const cwd = options.cwd ?? this.container.cwd
     const stdout = options.stdout ?? 'pipe'
     const stderr = options.stderr ?? 'pipe'

package/src/node/features/ui.ts

@@ -104,7 +104,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * @param text - The markdown string to parse and render
    * @returns The rendered terminal-formatted string
    */
-  markdown(text: string) {
+  markdown(text: string): string | Promise<string> {
     return marked.parse(text)
   }
 
@@ -220,7 +220,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * });
    * ```
    */
-  get randomColor() {
+  get randomColor(): string | undefined {
     const colors = Object.keys(this.colors);
     const index = Math.floor(Math.random() * colors.length);
 
@@ -321,7 +321,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * ], { version: '1.0.0' });
    * ```
    */
-  wizard(questions: any[], initialAnswers: any = {}) {
+  wizard(questions: any[], initialAnswers: any = {}): Promise<any> {
     return inquirer.createPromptModule()(questions, initialAnswers);
   }
 
@@ -331,7 +331,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * @param question - The question message to display
    * @returns Promise resolving to the answers object with a `question` key
    */
-  askQuestion(question: string) {
+  askQuestion(question: string): Promise<any> {
     return inquirer.createPromptModule()([{
       type: 'input',
       name: 'question',
@@ -371,7 +371,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * const editedMarkdown = await ui.openInEditor(markdown, '.md');
    * ```
    */
-  async openInEditor(text: string, extension = ".ts") {
+  async openInEditor(text: string, extension = ".ts"): Promise<unknown> {
     const results = await new Promise((resolve, reject) => {
       /*
       editAsync(
@@ -429,7 +429,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * console.log('Available fonts:', ui.fonts.slice(0, 10).join(', '));
    * ```
    */
-  asciiArt(text: string, font: Fonts) {
+  asciiArt(text: string, font: Fonts): string {
     if (!figlet) return text;
     return figlet.textSync(text, font);
   }
@@ -481,7 +481,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * // Available colors: any chalk color names
    * ```
    */
-  banner(text: string, options: { font: Fonts; colors: Color[] } = { font: 'Star Wars', colors: ['red', 'white', 'blue'] }) {
+  banner(text: string, options: { font: Fonts; colors: Color[] } = { font: 'Star Wars', colors: ['red', 'white', 'blue'] }): string {
     const art = this.asciiArt(text, options.font || 'Star Wars');
     const colored = this.applyGradient(art, options.colors || ['red', 'white', 'blue']);
 
@@ -495,7 +495,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * @param args - Tagged template literal arguments
    * @returns The dedented string
    */
-  endent(...args: any[]) {
+  endent(...args: any[]): string {
     // @ts-ignore
     return endent(...args)
   }
@@ -544,7 +544,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
     text: string,
     lineColors: Color[] = ["red", "white", "blue"],
     direction: "horizontal" | "vertical" = "horizontal"
-  ) {
+  ): string {
     if (direction === "horizontal") {
       return this.applyHorizontalGradient(text, lineColors);
     }
@@ -587,7 +587,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
   applyHorizontalGradient(
     text: string,
     lineColors: Color[] = ["red", "white", "blue"]
-  ) {
+  ): string {
     const gColors = Object.fromEntries(
       lineColors.map((color) => [color, this.colors[color]])
     );
@@ -639,7 +639,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
   applyVerticalGradient(
     text: string,
     lineColors: Color[] = ["red", "white", "blue"]
-  ) {
+  ): string {
     const gColors = Object.fromEntries(
       lineColors.map((color) => [color, this.colors[color]])
     );
@@ -689,7 +689,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * const title = ui.padLeft('TITLE', 20, '-'); // '---------------TITLE'
    * ```
    */
-  padLeft(str: string, length: number, padChar = " ") {
+  padLeft(str: string, length: number, padChar = " "): string {
     if (str.length >= length) {
       return str;
     }
@@ -744,7 +744,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * const menuItem = ui.padRight('Coffee', 20, '.') + '$3.50';
    * ```
    */
-  padRight(str: string, length: number, padChar = " ") {
+  padRight(str: string, length: number, padChar = " "): string {
     if (str.length >= length) {
       return str;
     }

package/src/node/features/vm.ts

@@ -67,7 +67,7 @@ export class VM<
    * // import { Container } from '@soederpop/luca'  → works
    * ```
    */
-  defineModule(id: string, exports: any) {
+  defineModule(id: string, exports: any): void {
     this.modules.set(id, exports)
   }
 
@@ -78,7 +78,7 @@ export class VM<
    * @param filePath - The file path to scope native require resolution to
    * @returns A require function with `.resolve` preserved from the native require
    */
-  createRequireFor(filePath: string) {
+  createRequireFor(filePath: string): ((id: string) => any) & { resolve: RequireResolve } {
     const nodeRequire = createRequire(filePath)
     const modules = this.modules
 
@@ -111,7 +111,7 @@ export class VM<
    * const result2 = script.runInContext(vm.createContext({ a: 10, b: 20 }))
    * ```
    */
-  createScript(code: string, options?: vm.ScriptOptions) {
+  createScript(code: string, options?: vm.ScriptOptions): vm.Script {
     return new vm.Script(code, {
       ...options
     })
@@ -152,7 +152,7 @@ export class VM<
    * const result = vm.runSync('user.name', context)
    * ```
    */
-  createContext(ctx: any = {}) {
+  createContext(ctx: any = {}): vm.Context {
     if (this.isContext(ctx)) return ctx
     return vm.createContext({
       console,

package/src/scaffolds/generated.ts

@@ -1,5 +1,5 @@
 // Auto-generated scaffold and MCP readme content
-// Generated at: 2026-03-23T07:45:57.906Z
+// Generated at: 2026-03-24T06:38:36.374Z
 // Source: docs/scaffolds/*.md, docs/examples/assistant/, and docs/mcp/readme.md
 //
 // Do not edit manually. Run: luca build-scaffolds

package/src/servers/express.ts

@@ -55,11 +55,11 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
     _listener?: any
     _mountedEndpoints: Endpoint[] = []
 
-    get express() {
+    get express(): typeof express {
       return express
     }
 
-    get hooks() {
+    get hooks(): { create: (app: Express, server: Server) => Express; beforeStart: (options: any, server: Server) => any } {
       const { create = defaultCreate, beforeStart = () => {} } = this.options  
       
       return {
@@ -68,7 +68,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       }
     }
 
-    get app() {
+    get app(): Express {
       if(this._app) {
         return this._app
       }
@@ -99,7 +99,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
      *
      * @param options - Optional runtime overrides for port and host
      */
-    override async start(options?: StartOptions) {
+    override async start(options?: StartOptions): Promise<this> {
       if (this.isListening) {
         return this
       }
@@ -137,7 +137,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       return this
     }
 
-    override async stop() {
+    override async stop(): Promise<this> {
       if (this.isStopped) {
         return this
       }
@@ -167,7 +167,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       return this
     }
     
-    override async configure() {
+    override async configure(): Promise<this> {
       this.state.set('configured', true)
       return this
     }

package/src/servers/mcp.ts

@@ -428,7 +428,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
    * Configure the MCP protocol server and register all protocol handlers.
    * Called automatically before start() if not already configured.
    */
-  override async configure() {
+  override async configure(): Promise<this> {
     if (this.isConfigured) return this
 
     const serverName = this.options.serverName || this.container.manifest?.name || 'luca-mcp'
@@ -470,7 +470,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
     host?: string
     mcpCompat?: MCPCompatMode
     stdioCompat?: StdioCompatMode
-  }) {
+  }): Promise<this> {
     if (this.isListening) return this
     await this._drainPendingPlugins()
     if (!this.isConfigured) await this.configure()
@@ -499,7 +499,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
   /**
    * Stop the MCP server and close all connections.
    */
-  override async stop() {
+  override async stop(): Promise<this> {
     if (this.isStopped) return this
 
     if (this._mcpServer) {
@@ -631,7 +631,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
   }
 
   /** Start an HTTP transport using StreamableHTTPServerTransport. */
-  private async _startHTTPTransport(port: number, compat: MCPCompatMode) {
+  private async _startHTTPTransport(port: number, compat: MCPCompatMode): Promise<void> {
     const { createServer } = await import('node:http')
     const { StreamableHTTPServerTransport } = await import(
       '@modelcontextprotocol/sdk/server/streamableHttp.js'