m3triq 0.2.5 → 0.2.7

package/dist/cli.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { setJsonMode } from './output.js';
 import { getEffectiveConfig, requireApiKey } from './config.js';
 import { M3triqClient, AgentsClient } from './client.js';
+import { reportCliError } from './errorReporter.js';
 import { registerConfigCommands } from './commands/config-cmd.js';
 import { registerProjectCommands } from './commands/projects.js';
 import { registerSessionCommands } from './commands/sessions.js';
@@ -23,7 +24,7 @@ const program = new Command();
 program
     .name('m3t')
     .description('M3TRIQ — protein-ligand analysis from the terminal')
-    .version('0.2.5')
+    .version('0.2.7')
     .option('--json', 'Output as JSON (machine-readable)')
     .hook('preAction', (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
@@ -46,8 +47,37 @@ registerMdCommands(program);
 registerZincCommands(program);
 registerCreditsCommands(program);
 registerPricingCommands(program);
+// Last-line-of-defense catches: anything that escapes a command handler.
+// These fire BEFORE process.exit(), so the reporter has time to flush
+// (it has its own 3-second timeout to bound the wait).
+process.on('uncaughtException', async (err) => {
+    try {
+        await reportCliError(err, { kind: 'uncaughtException' });
+    }
+    catch { }
+    process.stderr.write(`Error: ${err?.message || String(err)}\n`);
+    process.exit(1);
+});
+process.on('unhandledRejection', async (reason) => {
+    try {
+        await reportCliError(reason, { kind: 'unhandledRejection' });
+    }
+    catch { }
+    const msg = reason instanceof Error ? reason.message : String(reason);
+    process.stderr.write(`Error: ${msg}\n`);
+    process.exit(1);
+});
 // Catch async errors from all command actions
-program.parseAsync().catch((err) => {
+program.parseAsync().catch(async (err) => {
+    // Don't beacon commander's own user-facing exits (--help, --version, bad args).
+    const code = err.code;
+    const isCommanderExit = typeof code === 'string' && code.startsWith('commander.');
+    if (!isCommanderExit) {
+        try {
+            await reportCliError(err, { kind: 'command' });
+        }
+        catch { }
+    }
     const message = err.message || String(err);
     if (message.includes('API error') || message.includes('MCP')) {
         process.stderr.write(`Error: ${message}\n`);

package/dist/commands/config-cmd.js

@@ -7,6 +7,7 @@ export function registerConfigCommands(program) {
         .option('--key <api-key>', 'Set API key')
         .option('--url <api-url>', 'Set API URL')
         .option('--console <console-url>', 'Set console URL')
+        .option('--error-reporting <on|off>', 'Toggle anonymous error reporting (default: on)')
         .action((opts) => {
         const config = loadConfig();
         // Update fields if provided
@@ -23,6 +24,21 @@ export function registerConfigCommands(program) {
             config.console_url = opts.console;
             updated = true;
         }
+        if (opts.errorReporting !== undefined) {
+            const v = String(opts.errorReporting).toLowerCase();
+            if (['off', 'false', '0', 'no'].includes(v)) {
+                config.error_reporting_disabled = true;
+                updated = true;
+            }
+            else if (['on', 'true', '1', 'yes'].includes(v)) {
+                config.error_reporting_disabled = false;
+                updated = true;
+            }
+            else {
+                process.stderr.write(`Error: --error-reporting expects on|off (got "${opts.errorReporting}")\n`);
+                process.exit(1);
+            }
+        }
         if (updated) {
             saveConfig(config);
             process.stderr.write('Config saved.\n');
@@ -38,14 +54,16 @@ export function registerConfigCommands(program) {
             console_url: effective.console_url,
             active_project: effective.active_project || null,
             active_project_name: effective.active_project_name || null,
+            error_reporting: effective.error_reporting_disabled ? 'off' : 'on',
         };
         const local = loadLocalProject();
         const projectSource = local ? 'local .m3triq' : effective.active_project ? 'global' : '';
         const human = [
-            `API Key:     ${maskedKey}`,
-            `API URL:     ${effective.api_url}`,
-            `Console URL: ${effective.console_url}`,
-            `Project:     ${effective.active_project_name || '(none)'} ${effective.active_project ? `(${effective.active_project.substring(0, 8)})` : ''} ${projectSource ? `[${projectSource}]` : ''}`,
+            `API Key:         ${maskedKey}`,
+            `API URL:         ${effective.api_url}`,
+            `Console URL:     ${effective.console_url}`,
+            `Project:         ${effective.active_project_name || '(none)'} ${effective.active_project ? `(${effective.active_project.substring(0, 8)})` : ''} ${projectSource ? `[${projectSource}]` : ''}`,
+            `Error reporting: ${effective.error_reporting_disabled ? 'off' : 'on'}`,
         ].join('\n');
         output(data, human);
     });

package/dist/commands/design.js

@@ -67,8 +67,8 @@ export function registerDesignCommands(program) {
         .argument('<target>', 'Target PDB ID (e.g., 6VXX) or path to .pdb file')
         .requiredOption('--hotspots <residues>', 'Binding hotspot residues (e.g., A100,A105,A110)')
         .option('--type <type>', 'Antibody type: nanobody or scfv', 'nanobody')
-        .option('--designs <n>', 'Number of designs (1-10)', parseInt, 3)
-        .option('--seqs <n>', 'Sequences per backbone (1-8)', parseInt, 1)
+        .option('--designs <n>', 'Number of designs (1-10)', (v) => parseInt(v, 10), 3)
+        .option('--seqs <n>', 'Sequences per backbone (1-8)', (v) => parseInt(v, 10), 1)
         .option('--cdr <loops>', 'CDR loop specs (e.g., H1:7,H2:6,H3:5-13)')
         .description('Design de novo antibodies with RFAntibody (Azure T4 GPU, ~3-5 min)')
         .action(async (target, opts) => {

package/dist/commands/predict.js

@@ -28,9 +28,9 @@ export function registerPredictCommands(program) {
         .option('--dna <seq>', 'DNA sequence (or @path to file). Repeatable.', collectArg, [])
         .option('--rna <seq>', 'RNA sequence (or @path to file). Repeatable.', collectArg, [])
         .option('--ligand <smiles_or_ccd>', 'Ligand as SMILES or CCD code (e.g. ATP). Repeatable.', collectArg, [])
-        .option('--samples <n>', 'Number of structure samples (1-25, default: 1)', parseInt, 1)
-        .option('--recycling <n>', 'Recycling steps (1-10, default: 3)', parseInt, 3)
-        .option('--sampling <n>', 'Diffusion sampling steps (10-1000, default: 50)', parseInt, 50)
+        .option('--samples <n>', 'Number of structure samples (1-25, default: 1)', (v) => parseInt(v, 10), 1)
+        .option('--recycling <n>', 'Recycling steps (1-10, default: 3)', (v) => parseInt(v, 10), 3)
+        .option('--sampling <n>', 'Diffusion sampling steps (10-1000, default: 50)', (v) => parseInt(v, 10), 50)
         .option('--name <name>', 'Custom job title')
         .action(async (opts) => {
         await runBoltz2(opts);

package/dist/config.d.ts

@@ -5,6 +5,7 @@ export interface M3triqConfig {
     console_url?: string;
     active_project?: string;
     active_project_name?: string;
+    error_reporting_disabled?: boolean;
 }
 interface LocalProjectConfig {
     project_id: string;

package/dist/errorReporter.d.ts

@@ -0,0 +1,5 @@
+export interface ReportContext {
+    kind?: string;
+    argv?: string[];
+}
+export declare function reportCliError(err: unknown, context?: ReportContext): Promise<void>;

package/dist/errorReporter.js

@@ -0,0 +1,77 @@
+// Beacon CLI errors to Django POST /api/errors/.
+// Best-effort: never throws, never blocks the exit beyond ~3 seconds.
+import os from 'node:os';
+import { getEffectiveConfig } from './config.js';
+const REPORT_TIMEOUT_MS = 3000;
+export async function reportCliError(err, context = {}) {
+    let config;
+    try {
+        config = getEffectiveConfig();
+    }
+    catch {
+        return;
+    }
+    // Opt-out gate. Either the config flag or env var disables reporting.
+    if (config.error_reporting_disabled === true)
+        return;
+    if (process.env.M3TRIQ_NO_ERROR_REPORTING === '1')
+        return;
+    const message = err instanceof Error ? err.message : String(err);
+    const stack = err instanceof Error ? (err.stack || '') : '';
+    const argv = (context.argv || process.argv).slice(1);
+    // Replace any token-like value (long hex/base64 strings) with a placeholder.
+    const sanitizedArgv = argv.map(a => /^[A-Za-z0-9_\-+/=]{32,}$/.test(a) ? '<redacted>' : a);
+    const url_or_cmd = sanitizedArgv.join(' ').slice(0, 500);
+    const cliVersion = await readCliVersion();
+    const payload = {
+        source: 'cli',
+        session_id: '',
+        url_or_cmd,
+        message: message.slice(0, 5000),
+        stack: stack.slice(0, 10000),
+        metadata: {
+            kind: context.kind || 'command',
+            cli_version: cliVersion,
+            node_version: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            os_release: os.release(),
+        },
+    };
+    const url = `${config.api_url || 'https://server.m3triq.com'}/api/errors/`;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), REPORT_TIMEOUT_MS);
+    try {
+        await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+            signal: ctrl.signal,
+        });
+    }
+    catch {
+        // Best-effort: swallow network errors, timeouts, anything.
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+let _cachedVersion = null;
+async function readCliVersion() {
+    if (_cachedVersion)
+        return _cachedVersion;
+    try {
+        const fs = await import('node:fs');
+        const path = await import('node:path');
+        const url = await import('node:url');
+        const here = path.dirname(url.fileURLToPath(import.meta.url));
+        const pkgPath = path.join(here, '..', 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        _cachedVersion = pkg.version || 'unknown';
+        return _cachedVersion;
+    }
+    catch {
+        _cachedVersion = 'unknown';
+        return _cachedVersion;
+    }
+}

package/package.json

@@ -1,13 +1,21 @@
 {
   "name": "m3triq",
-  "version": "0.2.5",
-  "description": "M3TRIQ — protein-ligand analysis from the terminal",
+  "version": "0.2.7",
+  "description": "M3TRIQ \u2014 protein-ligand analysis from the terminal",
   "type": "module",
   "bin": {
     "m3t": "./dist/cli.js"
   },
   "main": "dist/cli.js",
-  "keywords": ["bioinformatics", "chembl", "docking", "protein", "ligand", "drug-discovery", "cli"],
+  "keywords": [
+    "bioinformatics",
+    "chembl",
+    "docking",
+    "protein",
+    "ligand",
+    "drug-discovery",
+    "cli"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/M3TRIQ/m3t.git"
@@ -28,6 +36,8 @@
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "license": "MIT"
 }