@agent-relay/utils 0.1.0

package/dist/logger.js

@@ -0,0 +1,84 @@
+/**
+ * Lightweight DIY Logger for Agent Relay
+ *
+ * Minimal logging utility (~50 lines) with:
+ * - JSON output for easy parsing with jq
+ * - Configurable via environment variables
+ * - Debug-only verbose logging
+ * - No external dependencies
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// Configuration from environment
+const LOG_FILE = process.env.AGENT_RELAY_LOG_FILE;
+const LOG_LEVEL = (process.env.AGENT_RELAY_LOG_LEVEL ?? 'INFO').toUpperCase();
+const LOG_JSON = process.env.AGENT_RELAY_LOG_JSON === '1';
+const _DEBUG = process.env.DEBUG === '1' || LOG_LEVEL === 'DEBUG';
+const LEVEL_PRIORITY = {
+    DEBUG: 0,
+    INFO: 1,
+    WARN: 2,
+    ERROR: 3,
+};
+// Ensure log directory exists if file logging enabled
+if (LOG_FILE) {
+    const logDir = path.dirname(LOG_FILE);
+    if (!fs.existsSync(logDir)) {
+        fs.mkdirSync(logDir, { recursive: true });
+    }
+}
+function shouldLog(level) {
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[LOG_LEVEL];
+}
+function formatMessage(entry) {
+    if (LOG_JSON) {
+        return JSON.stringify(entry);
+    }
+    const { ts, level, component, msg, ...extra } = entry;
+    const extraStr = Object.keys(extra).length > 0
+        ? ' ' + Object.entries(extra).map(([k, v]) => `${k}=${v}`).join(' ')
+        : '';
+    return `${ts} [${level}] [${component}] ${msg}${extraStr}`;
+}
+function log(level, component, msg, extra) {
+    if (!shouldLog(level))
+        return;
+    const entry = {
+        ts: new Date().toISOString(),
+        level,
+        component,
+        msg,
+        ...extra,
+    };
+    const formatted = formatMessage(entry);
+    // Write to file if configured
+    if (LOG_FILE) {
+        fs.appendFileSync(LOG_FILE, formatted + '\n');
+    }
+    // Write to console (stderr for WARN/ERROR)
+    if (level === 'ERROR' || level === 'WARN') {
+        console.error(formatted);
+    }
+    else {
+        console.log(formatted);
+    }
+}
+/**
+ * Create a logger for a specific component.
+ * @param component - Component name (e.g., 'daemon', 'router', 'connection')
+ */
+export function createLogger(component) {
+    return {
+        debug: (msg, extra) => log('DEBUG', component, msg, extra),
+        info: (msg, extra) => log('INFO', component, msg, extra),
+        warn: (msg, extra) => log('WARN', component, msg, extra),
+        error: (msg, extra) => log('ERROR', component, msg, extra),
+    };
+}
+// Pre-created loggers for common components
+export const daemonLog = createLogger('daemon');
+export const routerLog = createLogger('router');
+export const connectionLog = createLogger('connection');
+// Default export for simple usage
+export default createLogger;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/model-mapping.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Model Mapping
+ *
+ * Maps agent profile model identifiers to CLI variants.
+ * Used for cost tracking and model selection when spawning agents.
+ */
+/**
+ * Convert a model identifier into the CLI command variant.
+ * Defaults to 'claude:sonnet' when no match is found.
+ *
+ * @param model - Model identifier from agent profile (e.g., 'claude-opus-4', 'sonnet')
+ * @returns CLI command variant (e.g., 'claude:opus', 'claude:sonnet')
+ *
+ * @example
+ * mapModelToCli('claude-opus-4')     // Returns 'claude:opus'
+ * mapModelToCli('sonnet')            // Returns 'claude:sonnet'
+ * mapModelToCli('gpt-4o')            // Returns 'codex'
+ * mapModelToCli(undefined)           // Returns 'claude:sonnet'
+ */
+export declare function mapModelToCli(model?: string): string;
+/**
+ * Extract the base CLI name from a model-mapped CLI variant.
+ *
+ * @param cliVariant - CLI variant (e.g., 'claude:opus', 'claude', 'codex')
+ * @returns Base CLI name (e.g., 'claude', 'codex')
+ */
+export declare function getBaseCli(cliVariant: string): string;
+//# sourceMappingURL=model-mapping.d.ts.map

