@vforsh/argus 0.1.16 → 0.1.19

package/dist/config/{argusConfig.js → validateConfig.js}

@@ -1,107 +1,53 @@
-import fs from 'node:fs';
-import path from 'node:path';
-const AUTO_CONFIG_CANDIDATES = ['.argus/config.json', '.config/argus.json', 'argus.config.json', 'argus/config.json'];
-const EXPECTED_SHAPE_HINT = 'Expected shape: { plugins?: string[], pluginAliases?: Record<string, string>, chrome?: { start?: { url?: string, watcherId?: string, profile?: "temp"|"default-full"|"default-medium"|"default-lite", devTools?: boolean, headless?: boolean } }, watcher?: { start?: { id?: string, url?: string, chromeHost?: string, chromePort?: number, artifacts?: string, pageIndicator?: boolean, pageConsoleLogging?: "none"|"minimal"|"full", inject?: { file: string, exposeArgus?: boolean } } } }.';
-const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-const invalidConfig = (configPath, message) => {
-    console.error(`Invalid Argus config at ${configPath}: ${message} ${EXPECTED_SHAPE_HINT}`);
-    process.exitCode = 2;
-    return null;
-};
-const invalidConfigPath = (configPath, message) => {
-    console.error(`Argus config error at ${configPath}: ${message}`);
-    process.exitCode = 2;
-    return null;
-};
-const assignDefined = (target, key, value) => {
-    if (value !== undefined) {
-        target[key] = value;
-    }
-};
-const validateOptionalString = (value, label) => {
-    if (value === undefined) {
-        return { ok: true };
-    }
-    if (typeof value !== 'string') {
-        return { ok: false, error: `${label} must be a string.` };
-    }
-    return { ok: true, value };
-};
-const validateOptionalBoolean = (value, label) => {
-    if (value === undefined) {
-        return { ok: true };
-    }
-    if (typeof value !== 'boolean') {
-        return { ok: false, error: `${label} must be a boolean.` };
-    }
-    return { ok: true, value };
-};
-const validateOptionalPort = (value, label) => {
-    if (value === undefined) {
-        return { ok: true };
-    }
-    if (typeof value !== 'number' || !Number.isFinite(value) || !Number.isInteger(value)) {
-        return { ok: false, error: `${label} must be an integer.` };
-    }
-    if (value < 1 || value > 65535) {
-        return { ok: false, error: `${label} must be between 1 and 65535.` };
-    }
-    return { ok: true, value };
-};
-const PAGE_CONSOLE_LOGGING_VALUES = ['none', 'minimal', 'full'];
-const validateOptionalPageConsoleLogging = (value, label) => {
-    if (value === undefined) {
-        return { ok: true };
-    }
-    if (typeof value !== 'string' || !PAGE_CONSOLE_LOGGING_VALUES.includes(value)) {
-        return { ok: false, error: `${label} must be one of: none, minimal, full.` };
+/** One-line shape reminder appended to every config validation error. */
+export const EXPECTED_SHAPE_HINT = 'Expected shape: { plugins?: string[], pluginAliases?: Record<string, string>, chrome?: { start?: { url?: string, watcherId?: string, profile?: "temp"|"default-full"|"default-medium"|"default-lite", devTools?: boolean, headless?: boolean } }, watcher?: { start?: { id?: string, url?: string, chromeHost?: string, chromePort?: number, artifacts?: string, pageIndicator?: boolean, pageConsoleLogging?: "none"|"minimal"|"full", inject?: { file: string, exposeArgus?: boolean } } } }.';
+/** Validate a parsed config file against the {@link ArgusConfig} shape. */
+export const validateArgusConfig = (value) => {
+    if (!isRecord(value)) {
+        return { ok: false, error: 'Config root must be an object.' };
     }
-    return { ok: true, value: value };
-};
-const validateOptionalStringArray = (value, label) => {
-    if (value === undefined) {
-        return { ok: true };
+    const pluginsResult = validateOptionalStringArray(value.plugins, '"plugins"');
+    if (!pluginsResult.ok) {
+        return pluginsResult;
     }
-    if (!Array.isArray(value)) {
-        return { ok: false, error: `${label} must be an array of strings.` };
+    const pluginAliasesResult = validateOptionalStringMap(value.pluginAliases, '"pluginAliases"');
+    if (!pluginAliasesResult.ok) {
+        return pluginAliasesResult;
     }
-    for (const [index, item] of value.entries()) {
-        if (typeof item !== 'string') {
-            return { ok: false, error: `${label}[${index}] must be a string.` };
+    const chromeResult = validateOptionalSection(value.chrome, '"chrome"', (section) => {
+        if (section.start === undefined) {
+            return { ok: true, value: {} };
         }
-        if (item.trim() === '') {
-            return { ok: false, error: `${label}[${index}] must be a non-empty string.` };
+        const startResult = validateChromeStartConfig(section.start);
+        if (!startResult.ok) {
+            return startResult;
         }
+        return { ok: true, value: { start: startResult.value } };
+    });
+    if (!chromeResult.ok) {
+        return chromeResult;
     }
-    return { ok: true, value };
-};
-const validateOptionalStringMap = (value, label) => {
-    if (value === undefined) {
-        return { ok: true };
-    }
-    if (!isRecord(value)) {
-        return { ok: false, error: `${label} must be an object with string values.` };
-    }
-    const entries = [];
-    for (const [key, item] of Object.entries(value)) {
-        if (key.trim() === '') {
-            return { ok: false, error: `${label} keys must be non-empty strings.` };
+    const watcherResult = validateOptionalSection(value.watcher, '"watcher"', (section) => {
+        if (section.start === undefined) {
+            return { ok: true, value: {} };
         }
-        if (typeof item !== 'string' || item.trim() === '') {
-            return { ok: false, error: `${label}.${key} must be a non-empty string.` };
+        const startResult = validateWatcherStartConfig(section.start);
+        if (!startResult.ok) {
+            return startResult;
         }
-        entries.push([key, item]);
-    }
-    return { ok: true, value: Object.fromEntries(entries) };
-};
-const validateOptionalSection = (value, label, validate) => {
-    if (value === undefined) {
-        return { ok: true };
-    }
-    if (!isRecord(value)) {
-        return { ok: false, error: `${label} must be an object.` };
+        return { ok: true, value: { start: startResult.value } };
+    });
+    if (!watcherResult.ok) {
+        return watcherResult;
     }
-    return validate(value);
+    return {
+        ok: true,
+        value: {
+            chrome: chromeResult.value,
+            watcher: watcherResult.value,
+            plugins: pluginsResult.value,
+            pluginAliases: pluginAliasesResult.value,
+        },
+    };
 };
 const validateChromeStartConfig = (value) => {
     if (!isRecord(value)) {
@@ -141,32 +87,6 @@ const validateChromeStartConfig = (value) => {
     assignDefined(config, 'headless', headlessResult.value);
     return { ok: true, value: config };
 };
-const validateOptionalInjectConfig = (value) => {
-    if (value === undefined) {
-        return { ok: true };
-    }
-    if (!isRecord(value)) {
-        return { ok: false, error: '"watcher.start.inject" must be an object.' };
-    }
-    const fileResult = validateOptionalString(value.file, '"watcher.start.inject.file"');
-    if (!fileResult.ok) {
-        return fileResult;
-    }
-    if (fileResult.value === undefined || fileResult.value.trim() === '') {
-        return { ok: false, error: '"watcher.start.inject.file" is required and must be a non-empty string.' };
-    }
-    const exposeArgusResult = validateOptionalBoolean(value.exposeArgus, '"watcher.start.inject.exposeArgus"');
-    if (!exposeArgusResult.ok) {
-        return exposeArgusResult;
-    }
-    return {
-        ok: true,
-        value: {
-            file: fileResult.value,
-            exposeArgus: exposeArgusResult.value,
-        },
-    };
-};
 const validateWatcherStartConfig = (value) => {
     if (!isRecord(value)) {
         return { ok: false, error: '"watcher.start" must be an object.' };
@@ -217,149 +137,121 @@ const validateWatcherStartConfig = (value) => {
     assignDefined(config, 'inject', injectResult.value);
     return { ok: true, value: config };
 };
-const validateArgusConfig = (value) => {
-    if (!isRecord(value)) {
-        return { ok: false, error: 'Config root must be an object.' };
+const validateOptionalInjectConfig = (value) => {
+    if (value === undefined) {
+        return { ok: true };
     }
-    const pluginsResult = validateOptionalStringArray(value.plugins, '"plugins"');
-    if (!pluginsResult.ok) {
-        return pluginsResult;
+    if (!isRecord(value)) {
+        return { ok: false, error: '"watcher.start.inject" must be an object.' };
     }
-    const pluginAliasesResult = validateOptionalStringMap(value.pluginAliases, '"pluginAliases"');
-    if (!pluginAliasesResult.ok) {
-        return pluginAliasesResult;
+    const fileResult = validateOptionalString(value.file, '"watcher.start.inject.file"');
+    if (!fileResult.ok) {
+        return fileResult;
     }
-    const chromeResult = validateOptionalSection(value.chrome, '"chrome"', (section) => {
-        if (section.start === undefined) {
-            return { ok: true, value: {} };
-        }
-        const startResult = validateChromeStartConfig(section.start);
-        if (!startResult.ok) {
-            return startResult;
-        }
-        return { ok: true, value: { start: startResult.value } };
-    });
-    if (!chromeResult.ok) {
-        return chromeResult;
+    if (fileResult.value === undefined || fileResult.value.trim() === '') {
+        return { ok: false, error: '"watcher.start.inject.file" is required and must be a non-empty string.' };
     }
-    const watcherResult = validateOptionalSection(value.watcher, '"watcher"', (section) => {
-        if (section.start === undefined) {
-            return { ok: true, value: {} };
-        }
-        const startResult = validateWatcherStartConfig(section.start);
-        if (!startResult.ok) {
-            return startResult;
-        }
-        return { ok: true, value: { start: startResult.value } };
-    });
-    if (!watcherResult.ok) {
-        return watcherResult;
+    const exposeArgusResult = validateOptionalBoolean(value.exposeArgus, '"watcher.start.inject.exposeArgus"');
+    if (!exposeArgusResult.ok) {
+        return exposeArgusResult;
     }
     return {
         ok: true,
         value: {
-            chrome: chromeResult.value,
-            watcher: watcherResult.value,
-            plugins: pluginsResult.value,
-            pluginAliases: pluginAliasesResult.value,
+            file: fileResult.value,
+            exposeArgus: exposeArgusResult.value,
         },
     };
 };
-export const resolveArgusConfigPath = ({ cliPath, cwd }) => {
-    if (cliPath) {
-        const resolved = path.isAbsolute(cliPath) ? cliPath : path.resolve(cwd, cliPath);
-        if (!fs.existsSync(resolved)) {
-            return invalidConfigPath(resolved, 'File not found.');
-        }
-        return resolved;
+const validateOptionalSection = (value, label, validate) => {
+    if (value === undefined) {
+        return { ok: true };
     }
-    for (const candidate of AUTO_CONFIG_CANDIDATES) {
-        const resolved = path.resolve(cwd, candidate);
-        if (fs.existsSync(resolved)) {
-            return resolved;
-        }
+    if (!isRecord(value)) {
+        return { ok: false, error: `${label} must be an object.` };
     }
-    return null;
+    return validate(value);
 };
-export const loadArgusConfig = (resolvedPath) => {
-    let raw;
-    try {
-        raw = fs.readFileSync(resolvedPath, 'utf8');
+const validateOptionalString = (value, label) => {
+    if (value === undefined) {
+        return { ok: true };
     }
-    catch (error) {
-        return invalidConfigPath(resolvedPath, error instanceof Error ? error.message : String(error));
+    if (typeof value !== 'string') {
+        return { ok: false, error: `${label} must be a string.` };
     }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
+    return { ok: true, value };
+};
+const validateOptionalBoolean = (value, label) => {
+    if (value === undefined) {
+        return { ok: true };
+    }
+    if (typeof value !== 'boolean') {
+        return { ok: false, error: `${label} must be a boolean.` };
     }
-    catch (error) {
-        return invalidConfig(resolvedPath, error instanceof Error ? error.message : String(error));
+    return { ok: true, value };
+};
+const validateOptionalPort = (value, label) => {
+    if (value === undefined) {
+        return { ok: true };
     }
-    const validated = validateArgusConfig(parsed);
-    if (!validated.ok) {
-        return invalidConfig(resolvedPath, validated.error);
+    if (typeof value !== 'number' || !Number.isFinite(value) || !Number.isInteger(value)) {
+        return { ok: false, error: `${label} must be an integer.` };
     }
-    return { config: validated.value, configDir: path.dirname(resolvedPath) };
+    if (value < 1 || value > 65535) {
+        return { ok: false, error: `${label} must be between 1 and 65535.` };
+    }
+    return { ok: true, value };
 };
-export const getConfigStartDefaults = (config) => ({
-    chromeStart: config.chrome?.start,
-    watcherStart: config.watcher?.start,
-});
-const resolveArtifactsPath = (configDir, artifacts) => path.resolve(configDir, artifacts);
-const resolveInjectPath = (configDir, inject) => ({
-    file: path.resolve(configDir, inject.file),
-    exposeArgus: inject.exposeArgus,
-});
-const mergeOption = (command, key, cliValue, configValue) => {
-    if (command.getOptionValueSource(key) === 'cli') {
-        return cliValue;
-    }
-    if (configValue !== undefined) {
-        return configValue;
-    }
-    return cliValue;
+const PAGE_CONSOLE_LOGGING_VALUES = ['none', 'minimal', 'full'];
+const validateOptionalPageConsoleLogging = (value, label) => {
+    if (value === undefined) {
+        return { ok: true };
+    }
+    if (typeof value !== 'string' || !PAGE_CONSOLE_LOGGING_VALUES.includes(value)) {
+        return { ok: false, error: `${label} must be one of: none, minimal, full.` };
+    }
+    return { ok: true, value: value };
 };
-export const mergeChromeStartOptionsWithConfig = (options, command, configResult) => {
-    if (!configResult) {
-        return options;
-    }
-    const { chromeStart } = getConfigStartDefaults(configResult.config);
-    if (!chromeStart) {
-        return options;
-    }
-    const merged = { ...options };
-    merged.url = mergeOption(command, 'url', options.url, chromeStart.url);
-    merged.fromWatcher = mergeOption(command, 'fromWatcher', options.fromWatcher, chromeStart.watcherId);
-    merged.profile = mergeOption(command, 'profile', options.profile, chromeStart.profile);
-    merged.devTools = mergeOption(command, 'devTools', options.devTools, chromeStart.devTools);
-    merged.headless = mergeOption(command, 'headless', options.headless, chromeStart.headless);
-    if (merged.url && merged.fromWatcher) {
-        console.error('Cannot combine --url with --from-watcher. Use one or the other.');
-        process.exitCode = 2;
-        return null;
-    }
-    return merged;
+const validateOptionalStringArray = (value, label) => {
+    if (value === undefined) {
+        return { ok: true };
+    }
+    if (!Array.isArray(value)) {
+        return { ok: false, error: `${label} must be an array of strings.` };
+    }
+    for (const [index, item] of value.entries()) {
+        if (typeof item !== 'string') {
+            return { ok: false, error: `${label}[${index}] must be a string.` };
+        }
+        if (item.trim() === '') {
+            return { ok: false, error: `${label}[${index}] must be a non-empty string.` };
+        }
+    }
+    return { ok: true, value };
+};
+const validateOptionalStringMap = (value, label) => {
+    if (value === undefined) {
+        return { ok: true };
+    }
+    if (!isRecord(value)) {
+        return { ok: false, error: `${label} must be an object with string values.` };
+    }
+    const entries = [];
+    for (const [key, item] of Object.entries(value)) {
+        if (key.trim() === '') {
+            return { ok: false, error: `${label} keys must be non-empty strings.` };
+        }
+        if (typeof item !== 'string' || item.trim() === '') {
+            return { ok: false, error: `${label}.${key} must be a non-empty string.` };
+        }
+        entries.push([key, item]);
+    }
+    return { ok: true, value: Object.fromEntries(entries) };
 };
-export const mergeWatcherStartOptionsWithConfig = (options, command, configResult) => {
-    if (!configResult) {
-        return options;
-    }
-    const { watcherStart } = getConfigStartDefaults(configResult.config);
-    if (!watcherStart) {
-        return options;
-    }
-    const merged = { ...options };
-    const configArtifacts = watcherStart.artifacts !== undefined ? resolveArtifactsPath(configResult.configDir, watcherStart.artifacts) : undefined;
-    const configInject = watcherStart.inject !== undefined ? resolveInjectPath(configResult.configDir, watcherStart.inject) : undefined;
-    merged.id = mergeOption(command, 'id', options.id, watcherStart.id);
-    merged.url = mergeOption(command, 'url', options.url, watcherStart.url);
-    merged.chromeHost = mergeOption(command, 'chromeHost', options.chromeHost, watcherStart.chromeHost);
-    merged.chromePort = mergeOption(command, 'chromePort', options.chromePort, watcherStart.chromePort);
-    merged.pageIndicator = mergeOption(command, 'pageIndicator', options.pageIndicator, watcherStart.pageIndicator);
-    merged.pageConsoleLogging = mergeOption(command, 'pageConsoleLogging', options.pageConsoleLogging, watcherStart.pageConsoleLogging);
-    merged.artifacts = mergeOption(command, 'artifacts', options.artifacts, configArtifacts);
-    merged.inject = mergeOption(command, 'inject', options.inject, configInject);
-    return merged;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const assignDefined = (target, key, value) => {
+    if (value !== undefined) {
+        target[key] = value;
+    }
 };
-//# sourceMappingURL=argusConfig.js.map
+//# sourceMappingURL=validateConfig.js.map

package/dist/config/validateConfig.js.map

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

package/dist/eval/evalClient.d.ts

@@ -33,5 +33,7 @@ export type EvalAttemptResult = {
     attempt: number;
 };
 export declare const evalOnce: (input: EvalOnceInput) => Promise<EvalOutcome>;
+/** Format transport errors with an eval-specific timeout hint when a long-running script likely exceeded the request budget. */
+export declare const formatEvalTransportError: (watcher: Pick<WatcherRecord, "id">, error: unknown, timeoutMs: number | undefined) => string;
 export declare const evalWithRetries: (input: EvalWithRetriesInput) => Promise<EvalAttemptResult>;
 //# sourceMappingURL=evalClient.d.ts.map

package/dist/eval/evalClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evalClient.d.ts","sourceRoot":"","sources":["../../src/eval/evalClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGrE,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IAClD,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,CAAA;AAEzF,MAAM,MAAM,iBAAiB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1G,eAAO,MAAM,QAAQ,GAAU,OAAO,aAAa,KAAG,OAAO,CAAC,WAAW,CAoCxE,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,OAAO,oBAAoB,KAAG,OAAO,CAAC,iBAAiB,CA+B5F,CAAA"}
+{"version":3,"file":"evalClient.d.ts","sourceRoot":"","sources":["../../src/eval/evalClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAMrE,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IAClD,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,CAAA;AAEzF,MAAM,MAAM,iBAAiB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1G,eAAO,MAAM,QAAQ,GAAU,OAAO,aAAa,KAAG,OAAO,CAAC,WAAW,CAqCxE,CAAA;AAED,gIAAgI;AAChI,eAAO,MAAM,wBAAwB,GAAI,SAAS,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,OAAO,EAAE,WAAW,MAAM,GAAG,SAAS,KAAG,MAY5H,CAAA;AAcD,eAAO,MAAM,eAAe,GAAU,OAAO,oBAAoB,KAAG,OAAO,CAAC,iBAAiB,CA+B5F,CAAA"}

package/dist/eval/evalClient.js

@@ -1,4 +1,6 @@
 import { fetchWatcherJson, formatWatcherTransportError } from '../watchers/requestWatcher.js';
+const DEFAULT_EVAL_REQUEST_TIMEOUT_MS = 10_000;
+const MIN_SUGGESTED_TIMEOUT_MS = 60_000;
 export const evalOnce = async (input) => {
     const body = {
         expression: input.expression,
@@ -8,20 +10,21 @@ export const evalOnce = async (input) => {
         returnByValue: input.returnByValue,
         timeoutMs: input.timeoutMs,
     };
+    const requestTimeoutMs = input.timeoutMs ? input.timeoutMs + 5_000 : DEFAULT_EVAL_REQUEST_TIMEOUT_MS;
     let response;
     try {
         response = await fetchWatcherJson(input.watcher, {
             path: '/eval',
             method: 'POST',
             body,
-            timeoutMs: input.timeoutMs ? input.timeoutMs + 5_000 : 10_000,
+            timeoutMs: requestTimeoutMs,
         });
     }
     catch (error) {
         return {
             ok: false,
             kind: 'transport',
-            error: formatWatcherTransportError(input.watcher, error),
+            error: formatEvalTransportError(input.watcher, error, input.timeoutMs),
         };
     }
     if (response.exception && input.failOnException) {
@@ -34,6 +37,27 @@ export const evalOnce = async (input) => {
     }
     return { ok: true, response };
 };
+/** Format transport errors with an eval-specific timeout hint when a long-running script likely exceeded the request budget. */
+export const formatEvalTransportError = (watcher, error, timeoutMs) => {
+    const baseMessage = formatWatcherTransportError(watcher, error);
+    if (!isTimeoutError(error)) {
+        return baseMessage;
+    }
+    const suggestedTimeoutMs = Math.max(MIN_SUGGESTED_TIMEOUT_MS, (timeoutMs ?? DEFAULT_EVAL_REQUEST_TIMEOUT_MS) * 2);
+    return (`${baseMessage}. ` +
+        `Eval may need more time; pass a longer timeout as milliseconds or a duration, for example: ` +
+        `\`argus eval ${watcher.id} --timeout ${formatSuggestedDuration(suggestedTimeoutMs)} ...\``);
+};
+const isTimeoutError = (error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    return /timed out|timeout/i.test(message);
+};
+const formatSuggestedDuration = (timeoutMs) => {
+    if (timeoutMs % 1_000 === 0) {
+        return `${timeoutMs / 1_000}s`;
+    }
+    return String(timeoutMs);
+};
 export const evalWithRetries = async (input) => {
     let attempt = 0;
     while (attempt <= input.retryCount) {

package/dist/eval/evalClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"evalClient.js","sourceRoot":"","sources":["../../src/eval/evalClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAyB7F,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAoB,EAAwB,EAAE;IAC5E,MAAM,IAAI,GAAG;QACZ,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC1B,CAAA;IAED,IAAI,QAAsB,CAAA;IAC1B,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,gBAAgB,CAAe,KAAK,CAAC,OAAO,EAAE;YAC9D,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM;SAC7D,CAAC,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO;YACN,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,2BAA2B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;SACxD,CAAA;IACF,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QACjD,OAAO;YACN,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,WAAW;YACjB,QAAQ;YACR,KAAK,EAAE,cAAc,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;SAC9C,CAAA;IACF,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAC9B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,KAA2B,EAA8B,EAAE;IAChG,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,OAAO,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,CAAA;QACZ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;SACtC,CAAC,CAAA;QAEF,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAA;QAC/B,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,CAAC,UAAU,CAAA;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAA;QAC/B,CAAC;IACF,CAAC;IAED,OAAO;QACN,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,2BAA2B,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC;QAClE,OAAO;KACP,CAAA;AACF,CAAC,CAAA"}
+{"version":3,"file":"evalClient.js","sourceRoot":"","sources":["../../src/eval/evalClient.ts"],"names":[],"mappings":"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"}