@nordsym/apiclaw 2.1.0 → 2.2.0

package/convex/nurture.ts

@@ -0,0 +1,355 @@
+import { internalMutation, mutation, query } from "./_generated/server";
+import { v } from "convex/values";
+import type { Id, Doc } from "./_generated/dataModel";
+
+/**
+ * APIClaw nurture system.
+ *
+ * Lifecycle stages:
+ *   new            — <48h since signup, no meaningful activity
+ *   activating     — some discovery/searches, no apiCalls
+ *   active         — recent apiCalls
+ *   power          — >50 calls in last 14d
+ *   dormant        — no activity 7d+
+ *   lost           — no activity 30d+
+ *   partner-locked — explicit partner workspace, NEVER nurture
+ *   excluded       — internal/test/opted-out
+ *
+ * Emails (sent via symbot-gmail webhook):
+ *   welcome       — day 0-1 after signup (stage=new)
+ *   try-discover  — day 2-3 if no searches yet (stage=new)
+ *   first-call    — day 5-7 after first search, no calls (stage=activating)
+ *   upgrade       — day 14 for active users (stage=active)
+ *   power-upgrade — power users, upsell to scale/pro
+ *   reactivate-7d — dormant workspace, soft nudge
+ *   reactivate-30d — lost workspace, last-chance nudge
+ */
+
+const DAY = 86400000;
+const HOUR = 3600000;
+
+// Permanent no-email list — partner domains, tests, disposable
+const DOMAIN_BLOCKLIST = [
+  "apilayer.com",
+  "filestack.com",
+  "nordsym.com",
+  "cqtinvest.com",
+  "apiclaw.local",        // synthetic anonymous workspaces from trafficGenerator
+  "example.com",
+  "wnbaldwy.com",         // known disposable
+];
+
+const EMAIL_BLOCKLIST = new Set<string>([
+  "pratham.kumar@apilayer.com",
+  "marketing@filestack.com",
+  "gustav@nordsym.com",
+  "symbot@nordsym.com",
+  "molle@nordsym.com",
+  "molle@cqtinvest.com",
+  "gustav_hemmingsson@hotmail.com",
+  "test@example.com",
+  "m6jgi9d8i1@wnbaldwy.com",
+  "maxence.dabrowski81@gmail.com",     // real external user — opt-out default
+  "andylopeslindao@gmail.com",
+]);
+
+function domainOf(email: string): string {
+  const at = email.lastIndexOf("@");
+  return at === -1 ? "" : email.slice(at + 1).toLowerCase();
+}
+
+function isBlocked(email: string): boolean {
+  const lower = email.toLowerCase();
+  if (EMAIL_BLOCKLIST.has(lower)) return true;
+  const dom = domainOf(lower);
+  if (DOMAIN_BLOCKLIST.includes(dom)) return true;
+  return false;
+}
+
+export const getByWorkspaceId = query({
+  args: { workspaceId: v.id("workspaces") },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("nurture")
+      .withIndex("by_workspaceId", (q) => q.eq("workspaceId", args.workspaceId))
+      .first();
+  },
+});
+
+export const list = query({
+  args: {},
+  handler: async (ctx) => {
+    return await ctx.db.query("nurture").collect();
+  },
+});
+
+export const stats = query({
+  args: {},
+  handler: async (ctx) => {
+    const all = await ctx.db.query("nurture").collect();
+    const byStage: Record<string, number> = {};
+    let totalSent = 0;
+    for (const n of all) {
+      byStage[n.stage] = (byStage[n.stage] || 0) + 1;
+      totalSent += n.emailsSent;
+    }
+    return { total: all.length, byStage, totalSent };
+  },
+});
+
+export const optOut = mutation({
+  args: { workspaceId: v.id("workspaces") },
+  handler: async (ctx, args) => {
+    const n = await ctx.db
+      .query("nurture")
+      .withIndex("by_workspaceId", (q) => q.eq("workspaceId", args.workspaceId))
+      .first();
+    if (!n) return { success: false };
+    await ctx.db.patch(n._id, { unsubscribed: true, stage: "excluded", updatedAt: Date.now() });
+    return { success: true };
+  },
+});
+
+// ═══════════════════════════════════════════════════════════════
+// CLASSIFIER — runs daily, upserts nurture row per workspace
+// ═══════════════════════════════════════════════════════════════
+export const classifyAllWorkspaces = internalMutation({
+  args: {},
+  handler: async (ctx) => {
+    const now = Date.now();
+    const workspaces = await ctx.db.query("workspaces").collect();
+
+    let upserted = 0;
+    let lockedCount = 0;
+    let excludedCount = 0;
+
+    for (const w of workspaces) {
+      const email = (w.email || "").toLowerCase();
+      const existing = await ctx.db
+        .query("nurture")
+        .withIndex("by_workspaceId", (q) => q.eq("workspaceId", w._id))
+        .first();
+
+      // Partner / excluded classification takes precedence only if email IS blocked
+      // (Missing email = anonymous workspace → stays in lifecycle, just unreachable by sender)
+      let stage: Doc<"nurture">["stage"] = "new";
+      const hasBlockedEmail = email && isBlocked(email);
+      if (hasBlockedEmail) {
+        const dom = domainOf(email);
+        stage = (dom === "apilayer.com" || dom === "filestack.com") ? "partner-locked" : "excluded";
+      } else {
+        // Compute activity
+        const ageMs = now - w.createdAt;
+        const lastActive = w.lastActiveAt || 0;
+        const inactivityMs = lastActive ? now - lastActive : ageMs;
+
+        // Calls in last 14d
+        const calls14d = await ctx.db
+          .query("apiCalls")
+          .withIndex("by_workspaceId", (q) => q.eq("workspaceId", w._id))
+          .collect();
+        const recent14dCalls = calls14d.filter((c) => now - c.timestamp < 14 * DAY).length;
+
+        // Searches ever
+        const searches = await ctx.db
+          .query("searchLogs")
+          .withIndex("by_workspaceId", (q) => q.eq("workspaceId", w._id))
+          .collect();
+        const totalSearches = searches.length;
+        const recent7dSearches = searches.filter((s) => now - s.timestamp < 7 * DAY).length;
+
+        if (inactivityMs > 30 * DAY) stage = "lost";
+        else if (inactivityMs > 7 * DAY) stage = "dormant";
+        else if (recent14dCalls >= 50) stage = "power";
+        else if (recent14dCalls > 0 || (w.usageCount || 0) > 0) stage = "active";
+        else if (totalSearches > 0 || recent7dSearches > 0) stage = "activating";
+        else stage = "new";
+      }
+
+      if (stage === "partner-locked") lockedCount++;
+      if (stage === "excluded") excludedCount++;
+
+      if (existing) {
+        // Don't demote unsubscribed users
+        if (existing.unsubscribed) {
+          await ctx.db.patch(existing._id, { updatedAt: now });
+          continue;
+        }
+        await ctx.db.patch(existing._id, {
+          stage,
+          email: email || undefined,
+          lastActivityAt: w.lastActiveAt,
+          updatedAt: now,
+        });
+      } else {
+        await ctx.db.insert("nurture", {
+          workspaceId: w._id,
+          email: email || undefined,
+          stage,
+          lastActivityAt: w.lastActiveAt,
+          emailsSent: 0,
+          unsubscribed: false,
+          createdAt: now,
+          updatedAt: now,
+        });
+        upserted++;
+      }
+    }
+
+    return {
+      workspaceCount: workspaces.length,
+      newlyTrackedCount: upserted,
+      partnerLocked: lockedCount,
+      excluded: excludedCount,
+    };
+  },
+});
+
+// ═══════════════════════════════════════════════════════════════
+// SENDER — daily cron picks up to N sendable nurture rows
+// ═══════════════════════════════════════════════════════════════
+const SYMBOT_GMAIL = "https://nordsym.app.n8n.cloud/webhook/symbot-gmail";
+
+function bodyFor(kind: string, firstName: string): { subject: string; html: string } {
+  const hi = firstName ? `Hi ${firstName},` : "Hi,";
+  const footer = `<p style="font-size:11px;color:#999;margin-top:32px;">APIClaw — The API layer for AI agents. <a href="https://apiclaw.cloud" style="color:#dc2626;">apiclaw.cloud</a></p>`;
+
+  switch (kind) {
+    case "welcome":
+      return {
+        subject: "Welcome to APIClaw — 26k APIs ready for your agents",
+        html: `<p>${hi}</p><p>Your APIClaw workspace is ready. You've got access to 26,704 discoverable APIs and 1,654 callable ones via a single endpoint.</p><p>Easiest first step: <a href="https://apiclaw.cloud/catalog">browse the catalog</a> or run <code>discover_apis</code> from your agent.</p><p>— Gustav, APIClaw</p>${footer}`,
+      };
+    case "try-discover":
+      return {
+        subject: "Try one search — see what APIClaw knows",
+        html: `<p>${hi}</p><p>Haven't tried discovery yet? One search shows you why this is worth it.</p><p>Try: <code>discover_apis("weather forecast")</code> or hit the <a href="https://apiclaw.cloud/catalog">catalog</a>. Weather, currency, flight data, PDFs, images — agents get a working API in one call.</p><p>— Gustav</p>${footer}`,
+      };
+    case "first-call":
+      return {
+        subject: "Make your first API call — takes 30 seconds",
+        html: `<p>${hi}</p><p>You've searched the catalog — next step is calling an API. No key management, no SDK integration:</p><pre style="background:#f5f5f5;padding:12px;border-radius:6px;font-size:12px;">call_api("apilayer", "weatherstack", { query: "Stockholm" })</pre><p>The <a href="https://apiclaw.cloud/docs">docs</a> have copy-paste examples.</p><p>— Gustav</p>${footer}`,
+      };
+    case "upgrade":
+      return {
+        subject: "Two weeks in — worth going Pro?",
+        html: `<p>${hi}</p><p>Your agent has been busy. Free tier is 50 calls/week — Pro is unlimited + priority routing + deeper analytics.</p><p><a href="https://apiclaw.cloud/upgrade" style="display:inline-block;background:#dc2626;color:white;padding:10px 20px;border-radius:6px;text-decoration:none;">See Pro pricing</a></p><p>— Gustav</p>${footer}`,
+      };
+    case "power-upgrade":
+      return {
+        subject: "You're a heavy user — Scale tier saves you money",
+        html: `<p>${hi}</p><p>You're making 50+ calls every two weeks. At that rate, Scale tier ($49/mo for 10k calls) beats per-call pricing.</p><p><a href="https://apiclaw.cloud/upgrade" style="display:inline-block;background:#dc2626;color:white;padding:10px 20px;border-radius:6px;text-decoration:none;">Move to Scale</a></p><p>— Gustav</p>${footer}`,
+      };
+    case "reactivate-7d":
+      return {
+        subject: "Quiet week — anything I can help unblock?",
+        html: `<p>${hi}</p><p>No calls this week. If something's broken or confusing, tell me — reply goes straight to me.</p><p>Or jump back in: <a href="https://apiclaw.cloud/catalog">apiclaw.cloud/catalog</a></p><p>— Gustav</p>${footer}`,
+      };
+    case "reactivate-30d":
+      return {
+        subject: "Still here? Free to stay free.",
+        html: `<p>${hi}</p><p>Your workspace is still live. If APIClaw isn't the right fit, no worries — reply STOP and I'll opt you out.</p><p>If it is: <a href="https://apiclaw.cloud/catalog">one search gets you back in</a>.</p><p>— Gustav</p>${footer}`,
+      };
+    default:
+      return { subject: "APIClaw update", html: `<p>${hi}</p>${footer}` };
+  }
+}
+
+async function sendEmail(to: string, subject: string, html: string): Promise<boolean> {
+  try {
+    const res = await fetch(SYMBOT_GMAIL, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ action: "send", to, subject, message: html, safeMode: true }),
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
+function pickEmailKind(n: Doc<"nurture">, wsCreatedAt: number): string | null {
+  const now = Date.now();
+  const ageMs = now - wsCreatedAt;
+  const lastEmailMs = n.lastEmailSentAt ? now - n.lastEmailSentAt : Infinity;
+
+  // Never stack emails closer than 72h except for the onboarding welcome which can follow signup quickly
+  if (lastEmailMs < 72 * HOUR && n.lastEmailKind !== null && n.lastEmailKind !== undefined) return null;
+
+  if (n.unsubscribed) return null;
+
+  if (n.stage === "partner-locked" || n.stage === "excluded") return null;
+
+  // Welcome (day 0-2)
+  if (n.emailsSent === 0 && ageMs < 2 * DAY) return "welcome";
+
+  // Try-discover (day 2-4, stage still "new")
+  if (n.stage === "new" && ageMs >= 2 * DAY && ageMs < 5 * DAY && n.lastEmailKind !== "try-discover") return "try-discover";
+
+  // First-call (stage activating, day 5-10)
+  if (n.stage === "activating" && ageMs >= 4 * DAY && n.lastEmailKind !== "first-call") return "first-call";
+
+  // Upgrade nudge (stage active, day 12+, only once)
+  if (n.stage === "active" && ageMs >= 12 * DAY && n.lastEmailKind !== "upgrade") return "upgrade";
+
+  // Power upgrade
+  if (n.stage === "power" && n.lastEmailKind !== "power-upgrade") return "power-upgrade";
+
+  // Reactivation
+  if (n.stage === "dormant" && n.lastEmailKind !== "reactivate-7d") return "reactivate-7d";
+  if (n.stage === "lost" && n.lastEmailKind !== "reactivate-30d") return "reactivate-30d";
+
+  return null;
+}
+
+export const sendDailyNurture = internalMutation({
+  args: { maxSends: v.optional(v.number()), dryRun: v.optional(v.boolean()) },
+  handler: async (ctx, args) => {
+    const cap = args.maxSends ?? 12;     // conservative daily send cap
+    const dryRun = args.dryRun ?? false;
+
+    const rows = await ctx.db.query("nurture").collect();
+    let sent = 0;
+    let considered = 0;
+    const sentLog: Array<{ email: string; kind: string }> = [];
+
+    for (const n of rows) {
+      if (sent >= cap) break;
+      if (!n.email) continue;
+      if (n.unsubscribed) continue;
+      if (n.stage === "partner-locked" || n.stage === "excluded") continue;
+      if (isBlocked(n.email)) continue;
+
+      const ws = await ctx.db.get(n.workspaceId);
+      if (!ws) continue;
+
+      const kind = pickEmailKind(n, ws.createdAt);
+      considered++;
+      if (!kind) continue;
+
+      const firstName = (n.email.split("@")[0] || "").split(/[._-]/)[0];
+      const firstNamePretty = firstName.charAt(0).toUpperCase() + firstName.slice(1);
+      const { subject, html } = bodyFor(kind, firstNamePretty);
+
+      if (dryRun) {
+        sentLog.push({ email: n.email, kind });
+        sent++;
+        continue;
+      }
+
+      const ok = await sendEmail(n.email, subject, html);
+      if (!ok) continue;
+
+      await ctx.db.patch(n._id, {
+        emailsSent: n.emailsSent + 1,
+        lastEmailSentAt: Date.now(),
+        lastEmailKind: kind,
+        updatedAt: Date.now(),
+      });
+      sentLog.push({ email: n.email, kind });
+      sent++;
+    }
+
+    return { sent, considered, capacity: cap, dryRun, sentLog };
+  },
+});

package/convex/schema.ts

@@ -426,6 +426,33 @@ export default defineSchema({
     .index("by_workspaceId", ["workspaceId"])
     .index("by_identifier", ["identifier"]),
 
+  // ============================================
+  // FUNNEL EVENTS — canonical conversion truth
+  // install -> first_run -> register_owner -> verify_code -> first_call_api_success
+  // ============================================
+  funnelEvents: defineTable({
+    event: v.string(), // one of FUNNEL_EVENTS (see convex/funnel.ts)
+    classification: v.string(), // "human" | "ci" | "bot" | "internal"
+    workspaceId: v.optional(v.id("workspaces")),
+    fingerprint: v.optional(v.string()),
+    sessionToken: v.optional(v.string()),
+    email: v.optional(v.string()),
+    userAgent: v.optional(v.string()),
+    mcpClient: v.optional(v.string()),
+    platform: v.optional(v.string()),
+    version: v.optional(v.string()),
+    dedupeKey: v.optional(v.string()), // for first-time events (install/first_run/first_call)
+    props: v.optional(v.any()),
+    timestamp: v.number(),
+  })
+    .index("by_event", ["event"])
+    .index("by_classification", ["classification"])
+    .index("by_workspaceId", ["workspaceId"])
+    .index("by_fingerprint", ["fingerprint"])
+    .index("by_dedupeKey", ["dedupeKey"])
+    .index("by_timestamp", ["timestamp"])
+    .index("by_event_timestamp", ["event", "timestamp"]),
+
   // MCP Server telemetry (anonymous usage tracking)
   telemetry: defineTable({
     type: v.string(),  // "startup", "search", "execute", "discovery"
@@ -866,4 +893,34 @@ export default defineSchema({
   })
     .index("by_partnerId", ["partnerId"])
     .index("by_status", ["status"]),
+
+  // ═══════════════════════════════════════════════════════════════
+  // NURTURE - Workspace lifecycle + email nurture state
+  // ═══════════════════════════════════════════════════════════════
+  nurture: defineTable({
+    workspaceId: v.id("workspaces"),
+    email: v.optional(v.string()),            // mirrored for easy dedupe
+    stage: v.union(
+      v.literal("new"),                       // <48h since signup, no activity yet
+      v.literal("activating"),                // seen some discovery, no calls
+      v.literal("active"),                    // has made API calls recently
+      v.literal("power"),                     // >50 calls in last 14d
+      v.literal("dormant"),                   // no activity 7d+
+      v.literal("lost"),                      // no activity 30d+
+      v.literal("partner-locked"),            // partner workspace — never nurture
+      v.literal("excluded")                   // explicit opt-out / internal / test
+    ),
+    lastActivityAt: v.optional(v.number()),
+    emailsSent: v.number(),                   // total nurture emails sent
+    lastEmailSentAt: v.optional(v.number()),
+    lastEmailKind: v.optional(v.string()),    // "welcome", "try-discover", "first-call", "upgrade", "reactivate-7d", "reactivate-30d", "power-upgrade"
+    unsubscribed: v.boolean(),
+    notes: v.optional(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("by_workspaceId", ["workspaceId"])
+    .index("by_email", ["email"])
+    .index("by_stage", ["stage"])
+    .index("by_lastActivityAt", ["lastActivityAt"]),
 });

package/dist/funnel-client.d.ts

@@ -0,0 +1,24 @@
+export type FunnelEventName = "install" | "first_run" | "register_owner" | "verify_code" | "first_call_api_success" | "register_owner_failed" | "verify_code_failed" | "call_api_blocked" | "call_api_error" | "quota_hit" | "gateway_retry";
+export type Classification = "human" | "ci" | "bot" | "internal";
+export declare function classifyLocalSource(input: {
+    userAgent?: string | null;
+    email?: string | null;
+    fingerprint?: string | null;
+    env?: NodeJS.ProcessEnv;
+}): Classification;
+export declare function hasLocalMarker(key: string): boolean;
+export declare function setLocalMarker(key: string): void;
+export interface EmitArgs {
+    event: FunnelEventName;
+    workspaceId?: string;
+    fingerprint?: string;
+    sessionToken?: string;
+    email?: string;
+    mcpClient?: string;
+    platform?: string;
+    version?: string;
+    dedupeKey?: string;
+    props?: Record<string, unknown>;
+}
+export declare function emitFunnelEvent(args: EmitArgs): void;
+//# sourceMappingURL=funnel-client.d.ts.map

package/dist/funnel-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel-client.d.ts","sourceRoot":"","sources":["../src/funnel-client.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,WAAW,GACX,gBAAgB,GAChB,aAAa,GACb,wBAAwB,GAExB,uBAAuB,GACvB,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,WAAW,GACX,eAAe,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC;AAkCjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAmBjB;AAwBD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAoCpD"}

package/dist/funnel-client.js

@@ -0,0 +1,131 @@
+/**
+ * APIClaw Funnel — client-side emitter for MCP server.
+ *
+ * Fire-and-forget POST to Convex funnel:recordEvent. Never throws, never
+ * blocks. See convex/funnel.ts for schema and classification rules.
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const CONVEX_URL = process.env.CONVEX_URL || "https://adventurous-avocet-799.convex.cloud";
+const CI_ENV_KEYS = [
+    "CI",
+    "GITHUB_ACTIONS",
+    "GITLAB_CI",
+    "CIRCLECI",
+    "BUILDKITE",
+    "JENKINS_URL",
+    "TEAMCITY_VERSION",
+    "TRAVIS",
+    "BITBUCKET_BUILD_NUMBER",
+];
+const BOT_UA_MARKERS = [
+    "bot",
+    "crawl",
+    "spider",
+    "scanner",
+    "curl/",
+    "wget/",
+    "httpclient",
+    "python-requests",
+    "go-http-client",
+    "okhttp",
+    "java/",
+    "httrack",
+    "headlesschrome",
+    "phantomjs",
+];
+const INTERNAL_EMAIL_DOMAINS = ["nordsym.com", "apiclaw.cloud"];
+const INTERNAL_EMAIL_EXACT = ["gustav@nordsym.com", "gustavnordsync@gmail.com"];
+export function classifyLocalSource(input) {
+    const email = (input.email || "").toLowerCase().trim();
+    if (email) {
+        if (INTERNAL_EMAIL_EXACT.includes(email))
+            return "internal";
+        const domain = email.split("@")[1] || "";
+        if (INTERNAL_EMAIL_DOMAINS.includes(domain))
+            return "internal";
+    }
+    const env = input.env || process.env;
+    for (const key of CI_ENV_KEYS) {
+        const val = env[key];
+        if (val && val !== "false" && val !== "0")
+            return "ci";
+    }
+    const ua = (input.userAgent || "").toLowerCase();
+    if (ua) {
+        for (const m of BOT_UA_MARKERS) {
+            if (ua.includes(m))
+                return "bot";
+        }
+    }
+    return "human";
+}
+// Persistent first-run marker stored alongside the session file.
+const MARKER_DIR = path.join(os.homedir(), ".apiclaw");
+const MARKER_FILE = path.join(MARKER_DIR, "funnel-markers.json");
+function readMarkers() {
+    try {
+        if (!fs.existsSync(MARKER_FILE))
+            return {};
+        return JSON.parse(fs.readFileSync(MARKER_FILE, "utf8")) || {};
+    }
+    catch {
+        return {};
+    }
+}
+function writeMarkers(m) {
+    try {
+        if (!fs.existsSync(MARKER_DIR))
+            fs.mkdirSync(MARKER_DIR, { mode: 0o700 });
+        fs.writeFileSync(MARKER_FILE, JSON.stringify(m), { mode: 0o600 });
+    }
+    catch {
+        /* ignore */
+    }
+}
+export function hasLocalMarker(key) {
+    return !!readMarkers()[key];
+}
+export function setLocalMarker(key) {
+    const m = readMarkers();
+    m[key] = Date.now();
+    writeMarkers(m);
+}
+export function emitFunnelEvent(args) {
+    if (process.env.APICLAW_TELEMETRY === "false")
+        return;
+    const classification = classifyLocalSource({
+        email: args.email,
+        fingerprint: args.fingerprint,
+    });
+    const payload = {
+        path: "funnel:recordEvent",
+        args: {
+            event: args.event,
+            classification,
+            workspaceId: args.workspaceId,
+            fingerprint: args.fingerprint,
+            sessionToken: args.sessionToken,
+            email: args.email,
+            userAgent: `apiclaw-mcp/${args.version || "unknown"}`,
+            mcpClient: args.mcpClient,
+            platform: args.platform || process.platform,
+            version: args.version,
+            dedupeKey: args.dedupeKey,
+            props: args.props,
+        },
+    };
+    // Fire and forget.
+    try {
+        fetch(`${CONVEX_URL}/api/mutation`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+        }).catch(() => { });
+    }
+    catch {
+        /* ignore */
+    }
+}
+//# sourceMappingURL=funnel-client.js.map

package/dist/funnel-client.js.map

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

package/dist/funnel.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=funnel.test.d.ts.map

package/dist/funnel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.test.d.ts","sourceRoot":"","sources":["../src/funnel.test.ts"],"names":[],"mappings":""}