@daniel.stefan/metalink 1.3.1

package/packages/core/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAE9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEjD"}

package/packages/core/dist/config/schema.js

@@ -0,0 +1,267 @@
+import { z } from 'zod';
+/**
+ * Health check configuration schema - common to both stdio and HTTP servers
+ */
+export const HealthCheckSchema = z.object({
+    enabled: z.boolean().optional().default(true),
+    interval: z.number().int().positive().optional().default(30000), // 30 seconds
+    timeout: z.number().int().positive().optional().default(5000), // 5 seconds
+});
+/**
+ * Authentication schema for HTTP servers
+ */
+export const HttpAuthSchema = z.object({
+    type: z.enum(['bearer', 'oauth2', 'api-key']).optional().default('bearer'),
+    token: z.string().optional(), // Can use ${secret:token_name} syntax
+    headerName: z.string().optional().default('Authorization'),
+    clientId: z.string().optional(), // For OAuth2
+    clientSecret: z.string().optional(), // For OAuth2
+}).optional();
+/**
+ * Session management schema for HTTP servers
+ */
+export const HttpSessionSchema = z.object({
+    enabled: z.boolean().optional().default(true),
+    headerName: z.string().optional().default('Mcp-Session-Id'),
+    allowClientTermination: z.boolean().optional().default(false),
+}).optional();
+/**
+ * CORS schema for HTTP servers
+ */
+export const HttpCorsSchema = z.object({
+    enabled: z.boolean().optional().default(false),
+    allowOrigin: z.string().optional().default('*'),
+}).optional();
+export const ServerSafetySchema = z.enum(['safe', 'risky', 'default']).optional()
+    .describe('Server-level safety: "safe" = all tools safe, "risky" = all tools risky, "default" = use tool-level classification (default)');
+/**
+ * Stdio (command-based) server configuration
+ */
+export const StdioServerConfigSchema = z.object({
+    name: z.string().min(1, 'Server name is required'),
+    transport: z.literal('stdio').optional().default('stdio'),
+    command: z.string().min(1, 'Command is required for stdio servers'),
+    args: z.array(z.string()).optional().default([]),
+    env: z.record(z.string()).optional().default({}),
+    cwd: z.string().optional()
+        .describe('Working directory for the server process (default: daemon working directory). Use ~ for home directory.'),
+    healthCheck: HealthCheckSchema.optional().default({}),
+    // v1.3.x: Server-level safety classification (optional, defaults to 'default')
+    safety: ServerSafetySchema,
+});
+/**
+ * HTTP (remote) server configuration
+ */
+export const HttpServerConfigSchema = z.object({
+    name: z.string().min(1, 'Server name is required'),
+    transport: z.enum(['http', 'sse', 'sse-first', 'http-stream']),
+    url: z.string().url('URL must be a valid HTTP(S) endpoint'),
+    auth: HttpAuthSchema,
+    session: HttpSessionSchema,
+    cors: HttpCorsSchema,
+    env: z.record(z.string()).optional().default({}), // For additional environment context
+    healthCheck: HealthCheckSchema.optional().default({}),
+    // v1.3.x: Server-level safety classification
+    safety: ServerSafetySchema,
+    // P1: Timeout configuration
+    requestTimeoutMs: z.number().int().positive().optional()
+        .default(30000)
+        .describe('Per-request timeout in milliseconds (default 30s)'),
+    streamTimeoutMs: z.number().int().positive().optional()
+        .default(120000)
+        .describe('SSE/HTTP-stream response timeout in milliseconds (default 2min)'),
+    connectTimeoutMs: z.number().int().positive().optional()
+        .default(10000)
+        .describe('Connection initialization timeout in milliseconds (default 10s)'),
+});
+/**
+ * Server configuration schema - supports both stdio and HTTP transports
+ * Uses discriminated union to enforce correct fields per transport type
+ */
+export const ServerConfigSchema = z.discriminatedUnion('transport', [
+    StdioServerConfigSchema,
+    HttpServerConfigSchema,
+]);
+/**
+ * Daemon configuration schema
+ * Defines HTTP server, authentication, rate limiting settings
+ */
+export const DaemonConfigSchema = z.object({
+    port: z.number().int().min(1).max(65535).optional().default(3000),
+    host: z.string().optional().default('0.0.0.0'),
+    logLevel: z.enum(['debug', 'info', 'warn', 'error']).optional().default('info'),
+    auth: z.object({
+        enabled: z.boolean().optional().default(false),
+        type: z.enum(['bearer', 'api-key']).optional().default('bearer'),
+        secret: z.string().optional(), // ${secret:auth_secret}
+    }).optional().default({}),
+    rateLimit: z.object({
+        enabled: z.boolean().optional().default(true),
+        windowMs: z.number().int().positive().optional().default(60000), // 1 minute
+        max: z.number().int().positive().optional().default(500), // 500 requests per minute
+        keyGenerator: z.enum(['ip', 'user']).optional().default('ip'),
+    }).optional().default({}),
+});
+/**
+ * Plugin configuration schema
+ * Allows extending functionality via before/after hooks
+ */
+export const PluginConfigSchema = z.object({
+    name: z.string().min(1),
+    enabled: z.boolean().optional().default(true),
+    path: z.string().optional(), // Path to plugin module
+    config: z.record(z.unknown()).optional().default({}),
+});
+/**
+ * Profile configuration schema
+ * Supports multi-environment configurations (dev, prod, staging)
+ */
+export const ProfileConfigSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    daemon: DaemonConfigSchema.optional(),
+    servers: z.array(ServerConfigSchema).optional().default([]),
+    environment: z.record(z.string()).optional().default({}),
+});
+/**
+ * Root configuration schema
+ * Complete metalink.config.yaml/json structure
+ */
+export const MetalinkConfigSchema = z.object({
+    version: z.string().optional().default('1.0.0'),
+    description: z.string().optional(),
+    daemon: DaemonConfigSchema.optional(),
+    servers: z.array(ServerConfigSchema).optional().default([]),
+    plugins: z.array(PluginConfigSchema).optional().default([]),
+    profiles: z.array(ProfileConfigSchema).optional().default([]),
+    // Global environment variables (interpolated in server env)
+    environment: z.record(z.string()).optional().default({}),
+    // Secrets configuration
+    secrets: z.object({
+        provider: z.enum(['env', 'keyring', 'vault']).optional().default('env'),
+        keyringService: z.string().optional().default('metalink'),
+    }).optional().default({}),
+    // Schema caching configuration (in milliseconds)
+    schemasCacheTTL: z.number().int().positive().optional().default(300000), // 5 minutes default
+    // Schema cache directory path (v1.3.62: global cache across versions)
+    schemasCachePath: z.string().optional().default('~/.config/metalink/schemas'),
+    // Maximum number of schemas to keep in memory (LRU eviction)
+    maxSchemaCacheEntries: z.number().int().positive().optional().default(100),
+    // Enable background refresh of schemas
+    schemasBackgroundRefresh: z.boolean().optional().default(true),
+    // Enable background population of missing schemas (v1.3.62)
+    backgroundSchemaPopulation: z.boolean().optional().default(false),
+    // Base servers to auto-start on daemon init (always available and instant)
+    // If not specified, no servers are auto-started
+    base_servers: z.array(z.string()).optional(),
+    // Auto-start base servers on daemon init (default: true)
+    // When true: base servers start immediately for instant availability
+    // When false: base servers behave like regular servers (on-demand start)
+    base_servers_auto_start: z.boolean().optional().default(true),
+    // Expose base server tools in tools/list (default: false for token optimization)
+    // When false: base servers pre-started but tools hidden (optimal tokens + instant availability)
+    // When true: base server tools exposed in tools/list (legacy behavior)
+    base_servers_auto_expose_tools: z.boolean().optional().default(false),
+    // Tool safety classification rules for execute_tool vs execute_tool_confirm
+    toolSafetyRules: z.object({
+        // Regex patterns for safe operations (read-only)
+        safePatterns: z.array(z.string()).optional(),
+        // Regex patterns for risky operations (write/destructive)
+        riskyPatterns: z.array(z.string()).optional(),
+        // Explicit safe tool overrides (server:tool format, supports wildcards)
+        safeToolOverrides: z.array(z.string()).optional(),
+        // Explicit risky tool overrides (server:tool format, supports wildcards)
+        riskyToolOverrides: z.array(z.string()).optional(),
+        // v1.1.29: Argument-level inspection for command-based tools
+        argumentInspectionRules: z.array(z.object({
+            // Tool identifier (e.g., "ssh:runRemoteCommand")
+            tool: z.string(),
+            // Which argument field to inspect (e.g., "command")
+            argumentField: z.string(),
+            // Safe command patterns (regex applied to argument value)
+            safeCommandPatterns: z.array(z.string()).optional(),
+            // Risky command patterns (regex applied to argument value)
+            riskyCommandPatterns: z.array(z.string()).optional(),
+            // Whitelist mode: if true, only safeCommandPatterns are allowed
+            whitelistMode: z.boolean().optional().default(false),
+            // v1.1.55: Optional field mode - if field is missing, skip inspection (return null)
+            // Use for tools with multiple modes (e.g., metabase:execute with SQL or card_id)
+            optionalField: z.boolean().optional().default(false),
+        })).optional(),
+    }).optional(),
+    // Discovery TTL (v1.4.0): Time in milliseconds before discovered tools expire
+    // Default: 600000 (10 minutes). Set to 0 to disable expiration.
+    // Discovered tools are removed from tools/list after TTL of inactivity.
+    // Tool calls reset the timer (activity refresh pattern).
+    discoveryTTL: z.number().optional(),
+    // Dynamic tool exposure (v1.3.51 - Speakeasy optimization):
+    // false (default): Only expose 4 meta-tools (search_tools, describe_tool, execute_tool, execute_tool_confirm)
+    //                  Reduces token usage to ~280 tokens (fixed, regardless of server count)
+    // true: Expose all discovered tools dynamically in tools/list (original behavior)
+    //       Token usage scales with discovery: 280 + (N servers × M tools × 70 tokens)
+    dynamicToolExposure: z.boolean().optional().default(false),
+    // Timeout configuration (in milliseconds)
+    timeouts: z.object({
+        // Server initialization timeout - time to wait for server to start and respond
+        serverInit: z.number().int().positive().optional().default(10000), // 10s
+        // Tool fetch timeout - time to wait for server to return tools/list
+        toolFetch: z.number().int().positive().optional().default(60000), // 60s
+        // Tool execution timeout - time to wait for tool execution to complete
+        toolExecution: z.number().int().positive().optional().default(300000), // 5min
+        // Graceful shutdown timeout - time to wait for server to shutdown gracefully before SIGKILL
+        gracefulShutdown: z.number().int().positive().optional().default(5000), // 5s
+    }).optional().default({}),
+    // Circuit breaker configuration for preventing cascade failures
+    circuitBreaker: z.object({
+        // Number of consecutive failures before opening circuit
+        failureThreshold: z.number().int().positive().optional().default(3),
+        // Time in milliseconds before attempting to close circuit after opening
+        resetTimeout: z.number().int().positive().optional().default(30000), // 30s
+        // Number of consecutive successes in HALF_OPEN state to close circuit
+        halfOpenSuccessThreshold: z.number().int().positive().optional().default(1),
+    }).optional().default({}),
+    // Auto-restart configuration for failed servers
+    autoRestart: z.object({
+        // Enable auto-restart for failed servers
+        enabled: z.boolean().optional().default(true),
+        // Maximum number of restart attempts before giving up
+        maxRetries: z.number().int().nonnegative().optional().default(3),
+        // Base delay in milliseconds for exponential backoff (first retry)
+        baseDelay: z.number().int().positive().optional().default(5000), // 5s
+        // Maximum delay in milliseconds between restart attempts
+        maxDelay: z.number().int().positive().optional().default(300000), // 5 minutes
+        // Multiplier for exponential backoff (delay = baseDelay * multiplier^attempt)
+        backoffMultiplier: z.number().positive().optional().default(2),
+    }).optional().default({}),
+});
+/**
+ * Export all schemas for use in loader
+ */
+export const ConfigSchemas = {
+    ServerConfig: ServerConfigSchema,
+    StdioServerConfig: StdioServerConfigSchema,
+    HttpServerConfig: HttpServerConfigSchema,
+    HealthCheck: HealthCheckSchema,
+    HttpAuth: HttpAuthSchema,
+    HttpSession: HttpSessionSchema,
+    HttpCors: HttpCorsSchema,
+    DaemonConfig: DaemonConfigSchema,
+    PluginConfig: PluginConfigSchema,
+    ProfileConfig: ProfileConfigSchema,
+    MetalinkConfig: MetalinkConfigSchema,
+};
+/**
+ * Validates configuration against schema
+ * Returns parsed config or throws ZodError
+ */
+export function validateConfig(config) {
+    return MetalinkConfigSchema.parse(config);
+}
+/**
+ * Safely validates configuration without throwing
+ * Returns { success: true, data } or { success: false, errors }
+ */
+export function validateConfigSafe(config) {
+    return MetalinkConfigSchema.safeParse(config);
+}
+//# sourceMappingURL=schema.js.map

