@1mcp/agent 0.40.0-beta.0 → 0.40.0-beta.2

package/build/productTelemetry/delivery.js

@@ -0,0 +1,142 @@
+import { pathToFileURL } from 'node:url';
+import { Worker } from 'node:worker_threads';
+import { createRequire } from 'node:module';
+const COLLECTOR = 'https://ingest.1mcp.app/v1/summaries';
+const MAX_ACTIVE = 2;
+const active = new Map();
+// SEA embeds compatibility modules; npm runtimes resolve their installed dependencies.
+const SEND_ONCE = `
+const { workerData, parentPort } = require('node:worker_threads');
+(async () => {
+const url = new URL(workerData.endpoint);
+if (url.protocol !== 'https:' && url.protocol !== 'http:') throw new Error('unsupported');
+let address = url;
+let transport = require(url.protocol === 'https:' ? 'node:https' : 'node:http');
+const options = { method: 'POST', headers: { 'content-type': 'application/json' } };
+let agent;
+if (workerData.proxyModules) {
+  const { getProxyForUrl } = await import(workerData.proxyModules.environment);
+  const proxy = getProxyForUrl(url.href);
+  if (proxy) {
+    const parsed = new URL(proxy);
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') throw new Error('unsupported_proxy');
+    if (url.protocol === 'https:') {
+      const { HttpsProxyAgent } = await import(workerData.proxyModules.https);
+      agent = new HttpsProxyAgent(parsed);
+    } else {
+      address = parsed;
+      transport = require(parsed.protocol === 'https:' ? 'node:https' : 'node:http');
+      options.path = url.href;
+      options.headers.host = url.host;
+      if (parsed.username || parsed.password) {
+        const credentials = decodeURIComponent(parsed.username) + ':' + decodeURIComponent(parsed.password);
+        options.headers['proxy-authorization'] = 'Basic ' + Buffer.from(credentials).toString('base64');
+        parsed.username = '';
+        parsed.password = '';
+      }
+    }
+  }
+  agent ??= new transport.Agent({ keepAlive: false });
+} else {
+  agent = new transport.Agent({ keepAlive: false, proxyEnv: process.env });
+}
+const request = transport.request(address, { ...options, agent });
+const close = () => { request.destroy(); agent.destroy(); parentPort.close(); };
+request.on('error', close);
+request.on('response', response => {
+  response.resume();
+  response.on('end', close);
+  response.on('error', close);
+});
+request.on('socket', socket => {
+  const ready = () => parentPort.postMessage('ready');
+  if (socket.encrypted && socket.secureConnecting) socket.once('secureConnect', ready);
+  else if (socket.connecting) socket.once('connect', ready);
+  else ready();
+});
+parentPort.once('message', body => {
+  request.setHeader('content-length', Buffer.byteLength(body));
+  request.end(body);
+});
+})().catch(() => { parentPort.close(); process.exitCode = 1; });
+`;
+/** Connect without a payload or a durable claim. Preparation cannot retain the foreground process. */
+export function prepareProductDelivery(endpoint = COLLECTOR) {
+    if (active.size >= MAX_ACTIVE)
+        return Promise.resolve(undefined);
+    return new Promise((resolve) => {
+        const [major, minor] = process.versions.node.split('.').map(Number);
+        const nativeProxy = major >= 25 || (major === 24 && minor >= 5) || (major === 22 && minor >= 21);
+        let proxyModules;
+        if (!nativeProxy) {
+            const embedded = globalThis
+                .__1MCP_TELEMETRY_PROXY_MODULE__;
+            if (embedded) {
+                proxyModules = { environment: embedded, https: embedded };
+            }
+            else {
+                const resolver = createRequire(import.meta.url);
+                proxyModules = {
+                    environment: pathToFileURL(resolver.resolve('proxy-from-env')).href,
+                    https: pathToFileURL(resolver.resolve('https-proxy-agent')).href,
+                };
+            }
+        }
+        const worker = new Worker(SEND_ONCE, {
+            eval: true,
+            execArgv: [],
+            // Proxy libraries and native HTTP diagnostics must never print credentials or payloads.
+            env: { ...process.env, DEBUG: '', NODE_DEBUG: '', NODE_DEBUG_NATIVE: '' },
+            workerData: { endpoint, proxyModules },
+            name: 'product-usage-delivery',
+        });
+        let ready = false;
+        let cancelled = false;
+        const cancel = () => {
+            cancelled = true;
+            ready = false;
+            void worker.terminate().catch(() => { });
+            resolve(undefined);
+        };
+        active.set(worker, cancel);
+        const deadline = setTimeout(cancel, 10_000);
+        deadline.unref();
+        worker.on('error', cancel);
+        worker.once('message', (message) => {
+            if (message !== 'ready')
+                return;
+            if (cancelled)
+                return;
+            ready = true;
+            resolve({
+                isReady: () => ready,
+                cancel,
+                dispatch: (body) => {
+                    if (!ready)
+                        return;
+                    ready = false;
+                    worker.postMessage(body);
+                },
+            });
+        });
+        worker.once('exit', () => {
+            ready = false;
+            active.delete(worker);
+            clearTimeout(deadline);
+            resolve(undefined);
+        });
+        worker.unref();
+    });
+}
+/** Adapter for explicit serialized fixtures; live producers prepare before their final durable claim. */
+export function dispatchProductBatch(body, endpoint = COLLECTOR) {
+    void prepareProductDelivery(endpoint)
+        .then((delivery) => delivery?.dispatch(body))
+        .catch(() => { });
+}
+/** Best effort: bytes already transmitted cannot be recalled. */
+export function abortProductDelivery() {
+    for (const cancel of active.values())
+        cancel();
+}
+//# sourceMappingURL=delivery.js.map