package/dist/model-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-mapping.d.ts","sourceRoot":"","sources":["../src/model-mapping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/model-mapping.js

@@ -0,0 +1,55 @@
+/**
+ * Model Mapping
+ *
+ * Maps agent profile model identifiers to CLI variants.
+ * Used for cost tracking and model selection when spawning agents.
+ */
+/**
+ * Mapping from model identifiers to CLI command variants.
+ * Keys are normalized model names, values are CLI command variants.
+ */
+const MODEL_TO_CLI = {
+    // Claude models
+    'claude-sonnet-4': 'claude:sonnet',
+    'claude-opus-4': 'claude:opus',
+    'claude-opus-4.5': 'claude:opus',
+    'sonnet': 'claude:sonnet',
+    'opus': 'claude:opus',
+    'haiku': 'claude:haiku',
+    // Codex (OpenAI)
+    'codex': 'codex',
+    'gpt-4o': 'codex',
+    // Gemini (Google)
+    'gemini': 'gemini',
+    'gemini-2.0-flash': 'gemini',
+};
+/**
+ * Convert a model identifier into the CLI command variant.
+ * Defaults to 'claude:sonnet' when no match is found.
+ *
+ * @param model - Model identifier from agent profile (e.g., 'claude-opus-4', 'sonnet')
+ * @returns CLI command variant (e.g., 'claude:opus', 'claude:sonnet')
+ *
+ * @example
+ * mapModelToCli('claude-opus-4')     // Returns 'claude:opus'
+ * mapModelToCli('sonnet')            // Returns 'claude:sonnet'
+ * mapModelToCli('gpt-4o')            // Returns 'codex'
+ * mapModelToCli(undefined)           // Returns 'claude:sonnet'
+ */
+export function mapModelToCli(model) {
+    if (!model) {
+        return 'claude:sonnet';
+    }
+    const normalized = model.trim().toLowerCase();
+    return MODEL_TO_CLI[normalized] ?? 'claude:sonnet';
+}
+/**
+ * Extract the base CLI name from a model-mapped CLI variant.
+ *
+ * @param cliVariant - CLI variant (e.g., 'claude:opus', 'claude', 'codex')
+ * @returns Base CLI name (e.g., 'claude', 'codex')
+ */
+export function getBaseCli(cliVariant) {
+    return cliVariant.split(':')[0];
+}
+//# sourceMappingURL=model-mapping.js.map

package/dist/model-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-mapping.js","sourceRoot":"","sources":["../src/model-mapping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,YAAY,GAA2B;IAC3C,gBAAgB;IAChB,iBAAiB,EAAE,eAAe;IAClC,eAAe,EAAE,aAAa;IAC9B,iBAAiB,EAAE,aAAa;IAChC,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,cAAc;IACvB,iBAAiB;IACjB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,OAAO;IACjB,kBAAkB;IAClB,QAAQ,EAAE,QAAQ;IAClB,kBAAkB,EAAE,QAAQ;CAC7B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,eAAe,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/name-generator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Auto-generate memorable agent names using adjective+noun combinations.
+ * Inspired by mcp_agent_mail's approach.
+ */
+/**
+ * Generate a random agent name (AdjectiveNoun format).
+ */
+export declare function generateAgentName(): string;
+/**
+ * Generate a unique agent name, checking against existing names.
+ */
+export declare function generateUniqueAgentName(existingNames: Set<string>, maxAttempts?: number): string;
+/**
+ * Validate an agent name (must be alphanumeric, 2-32 chars).
+ */
+export declare function isValidAgentName(name: string): boolean;
+//# sourceMappingURL=name-generator.d.ts.map

