@willjackson/claude-code-bridge 0.2.4 → 0.3.0

package/dist/index.d.ts

@@ -1306,84 +1306,6 @@ declare class WebSocketTransport implements Transport {
     getReconnectAttempts(): number;
 }
 
-/**
- * Peer Discovery Module
- *
- * Provides functions to discover bridge-enabled Docker containers
- * and development environment projects.
- */
-/**
- * Discovered peer information
- */
-interface DiscoveredPeer {
-    name: string;
-    source: 'docker' | 'docksal' | 'ddev' | 'lando';
-    url: string;
-    containerId?: string;
-    status?: string;
-}
-/**
- * Bridge label configuration parsed from Docker container labels
- */
-interface BridgeLabelConfig {
-    enabled: boolean;
-    port?: number;
-    name?: string;
-}
-/**
- * Parse Docker container labels to extract bridge configuration
- *
- * @param labels - Comma-separated label string from Docker
- * @returns Parsed bridge configuration or null if bridge not enabled
- */
-declare function parseDockerLabels(labels: string): BridgeLabelConfig | null;
-/**
- * Check if Docker daemon is available and running
- */
-declare function isDockerAvailable(): boolean;
-/**
- * Discover Docker containers with bridge labels
- *
- * Searches for running containers that have the claude.bridge.enabled=true label
- * and extracts connection information from their labels.
- *
- * @returns Array of discovered peers with connection URLs
- */
-declare function discoverDockerPeers(): DiscoveredPeer[];
-/**
- * Discover Docksal projects with bridges
- *
- * Uses the `fin project list` command to find running Docksal projects.
- *
- * @returns Array of discovered peers with connection URLs
- */
-declare function discoverDocksalProjects(): DiscoveredPeer[];
-/**
- * Discover DDEV projects with bridges
- *
- * Uses the `ddev list` command to find running DDEV projects.
- *
- * @returns Array of discovered peers with connection URLs
- */
-declare function discoverDdevProjects(): DiscoveredPeer[];
-/**
- * Discover Lando projects with bridges
- *
- * Uses the `lando list` command to find running Lando apps.
- *
- * @returns Array of discovered peers with connection URLs
- */
-declare function discoverLandoProjects(): DiscoveredPeer[];
-/**
- * Discover all peers from all sources
- *
- * Aggregates peers from Docker containers and all supported development
- * environments (Docksal, DDEV, Lando).
- *
- * @returns Array of all discovered peers
- */
-declare function discoverAllPeers(): DiscoveredPeer[];
-
 /**
  * Transport module exports
  */