package/build/productTelemetry/delivery.js.map

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

package/build/productTelemetry/index.d.ts

@@ -0,0 +1,15 @@
+import { InstallationStore } from './installationStore.js';
+import { type CommandCompletion, type CommandName, type FeatureName, type OperationName } from './producer.js';
+export { PRODUCT_NOTICE } from './notice.js';
+export declare function localInstallationStore(background?: boolean): InstallationStore;
+export declare function beginProductCommand(name: CommandName): CommandCompletion;
+export declare function beginProductFeature(name: FeatureName): CommandCompletion;
+export declare function recordProductFeature(name: FeatureName, outcome: 'success' | 'failure'): void;
+export declare function beginProductOperation(name: OperationName, transport: 'none' | 'stdio' | 'http' | 'sse', client: 'none' | 'claude' | 'codex' | 'cursor' | 'vscode' | 'other'): CommandCompletion;
+export declare function recordProductOperation(name: OperationName, outcome: 'success' | 'failure', transport: 'none' | 'stdio' | 'http' | 'sse', client: 'none' | 'claude' | 'codex' | 'cursor' | 'vscode' | 'other'): void;
+export declare function observeProductRuntimeConfiguration(name: 'servers' | 'tools', count: number): void;
+/** Snapshot only: attaches finite buckets to the next genuine activity. */
+export declare function observeProductConfiguration(name: 'servers' | 'tools', count: number): void;
+/** One invocation owns readiness/failure/cancellation; shutdown creates no outcome. */
+export declare function beginProductStartup(name: 'serve' | 'proxy' | 'runtime_start'): CommandCompletion;
+//# sourceMappingURL=index.d.ts.map

package/build/productTelemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/productTelemetry/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAEnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,sBAAsB,CAAC,UAAU,UAAQ,GAAG,iBAAiB,CAK5E;AA4BD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAExE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAExE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAE5F;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,EAC5C,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAClE,iBAAiB,CAEnB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,EAC5C,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAClE,IAAI,CAEN;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjG;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE1F;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,eAAe,GAAG,iBAAiB,CAyBhG"}

package/build/productTelemetry/index.js