package/dist/name-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-generator.d.ts","sourceRoot":"","sources":["../src/name-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,SAAM,GAAG,MAAM,CAS7F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/name-generator.js

@@ -0,0 +1,52 @@
+/**
+ * Auto-generate memorable agent names using adjective+noun combinations.
+ * Inspired by mcp_agent_mail's approach.
+ */
+const ADJECTIVES = [
+    'Blue', 'Green', 'Red', 'Purple', 'Golden', 'Silver', 'Crystal', 'Amber',
+    'Coral', 'Jade', 'Ruby', 'Sapphire', 'Emerald', 'Onyx', 'Pearl', 'Copper',
+    'Bronze', 'Iron', 'Steel', 'Velvet', 'Silk', 'Cotton', 'Linen', 'Marble',
+    'Granite', 'Cobalt', 'Crimson', 'Azure', 'Indigo', 'Scarlet', 'Violet',
+    'Olive', 'Teal', 'Cyan', 'Magenta', 'Ochre', 'Rustic', 'Misty', 'Stormy',
+    'Sunny', 'Frosty', 'Dusty', 'Mossy', 'Rocky', 'Sandy', 'Snowy', 'Windy',
+    'Swift', 'Calm', 'Bold', 'Brave', 'Clever', 'Eager', 'Gentle', 'Happy',
+    'Jolly', 'Kind', 'Lively', 'Merry', 'Noble', 'Proud', 'Quick', 'Quiet',
+];
+const NOUNS = [
+    'Mountain', 'River', 'Forest', 'Ocean', 'Valley', 'Canyon', 'Desert', 'Island',
+    'Lake', 'Meadow', 'Prairie', 'Glacier', 'Volcano', 'Waterfall', 'Creek', 'Pond',
+    'Hill', 'Peak', 'Ridge', 'Cliff', 'Cave', 'Reef', 'Marsh', 'Grove',
+    'Fox', 'Wolf', 'Bear', 'Eagle', 'Hawk', 'Owl', 'Deer', 'Elk',
+    'Falcon', 'Raven', 'Swan', 'Crane', 'Heron', 'Otter', 'Beaver', 'Badger',
+    'Castle', 'Tower', 'Bridge', 'Harbor', 'Haven', 'Shelter', 'Beacon', 'Anchor',
+    'Stone', 'Pebble', 'Boulder', 'Crystal', 'Gem', 'Prism', 'Spark', 'Ember',
+    'Star', 'Moon', 'Sun', 'Comet', 'Cloud', 'Storm', 'Thunder', 'Lightning',
+];
+/**
+ * Generate a random agent name (AdjectiveNoun format).
+ */
+export function generateAgentName() {
+    const adjective = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+    const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+    return `${adjective}${noun}`;
+}
+/**
+ * Generate a unique agent name, checking against existing names.
+ */
+export function generateUniqueAgentName(existingNames, maxAttempts = 100) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const name = generateAgentName();
+        if (!existingNames.has(name)) {
+            return name;
+        }
+    }
+    // Fallback: append random suffix
+    return `${generateAgentName()}${Math.floor(Math.random() * 1000)}`;
+}
+/**
+ * Validate an agent name (must be alphanumeric, 2-32 chars).
+ */
+export function isValidAgentName(name) {
+    return /^[a-zA-Z][a-zA-Z0-9_-]{1,31}$/.test(name);
+}
+//# sourceMappingURL=name-generator.js.map

package/dist/name-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-generator.js","sourceRoot":"","sources":["../src/name-generator.ts"],"names":[],"mappings":"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"}

