@muggleai/telemetry 0.2.0

package/PRIVACY.md

@@ -0,0 +1,52 @@
+# Privacy
+
+Muggle Test client-side telemetry attaches the following fields to every event sent to Azure Application Insights.
+
+## Common properties (every event)
+
+| Field | Source | Purpose |
+|---|---|---|
+| `source` | constant `'client'` | Distinguishes from server-auto-collected request spans |
+| `serviceName` | one of `muggle-mcp`, `muggle-electron`, `muggle-skill` | Which surface emitted the event |
+| `surface` | one of `mcp-local`, `mcp-remote`, `skill`, `electron` | Process surface |
+| `release` | release manifest | Product version |
+| `buildId` | release manifest | CI build identifier |
+| `commitSha` | release manifest | Git commit hash |
+| `buildTime` | release manifest | Build timestamp |
+| `installId` | `~/.muggle-ai/install-id.json` | Opaque per-machine UUID, generated on first run, stable across upgrades, lost on uninstall |
+| `userId` | `~/.muggle-ai/oauth-session.json` (when signed in) | Opaque Auth0 subject identifier, **not** the user's email |
+| `nodeVersion` | `process.version` | Node.js version |
+| `platform` | `process.platform` | OS family (`win32`, `darwin`, `linux`) |
+
+## Network-level fields attached by Azure (not by this package)
+
+- **Source IP**: Azure App Insights records the originating IP on every event (default SDK behavior). Used for geographic aggregation and abuse detection. We do not strip it.
+
+## What we do NOT collect
+
+- Personal email address
+- OS username
+- Hostname / machine name
+- Absolute file paths
+- File contents (test scripts, source code, configuration)
+- Browser session contents
+
+## How to disable
+
+Either:
+
+```bash
+echo '{"telemetryEnabled": false}' > ~/.muggle-ai/preferences.json
+```
+
+Or set:
+
+```bash
+export MUGGLE_TELEMETRY_DISABLED=1
+```
+
+When disabled, no network requests are made, no events are queued, and no disk cache is written.
+
+## Data retention
+
+Application Insights resources are owned by Multiplex AI. Retention follows the Azure resource's configured retention policy (default 90 days unless otherwise documented).

package/README.md

@@ -0,0 +1,86 @@
+# @muggleai/telemetry
+
+Shared client-side telemetry for Muggle Test. Used by:
+
+- **MCP** (`muggle-ai-works/packages/mcps`)
+- **Electron app** (`muggle-ai-teaching-service/packages/electron-app`)
+- **Skills** (`muggle-ai-works` skill bundle) — calls into MCP, which calls this package
+
+Sends `customEvents` to Azure Application Insights with consistent identity (`installId`, `userId`, `release`, `buildId`, `commitSha`) and a `source: 'client'` tag so dashboards can separate client-emitted events from server-auto-collected request spans.
+
+## Usage
+
+```ts
+import { initTelemetry, track } from "@muggleai/telemetry";
+
+initTelemetry({ serviceName: "muggle-mcp", surface: "mcp-local" });
+
+track({
+  name: "mcp.tool.invoked",
+  props: {
+    toolName: "muggle-local-execute-replay",
+    toolSurface: "local",
+    correlationId: "abc-123",
+  },
+});
+```
+
+## Connection string
+
+Read in this order:
+
+1. Explicit `initTelemetry({ connectionString })` argument
+2. `APPLICATIONINSIGHTS_CONNECTION_STRING` env var
+3. `VITE_APPLICATIONINSIGHTS_CONNECTION_STRING` env var (Electron-style)
+
+When none is set, `initTelemetry()` becomes a no-op — `track()` calls are silently dropped. This keeps the package safe to import in dev environments.
+
+## Opt-out
+
+```ts
+import { isTelemetryEnabled, setTelemetryEnabled } from "@muggleai/telemetry";
+
+if (!isTelemetryEnabled()) { /* nothing will be sent */ }
+setTelemetryEnabled(false); // persists to ~/.muggle-ai/preferences.json
+```
+
+Or set the env var `MUGGLE_TELEMETRY_DISABLED=1`.
+
+## Disclosure
+
+```ts
+import { getDisclosureCopy, hasShownDisclosure, markDisclosureShown } from "@muggleai/telemetry";
+
+if (!hasShownDisclosure()) {
+  console.log(getDisclosureCopy());
+  markDisclosureShown();
+}
+```
+
+## Privacy
+
+See [PRIVACY.md](./PRIVACY.md) for the complete list of fields collected.
+
+## Design
+
+See `muggle-ai-brain/architecture/2026-05-05-mcp-skill-telemetry-design.md` (private repo).
+
+## Development
+
+```bash
+npm install
+npm test          # vitest
+npm run typecheck
+npm run build     # tsc → dist/
+```
+
+## Releasing
+
+Tag and push:
+
+```bash
+git tag v0.2.0
+git push --tags
+```
+
+The `publish.yml` workflow verifies (typecheck + tests + build) then publishes to public npm via OIDC trusted publishing. No `NPM_TOKEN` secret required — auth is configured on npmjs.com under the package's Trusted Publisher settings.

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import type { TelemetryClient } from "applicationinsights";
+import type { InitOptions } from "./types/client.js";
+export type { InitOptions } from "./types/client.js";
+export declare function initTelemetry(options: InitOptions): void;
+export declare function getClient(): TelemetryClient | null;
+export declare function isInitialized(): boolean;
+export declare function resetClientForTests(): void;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGlE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmCrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAwDxD;AAED,wBAAgB,SAAS,IAAI,eAAe,GAAG,IAAI,CAElD;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/client.js

