agentcheck-sdk 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { AgentToolChecker } from "./langchain";
 export { DelegationDashboard } from "./dashboard";
 export { quickStart } from "./quickstart";
 export { templates } from "./templates";
+export { TelemetryPlugin } from "./telemetry";
 export type { WebhookEvent } from "./webhook";
 export type { ScopeVerifier, DelegationProviderConfig } from "./provider";
 export type { GuardConfig } from "./guard";

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RateLimitError = exports.ValidationError = exports.NotFoundError = exports.AuthenticationError = exports.AgentCheckError = exports.templates = exports.quickStart = exports.DelegationDashboard = exports.AgentToolChecker = exports.delegationGuard = exports.DelegationProvider = exports.WebhookHandler = exports.AgentCheckClient = void 0;
+exports.RateLimitError = exports.ValidationError = exports.NotFoundError = exports.AuthenticationError = exports.AgentCheckError = exports.TelemetryPlugin = exports.templates = exports.quickStart = exports.DelegationDashboard = exports.AgentToolChecker = exports.delegationGuard = exports.DelegationProvider = exports.WebhookHandler = exports.AgentCheckClient = void 0;
 // Individual commands (basic menu)
 var client_1 = require("./client");
 Object.defineProperty(exports, "AgentCheckClient", { enumerable: true, get: function () { return client_1.AgentCheckClient; } });
@@ -19,6 +19,8 @@ var quickstart_1 = require("./quickstart");
 Object.defineProperty(exports, "quickStart", { enumerable: true, get: function () { return quickstart_1.quickStart; } });
 var templates_1 = require("./templates");
 Object.defineProperty(exports, "templates", { enumerable: true, get: function () { return templates_1.templates; } });
+var telemetry_1 = require("./telemetry");
+Object.defineProperty(exports, "TelemetryPlugin", { enumerable: true, get: function () { return telemetry_1.TelemetryPlugin; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AgentCheckError", { enumerable: true, get: function () { return errors_1.AgentCheckError; } });
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });

package/dist/telemetry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Telemetry Plugin - Opt-in usage tracking.
+ *
+ * NOT enabled by default. You must explicitly enable it.
+ *
+ * What it tracks:
+ * - Which SDK features are used (record, list, revoke, etc.)
+ * - SDK language and version
+ * - Agent names (for your own analytics)
+ *
+ * What it does NOT track:
+ * - Scope content, email addresses, API keys, payloads
+ */
+export declare class TelemetryPlugin {
+    private static instance;
+    private apiKey;
+    private baseUrl;
+    private buffer;
+    private enabled;
+    private timer;
+    private flushInterval;
+    constructor(apiKey: string, baseUrl?: string, flushInterval?: number);
+    /** Start collecting telemetry (opt-in). */
+    enable(): void;
+    /** Stop collecting telemetry. */
+    disable(): void;
+    /** Record a telemetry event (no-op if not enabled). */
+    static track(event: string, feature?: string, agentName?: string, metadata?: Record<string, unknown>): void;
+    private flush;
+}

package/dist/telemetry.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Telemetry Plugin - Opt-in usage tracking.
+ *
+ * NOT enabled by default. You must explicitly enable it.
+ *
+ * What it tracks:
+ * - Which SDK features are used (record, list, revoke, etc.)
+ * - SDK language and version
+ * - Agent names (for your own analytics)
+ *
+ * What it does NOT track:
+ * - Scope content, email addresses, API keys, payloads
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryPlugin = void 0;
+class TelemetryPlugin {
+    constructor(apiKey, baseUrl = "https://agentcheck.spaceplanning.work", flushInterval = 60000) {
+        this.buffer = [];
+        this.enabled = false;
+        this.timer = null;
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.flushInterval = flushInterval;
+    }
+    /** Start collecting telemetry (opt-in). */
+    enable() {
+        this.enabled = true;
+        TelemetryPlugin.instance = this;
+        this.timer = setInterval(() => this.flush(), this.flushInterval);
+    }
+    /** Stop collecting telemetry. */
+    disable() {
+        this.enabled = false;
+        TelemetryPlugin.instance = null;
+        if (this.timer)
+            clearInterval(this.timer);
+        this.flush();
+    }
+    /** Record a telemetry event (no-op if not enabled). */
+    static track(event, feature, agentName, metadata) {
+        const instance = TelemetryPlugin.instance;
+        if (!instance || !instance.enabled)
+            return;
+        instance.buffer.push({
+            event,
+            sdk_language: "typescript",
+            sdk_version: "0.4.0",
+            feature,
+            agent_name: agentName,
+            metadata,
+        });
+        if (instance.buffer.length >= 50) {
+            instance.flush();
+        }
+    }
+    async flush() {
+        if (!this.buffer.length)
+            return;
+        const events = [...this.buffer];
+        this.buffer = [];
+        try {
+            await fetch(`${this.baseUrl}/api/v1/telemetry`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-API-Key": this.apiKey,
+                },
+                body: JSON.stringify({ events }),
+            });
+        }
+        catch {
+            // Telemetry should never break the app
+        }
+    }
+}
+exports.TelemetryPlugin = TelemetryPlugin;
+TelemetryPlugin.instance = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcheck-sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Record what your AI agent is allowed to do",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",