Module API

lib/config.js

Load configuration.

const config = require('./lib/config');

config.get('github.repo');
config.get('paths.models');
config.set('node.pollInterval', 30);

lib/brain.js

Brain file structure and management.

const brain = require('./lib/brain');

await brain.load();      // Load all brain files
await brain.get(key);  // Get file content
await brain.set(key, content); // Set file content
await brain.save();   // Save to disk

lib/lock.js

Manage locks.

const lock = require('./lib/lock');

await lock.acquire(agentId);
await lock.release(agentId, token);

lib/branch.js

Manage branches.

const branch = require('./lib/branch');

branch.currentBranch();
branch.checkout(branchName);
branch.commit(agentId, message);

lib/vaf.js

Validate inputs.

const vaf = require('./lib/vaf');

// Validation
vaf.validate(input);                    // Throws on invalid
vaf.check(input, {type: 'string', maxLength: 50000}); // Check with rules

// Different types
vaf.check(input, {type: 'path'});              // File path - blocks traversal
vaf.check(content, {type: 'string', skipDangerous: true}); // Skip content check (for memory)
vaf.checkPathTraversal('../etc/passwd'); // Check path traversal
vaf.checkContent('<script>');            // Check for injection
vaf.checkFileExtension('file.exe');      // Check dangerous extensions

// Rate limiting
vaf.checkRateLimit(ip);                  // Check if IP is rate limited
vaf.isBlocked(ip);                       // Check if IP is blocked
vaf.recordFailedAttempt(ip);             // Record failed attempt
vaf.getStatus();                         // Get VAF status

// Sanitization
vaf.sanitize(input);                     // Remove dangerous content

// Middleware
vaf.middleware(req, res, next);          // Express middleware

// Admin
vaf.reset();                             // Reset all limits

lib/health.js

Health checks.

const health = require('./lib/health');

await health.run();        // Run all checks
const status = await health.check(); // Get status

lib/logger.js

Logging.

const logger = require('./lib/logger');

logger.info('message');
logger.warn('warning');
logger.error('error');

lib/version.js

Version management.

const version = require('./lib/version');

version.get();    // Get current version
version.bump('patch'); // Bump version

lib/succession.js

Version tracking and brain inheritance.

const succession = require('./lib/succession');

await succession.get();     // Get current version
await succession.trust();   // Mark trusted
await succession.diff();    // Compare to previous

lib/protection.js

Protect sensitive data.

const protection = require('./lib/protection');

// Circuit breaker
protection.enable();   // Enable circuit breaker
protection.disable(); // Disable
protection.trigger();  // Trigger protection mode
protection.getStatus(); // Get protection status

// Active request tracking
protection.incrementActive();  // Track new request
protection.decrementActive();  // Release request
protection.getActiveCount();   // Get active count
protection.canProceed();       // Check if can accept more

// Input size limits
protection.getMaxInputSize();    // Get max size
protection.checkInputSize(data); // Check size

// Failure tracking
protection.recordFailure(ip);      // Record failure
protection.getFailureCount(ip);   // Get failure count
protection.isCircuitOpen();       // Check if circuit open
protection.getCircuitStatus();    // Get full status
protection.resetCircuit();         // Reset circuit

lib/rate-limit.js

Rate limiting.

const rateLimit = require('./lib/rate-limit');

await rateLimit.check();    // Check remaining
await rateLimit.wait();    // Wait if needed
rateLimit.getResetTime();  // Get reset time

lib/auto-update.js

Auto-save on exit.

const autoUpdate = require('./lib/auto-update');

autoUpdate.enable();    // Enable auto-save
autoUpdate.disable();  // Disable
autoUpdate.trigger();  // Trigger save

lib/onboard.js

Onboard new agents to your brain.

const onboard = require('./lib/onboard');

await onboard.query('question');
await onboard.list();    // List available

lib/errors.js

Error codes and troubleshooting.

const errors = require('./lib/errors');

errors.handle(error, 'context');  // Handle error with context

// Wrapping helpers
errors.configError('message');       // Wrap config error
errors.githubError('message', 404); // Wrap GitHub error
errors.networkError('message');   // Wrap network error

// Retry
await errors.retry(fn, 3, 1000);   // Retry with backoff

// Get error info
errors.get(code);                 // Get error by code
errors.format(error);             // Format error message

lib/load.js

Load brain files.

const load = require('./lib/load');

await load.files();      // Load all files
await load.file(path);  // Load single file

lib/colors.js

Terminal colors.

const colors = require('./lib/colors');

// Primary colors
colors.error('message');    // Red
colors.warning('message');  // Yellow
colors.success('message');  // Green
colors.info('message');     // Blue
colors.primary('message');  // Cyan

// Styling
colors.bold('message');
colors.dim('message');
colors.inverse('message');

// Brand
colors.vant;           // Bold cyan VANT
colors.vantHeader;     // [VANT] header

// Sections
colors.section('title');

lib/progress.js

Progress bars.

const progress = require('./lib/progress');

progress.start(total);
progress.update(current);
progress.complete();

lib/prompts.js

Interactive prompts.

const prompts = require('./lib/prompts');

// Interactive prompts
const confirmed = await prompts.confirm('Continue?');
const name = await prompts.input('Your name');
const password = await prompts.password('Password');
const choice = await prompts.select('Choose:', ['a', 'b', 'c']);
const choices = await prompts.checkbox('Select:', ['a', 'b', 'c']);

lib/verbosity.js

Configure verbosity.

const verbosity = require('./lib/verbosity');

// Get verbosity level
verbosity.get();           // Get all levels
verbosity.get('content');   // Get specific: log, response, content, comment, code
verbosity.isVerbose('content'); // Check if verbose

// Set verbosity
verbosity.set('content', 'extended');
verbosity.set({ content: 'extended', response: 'terse' });

// Adjust
verbosity.increase('log');
verbosity.decrease('log');

// Output helpers
verbosity.log('message');        // Respects log= setting
verbosity.response('message');    // Respects response= setting
verbosity.content('message');     // Respects content= setting

lib/stego.js

Steganography.

const stego = require('./lib/stego');

stego.encode(message, image);
stego.decode(image);

lib/notifications.js

Send notifications.

const notifications = require('./lib/notifications');

notifications.send('title', 'message');
notifications.list();

lib/metrics.js

Track metrics.

const metrics = require('./lib/metrics');

metrics.increment('vant.sync.success');
metrics.gauge('vant.memory.usage', 256);
metrics.timing('vant.sync.duration', 1234);

lib/resolution.js

How Vant handles brain conflicts and resolution.

const resolution = require('./lib/resolution');

resolution.getStatus('fears', 'fear of X');
resolution.resolve('fears', 'fear of X', 'resolved', 'therapy');
resolution.deprecate('goals', 'old goal', 'new goal');
resolution.reject('identity', 'old belief', 'ethics changed');
resolution.getLedger();

lib/telegram.js

Telegram bot.

const telegram = require('./lib/telegram');

telegram.onCommand('status', async (msg) => {
    await telegram.send(msg.chat, 'VANT is running');
});
telegram.onMessage(async (msg) => {
    console.log('Received:', msg.text);
});
await telegram.startPolling();

lib/update-check.js

Check for updates.

const updateCheck = require('./lib/update-check');

const hasUpdate = await updateCheck.checkForUpdate();
const latest = await updateCheck.getLatestVersion();
await updateCheck.notifyIfUpdate();