package/dist/precompiled-patterns.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Precompiled Pattern Matching
+ *
+ * Optimized regex patterns for high-performance message parsing.
+ * Inspired by russian-code-ts performance targets (<1ms for pattern matching).
+ *
+ * Strategies:
+ * 1. Precompile patterns at module load (not per-instance)
+ * 2. Combine multiple patterns into single regex where possible
+ * 3. Use non-capturing groups and atomic patterns
+ * 4. Cache compiled patterns by prefix
+ */
+export interface CompiledPatterns {
+    inline: RegExp;
+    fencedInline: RegExp;
+    escape: RegExp;
+}
+/**
+ * Get or create compiled patterns for a given prefix configuration.
+ * Patterns are cached for reuse across parser instances.
+ */
+export declare function getCompiledPatterns(prefix?: string, thinkingPrefix?: string): CompiledPatterns;
+/**
+ * Fast check if text matches any instructional pattern.
+ * Single regex test instead of array.some().
+ */
+export declare function isInstructionalTextFast(body: string): boolean;
+/**
+ * Fast placeholder target check using Set.
+ */
+export declare function isPlaceholderTargetFast(target: string): boolean;
+/**
+ * Strip ANSI escape codes from a string.
+ * Uses precompiled patterns for better performance.
+ */
+export declare function stripAnsiFast(str: string): string;
+/**
+ * Precompiled static patterns used across parsing operations.
+ */
+export declare const StaticPatterns: {
+    readonly BLOCK_END: RegExp;
+    readonly BLOCK_METADATA_END: RegExp;
+    readonly CODE_FENCE: RegExp;
+    readonly FENCE_END_START: RegExp;
+    readonly FENCE_END_LINE: RegExp;
+    readonly FENCE_END: RegExp;
+    readonly ESCAPED_FENCE_START: RegExp;
+    readonly ESCAPED_FENCE_END: RegExp;
+    readonly ESCAPED_FENCE_END_CHECK: RegExp;
+    readonly ESCAPED_FENCE_START_CHECK: RegExp;
+    readonly BULLET_OR_NUMBERED_LIST: RegExp;
+    readonly PROMPTISH_LINE: RegExp;
+    readonly RELAY_INJECTION_PREFIX: RegExp;
+    readonly SPAWN_COMMAND: RegExp;
+    readonly RELEASE_COMMAND: RegExp;
+    readonly THINKING_START: RegExp;
+    readonly THINKING_END: RegExp;
+    readonly AGENT_NAME: RegExp;
+    readonly CLI_PROMPTS: {
+        readonly claude: RegExp;
+        readonly gemini: RegExp;
+        readonly codex: RegExp;
+        readonly droid: RegExp;
+        readonly opencode: RegExp;
+        readonly spawned: RegExp;
+        readonly other: RegExp;
+    };
+};
+/**
+ * Check if line is a spawn or release command.
+ */
+export declare function isSpawnOrReleaseCommandFast(line: string): boolean;
+/**
+ * Check if a line contains an escaped fence end.
+ */
+export declare function isEscapedFenceEndFast(line: string): boolean;
+/**
+ * Unescape fence markers in content.
+ */
+export declare function unescapeFenceMarkersFast(content: string): string;
+interface PatternMetrics {
+    calls: number;
+    totalMs: number;
+    maxMs: number;
+}
+/**
+ * Track pattern matching performance (for debugging/profiling).
+ * Call with pattern name and execution time.
+ */
+export declare function trackPatternPerformance(name: string, ms: number): void;
+/**
+ * Get pattern performance metrics.
+ */
+export declare function getPatternMetrics(): Map<string, PatternMetrics & {
+    avgMs: number;
+}>;
+/**
+ * Reset pattern performance metrics.
+ */
+export declare function resetPatternMetrics(): void;
+/**
+ * Benchmark pattern matching performance.
+ * Useful for testing optimization impact.
+ */
+export declare function benchmarkPatterns(iterations?: number): Record<string, {
+    avgNs: number;
+    maxNs: number;
+}>;
+export {};
+//# sourceMappingURL=precompiled-patterns.d.ts.map

package/dist/precompiled-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precompiled-patterns.d.ts","sourceRoot":"","sources":["../src/precompiled-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,MAAmB,EAC3B,cAAc,GAAE,MAAsB,GACrC,gBAAgB,CAsClB;AAsCD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAoBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/D;AAkBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CjB,CAAC;AAMX;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOhE;AAMD,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAStE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CASnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,GAAE,MAAc,GACzB,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA0ElD"}