@@ -1405,6 +1327,38 @@ interface CreateTransportOptions {
  */
 declare function createTransport(type: TransportType, options?: CreateTransportOptions): Transport;
 
+/**
+ * Log levels supported by the logger
+ */
+type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Logger interface (subset of pino.Logger for public API)
+ */
+type Logger = pino.Logger;
+/**
+ * Creates a logger instance with the given component name
+ *
+ * @param name - Component name to include in log output
+ * @param level - Optional log level override (defaults to LOG_LEVEL env var or 'info')
+ * @returns A pino logger instance configured for the component
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger('bridge');
+ * logger.info('Bridge started');
+ * logger.error({ err }, 'Connection failed');
+ * ```
+ */
+declare function createLogger(name: string, level?: LogLevel): Logger;
+/**
+ * Creates a child logger from an existing logger with additional context
+ *
+ * @param parent - Parent logger instance
+ * @param bindings - Additional context to include in all log messages
+ * @returns A child logger instance
+ */
+declare function createChildLogger(parent: Logger, bindings: Record<string, unknown>): Logger;
+
 /**
  * Configuration for the bridge's listening socket
  */
@@ -1489,214 +1443,6 @@ declare function loadConfig(configPath?: string): Promise<BridgeConfig>;
  */
 declare function loadConfigSync(configPath?: string): BridgeConfig;
 
-/**
- * Environment detection utilities for Claude Code Bridge
- *
- * Detects the runtime environment (Docksal, DDEV, Lando, Docker, or native)
- * and provides appropriate configuration defaults.
- */
-
-/**
- * Supported Docker environment types
- */
-type DockerEnvironment = 'docksal' | 'ddev' | 'lando' | 'docker-compose' | 'docker' | 'native';
-/**
- * Information about the detected runtime environment
- */
-interface EnvironmentInfo {
-    /** The type of environment detected */
-    type: DockerEnvironment;
-    /** Whether running inside a container */
-    isContainer: boolean;
-    /** Project name (if applicable) */
-    projectName?: string;
-    /** Project root path (if applicable) */
-    projectRoot?: string;
-    /** Host gateway address for container-to-host communication */
-    hostGateway?: string;
-    /** Operating system platform */
-    platform: NodeJS.Platform;
-    /** Additional environment-specific metadata */
-    meta?: Record<string, string>;
-}
-/**
- * Detect the current runtime environment
- *
- * Detection order (first match wins):
- * 1. Docksal (DOCKSAL_STACK env var)
- * 2. DDEV (IS_DDEV_PROJECT=true env var)
- * 3. Lando (LANDO=ON env var)
- * 4. Docker Compose (COMPOSE_PROJECT_NAME env var)
- * 5. Generic Docker (/.dockerenv file exists)
- * 6. Native (fallback)
- *
- * @returns EnvironmentInfo object with detected environment details
- */
-declare function detectEnvironment(): EnvironmentInfo;
-/**
- * Get the host gateway address for container-to-host communication
- *
- * - macOS and Windows: Use host.docker.internal (provided by Docker Desktop)
- * - Linux: May need to use bridge gateway IP or host-gateway flag
- *
- * @returns The hostname or IP to reach the Docker host from inside a container
- */
-declare function getHostGateway(): string;
-/**
- * Get default bridge configuration based on the detected environment
- *
- * Different environments may have different port defaults or connection
- * preferences.
- *
- * @param env - The detected environment info
- * @returns Partial BridgeConfig with environment-specific defaults
- */
-declare function getDefaultConfig(env: EnvironmentInfo): Partial<BridgeConfig>;
-
-/**
- * Docksal-specific helper functions for Claude Code Bridge
- *
- * Provides utilities to extract project information from the Docksal environment.
- * Docksal is a Docker-based development environment primarily used for
- * Drupal and other PHP projects.
- *
- * @see https://docksal.io/
- */
-/**
- * Information about a Docksal project
- */
-interface DocksalProjectInfo {
-    /** Project name from DOCKSAL_PROJECT env var */
-    projectName: string;
-    /** Project root path from PROJECT_ROOT env var */
-    projectRoot: string;
-    /** Docksal stack name from DOCKSAL_STACK env var */
-    stack: string;
-}
-/**
- * Get Docksal project information from environment variables
- *
- * Extracts project details from the standard Docksal environment variables:
- * - DOCKSAL_PROJECT: The project name
- * - PROJECT_ROOT: The project root directory
- * - DOCKSAL_STACK: The Docksal stack being used (e.g., 'default', 'acquia')
- *
- * @returns DocksalProjectInfo if in Docksal environment, null otherwise
- *
- * @example
- * ```typescript
- * const info = getDocksalProjectInfo();
- * if (info) {
- *   console.log(`Project: ${info.projectName}`);
- *   console.log(`Root: ${info.projectRoot}`);
- *   console.log(`Stack: ${info.stack}`);
- * }
- * ```
- */
-declare function getDocksalProjectInfo(): DocksalProjectInfo | null;
-
-/**
- * DDEV-specific helper functions for Claude Code Bridge
- *
- * Provides utilities to extract project information from the DDEV environment.
- * DDEV is a Docker-based development environment for PHP and other projects.
- *
- * @see https://ddev.readthedocs.io/
- */
-/**
- * Information about a DDEV project
- */
-interface DdevProjectInfo {
-    /** Project name from DDEV_PROJECT env var */
-    projectName: string;
-    /** Project document root from DDEV_DOCROOT env var */
-    projectRoot: string;
-}
-/**
- * Get DDEV project information from environment variables
- *
- * Extracts project details from the standard DDEV environment variables:
- * - DDEV_PROJECT: The project name
- * - DDEV_DOCROOT: The document root directory (web root)
- *
- * @returns DdevProjectInfo if in DDEV environment, null otherwise
- *
- * @example
- * ```typescript
- * const info = getDdevProjectInfo();
- * if (info) {
- *   console.log(`Project: ${info.projectName}`);
- *   console.log(`Root: ${info.projectRoot}`);
- * }
- * ```
- */
-declare function getDdevProjectInfo(): DdevProjectInfo | null;
-
-/**
- * Lando-specific helper functions for Claude Code Bridge
- *
- * Provides utilities to extract project information from the Lando environment.
- * Lando is a Docker-based development environment for PHP, Node.js, and other projects.
- *
- * @see https://docs.lando.dev/
- */
-/**
- * Information about a Lando project
- */
-interface LandoProjectInfo {
-    /** Project name (app name) from LANDO_APP_NAME env var */
-    projectName: string;
-}
-/**
- * Get Lando project information from environment variables
- *
- * Extracts project details from the standard Lando environment variables:
- * - LANDO_APP_NAME: The application/project name
- *
- * @returns LandoProjectInfo if in Lando environment, null otherwise
- *
- * @example
- * ```typescript
- * const info = getLandoProjectInfo();
- * if (info) {
- *   console.log(`Project: ${info.projectName}`);
- * }
- * ```
- */
-declare function getLandoProjectInfo(): LandoProjectInfo | null;
-
-/**
- * Log levels supported by the logger
- */
-type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
-/**
- * Logger interface (subset of pino.Logger for public API)
- */
-type Logger = pino.Logger;
-/**
- * Creates a logger instance with the given component name
- *
- * @param name - Component name to include in log output
- * @param level - Optional log level override (defaults to LOG_LEVEL env var or 'info')
- * @returns A pino logger instance configured for the component
- *
- * @example
- * ```typescript
- * const logger = createLogger('bridge');
- * logger.info('Bridge started');
- * logger.error({ err }, 'Connection failed');
- * ```
- */
-declare function createLogger(name: string, level?: LogLevel): Logger;
-/**
- * Creates a child logger from an existing logger with additional context
- *
- * @param parent - Parent logger instance
- * @param bindings - Additional context to include in all log messages
- * @returns A child logger instance
- */
-declare function createChildLogger(parent: Logger, bindings: Record<string, unknown>): Logger;
-
 /**
  * Token counting utilities for context chunking.
  * Uses word-based approximation since exact token counting requires
@@ -1864,12 +1610,11 @@ declare function isErrorCode(error: unknown, code: ErrorCode): boolean;
  * Claude Code Bridge
  *
  * A bidirectional communication system that enables two separate Claude Code instances
- * to collaborate across different environments. The primary use case is connecting a
- * native macOS Claude Code instance with a Claude Code instance running inside a
- * Docker-based development environment (Docksal, DDEV, Lando, or plain Docker).
+ * to collaborate across different environments. Connect instances running on different
+ * machines, containers, or networks via WebSocket.
  *
  * @packageDocumentation
  */
 declare const VERSION = "0.1.0";
 
-export { type Artifact, ArtifactSchema, Bridge, type BridgeConfig$1 as BridgeConfig, type BridgeConnectConfig, BridgeError, type BridgeLabelConfig, BridgeLifecycleError, type BridgeListenConfig, type BridgeMessage, BridgeMessageSchema, type BridgeMode, type BuildDirectoryTreeOptions, ConfigurationError, type ConnectConfig, type ConnectionConfig, ConnectionError, ConnectionState, type Context, type ContextDelta, ContextError, ContextManager, type ContextManagerOptions, type ContextReceivedHandler, type ContextRequestedHandler, ContextSchema, type ContextSharingConfig$1 as ContextSharingConfig, DEFAULT_CONFIG, type DdevProjectInfo, type DirectoryTree, DirectoryTreeSchema, type DiscoveredPeer, type DockerEnvironment, type DocksalProjectInfo, type EnvironmentInfo, type ErrorCode, ErrorCodes, type FileChange, type FileChunk, FileChunkSchema, type InteractionConfig, type LandoProjectInfo, type ListenConfig, type LogLevel, type Logger, type MessageReceivedHandler, MessageType, type NotificationData, type PeerConnectedHandler, type PeerDisconnectedHandler, PeerError, type PeerInfo, type ProjectSnapshot, ProtocolError, TaskError, type TaskReceivedHandler, type TaskRequest, TaskRequestSchema, type TaskResult, TaskResultSchema, type Transport, type BridgeConfig as UtilsBridgeConfig, type ContextSharingConfig as UtilsContextSharingConfig, VERSION, WebSocketTransport, buildDirectoryTree, createChildLogger, createContextRequestMessage, createContextSyncMessage, createLogger, createMessage, createNotificationMessage, createTaskDelegateMessage, createTaskResponseMessage, createTransport, deserializeMessage, detectEnvironment, discoverAllPeers, discoverDdevProjects, discoverDockerPeers, discoverDocksalProjects, discoverLandoProjects, estimateTokens, formatErrorForLogging, getDdevProjectInfo, getDefaultConfig, getDocksalProjectInfo, getHostGateway, getLandoProjectInfo, isDockerAvailable, isErrorCode, loadConfig, loadConfigSync, mergeConfig, parseDockerLabels, safeDeserializeMessage, safeValidateMessage, serializeMessage, truncateToTokenLimit, validateMessage, wrapError };
+export { type Artifact, ArtifactSchema, Bridge, type BridgeConfig$1 as BridgeConfig, type BridgeConnectConfig, BridgeError, BridgeLifecycleError, type BridgeListenConfig, type BridgeMessage, BridgeMessageSchema, type BridgeMode, type BuildDirectoryTreeOptions, ConfigurationError, type ConnectConfig, type ConnectionConfig, ConnectionError, ConnectionState, type Context, type ContextDelta, ContextError, ContextManager, type ContextManagerOptions, type ContextReceivedHandler, type ContextRequestedHandler, ContextSchema, type ContextSharingConfig$1 as ContextSharingConfig, DEFAULT_CONFIG, type DirectoryTree, DirectoryTreeSchema, type ErrorCode, ErrorCodes, type FileChange, type FileChunk, FileChunkSchema, type InteractionConfig, type ListenConfig, type LogLevel, type Logger, type MessageReceivedHandler, MessageType, type NotificationData, type PeerConnectedHandler, type PeerDisconnectedHandler, PeerError, type PeerInfo, type ProjectSnapshot, ProtocolError, TaskError, type TaskReceivedHandler, type TaskRequest, TaskRequestSchema, type TaskResult, TaskResultSchema, type Transport, type BridgeConfig as UtilsBridgeConfig, type ContextSharingConfig as UtilsContextSharingConfig, VERSION, WebSocketTransport, buildDirectoryTree, createChildLogger, createContextRequestMessage, createContextSyncMessage, createLogger, createMessage, createNotificationMessage, createTaskDelegateMessage, createTaskResponseMessage, createTransport, deserializeMessage, estimateTokens, formatErrorForLogging, isErrorCode, loadConfig, loadConfigSync, mergeConfig, safeDeserializeMessage, safeValidateMessage, serializeMessage, truncateToTokenLimit, validateMessage, wrapError };

package/dist/index.js

@@ -20,24 +20,14 @@ import {
   createTaskDelegateMessage,
   createTaskResponseMessage,
   deserializeMessage,
-  detectEnvironment,
-  discoverAllPeers,
-  discoverDdevProjects,
-  discoverDockerPeers,
-  discoverDocksalProjects,
-  discoverLandoProjects,
-  getDefaultConfig,
-  getHostGateway,
-  isDockerAvailable,
   loadConfig,
   loadConfigSync,
   mergeConfig,
-  parseDockerLabels,
   safeDeserializeMessage,
   safeValidateMessage,
   serializeMessage,
   validateMessage
-} from "./chunk-5HWFDZKH.js";
+} from "./chunk-LUL3SX2F.js";
 
 // src/bridge/context.ts
 import { readdirSync, readFileSync, statSync, realpathSync } from "fs";