@@ -0,0 +1,118 @@
+import path from 'node:path';
+import { getProductCollectionPolicy, initializeProductTelemetry, productCollectionEnabled, } from '../config/productTelemetryBootstrap.js';
+import { MCP_SERVER_VERSION } from '../constants.js';
+import { getGlobalConfigDir } from '../constants/paths.js';
+import { abortProductDelivery, dispatchProductBatch, prepareProductDelivery } from './delivery.js';
+import { InstallationStore } from './installationStore.js';
+import { writeProductNotice } from './notice.js';
+import { ProductUsageProducer, } from './producer.js';
+let producer;
+export { PRODUCT_NOTICE } from './notice.js';
+export function localInstallationStore(background = false) {
+    return new InstallationStore(path.join(getGlobalConfigDir(), 'product-telemetry'), {
+        background,
+        notice: writeProductNotice,
+    });
+}
+function collection() {
+    if (!productCollectionEnabled())
+        return;
+    try {
+        return initializeProductTelemetry(() => {
+            const policy = getProductCollectionPolicy();
+            producer ??= new ProductUsageProducer({
+                store: localInstallationStore(true),
+                now: Date.now,
+                dispatch: dispatchProductBatch,
+                prepareDelivery: prepareProductDelivery,
+                abortDelivery: abortProductDelivery,
+                dimensions: {
+                    version: MCP_SERVER_VERSION,
+                    os: platform(),
+                    arch: architecture(),
+                    node_major: Number(process.versions.node.split('.')[0]),
+                    ci: policy.ci,
+                },
+            });
+            return producer;
+        });
+    }
+    catch {
+        return;
+    }
+}
+export function beginProductCommand(name) {
+    return collection()?.beginCommand(name) ?? { finish: () => { } };
+}
+export function beginProductFeature(name) {
+    return collection()?.beginFeature(name) ?? { finish: () => { } };
+}
+export function recordProductFeature(name, outcome) {
+    collection()?.recordFeature(name, outcome);
+}
+export function beginProductOperation(name, transport, client) {
+    return collection()?.beginOperation(name, transport, client) ?? { finish: () => { } };
+}
+export function recordProductOperation(name, outcome, transport, client) {
+    collection()?.recordOperation(name, outcome, transport, client);
+}
+export function observeProductRuntimeConfiguration(name, count) {
+    producer?.observeRuntimeConfiguration(name, count);
+}
+/** Snapshot only: attaches finite buckets to the next genuine activity. */
+export function observeProductConfiguration(name, count) {
+    producer?.observeConfiguration(name, count);
+}
+/** One invocation owns readiness/failure/cancellation; shutdown creates no outcome. */
+export function beginProductStartup(name) {
+    const runtime = collection();
+    if (!runtime)
+        return { finish: () => { } };
+    runtime.startRuntime();
+    const command = name === 'runtime_start' ? runtime.beginRuntimeStartup() : runtime.beginCommand(name);
+    let finished = false;
+    const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+    const handlers = signals.map((signal) => {
+        const handler = () => {
+            completion.finish('failure');
+            // Preserve the default signal action when no lifecycle owner installed a handler yet.
+            if (process.listenerCount(signal) === 0)
+                process.kill(process.pid, signal);
+        };
+        process.prependOnceListener(signal, handler);
+        return handler;
+    });
+    const completion = {
+        finish(outcome) {
+            if (finished)
+                return;
+            finished = true;
+            signals.forEach((signal, index) => process.removeListener(signal, handlers[index]));
+            command.finish(outcome);
+        },
+    };
+    return completion;
+}
+function platform() {
+    switch (process.platform) {
+        case 'linux':
+        case 'darwin':
+        case 'win32':
+        case 'freebsd':
+            return process.platform;
+        default:
+            return 'other';
+    }
+}
+function architecture() {
+    switch (process.arch) {
+        case 'x64':
+        case 'arm64':
+        case 'arm':
+        case 'ia32':
+            return process.arch;
+        default:
+            return 'other';
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/productTelemetry/index.js.map

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

package/build/productTelemetry/installationStore.d.ts

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import { type Summary } from './contract.js';
+declare const stateSchema: z.ZodObject<{
+    format: z.ZodLiteral<1>;
+    epoch: z.ZodUUID;
+    generation: z.ZodNumber;
+    preference: z.ZodEnum<{
+        default: "default";
+        disabled: "disabled";
+        enabled: "enabled";
+    }>;
+    installationId: z.ZodOptional<z.ZodUUID>;
+    noticed: z.ZodBoolean;
+    queue: z.ZodArray<z.ZodObject<{
+        installation_id: z.ZodUUID;
+        occurred_at: z.ZodISODateTime;
+        version: z.ZodString;
+        os: z.ZodEnum<{
+            darwin: "darwin";
+            freebsd: "freebsd";
+            linux: "linux";
+            win32: "win32";
+            other: "other";
+        }>;
+        arch: z.ZodEnum<{
+            other: "other";
+            x64: "x64";
+            arm64: "arm64";
+            arm: "arm";
+            ia32: "ia32";
+        }>;
+        node_major: z.ZodNumber;
+        ci: z.ZodBoolean;
+        counters: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                command: "command";
+                configuration: "configuration";
+                feature: "feature";
+                operation: "operation";
+            }>;
+            name: z.ZodString;
+            outcome: z.ZodEnum<{
+                failure: "failure";
+                success: "success";
+                observation: "observation";
+            }>;
+            transport: z.ZodEnum<{
+                http: "http";
+                sse: "sse";
+                stdio: "stdio";
+                none: "none";
+            }>;
+            client: z.ZodEnum<{
+                other: "other";
+                none: "none";
+                claude: "claude";
+                codex: "codex";
+                cursor: "cursor";
+                vscode: "vscode";
+            }>;
+            bucket: z.ZodEnum<{
+                1: "1";
+                0: "0";
+                none: "none";
+                "2-5": "2-5";
+                "6-20": "6-20";
+                "21-100": "21-100";
+                "101+": "101+";
+            }>;
+            count: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type State = z.infer<typeof stateSchema>;
+export interface PreparedDelivery {
+    dispatch(body: string): void;
+    cancel(): void;
+    isReady(): boolean;
+}
+export type PrepareDelivery = () => Promise<PreparedDelivery | undefined>;
+export interface AdmissionTicket {
+    readonly epoch: string;
+    readonly generation: number;
+    readonly installationId: string;
+}
+export interface InstallationStatus {
+    preference: State['preference'];
+    identityPresent: boolean;
+    queuedSummaries: number;
+    coordination: 'available' | 'busy-or-ambiguous';
+    recovery: 'not-needed' | 'wait' | 'automatic' | 'offline-required';
+}
+export declare class InstallationStore {
+    private readonly root;
+    private readonly options;
+    constructor(root: string, options: {
+        notice: () => void | Promise<void>;
+        now?: () => number;
+        background?: boolean;
+    });
+    status(): Promise<InstallationStatus>;
+    control(action: 'enable' | 'disable' | 'reset'): Promise<void>;
+    admit(): Promise<AdmissionTicket | undefined>;
+    /** Read-only live-control observation; never creates an identity or admits activity. */
+    isCurrent(ticket: AdmissionTicket): Promise<boolean>;
+    append(ticket: AdmissionTicket, facts: Omit<Summary, 'installation_id'>): Promise<boolean>;
+    /** A durable final claim precedes payload handoff, within the generation lock. Prepare outside that lock. */
+    attemptSend(ticket: AdmissionTicket, dispatch: (body: string) => void | Promise<void>, prepare?: PrepareDelivery): Promise<void>;
+    private now;
+    private checkRoot;
+    private read;
+    private commit;
+    private cleanOrphanedWrites;
+    /** Legacy producers still share this guard; only verified dead owners may be recovered. */
+    private transaction;
+}
+export {};
+//# sourceMappingURL=installationStore.d.ts.map

package/build/productTelemetry/installationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installationStore.d.ts","sourceRoot":"","sources":["../../src/productTelemetry/installationStore.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAiC,KAAK,OAAO,EAAiB,MAAM,eAAe,CAAC;AAK3F,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQf,CAAC;AACH,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,OAAO,CAAC;CACpB;AACD,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AACD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,WAAW,GAAG,mBAAmB,CAAC;IAChD,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,kBAAkB,CAAC;CACpE;AAUD,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAGtG,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAarC,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D,KAAK,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAcnD,wFAAwF;IAClF,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAyChG,6GAA6G;IACvG,WAAW,CACf,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAChD,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;IAgDhB,OAAO,CAAC,GAAG;YAIG,SAAS;YAaT,IAAI;YAqBJ,MAAM;YA0BN,mBAAmB;IAWjC,2FAA2F;YAC7E,WAAW;CA+C1B"}