Installation

npm install @neural-tools/core

Usage

import { logger, validateConfig } from '@neural-tools/core';

// Structured logging
logger.info('Starting MCP server');
logger.error('Connection failed', { error });

// Configuration validation
const config = validateConfig({
  port: 8000,
  host: 'localhost'
});

Features

Logger

Structured logging with multiple levels and formatting:

logger.debug('Debug message');
logger.info('Info message');
logger.warn('Warning message');
logger.error('Error message', { context });

Type Definitions

TypeScript types for Neural Tools ecosystem:

• MCP server configurations
• Claude command schemas
• Agent definitions
• Workflow types

Utilities

Common helper functions:

• Configuration validation
• File system operations
• Template rendering
• Error handling

API Reference

logger

Structured logging instance with methods:

• logger.debug(message, context?)
• logger.info(message, context?)
• logger.warn(message, context?)
• logger.error(message, context?)

validateConfig

Validate configuration objects using Zod schemas:

const config = validateConfig(userConfig, schema);

Related Packages

• @neural-tools/cli - Main CLI tool
• @neural-tools/create - Workspace scaffolding