hackmyagent 0.11.3 → 0.11.5

package/dist/telemetry/contribute.js

@@ -2,12 +2,24 @@
 /**
  * Community Contribution Module
  *
- * Sends anonymized HMA scan findings to the OpenA2A Registry.
- * No PII, no source code -- only check pass/fail results.
+ * Queue-based contribution of anonymized HMA scan summaries to the
+ * OpenA2A Registry. Compatible with @opena2a/contribute queue format:
+ * events queued by HMA are flushed by opena2a-cli and vice versa.
+ *
+ * Queue file: ~/.opena2a/contribute-queue.json
+ * Endpoint:   POST api.oa2a.org/api/v1/contribute
+ *
+ * PRIVACY: Only summary statistics are sent (totalChecks, passed,
+ * severity counts, score, verdict). No file paths, no source code,
+ * no raw finding descriptions, no PII.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateContributorToken = generateContributorToken;
-exports.buildContributionPayload = buildContributionPayload;
+exports.generateContributorToken = void 0;
+exports.getContributorToken = getContributorToken;
+exports.queueEvent = queueEvent;
+exports.buildScanEvent = buildScanEvent;
+exports.queueAndMaybeFlush = queueAndMaybeFlush;
+exports.flushQueue = flushQueue;
 exports.buildContributionPayloadFromDir = buildContributionPayloadFromDir;
 exports.submitContribution = submitContribution;
 const crypto_1 = require("crypto");
@@ -15,20 +27,25 @@ const fs_1 = require("fs");
 const os_1 = require("os");
 const path_1 = require("path");
 const index_1 = require("../index");
-/**
- * Resolve the path to the OpenA2A home directory.
- * Respects the OPENA2A_HOME env var, defaults to ~/.opena2a.
- */
+// ---------------------------------------------------------------------------
+// Paths and constants
+// ---------------------------------------------------------------------------
+const REGISTRY_URL = 'https://api.oa2a.org';
+const FLUSH_THRESHOLD = 10;
+const MAX_QUEUE_SIZE = 100;
+const TIMEOUT_MS = 10000;
 function getOpena2aHome() {
     return process.env.OPENA2A_HOME || (0, path_1.join)(require('os').homedir(), '.opena2a');
 }