package/packages/core/dist/config/schema.js.map

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

package/packages/core/dist/daemon.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * MetaLink Daemon
+ * Main entry point for the HTTP server
+ */
+export {};
+//# sourceMappingURL=daemon.d.ts.map

package/packages/core/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/packages/core/dist/daemon.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * MetaLink Daemon
+ * Main entry point for the HTTP server
+ */
+import { config as dotenvConfig } from 'dotenv';
+import path from 'path';
+import { initializeConfigSync, HttpServer, getConfigLoader } from './index.js';
+async function main() {
+    try {
+        console.log('[MetaLink] Starting daemon...');
+        // Load environment variables from ~/.config/metalink/.env
+        // This allows credentials to be stored separately from mcp-registry.json
+        const envPath = path.join(process.env.HOME || '~', '.config', 'metalink', '.env');
+        const envResult = dotenvConfig({ path: envPath });
+        if (envResult.parsed) {
+            console.log(`[MetaLink] Loaded ${Object.keys(envResult.parsed).length} env vars from ${envPath}`);
+        }
+        else if (envResult.error && envResult.error.code !== 'ENOENT') {
+            console.warn(`[MetaLink] Warning: Could not load .env file: ${envResult.error.message}`);
+        }
+        // Note: ENOENT (file not found) is silently ignored - .env is optional
+        console.log(`[MetaLink] Working directory: ${process.cwd()}`);
+        console.log(`[MetaLink] HOME: ${process.env.HOME}`);
+        console.log(`[MetaLink] METALINK_CONFIG: ${process.env.METALINK_CONFIG || 'not set'}`);
+        // Load configuration
+        initializeConfigSync(process.env.METALINK_CONFIG);
+        const configLoader = getConfigLoader();
+        console.log(`[MetaLink] Configuration loaded successfully`);
+        console.log(`[MetaLink] Registry path: ${configLoader['getRegistryPath']?.() || 'unknown'}`);
+        // Get daemon settings (check METALINK_PORT first, then PORT for backward compat)
+        const daemonConfig = configLoader.getDaemon();
+        const port = process.env.METALINK_PORT
+            ? parseInt(process.env.METALINK_PORT, 10)
+            : (process.env.PORT
+                ? parseInt(process.env.PORT, 10)
+                : daemonConfig.port || 3000);
+        const host = process.env.HOST || daemonConfig.host || '0.0.0.0';
+        const branch = process.env.BRANCH || 'unknown';
+        const logLevel = daemonConfig.logLevel || 'info';
+        // Warn about deprecated PORT variable
+        if (process.env.PORT && !process.env.METALINK_PORT) {
+            console.warn('⚠️  PORT environment variable is deprecated, use METALINK_PORT instead');
+        }
+        // Port validation
+        if (port < 1024 || port > 65535) {
+            throw new Error(`[MetaLink] Invalid METALINK_PORT: ${port}. Must be 1024-65535.`);
+        }
+        // Conventional port validation (warning only, not enforced)
+        const CONVENTIONAL_PORTS = {
+            production: 6655,
+            staging: 6656
+        };
+        if (CONVENTIONAL_PORTS[branch] && port !== CONVENTIONAL_PORTS[branch]) {
+            console.warn(`⚠️  BRANCH=${branch} conventionally uses port ${CONVENTIONAL_PORTS[branch]}, but METALINK_PORT=${port}`);
+        }
+        // Log startup context
+        console.log(`[MetaLink] Starting daemon on port ${port} (BRANCH: ${branch})`);
+        // Set log level
+        if (logLevel === 'debug') {
+            console.log('[MetaLink] Debug mode enabled');
+        }
+        // Create and start HTTP server
+        console.log('[MetaLink] Creating HTTP server...');
+        const httpServer = new HttpServer(configLoader);
+        console.log('[MetaLink] HTTP server created successfully');
+        // Register signal handlers BEFORE starting server
+        // This ensures they're active when daemon starts in background mode
+        process.on('SIGINT', async () => {
+            console.log('\n[MetaLink] Shutting down gracefully...');
+            await httpServer.cleanup();
+            process.exit(0);
+        });
+        process.on('SIGTERM', async () => {
+            console.log('[MetaLink] Received SIGTERM, shutting down...');
+            await httpServer.cleanup();
+            process.exit(0);
+        });
+        // Start HTTP server FIRST so validation can connect immediately
+        console.log(`[MetaLink] Starting HTTP server on ${host}:${port}...`);
+        await httpServer.listen(port, host);
+        // Initialize base servers in background (non-blocking for faster startup)
+        const baseServersAutoStart = configLoader.getConfig().base_servers_auto_start ?? true;
+        if (baseServersAutoStart) {
+            console.log('[MetaLink] Initializing base servers in background...');
+            // Don't await - let base servers initialize while HTTP server is already listening
+            httpServer.getServerManager().initializeBaseServers(configLoader)
+                .then(() => {
+                console.log('[MetaLink] Base servers initialized successfully');
+            })
+                .catch((error) => {
+                console.error('[MetaLink] Error initializing base servers:', error);
+                // Base servers are not critical for HTTP server operation
+            });
+        }
+        else {
+            console.log('[MetaLink] Base servers auto-start disabled (base_servers_auto_start: false)');
+        }
+        console.log(`[MetaLink] Daemon started successfully on ${host}:${port}`);
+        // Background schema population (v1.3.62) - runs AFTER daemon is fully started
+        const backgroundSchemaPopulation = configLoader.getConfig().backgroundSchemaPopulation ?? false;
+        if (backgroundSchemaPopulation) {
+            console.log('[MetaLink] Background schema population enabled, starting...');
+            // Run in background without blocking
+            httpServer.getServerManager().populateMissingSchemas(configLoader)
+                .then(() => console.log('[MetaLink] Background schema population complete'))
+                .catch(error => console.error('[MetaLink] Background schema population failed:', error));
+        }
+    }
+    catch (error) {
+        console.error('[MetaLink] Fatal error:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=daemon.js.map

package/packages/core/dist/daemon.js.map

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

package/packages/core/dist/http-client-retry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Retry Logic for HttpClient
+ *
+ * Provides exponential backoff retry mechanism for transient HTTP failures.
+ * This code is meant to be integrated into http-client.ts
+ */
+/**
+ * HTTP status codes that indicate retryable errors
+ */
+declare const RETRYABLE_STATUS_CODES: Set<number>;
+/**
+ * HTTP status codes that should never be retried
+ */
+declare const NON_RETRYABLE_STATUS_CODES: Set<number>;
+/**
+ * Network error patterns that are retryable
+ */
+declare const RETRYABLE_ERROR_PATTERNS: string[];
+/**
+ * Retry configuration
+ */
+interface RetryConfig {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    jitterMs: number;
+}
+/**
+ * Error type with optional status code
+ */
+interface HttpError extends Error {
+    statusCode?: number;
+    isRetryable?: boolean;
+}
+/**
+ * Check if an error or response is retryable
+ *
+ * @param error - Error object or Response
+ * @returns true if the error should be retried
+ */
+declare function isRetryable(error: Error | Response | HttpError): boolean;
+/**
+ * Calculate exponential backoff delay with jitter
+ * Formula: min(baseDelay * 2^attempt + random(0, jitter), maxDelay)
+ *
+ * @param attempt - Retry attempt number (0-based)
+ * @param config - Retry configuration
+ * @returns Delay in milliseconds
+ */
+declare function calculateBackoffDelay(attempt: number, config: RetryConfig): number;
+/**
+ * Sleep for specified duration
+ * @param ms - Milliseconds to sleep
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Execute fetch with exponential backoff retry
+ *
+ * @param url - URL to fetch
+ * @param options - Fetch options
+ * @param retryConfig - Retry configuration
+ * @returns Response object
+ * @throws Error if all retries exhausted
+ */
+declare function fetchWithRetry(url: string, options: RequestInit, retryConfig?: RetryConfig): Promise<Response>;
+export { fetchWithRetry, isRetryable, calculateBackoffDelay, sleep, RETRYABLE_STATUS_CODES, NON_RETRYABLE_STATUS_CODES, RETRYABLE_ERROR_PATTERNS, type RetryConfig, type HttpError, };
+//# sourceMappingURL=http-client-retry.d.ts.map

package/packages/core/dist/http-client-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client-retry.d.ts","sourceRoot":"","sources":["../src/http-client-retry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,QAAA,MAAM,sBAAsB,aAA2B,CAAC;AAExD;;GAEG;AACH,QAAA,MAAM,0BAA0B,aAAgC,CAAC;AAEjE;;GAEG;AACH,QAAA,MAAM,wBAAwB,UAO7B,CAAC;AAEF;;GAEG;AACH,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,SAAU,SAAQ,KAAK;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CA2BjE;AAED;;;;;;;GAOG;AACH,iBAAS,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAK3E;AAED;;;GAGG;AACH,iBAAS,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExC;AAED;;;;;;;;GAQG;AACH,iBAAe,cAAc,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,WAAW,GAAE,WAKZ,GACA,OAAO,CAAC,QAAQ,CAAC,CAkDnB;AAED,OAAO,EACL,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,KAAK,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,CAAC"}

package/packages/core/dist/http-client-retry.js

@@ -0,0 +1,133 @@
+/**
+ * Retry Logic for HttpClient
+ *
+ * Provides exponential backoff retry mechanism for transient HTTP failures.
+ * This code is meant to be integrated into http-client.ts
+ */
+/**
+ * HTTP status codes that indicate retryable errors
+ */
+const RETRYABLE_STATUS_CODES = new Set([502, 503, 504]);
+/**
+ * HTTP status codes that should never be retried
+ */
+const NON_RETRYABLE_STATUS_CODES = new Set([400, 401, 403, 404]);
+/**
+ * Network error patterns that are retryable
+ */
+const RETRYABLE_ERROR_PATTERNS = [
+    'ECONNREFUSED',
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'ERR_HTTP2_STREAM_RESET',
+];
+/**
+ * Check if an error or response is retryable
+ *
+ * @param error - Error object or Response
+ * @returns true if the error should be retried
+ */
+function isRetryable(error) {
+    // Handle Response objects (failed fetch)
+    if (error instanceof Response) {
+        if (NON_RETRYABLE_STATUS_CODES.has(error.status)) {
+            return false;
+        }
+        return RETRYABLE_STATUS_CODES.has(error.status);
+    }
+    // Handle Error objects
+    if (error instanceof Error) {
+        const message = error.message;
+        const httpError = error;
+        // Check if status code is set (from HTTP response)
+        if (httpError.statusCode) {
+            if (NON_RETRYABLE_STATUS_CODES.has(httpError.statusCode)) {
+                return false;
+            }
+            return RETRYABLE_STATUS_CODES.has(httpError.statusCode);
+        }
+        // Check for retryable network error patterns
+        return RETRYABLE_ERROR_PATTERNS.some(pattern => message.includes(pattern));
+    }
+    return false;
+}
+/**
+ * Calculate exponential backoff delay with jitter
+ * Formula: min(baseDelay * 2^attempt + random(0, jitter), maxDelay)
+ *
+ * @param attempt - Retry attempt number (0-based)
+ * @param config - Retry configuration
+ * @returns Delay in milliseconds
+ */
+function calculateBackoffDelay(attempt, config) {
+    const baseDelay = config.initialDelayMs * Math.pow(2, attempt);
+    const jitter = Math.random() * config.jitterMs;
+    const delayWithJitter = baseDelay + jitter;
+    return Math.min(delayWithJitter, config.maxDelayMs);
+}
+/**
+ * Sleep for specified duration
+ * @param ms - Milliseconds to sleep
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Execute fetch with exponential backoff retry
+ *
+ * @param url - URL to fetch
+ * @param options - Fetch options
+ * @param retryConfig - Retry configuration
+ * @returns Response object
+ * @throws Error if all retries exhausted
+ */
+async function fetchWithRetry(url, options, retryConfig = {
+    maxRetries: 3,
+    initialDelayMs: 100,
+    maxDelayMs: 30000,
+    jitterMs: 1000,
+}) {
+    let lastError = null;
+    for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {
+        try {
+            const response = await fetch(url, options);
+            // Success: return immediately
+            if (response.ok) {
+                return response;
+            }
+            // Non-retryable status code: throw immediately
+            if (!isRetryable(response)) {
+                const error = new Error(`HTTP ${response.status}: ${response.statusText}`);
+                error.statusCode = response.status;
+                throw error;
+            }
+            // Retryable status code - will retry below
+            lastError = response;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Non-retryable error: throw immediately
+            if (!isRetryable(lastError)) {
+                throw lastError;
+            }
+        }
+        // If this was the last attempt, throw
+        if (attempt === retryConfig.maxRetries) {
+            const message = lastError instanceof Response
+                ? `HTTP ${lastError.status} after ${retryConfig.maxRetries} retries`
+                : lastError instanceof Error
+                    ? lastError.message
+                    : 'Unknown error';
+            throw new Error(`Failed to fetch ${url}: ${message}`);
+        }
+        // Calculate backoff and wait
+        const delayMs = calculateBackoffDelay(attempt, retryConfig);
+        await sleep(delayMs);
+    }
+    // Should not reach here, but satisfy TypeScript
+    throw lastError || new Error('Unknown error in retry loop');
+}
+export { fetchWithRetry, isRetryable, calculateBackoffDelay, sleep, RETRYABLE_STATUS_CODES, NON_RETRYABLE_STATUS_CODES, RETRYABLE_ERROR_PATTERNS, };
+//# sourceMappingURL=http-client-retry.js.map

package/packages/core/dist/http-client-retry.js.map

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