@@ -0,0 +1,96 @@
+// AppInsights client setup. One process = one client.
+// Common props attached on every event so server-side queries can filter by
+// `source: 'client'`, `serviceName`, `surface`, `installId`, etc.
+import * as AppInsights from "applicationinsights";
+import { ENV_CONNECTION_STRING, ENV_VITE_CONNECTION_STRING } from "./constants/env.js";
+import { getInstallId } from "./install-id.js";
+import { readReleaseManifest } from "./release-manifest.js";
+import { readUserId } from "./user-id.js";
+let state = null;
+function resolveConnectionString(explicit) {
+    if (explicit && explicit.length > 0)
+        return explicit;
+    return (process.env[ENV_CONNECTION_STRING] ??
+        process.env[ENV_VITE_CONNECTION_STRING] ??
+        undefined);
+}
+function buildCommonProperties(serviceName, surface) {
+    const manifest = readReleaseManifest();
+    const props = {
+        source: "client",
+        serviceName,
+        surface,
+        release: manifest.release,
+        buildId: manifest.buildId,
+        commitSha: manifest.commitSha,
+        buildTime: manifest.buildTime,
+        installId: getInstallId(),
+        nodeVersion: process.version,
+        platform: process.platform,
+    };
+    const userId = readUserId();
+    if (userId !== undefined)
+        props.userId = userId;
+    return props;
+}
+export function initTelemetry(options) {
+    if (state !== null && state.initialized)
+        return;
+    const connectionString = resolveConnectionString(options.connectionString);
+    if (!connectionString) {
+        state = {
+            client: null,
+            serviceName: options.serviceName,
+            surface: options.surface,
+            initialized: true,
+        };
+        return;
+    }
+    try {
+        AppInsights.setup(connectionString)
+            .setUseDiskRetryCaching(true)
+            .setDistributedTracingMode(AppInsights.DistributedTracingModes.AI_AND_W3C)
+            .setAutoCollectRequests(false)
+            .setAutoCollectPerformance(false, false)
+            .setAutoCollectExceptions(true)
+            .setAutoCollectDependencies(false)
+            .setAutoCollectConsole(false)
+            .setSendLiveMetrics(false);
+        const client = AppInsights.defaultClient;
+        const manifest = readReleaseManifest();
+        client.context.tags[client.context.keys.cloudRole] = options.serviceName;
+        client.context.tags[client.context.keys.applicationVersion] = manifest.release;
+        client.commonProperties = {
+            ...client.commonProperties,
+            ...buildCommonProperties(options.serviceName, options.surface),
+        };
+        AppInsights.start();
+        state = {
+            client,
+            serviceName: options.serviceName,
+            surface: options.surface,
+            initialized: true,
+        };
+    }
+    catch (err) {
+        console.warn("[muggle-telemetry] init failed; events will be dropped", {
+            error: err.message,
+        });
+        state = {
+            client: null,
+            serviceName: options.serviceName,
+            surface: options.surface,
+            initialized: true,
+        };
+    }
+}
+export function getClient() {
+    return state?.client ?? null;
+}
+export function isInitialized() {
+    return state?.initialized === true;
+}
+export function resetClientForTests() {
+    state = null;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,4EAA4E;AAC5E,kEAAkE;AAElE,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,IAAI,KAAK,GAAuB,IAAI,CAAC;AAErC,SAAS,uBAAuB,CAAC,QAA4B;IAC3D,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACrD,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QACvC,SAAS,CACV,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,WAAwB,EACxB,OAAgB;IAEhB,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,MAAM,KAAK,GAA2B;QACpC,MAAM,EAAE,QAAQ;QAChB,WAAW;QACX,OAAO;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,YAAY,EAAE;QACzB,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IAChD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAoB;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO;IAEhD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE3E,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,KAAK,GAAG;YACN,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,IAAI;SAClB,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC;aAChC,sBAAsB,CAAC,IAAI,CAAC;aAC5B,yBAAyB,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,CAAC;aACzE,sBAAsB,CAAC,KAAK,CAAC;aAC7B,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC;aACvC,wBAAwB,CAAC,IAAI,CAAC;aAC9B,0BAA0B,CAAC,KAAK,CAAC;aACjC,qBAAqB,CAAC,KAAK,CAAC;aAC5B,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAE7B,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,CAAC;QACzC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;QAEvC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;QACzE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;QAE/E,MAAM,CAAC,gBAAgB,GAAG;YACxB,GAAG,MAAM,CAAC,gBAAgB;YAC1B,GAAG,qBAAqB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC;SAC/D,CAAC;QAEF,WAAW,CAAC,KAAK,EAAE,CAAC;QAEpB,KAAK,GAAG;YACN,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,wDAAwD,EAAE;YACrE,KAAK,EAAG,GAAa,CAAC,OAAO;SAC9B,CAAC,CAAC;QACH,KAAK,GAAG;YACN,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,KAAK,EAAE,MAAM,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,KAAK,GAAG,IAAI,CAAC;AACf,CAAC"}

package/dist/constants/disclosure.d.ts

@@ -0,0 +1,2 @@
+export declare const DISCLOSURE_COPY = "Muggle Test collects anonymous usage telemetry \u2014 which features you use, how long they take, and whether they succeed \u2014 to help us improve the product. We attach an opaque install ID, your account ID (when signed in), and your IP. We do not collect file contents, OS username, hostname, or file paths. To opt out, set telemetryEnabled to false in ~/.muggle-ai/preferences.json or run `muggle preferences set telemetryEnabled false`.";
+//# sourceMappingURL=disclosure.d.ts.map

package/dist/constants/disclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclosure.d.ts","sourceRoot":"","sources":["../../src/constants/disclosure.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,+bAAub,CAAC"}

package/dist/constants/disclosure.js

@@ -0,0 +1,2 @@
+export const DISCLOSURE_COPY = `Muggle Test collects anonymous usage telemetry — which features you use, how long they take, and whether they succeed — to help us improve the product. We attach an opaque install ID, your account ID (when signed in), and your IP. We do not collect file contents, OS username, hostname, or file paths. To opt out, set telemetryEnabled to false in ~/.muggle-ai/preferences.json or run \`muggle preferences set telemetryEnabled false\`.`;
+//# sourceMappingURL=disclosure.js.map

package/dist/constants/disclosure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclosure.js","sourceRoot":"","sources":["../../src/constants/disclosure.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,obAAob,CAAC"}

package/dist/constants/env.d.ts

@@ -0,0 +1,4 @@
+export declare const ENV_CONNECTION_STRING = "APPLICATIONINSIGHTS_CONNECTION_STRING";
+export declare const ENV_VITE_CONNECTION_STRING = "VITE_APPLICATIONINSIGHTS_CONNECTION_STRING";
+export declare const ENV_TELEMETRY_DISABLED = "MUGGLE_TELEMETRY_DISABLED";
+//# sourceMappingURL=env.d.ts.map

package/dist/constants/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,0CAA0C,CAAC;AAE7E,eAAO,MAAM,0BAA0B,+CAA+C,CAAC;AAEvF,eAAO,MAAM,sBAAsB,8BAA8B,CAAC"}

package/dist/constants/env.js

@@ -0,0 +1,4 @@
+export const ENV_CONNECTION_STRING = "APPLICATIONINSIGHTS_CONNECTION_STRING";
+export const ENV_VITE_CONNECTION_STRING = "VITE_APPLICATIONINSIGHTS_CONNECTION_STRING";
+export const ENV_TELEMETRY_DISABLED = "MUGGLE_TELEMETRY_DISABLED";
+//# sourceMappingURL=env.js.map

package/dist/constants/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,uCAAuC,CAAC;AAE7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,4CAA4C,CAAC;AAEvF,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC"}

package/dist/constants/manifest.d.ts

@@ -0,0 +1,3 @@
+import type { ReleaseManifest } from "../types/release-manifest.js";
+export declare const DEV_MANIFEST: ReleaseManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/constants/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/constants/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,YAAY,EAAE,eAM1B,CAAC"}

package/dist/constants/manifest.js

@@ -0,0 +1,8 @@
+export const DEV_MANIFEST = {
+    release: "dev",
+    buildId: "dev",
+    commitSha: "dev",
+    buildTime: "1970-01-01T00:00:00Z",
+    serviceName: "muggle-ai-telemetry",
+};
+//# sourceMappingURL=manifest.js.map

package/dist/constants/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/constants/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,sBAAsB;IACjC,WAAW,EAAE,qBAAqB;CACnC,CAAC"}

package/dist/constants/paths.d.ts

@@ -0,0 +1,6 @@
+export declare const DATA_DIR_NAME = ".muggle-ai";
+export declare const INSTALL_ID_FILENAME = "install-id.json";
+export declare const PREFS_FILENAME = "preferences.json";
+export declare const OAUTH_SESSION_FILENAME = "oauth-session.json";
+export declare const RELEASE_MANIFEST_FILENAME = "release-manifest.json";
+//# sourceMappingURL=paths.d.ts.map

package/dist/constants/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,eAAO,MAAM,yBAAyB,0BAA0B,CAAC"}

package/dist/constants/paths.js

@@ -0,0 +1,6 @@
+export const DATA_DIR_NAME = ".muggle-ai";
+export const INSTALL_ID_FILENAME = "install-id.json";
+export const PREFS_FILENAME = "preferences.json";
+export const OAUTH_SESSION_FILENAME = "oauth-session.json";
+export const RELEASE_MANIFEST_FILENAME = "release-manifest.json";
+//# sourceMappingURL=paths.js.map

package/dist/constants/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE3D,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC"}

package/dist/data-dir.d.ts

@@ -0,0 +1,3 @@
+export declare function getDataDir(): string;
+export declare function setDataDirForTests(dir: string | undefined): void;
+//# sourceMappingURL=data-dir.d.ts.map

package/dist/data-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-dir.d.ts","sourceRoot":"","sources":["../src/data-dir.ts"],"names":[],"mappings":"AAOA,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEhE"}

package/dist/data-dir.js

@@ -0,0 +1,13 @@
+import * as os from "node:os";
+import * as path from "node:path";
+import { DATA_DIR_NAME } from "./constants/paths.js";
+let dataDirOverride;
+export function getDataDir() {
+    if (dataDirOverride !== undefined)
+        return dataDirOverride;
+    return path.join(os.homedir(), DATA_DIR_NAME);
+}
+export function setDataDirForTests(dir) {
+    dataDirOverride = dir;
+}
+//# sourceMappingURL=data-dir.js.map

package/dist/data-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-dir.js","sourceRoot":"","sources":["../src/data-dir.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,IAAI,eAAmC,CAAC;AAExC,MAAM,UAAU,UAAU;IACxB,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAuB;IACxD,eAAe,GAAG,GAAG,CAAC;AACxB,CAAC"}

package/dist/disclosure.d.ts

@@ -0,0 +1,5 @@
+export { DISCLOSURE_COPY } from "./constants/disclosure.js";
+export declare function getDisclosureCopy(): string;
+export declare function hasShownDisclosure(): boolean;
+export declare function markDisclosureShown(now?: Date): void;
+//# sourceMappingURL=disclosure.d.ts.map

package/dist/disclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclosure.d.ts","sourceRoot":"","sources":["../src/disclosure.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,IAAiB,GAAG,IAAI,CAEhE"}

package/dist/disclosure.js

@@ -0,0 +1,18 @@
+// First-run telemetry disclosure. Stored in preferences.json so MCP, skills,
+// and Electron all share the same "shown" flag.
+import { DISCLOSURE_COPY } from "./constants/disclosure.js";
+import { preferencesFileExists, readPreferences, updatePreference } from "./preferences.js";
+export { DISCLOSURE_COPY } from "./constants/disclosure.js";
+export function getDisclosureCopy() {
+    return DISCLOSURE_COPY;
+}
+export function hasShownDisclosure() {
+    if (!preferencesFileExists())
+        return false;
+    const prefs = readPreferences();
+    return typeof prefs.disclosureShownAt === "string" && prefs.disclosureShownAt.length > 0;
+}
+export function markDisclosureShown(now = new Date()) {
+    updatePreference("disclosureShownAt", now.toISOString());
+}
+//# sourceMappingURL=disclosure.js.map

package/dist/disclosure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclosure.js","sourceRoot":"","sources":["../src/disclosure.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gDAAgD;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,qBAAqB,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,OAAO,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,IAAI,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAY,IAAI,IAAI,EAAE;IACxD,gBAAgB,CAAC,mBAAmB,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/emit.d.ts

@@ -0,0 +1,3 @@
+import type { TelemetryEvent } from "./types/events.js";
+export declare function track(event: TelemetryEvent): void;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,wBAAgB,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAYjD"}

package/dist/emit.js

@@ -0,0 +1,21 @@
+// Public emit surface. Opt-out is checked at every track() call so flipping
+// the preference takes effect immediately without restart.
+import { getClient } from "./client.js";
+import { isTelemetryEnabled } from "./opt-out.js";
+export function track(event) {
+    if (!isTelemetryEnabled())
+        return;
+    const client = getClient();
+    if (!client)
+        return;
+    try {
+        client.trackEvent({
+            name: event.name,
+            properties: event.props,
+        });
+    }
+    catch {
+        // Telemetry must never crash the host process.
+    }
+}
+//# sourceMappingURL=emit.js.map

package/dist/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2DAA2D;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,UAAU,KAAK,CAAC,KAAqB;IACzC,IAAI,CAAC,kBAAkB,EAAE;QAAE,OAAO;IAClC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC;QACH,MAAM,CAAC,UAAU,CAAC;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,KAAgC;SACnD,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { initTelemetry, isInitialized, resetClientForTests } from "./client.js";
+export type { InitOptions } from "./types/client.js";
+export { track } from "./emit.js";
+export { isTelemetryEnabled, setTelemetryEnabled } from "./opt-out.js";
+export { DISCLOSURE_COPY, getDisclosureCopy, hasShownDisclosure, markDisclosureShown, } from "./disclosure.js";
+export { getInstallId } from "./install-id.js";
+export { DEV_MANIFEST, readReleaseManifest } from "./release-manifest.js";
+export type { ReleaseManifest } from "./types/release-manifest.js";
+export type { EventName, McpToolCompleted, McpToolInvoked, Outcome, ServiceName, SkillCompleted, SkillInvoked, Surface, SystemDisclosureShown, SystemOptOutChanged, SystemStartup, TelemetryEvent, ToolSurface, Trigger, } from "./types/events.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,WAAW,EACX,cAAc,EACd,YAAY,EACZ,OAAO,EACP,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,WAAW,EACX,OAAO,GACR,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Public surface of @muggleai/telemetry.
+export { initTelemetry, isInitialized, resetClientForTests } from "./client.js";
+export { track } from "./emit.js";
+export { isTelemetryEnabled, setTelemetryEnabled } from "./opt-out.js";
+export { DISCLOSURE_COPY, getDisclosureCopy, hasShownDisclosure, markDisclosureShown, } from "./disclosure.js";
+export { getInstallId } from "./install-id.js";
+export { DEV_MANIFEST, readReleaseManifest } from "./release-manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGhF,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/install-id.d.ts

@@ -0,0 +1,3 @@
+export declare function getInstallId(): string;
+export declare function resetInstallIdCacheForTests(): void;
+//# sourceMappingURL=install-id.d.ts.map

package/dist/install-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.d.ts","sourceRoot":"","sources":["../src/install-id.ts"],"names":[],"mappings":"AAiCA,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/install-id.js

@@ -0,0 +1,50 @@
+// Stable opaque per-machine install identifier. Persisted at ~/.muggle-ai/install-id.json.
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { INSTALL_ID_FILENAME } from "./constants/paths.js";
+import { getDataDir } from "./data-dir.js";
+let cachedInstallId;
+function installIdFilePath() {
+    return join(getDataDir(), INSTALL_ID_FILENAME);
+}
+function generateAndPersist(filePath) {
+    const installId = randomUUID();
+    const contents = { installId };
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, JSON.stringify(contents, null, 2) + "\n", "utf8");
+    return installId;
+}
+function isValid(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.installId === "string" &&
+        value.installId.length > 0);
+}
+export function getInstallId() {
+    if (cachedInstallId !== undefined)
+        return cachedInstallId;
+    const filePath = installIdFilePath();
+    if (!existsSync(filePath)) {
+        cachedInstallId = generateAndPersist(filePath);
+        return cachedInstallId;
+    }
+    try {
+        const raw = readFileSync(filePath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (isValid(parsed)) {
+            cachedInstallId = parsed.installId;
+            return cachedInstallId;
+        }
+        cachedInstallId = generateAndPersist(filePath);
+        return cachedInstallId;
+    }
+    catch {
+        cachedInstallId = generateAndPersist(filePath);
+        return cachedInstallId;
+    }
+}
+export function resetInstallIdCacheForTests() {
+    cachedInstallId = undefined;
+}
+//# sourceMappingURL=install-id.js.map

package/dist/install-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.js","sourceRoot":"","sources":["../src/install-id.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,IAAI,eAAmC,CAAC;AAExC,SAAS,iBAAiB;IACxB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,mBAAmB,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAkB,EAAE,SAAS,EAAE,CAAC;IAC9C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiC,CAAC,SAAS,KAAK,QAAQ;QAC/D,KAA+B,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC;IAE1D,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IAErC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;YACnC,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,eAAe,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,eAAe,GAAG,SAAS,CAAC;AAC9B,CAAC"}

package/dist/opt-out.d.ts

@@ -0,0 +1,3 @@
+export declare function isTelemetryEnabled(): boolean;
+export declare function setTelemetryEnabled(enabled: boolean): void;
+//# sourceMappingURL=opt-out.d.ts.map

package/dist/opt-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opt-out.d.ts","sourceRoot":"","sources":["../src/opt-out.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,IAAI,OAAO,CAK5C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE1D"}

package/dist/opt-out.js

@@ -0,0 +1,16 @@
+// Resolves whether telemetry is enabled.
+// Order: env override > preferences.json > default true.
+import { ENV_TELEMETRY_DISABLED } from "./constants/env.js";
+import { readPreferences, updatePreference } from "./preferences.js";
+export function isTelemetryEnabled() {
+    if (process.env[ENV_TELEMETRY_DISABLED] === "1")
+        return false;
+    const prefs = readPreferences();
+    if (prefs.telemetryEnabled === false)
+        return false;
+    return true;
+}
+export function setTelemetryEnabled(enabled) {
+    updatePreference("telemetryEnabled", enabled);
+}
+//# sourceMappingURL=opt-out.js.map

package/dist/opt-out.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opt-out.js","sourceRoot":"","sources":["../src/opt-out.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,yDAAyD;AAEzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,gBAAgB,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,gBAAgB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/preferences.d.ts

@@ -0,0 +1,7 @@
+import type { Preferences } from "./types/preferences.js";
+export type { Preferences } from "./types/preferences.js";
+export declare function readPreferences(): Preferences;
+export declare function writePreferences(prefs: Preferences): void;
+export declare function updatePreference<K extends keyof Preferences>(key: K, value: Preferences[K]): void;
+export declare function preferencesFileExists(): boolean;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1D,wBAAgB,eAAe,IAAI,WAAW,CAa7C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAIzD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,WAAW,EAC1D,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GACpB,IAAI,CAIN;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/dist/preferences.js

@@ -0,0 +1,39 @@
+// Reads and writes ~/.muggle-ai/preferences.json. Used by both opt-out and
+// disclosure to persist user state.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { PREFS_FILENAME } from "./constants/paths.js";
+import { getDataDir } from "./data-dir.js";
+function prefsFilePath() {
+    return join(getDataDir(), PREFS_FILENAME);
+}
+export function readPreferences() {
+    const filePath = prefsFilePath();
+    if (!existsSync(filePath))
+        return {};
+    try {
+        const raw = readFileSync(filePath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === "object" && parsed !== null) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+export function writePreferences(prefs) {
+    const filePath = prefsFilePath();
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, JSON.stringify(prefs, null, 2) + "\n", "utf8");
+}
+export function updatePreference(key, value) {
+    const prefs = readPreferences();
+    prefs[key] = value;
+    writePreferences(prefs);
+}
+export function preferencesFileExists() {
+    return existsSync(prefsFilePath());
+}
+//# sourceMappingURL=preferences.js.map

package/dist/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,oCAAoC;AAEpC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAK3C,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,OAAO,MAAqB,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IACjD,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,GAAM,EACN,KAAqB;IAErB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/release-manifest.d.ts

@@ -0,0 +1,7 @@
+import type { ReleaseManifest } from "./types/release-manifest.js";
+export { DEV_MANIFEST } from "./constants/manifest.js";
+export type { ReleaseManifest } from "./types/release-manifest.js";
+export declare function readReleaseManifest(): ReleaseManifest;
+export declare function setManifestPathForTests(path: string | undefined): void;
+export declare function resetReleaseManifestCacheForTests(): void;
+//# sourceMappingURL=release-manifest.d.ts.map

package/dist/release-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-manifest.d.ts","sourceRoot":"","sources":["../src/release-manifest.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAyBnE,wBAAgB,mBAAmB,IAAI,eAAe,CAkBrD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEtE;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}

package/dist/release-manifest.js

@@ -0,0 +1,56 @@
+// Build-time-generated manifest co-located with the built JS as a sibling
+// `release-manifest.json`. Falls back to DEV_MANIFEST when absent.
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { DEV_MANIFEST } from "./constants/manifest.js";
+import { RELEASE_MANIFEST_FILENAME } from "./constants/paths.js";
+export { DEV_MANIFEST } from "./constants/manifest.js";
+const MANIFEST_PATH = (() => {
+    try {
+        return join(dirname(fileURLToPath(import.meta.url)), RELEASE_MANIFEST_FILENAME);
+    }
+    catch {
+        return RELEASE_MANIFEST_FILENAME;
+    }
+})();
+let cachedManifest;
+let manifestPathOverride;
+function isValid(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const m = value;
+    return (typeof m.release === "string" &&
+        typeof m.buildId === "string" &&
+        typeof m.commitSha === "string" &&
+        typeof m.buildTime === "string" &&
+        typeof m.serviceName === "string");
+}
+export function readReleaseManifest() {
+    if (cachedManifest !== undefined)
+        return cachedManifest;
+    const path = manifestPathOverride ?? MANIFEST_PATH;
+    try {
+        const raw = readFileSync(path, "utf8");
+        const parsed = JSON.parse(raw);
+        cachedManifest = isValid(parsed) ? parsed : DEV_MANIFEST;
+        return cachedManifest;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code !== "ENOENT") {
+            console.warn("release-manifest: unexpected read error, using DEV fallback", {
+                error: err.message,
+            });
+        }
+        cachedManifest = DEV_MANIFEST;
+        return cachedManifest;
+    }
+}
+export function setManifestPathForTests(path) {
+    manifestPathOverride = path;
+}
+export function resetReleaseManifestCacheForTests() {
+    cachedManifest = undefined;
+}
+//# sourceMappingURL=release-manifest.js.map