-/**
- * Generate a stable per-device contributor token.
- *
- * SHA256(hostname + username + random salt stored at ~/.opena2a/contributor-salt).
- * The salt is generated once on first call and persisted locally.
- */
-function generateContributorToken() {
+function ensureDir() {
+    const dir = getOpena2aHome();
+    if (!(0, fs_1.existsSync)(dir))
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+}
+// ---------------------------------------------------------------------------
+// Contributor token (stable per-device, SHA256-hashed)
+// ---------------------------------------------------------------------------
+function getContributorToken() {
     const home = getOpena2aHome();
     const saltPath = (0, path_1.join)(home, 'contributor-salt');
     let salt;
@@ -37,28 +54,60 @@ function generateContributorToken() {
     }
     else {
         salt = (0, crypto_1.randomBytes)(32).toString('hex');
-        (0, fs_1.mkdirSync)(home, { recursive: true });
+        ensureDir();
         (0, fs_1.writeFileSync)(saltPath, salt, { mode: 0o600 });
     }
     const input = `${(0, os_1.hostname)()}|${(0, os_1.userInfo)().username}|${salt}`;
     return (0, crypto_1.createHash)('sha256').update(input).digest('hex');
 }
-/**
- * Map the Node.js os.type() value to the server-accepted osType enum.
- */
-function resolveOsType() {
-    const t = (0, os_1.type)();
-    if (t === 'Darwin')
-        return 'macos';
-    if (t === 'Windows_NT')
-        return 'windows';
-    return 'linux';
+// ---------------------------------------------------------------------------
+// Queue operations (compatible with @opena2a/contribute queue format)
+// ---------------------------------------------------------------------------
+function queuePath() {
+    return (0, path_1.join)(getOpena2aHome(), 'contribute-queue.json');
 }
-/**
- * Detect the package ecosystem from the target directory.
- * Checks for package.json (npm), setup.py / pyproject.toml (pypi),
- * or falls back to github.
- */
+function loadQueue() {
+    const path = queuePath();
+    if (!(0, fs_1.existsSync)(path))
+        return { events: [] };
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
+    }
+    catch {
+        return { events: [] };
+    }
+}
+function saveQueue(queue) {
+    ensureDir();
+    (0, fs_1.writeFileSync)(queuePath(), JSON.stringify(queue), { mode: 0o600 });
+}
+function queueEvent(event) {
+    const queue = loadQueue();
+    queue.events.push(event);
+    if (queue.events.length > MAX_QUEUE_SIZE) {
+        queue.events = queue.events.slice(-MAX_QUEUE_SIZE);
+    }
+    saveQueue(queue);
+}
+function shouldFlush() {
+    return loadQueue().events.length >= FLUSH_THRESHOLD;
+}
+function buildBatch() {
+    const events = loadQueue().events;
+    if (events.length === 0)
+        return null;
+    return {
+        contributorToken: getContributorToken(),
+        events,
+        submittedAt: new Date().toISOString(),
+    };
+}
+function clearQueue() {
+    saveQueue({ events: [] });
+}
+// ---------------------------------------------------------------------------
+// Ecosystem and version detection
+// ---------------------------------------------------------------------------
 function detectEcosystem(directory) {
     if ((0, fs_1.existsSync)((0, path_1.join)(directory, 'package.json')))
         return 'npm';
@@ -68,102 +117,147 @@ function detectEcosystem(directory) {
     }
     return 'github';
 }
-/**
- * Build an anonymized contribution payload from scan findings.
- *
- * PRIVACY: This function intentionally strips all sensitive fields.
- * The output contains ONLY: checkId, pass/fail result, and severity.
- * No file paths, line numbers, descriptions, fix text, or code content.
- */
-function buildContributionPayload(packageName, packageVersion, ecosystem, findings) {
-    const contributionFindings = findings.map((f) => ({
-        checkId: f.checkId,
-        result: f.passed ? 'pass' : 'fail',
-        severity: f.severity,
-    }));
-    return {
-        contributorToken: generateContributorToken(),
-        packageName,
-        packageVersion: packageVersion || '',
-        ecosystem,
-        scanTimestamp: new Date().toISOString(),
-        findings: contributionFindings,
-        hmaVersion: index_1.VERSION,
-        osType: resolveOsType(),
-    };
-}
-/**
- * Build a contribution payload from scan findings, auto-detecting
- * ecosystem and version from the target directory.
- *
- * Convenience wrapper around buildContributionPayload for CLI use.
- */
-function buildContributionPayloadFromDir(packageName, directory, findings) {
-    let version = '';
-    const ecosystem = detectEcosystem(directory);
+function detectPackageVersion(directory, ecosystem) {
     try {
         if (ecosystem === 'npm') {
             const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(directory, 'package.json'), 'utf-8'));
-            version = pkg.version || '';
+            return pkg.version || '';
         }
-        else if (ecosystem === 'pypi') {
-            // Best-effort version detection from setup.py or pyproject.toml
+        if (ecosystem === 'pypi') {
             const setupPath = (0, path_1.join)(directory, 'setup.py');
             if ((0, fs_1.existsSync)(setupPath)) {
                 const content = (0, fs_1.readFileSync)(setupPath, 'utf-8');
                 const match = content.match(/version\s*=\s*['"]([^'"]+)['"]/);
                 if (match)
-                    version = match[1];
+                    return match[1];
             }
         }
     }
     catch {
         // Non-fatal: version detection is best-effort
     }
-    return buildContributionPayload(packageName, version, ecosystem, findings);
+    return '';
+}
+// ---------------------------------------------------------------------------
+// Map OS type
+// ---------------------------------------------------------------------------
+function resolveOsType() {
+    const t = (0, os_1.type)();
+    if (t === 'Darwin')
+        return 'macos';
+    if (t === 'Windows_NT')
+        return 'windows';
+    return 'linux';
+}
+// ---------------------------------------------------------------------------
+// Build contribution event from scan findings
+// ---------------------------------------------------------------------------
+function computeVerdict(findings) {
+    const critical = findings.filter(f => !f.passed && f.severity === 'critical').length;
+    const high = findings.filter(f => !f.passed && f.severity === 'high').length;
+    if (critical > 0)
+        return 'fail';
+    if (high > 0)
+        return 'warn';
+    return 'pass';
 }
 /**
- * Submit an anonymized contribution payload to the OpenA2A Registry.
+ * Build a ContributionEvent from HMA scan findings.
  *
- * POST to https://api.oa2a.org/api/v1/telemetry/scan
- * Timeout: 10 seconds. Non-blocking: failures are logged as warnings, never crash the scan.
+ * Converts the detailed finding list into an anonymized summary:
+ * only counts and severity distribution, no file paths or descriptions.
  */
-async function submitContribution(payload, registryUrl) {
-    const baseUrl = registryUrl || 'https://api.oa2a.org';
-    const url = `${baseUrl}/api/v1/telemetry/scan`;
+function buildScanEvent(packageName, directory, findings, durationMs) {
+    const ecosystem = detectEcosystem(directory);
+    const version = detectPackageVersion(directory, ecosystem);
+    const total = findings.length;
+    const passed = findings.filter(f => f.passed).length;
+    const failed = findings.filter(f => !f.passed);
+    return {
+        type: 'scan_result',
+        tool: 'hackmyagent',
+        toolVersion: index_1.VERSION,
+        timestamp: new Date().toISOString(),
+        package: {
+            name: packageName,
+            version: version || undefined,
+            ecosystem,
+        },
+        scanSummary: {
+            totalChecks: total,
+            passed,
+            critical: failed.filter(f => f.severity === 'critical').length,
+            high: failed.filter(f => f.severity === 'high').length,
+            medium: failed.filter(f => f.severity === 'medium').length,
+            low: failed.filter(f => f.severity === 'low').length,
+            score: total > 0 ? Math.round((passed / total) * 100) : 0,
+            verdict: computeVerdict(findings),
+            durationMs,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Submit: queue + flush
+// ---------------------------------------------------------------------------
+/**
+ * Queue a scan result and flush if threshold reached.
+ * Non-blocking, best-effort. Never throws.
+ */
+async function queueAndMaybeFlush(event, registryUrl, verbose) {
+    queueEvent(event);
+    if (shouldFlush()) {
+        await flushQueue(registryUrl, verbose);
+    }
+}
+/**
+ * Flush queued events to the OpenA2A Registry.
+ * Returns true if submission succeeded (or queue was empty).
+ */
+async function flushQueue(registryUrl, verbose) {
+    const batch = buildBatch();
+    if (!batch)
+        return true;
+    const url = `${(registryUrl || REGISTRY_URL).replace(/\/+$/, '')}/api/v1/contribute`;
     try {
         const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 10000);
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
         const response = await fetch(url, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
                 'User-Agent': `HackMyAgent-CLI/${index_1.VERSION}`,
             },
-            body: JSON.stringify(payload),
+            body: JSON.stringify(batch),
             signal: controller.signal,
         });
-        clearTimeout(timeout);
-        if (!response.ok) {
-            const body = await response.text().catch(() => '');
-            return {
-                success: false,
-                error: `HTTP ${response.status}: ${body}`.substring(0, 200),
-            };
+        clearTimeout(timer);
+        if (response.ok) {
+            clearQueue();
+            if (verbose) {
+                process.stderr.write(`  Shared: anonymized results for ${batch.events.length} scan(s) (community trust)\n`);
+            }
+            return true;
         }
-        const result = (await response.json());
-        return {
-            success: true,
-            scanId: result.scanId || undefined,
-        };
+        return false;
     }
-    catch (err) {
-        const message = err instanceof Error ? err.message : 'Unknown error';
-        // AbortError means timeout
-        if (message.includes('abort') || message.includes('Abort')) {
-            return { success: false, error: 'Request timed out (10s)' };
-        }
-        return { success: false, error: message };
+    catch {
+        // Offline or unreachable -- events stay in queue for next time
+        return false;
     }
 }
+// ---------------------------------------------------------------------------
+// Legacy compatibility exports (used by existing code)
+// ---------------------------------------------------------------------------
+/** @deprecated Use buildScanEvent + queueAndMaybeFlush instead. */
+function buildContributionPayloadFromDir(packageName, directory, findings) {
+    return buildScanEvent(packageName, directory, findings, 0);
+}
+/** @deprecated Use flushQueue instead. */
+async function submitContribution(payload, registryUrl) {
+    queueEvent(payload);
+    const ok = await flushQueue(registryUrl);
+    return { success: ok };
+}
+/** @deprecated Kept for backward compat. */
+exports.generateContributorToken = getContributorToken;
 //# sourceMappingURL=contribute.js.map

package/dist/telemetry/contribute.js.map

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

package/dist/telemetry/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Telemetry module -- community contribution of anonymized scan findings.
  */
-export { generateContributorToken, buildContributionPayload, buildContributionPayloadFromDir, submitContribution, type ContributionFinding, type ContributionPayload, type ContributionResult, } from './contribute';
-export { isContributeEnabled, shouldPromptContribute, incrementScanCount, saveContributeChoice, showContributePrompt, } from './opt-in';
+export { getContributorToken, generateContributorToken, buildScanEvent, buildContributionPayloadFromDir, queueEvent, queueAndMaybeFlush, flushQueue, submitContribution, type ContributionEvent, type ContributionBatch, } from './contribute';
+export { isContributeEnabled, shouldPromptContribute, incrementScanCount, saveContributeChoice, showContributePrompt, recordScanAndMaybeShowTip, _resetBackend, } from './opt-in';
 //# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,+BAA+B,EAC/B,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,+BAA+B,EAC/B,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,GACd,MAAM,UAAU,CAAC"}

package/dist/telemetry/index.js

@@ -3,11 +3,15 @@
  * Telemetry module -- community contribution of anonymized scan findings.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.showContributePrompt = exports.saveContributeChoice = exports.incrementScanCount = exports.shouldPromptContribute = exports.isContributeEnabled = exports.submitContribution = exports.buildContributionPayloadFromDir = exports.buildContributionPayload = exports.generateContributorToken = void 0;
+exports._resetBackend = exports.recordScanAndMaybeShowTip = exports.showContributePrompt = exports.saveContributeChoice = exports.incrementScanCount = exports.shouldPromptContribute = exports.isContributeEnabled = exports.submitContribution = exports.flushQueue = exports.queueAndMaybeFlush = exports.queueEvent = exports.buildContributionPayloadFromDir = exports.buildScanEvent = exports.generateContributorToken = exports.getContributorToken = void 0;
 var contribute_1 = require("./contribute");
+Object.defineProperty(exports, "getContributorToken", { enumerable: true, get: function () { return contribute_1.getContributorToken; } });
 Object.defineProperty(exports, "generateContributorToken", { enumerable: true, get: function () { return contribute_1.generateContributorToken; } });
-Object.defineProperty(exports, "buildContributionPayload", { enumerable: true, get: function () { return contribute_1.buildContributionPayload; } });
+Object.defineProperty(exports, "buildScanEvent", { enumerable: true, get: function () { return contribute_1.buildScanEvent; } });
 Object.defineProperty(exports, "buildContributionPayloadFromDir", { enumerable: true, get: function () { return contribute_1.buildContributionPayloadFromDir; } });
+Object.defineProperty(exports, "queueEvent", { enumerable: true, get: function () { return contribute_1.queueEvent; } });
+Object.defineProperty(exports, "queueAndMaybeFlush", { enumerable: true, get: function () { return contribute_1.queueAndMaybeFlush; } });
+Object.defineProperty(exports, "flushQueue", { enumerable: true, get: function () { return contribute_1.flushQueue; } });
 Object.defineProperty(exports, "submitContribution", { enumerable: true, get: function () { return contribute_1.submitContribution; } });
 var opt_in_1 = require("./opt-in");
 Object.defineProperty(exports, "isContributeEnabled", { enumerable: true, get: function () { return opt_in_1.isContributeEnabled; } });
@@ -15,4 +19,6 @@ Object.defineProperty(exports, "shouldPromptContribute", { enumerable: true, get
 Object.defineProperty(exports, "incrementScanCount", { enumerable: true, get: function () { return opt_in_1.incrementScanCount; } });
 Object.defineProperty(exports, "saveContributeChoice", { enumerable: true, get: function () { return opt_in_1.saveContributeChoice; } });
 Object.defineProperty(exports, "showContributePrompt", { enumerable: true, get: function () { return opt_in_1.showContributePrompt; } });
+Object.defineProperty(exports, "recordScanAndMaybeShowTip", { enumerable: true, get: function () { return opt_in_1.recordScanAndMaybeShowTip; } });
+Object.defineProperty(exports, "_resetBackend", { enumerable: true, get: function () { return opt_in_1._resetBackend; } });
 //# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2CAQsB;AAPpB,sHAAA,wBAAwB,OAAA;AACxB,sHAAA,wBAAwB,OAAA;AACxB,6HAAA,+BAA+B,OAAA;AAC/B,gHAAA,kBAAkB,OAAA;AAMpB,mCAMkB;AALhB,6GAAA,mBAAmB,OAAA;AACnB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2CAWsB;AAVpB,iHAAA,mBAAmB,OAAA;AACnB,sHAAA,wBAAwB,OAAA;AACxB,4GAAA,cAAc,OAAA;AACd,6HAAA,+BAA+B,OAAA;AAC/B,wGAAA,UAAU,OAAA;AACV,gHAAA,kBAAkB,OAAA;AAClB,wGAAA,UAAU,OAAA;AACV,gHAAA,kBAAkB,OAAA;AAKpB,mCAQkB;AAPhB,6GAAA,mBAAmB,OAAA;AACnB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA;AACpB,mHAAA,yBAAyB,OAAA;AACzB,uGAAA,aAAa,OAAA"}

package/dist/telemetry/opt-in.d.ts

@@ -1,46 +1,55 @@
 /**
- * Contribution Opt-In Prompt
+ * Contribution Consent and Scan Counting
  *
- * Handles the user's consent to share anonymized scan findings
- * with the OpenA2A Registry.
+ * Manages the user's consent to share anonymized scan findings
+ * with the OpenA2A Registry. Uses a delayed consent tip shown
+ * after the 3rd scan (non-interactive, no blocking prompts).
  *
  * Config/counting is delegated to @opena2a/shared (the canonical
  * source for ~/.opena2a/config.json). If @opena2a/shared is not
  * available at runtime, falls back to a local implementation.
  */
+/** Reset cached backend (for testing). */
+export declare function _resetBackend(): void;
 /**
  * Check whether the contribution setting is enabled.
  *
  * Returns:
  *   true  - user explicitly opted in
  *   false - user explicitly opted out (or default in shared backend)
- *   undefined - not yet configured (local fallback only; shared backend
- *               defaults to false, so callers should rely on
- *               shouldPromptContribute() for prompt logic)
+ *   undefined - not yet configured
  */
 export declare function isContributeEnabled(): boolean | undefined;
 /**
- * Check whether we should show the contribution prompt.
+ * Check whether we should show the contribution tip.
  *
- * HMA-specific: also checks for TTY (non-interactive environments
- * should never prompt). The backend handles scan-count thresholds
- * and cooldown/dismiss logic.
+ * Returns true after the 3rd scan if the user hasn't opted in,
+ * opted out, or dismissed the tip within the last 30 days.
  */
 export declare function shouldPromptContribute(): boolean;
 /**
  * Increment the scan count. Called after each scan completes,
  * regardless of contribution setting.
  */
-export declare function incrementScanCount(): void;
+export declare function incrementScanCount(): number;
 /**
  * Save the user's contribution choice to the config file.
  */
 export declare function saveContributeChoice(enabled: boolean): void;
+/**
+ * Record a scan and return a consent tip string if the threshold is reached.
+ *
+ * After the 3rd scan, returns a non-interactive tip encouraging the user
+ * to enable contribution. Returns null if tip should not be shown.
+ * This replaces the previous interactive Y/N prompt.
+ */
+export declare function recordScanAndMaybeShowTip(): string | null;
 /**
  * Display the contribution opt-in prompt and return the user's choice.
  *
- * Uses raw stdin to read a single keypress (Y/N).
- * Returns true if the user opted in, false otherwise.
+ * @deprecated Use recordScanAndMaybeShowTip() instead. This is kept
+ * for backward compatibility but now shows a non-interactive tip
+ * rather than blocking for input.
  */
 export declare function showContributePrompt(): Promise<boolean>;
 //# sourceMappingURL=opt-in.d.ts.map

package/dist/telemetry/opt-in.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opt-in.d.ts","sourceRoot":"","sources":["../../src/telemetry/opt-in.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsIH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,GAAG,SAAS,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAK3D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CA2B7D"}
+{"version":3,"file":"opt-in.d.ts","sourceRoot":"","sources":["../../src/telemetry/opt-in.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,0CAA0C;AAC1C,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AA2ID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,GAAG,SAAS,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAK3D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAezD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM7D"}