@@ -546,63 +536,6 @@ function createTransport(type, options) {
   }
 }
 
-// src/environment/docksal.ts
-function isDocksalEnvironment() {
-  return !!process.env.DOCKSAL_STACK;
-}
-function getDocksalProjectInfo() {
-  if (!isDocksalEnvironment()) {
-    return null;
-  }
-  const projectName = process.env.DOCKSAL_PROJECT;
-  const projectRoot = process.env.PROJECT_ROOT;
-  const stack = process.env.DOCKSAL_STACK;
-  if (!projectName || !projectRoot || !stack) {
-    return null;
-  }
-  return {
-    projectName,
-    projectRoot,
-    stack
-  };
-}
-
-// src/environment/ddev.ts
-function isDdevEnvironment() {
-  return process.env.IS_DDEV_PROJECT === "true";
-}
-function getDdevProjectInfo() {
-  if (!isDdevEnvironment()) {
-    return null;
-  }
-  const projectName = process.env.DDEV_PROJECT;
-  const projectRoot = process.env.DDEV_DOCROOT;
-  if (!projectName || !projectRoot) {
-    return null;
-  }
-  return {
-    projectName,
-    projectRoot
-  };
-}
-
-// src/environment/lando.ts
-function isLandoEnvironment() {
-  return process.env.LANDO === "ON";
-}
-function getLandoProjectInfo() {
-  if (!isLandoEnvironment()) {
-    return null;
-  }
-  const projectName = process.env.LANDO_APP_NAME;
-  if (!projectName) {
-    return null;
-  }
-  return {
-    projectName
-  };
-}
-
 // src/utils/errors.ts
 var BridgeError = class extends Error {
   code;
@@ -947,25 +880,12 @@ export {
   createTaskResponseMessage,
   createTransport,
   deserializeMessage,
-  detectEnvironment,
-  discoverAllPeers,
-  discoverDdevProjects,
-  discoverDockerPeers,
-  discoverDocksalProjects,
-  discoverLandoProjects,
   estimateTokens,
   formatErrorForLogging,
-  getDdevProjectInfo,
-  getDefaultConfig,
-  getDocksalProjectInfo,
-  getHostGateway,
-  getLandoProjectInfo,
-  isDockerAvailable,
   isErrorCode,
   loadConfig,
   loadConfigSync,
   mergeConfig,
-  parseDockerLabels,
   safeDeserializeMessage,
   safeValidateMessage,
   serializeMessage,