package/dist/release-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-manifest.js","sourceRoot":"","sources":["../src/release-manifest.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,mEAAmE;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,yBAAyB,CAAC;IACnC,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL,IAAI,cAA2C,CAAC;AAChD,IAAI,oBAAwC,CAAC;AAE7C,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IACxD,MAAM,IAAI,GAAG,oBAAoB,IAAI,aAAa,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;QACzD,OAAO,cAAc,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,6DAA6D,EAAE;gBAC1E,KAAK,EAAG,GAAa,CAAC,OAAO;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,cAAc,GAAG,YAAY,CAAC;QAC9B,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAwB;IAC9D,oBAAoB,GAAG,IAAI,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,cAAc,GAAG,SAAS,CAAC;AAC7B,CAAC"}

package/dist/types/client.d.ts

@@ -0,0 +1,15 @@
+import type { TelemetryClient } from "applicationinsights";
+import type { ServiceName, Surface } from "./events.js";
+export interface InitOptions {
+    serviceName: ServiceName;
+    surface: Surface;
+    /** Override connection string. Falls back to env vars when omitted. */
+    connectionString?: string;
+}
+export interface ClientState {
+    client: TelemetryClient | null;
+    serviceName: ServiceName;
+    surface: Surface;
+    initialized: boolean;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":""}

package/dist/types/events.d.ts

@@ -0,0 +1,59 @@
+export type Trigger = "user-slash" | "claude-proactive" | "nested-skill";
+export type Outcome = "success" | "error" | "cancelled";
+export type ToolSurface = "local" | "remote";
+export type Surface = "mcp-local" | "mcp-remote" | "skill" | "electron";
+export type ServiceName = "muggle-mcp" | "muggle-electron" | "muggle-skill";
+export type SkillInvoked = {
+    name: "skill.invoked";
+    props: {
+        skillName: string;
+        trigger: Trigger;
+    };
+};
+export type SkillCompleted = {
+    name: "skill.completed";
+    props: {
+        skillName: string;
+        durationMs: number;
+        outcome: Outcome;
+    };
+};
+export type McpToolInvoked = {
+    name: "mcp.tool.invoked";
+    props: {
+        toolName: string;
+        toolSurface: ToolSurface;
+        correlationId: string;
+    };
+};
+export type McpToolCompleted = {
+    name: "mcp.tool.completed";
+    props: {
+        toolName: string;
+        toolSurface: ToolSurface;
+        correlationId: string;
+        durationMs: number;
+        outcome: Outcome;
+        errorCode?: string;
+    };
+};
+export type SystemStartup = {
+    name: "system.startup";
+    props: {
+        serviceName: ServiceName;
+    };
+};
+export type SystemOptOutChanged = {
+    name: "system.opt_out_changed";
+    props: {
+        from: boolean;
+        to: boolean;
+    };
+};
+export type SystemDisclosureShown = {
+    name: "system.disclosure_shown";
+    props: Record<string, never>;
+};
+export type TelemetryEvent = SkillInvoked | SkillCompleted | McpToolInvoked | McpToolCompleted | SystemStartup | SystemOptOutChanged | SystemDisclosureShown;
+export type EventName = TelemetryEvent["name"];
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;AAExE,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,WAAW,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,WAAW,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE;QACL,WAAW,EAAE,WAAW,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE;QACL,IAAI,EAAE,OAAO,CAAC;QACd,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,mBAAmB,GACnB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/types/events.js

@@ -0,0 +1,4 @@
+// Telemetry event schema. Discriminated union; each event has a stable
+// `name` and typed `props`. Adding a new event = add a member here.
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE"}

package/dist/types/install-id.d.ts

@@ -0,0 +1,4 @@
+export interface InstallIdFile {
+    installId: string;
+}
+//# sourceMappingURL=install-id.d.ts.map

package/dist/types/install-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.d.ts","sourceRoot":"","sources":["../../src/types/install-id.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/install-id.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install-id.js.map

package/dist/types/install-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.js","sourceRoot":"","sources":["../../src/types/install-id.ts"],"names":[],"mappings":""}

package/dist/types/preferences.d.ts

@@ -0,0 +1,6 @@
+export interface Preferences {
+    telemetryEnabled?: boolean;
+    disclosureShownAt?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=preferences.d.ts.map

package/dist/types/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/types/preferences.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/preferences.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preferences.js.map

package/dist/types/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/types/preferences.ts"],"names":[],"mappings":""}

package/dist/types/release-manifest.d.ts

@@ -0,0 +1,8 @@
+export interface ReleaseManifest {
+    release: string;
+    buildId: string;
+    commitSha: string;
+    buildTime: string;
+    serviceName: string;
+}
+//# sourceMappingURL=release-manifest.d.ts.map

package/dist/types/release-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-manifest.d.ts","sourceRoot":"","sources":["../../src/types/release-manifest.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/release-manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release-manifest.js.map

package/dist/types/release-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-manifest.js","sourceRoot":"","sources":["../../src/types/release-manifest.ts"],"names":[],"mappings":""}

package/dist/types/user-id.d.ts

@@ -0,0 +1,4 @@
+export interface AuthSessionFile {
+    userId?: unknown;
+}
+//# sourceMappingURL=user-id.d.ts.map

package/dist/types/user-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-id.d.ts","sourceRoot":"","sources":["../../src/types/user-id.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/user-id.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user-id.js.map

package/dist/types/user-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-id.js","sourceRoot":"","sources":["../../src/types/user-id.ts"],"names":[],"mappings":""}

package/dist/user-id.d.ts

@@ -0,0 +1,2 @@
+export declare function readUserId(): string | undefined;
+//# sourceMappingURL=user-id.d.ts.map

package/dist/user-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-id.d.ts","sourceRoot":"","sources":["../src/user-id.ts"],"names":[],"mappings":"AAUA,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAa/C"}

package/dist/user-id.js

@@ -0,0 +1,23 @@
+// Best-effort read of the opaque userId from the auth session file. Returns
+// undefined when the user is not signed in. Never throws.
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { OAUTH_SESSION_FILENAME } from "./constants/paths.js";
+import { getDataDir } from "./data-dir.js";
+export function readUserId() {
+    const filePath = join(getDataDir(), OAUTH_SESSION_FILENAME);
+    if (!existsSync(filePath))
+        return undefined;
+    try {
+        const raw = readFileSync(filePath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.userId === "string" && parsed.userId.length > 0) {
+            return parsed.userId;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=user-id.js.map

package/dist/user-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-id.js","sourceRoot":"","sources":["../src/user-id.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0DAA0D;AAE1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,sBAAsB,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAClD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@muggleai/telemetry",
+  "version": "0.2.0",
+  "description": "Shared client-side telemetry for Muggle Test (MCP, skills, Electron).",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "PRIVACY.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/multiplex-ai/muggle-ai-telemetry.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "applicationinsights": "^3.14.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "nock": "^14.0.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}