@unclick/mcp-server 0.2.4 → 0.3.0

package/dist/memory/supabase.js

@@ -0,0 +1,209 @@
+/**
+ * Supabase backend for UnClick Memory.
+ *
+ * Cloud mode: data lives in the user's own Supabase project (BYOD).
+ * Requires SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY env vars.
+ */
+import { createClient } from "@supabase/supabase-js";
+let client = null;
+function getSupabase() {
+    if (client)
+        return client;
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY;
+    if (!url || !key) {
+        throw new Error("Missing SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY (or SUPABASE_ANON_KEY) environment variables. " +
+            "Set these in your MCP config's env block.");
+    }
+    client = createClient(url, key, {
+        auth: { persistSession: false, autoRefreshToken: false },
+    });
+    return client;
+}
+async function rpc(fn, params = {}) {
+    const sb = getSupabase();
+    const { data, error } = await sb.rpc(fn, params);
+    if (error)
+        throw new Error(`rpc(${fn}) failed: ${error.message}`);
+    return data;
+}
+function now() {
+    return new Date().toISOString();
+}
+function truncate(s, max = 8000) {
+    return s.length > max ? s.slice(0, max) + "\n...[truncated]" : s;
+}
+export class SupabaseBackend {
+    constructor() {
+        // Verify connection on creation
+        getSupabase();
+        console.error("UnClick Memory: Supabase cloud mode");
+    }
+    async getStartupContext(numSessions) {
+        return rpc("get_startup_context", { num_sessions: numSessions });
+    }
+    async searchMemory(query, maxResults) {
+        return rpc("search_memory", { search_query: query, max_results: maxResults });
+    }
+    async searchFacts(query) {
+        return rpc("search_facts", { search_query: query });
+    }
+    async searchLibrary(query) {
+        return rpc("search_library", { search_query: query });
+    }
+    async getLibraryDoc(slug) {
+        return rpc("get_library_doc", { doc_slug: slug });
+    }
+    async listLibrary() {
+        return rpc("list_library");
+    }
+    async writeSessionSummary(data) {
+        const sb = getSupabase();
+        const { data: row, error } = await sb.from("session_summaries").insert({
+            session_id: data.session_id,
+            summary: data.summary,
+            topics: data.topics,
+            open_loops: data.open_loops,
+            decisions: data.decisions,
+            platform: data.platform,
+            duration_minutes: data.duration_minutes,
+        }).select().single();
+        if (error)
+            throw error;
+        return { id: row.id };
+    }
+    async addFact(data) {
+        const sb = getSupabase();
+        const { data: row, error } = await sb.from("extracted_facts").insert({
+            fact: data.fact,
+            category: data.category,
+            confidence: data.confidence,
+            source_session_id: data.source_session_id ?? null,
+            source_type: "manual",
+            status: "active",
+            decay_tier: "hot",
+            last_accessed: now(),
+        }).select().single();
+        if (error)
+            throw error;
+        return { id: row.id };
+    }
+    async supersedeFact(oldId, newText, category, confidence) {
+        const params = { old_fact_id: oldId, new_fact_text: newText };
+        if (category !== undefined)
+            params.new_category = category;
+        if (confidence !== undefined)
+            params.new_confidence = confidence;
+        const data = await rpc("supersede_fact", params);
+        return String(data);
+    }
+    async logConversation(data) {
+        const sb = getSupabase();
+        const { error } = await sb.from("conversation_log").insert({
+            session_id: data.session_id,
+            role: data.role,
+            content: truncate(data.content),
+            has_code: data.has_code,
+        });
+        if (error)
+            throw error;
+    }
+    async getConversationDetail(sessionId) {
+        return rpc("get_conversation_detail", { sid: sessionId });
+    }
+    async storeCode(data) {
+        const sb = getSupabase();
+        const { data: row, error } = await sb.from("code_dumps").insert({
+            session_id: data.session_id,
+            language: data.language,
+            filename: data.filename ?? null,
+            content: truncate(data.content, 50000),
+            description: data.description ?? null,
+        }).select().single();
+        if (error)
+            throw error;
+        return { id: row.id };
+    }
+    async getBusinessContext() {
+        const sb = getSupabase();
+        const { data, error } = await sb.from("business_context").select("*").order("category").order("key");
+        if (error)
+            throw error;
+        return data ?? [];
+    }
+    async setBusinessContext(category, key, value, priority) {
+        const sb = getSupabase();
+        const row = {
+            category,
+            key,
+            value: typeof value === "string" ? (() => { try {
+                return JSON.parse(value);
+            }
+            catch {
+                return value;
+            } })() : value,
+            last_accessed: now(),
+            decay_tier: "hot",
+        };
+        if (priority !== undefined)
+            row.priority = priority;
+        const { error } = await sb.from("business_context")
+            .upsert(row, { onConflict: "category,key" })
+            .select().single();
+        if (error)
+            throw error;
+    }
+    async upsertLibraryDoc(data) {
+        const sb = getSupabase();
+        const { data: existing } = await sb.from("knowledge_library")
+            .select("id, version").eq("slug", data.slug).single();
+        if (existing) {
+            // DB trigger auto-archives old content and bumps version
+            const { error } = await sb.from("knowledge_library").update({
+                title: data.title,
+                category: data.category,
+                content: data.content,
+                tags: data.tags,
+                last_accessed: now(),
+                decay_tier: "hot",
+            }).eq("id", existing.id);
+            if (error)
+                throw error;
+            return `Library doc updated: "${data.title}" (v${existing.version + 1})`;
+        }
+        else {
+            const { error } = await sb.from("knowledge_library").insert({
+                slug: data.slug,
+                title: data.title,
+                category: data.category,
+                content: data.content,
+                tags: data.tags,
+                version: 1,
+                decay_tier: "hot",
+                last_accessed: now(),
+            });
+            if (error)
+                throw error;
+            return `Library doc created: "${data.title}" (v1)`;
+        }
+    }
+    async manageDecay() {
+        return rpc("manage_decay");
+    }
+    async getMemoryStatus() {
+        const sb = getSupabase();
+        const tables = ["business_context", "knowledge_library", "session_summaries", "extracted_facts", "conversation_log", "code_dumps"];
+        const counts = {};
+        for (const table of tables) {
+            const { count } = await sb.from(table).select("*", { count: "exact", head: true });
+            counts[table] = count;
+        }
+        const { data: factTiers } = await sb.from("extracted_facts").select("decay_tier").eq("status", "active");
+        const tiers = { hot: 0, warm: 0, cold: 0 };
+        for (const row of factTiers ?? []) {
+            tiers[row.decay_tier]++;
+        }
+        return { mode: "supabase", table_counts: counts, fact_decay_tiers: tiers };
+    }
+}
+//# sourceMappingURL=supabase.js.map

package/dist/memory/supabase.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Shared types for UnClick Memory backends (local + Supabase).
+ */
+export interface SessionSummaryInput {
+    session_id: string;
+    summary: string;
+    topics: string[];
+    open_loops: string[];
+    decisions: string[];
+    platform: string;
+    duration_minutes?: number;
+}
+export interface FactInput {
+    fact: string;
+    category: string;
+    confidence: number;
+    source_session_id?: string;
+}
+export interface ConversationInput {
+    session_id: string;
+    role: string;
+    content: string;
+    has_code: boolean;
+}
+export interface CodeInput {
+    session_id: string;
+    language: string;
+    filename?: string;
+    content: string;
+    description?: string;
+}
+export interface LibraryDocInput {
+    slug: string;
+    title: string;
+    category: string;
+    content: string;
+    tags: string[];
+}
+export interface MemoryBackend {
+    /** Load startup context (business context + recent sessions + hot facts). */
+    getStartupContext(numSessions: number): Promise<unknown>;
+    /** Full-text search across conversation logs. */
+    searchMemory(query: string, maxResults: number): Promise<unknown>;
+    /** Search extracted facts. */
+    searchFacts(query: string): Promise<unknown>;
+    /** Search knowledge library. */
+    searchLibrary(query: string): Promise<unknown>;
+    /** Get a specific library doc by slug. */
+    getLibraryDoc(slug: string): Promise<unknown>;
+    /** List all library documents. */
+    listLibrary(): Promise<unknown>;
+    /** Write end-of-session summary. */
+    writeSessionSummary(data: SessionSummaryInput): Promise<{
+        id: string;
+    }>;
+    /** Add an extracted fact. */
+    addFact(data: FactInput): Promise<{
+        id: string;
+    }>;
+    /** Replace a fact with a new version. */
+    supersedeFact(oldId: string, newText: string, category?: string, confidence?: number): Promise<string>;
+    /** Log a conversation message. */
+    logConversation(data: ConversationInput): Promise<void>;
+    /** Get full conversation log for a session. */
+    getConversationDetail(sessionId: string): Promise<unknown>;
+    /** Store a code block. */
+    storeCode(data: CodeInput): Promise<{
+        id: string;
+    }>;
+    /** Get all business context entries. */
+    getBusinessContext(): Promise<unknown[]>;
+    /** Set or update a business context entry. */
+    setBusinessContext(category: string, key: string, value: unknown, priority?: number): Promise<void>;
+    /** Create or update a knowledge library doc. */
+    upsertLibraryDoc(data: LibraryDocInput): Promise<string>;
+    /** Run memory decay management. */
+    manageDecay(): Promise<unknown>;
+    /** Get memory usage stats. */
+    getMemoryStatus(): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/memory/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for UnClick Memory backends (local + Supabase).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

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

package/dist/mistral-tool.d.ts

@@ -0,0 +1,4 @@
+export declare function mistralChatCompletion(args: Record<string, unknown>): Promise<unknown>;
+export declare function mistralListModels(args: Record<string, unknown>): Promise<unknown>;
+export declare function mistralCreateEmbedding(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=mistral-tool.d.ts.map

package/dist/mistral-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral-tool.d.ts","sourceRoot":"","sources":["../src/mistral-tool.ts"],"names":[],"mappings":"AA+FA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA4C3F;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBvF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA8B5F"}

package/dist/mistral-tool.js

@@ -0,0 +1,145 @@
+// Mistral AI API integration for the UnClick MCP server.
+// Uses the Mistral REST API via fetch - no external dependencies.
+// Users must supply an API key from console.mistral.ai.
+const MISTRAL_API_BASE = "https://api.mistral.ai/v1";
+// --- Auth validation ---------------------------------------------------------
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at console.mistral.ai.");
+    return key;
+}
+// --- API helpers -------------------------------------------------------------
+async function mistralPost(apiKey, path, body) {
+    const res = await fetch(`${MISTRAL_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`Mistral error: ${msg}`);
+    }
+    return data;
+}
+async function mistralGet(apiKey, path) {
+    const res = await fetch(`${MISTRAL_API_BASE}${path}`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`Mistral error: ${msg}`);
+    }
+    return data;
+}
+// --- Operations --------------------------------------------------------------
+export async function mistralChatCompletion(args) {
+    try {
+        const apiKey = requireKey(args);
+        const model = String(args.model ?? "mistral-small-latest");
+        // Parse messages
+        let messages;
+        if (Array.isArray(args.messages)) {
+            messages = args.messages;
+        }
+        else if (typeof args.messages === "string") {
+            try {
+                messages = JSON.parse(args.messages);
+            }
+            catch {
+                throw new Error("messages must be a JSON array of {role, content} objects.");
+            }
+        }
+        else if (args.prompt) {
+            const systemPrompt = args.system_prompt ? String(args.system_prompt) : undefined;
+            messages = [];
+            if (systemPrompt)
+                messages.push({ role: "system", content: systemPrompt });
+            messages.push({ role: "user", content: String(args.prompt) });
+        }
+        else {
+            throw new Error("Either messages (array) or prompt (string) is required.");
+        }
+        if (messages.length === 0)
+            throw new Error("messages array must not be empty.");
+        const body = { model, messages, stream: false };
+        if (args.max_tokens)
+            body.max_tokens = Number(args.max_tokens);
+        if (args.temperature !== undefined)
+            body.temperature = Number(args.temperature);
+        if (args.top_p !== undefined)
+            body.top_p = Number(args.top_p);
+        const result = await mistralPost(apiKey, "/chat/completions", body);
+        return {
+            id: result.id,
+            model: result.model,
+            created: new Date(result.created * 1000).toISOString(),
+            message: result.choices[0]?.message.content ?? null,
+            finish_reason: result.choices[0]?.finish_reason ?? null,
+            choices: result.choices.map((c) => ({
+                content: c.message.content,
+                finish_reason: c.finish_reason,
+            })),
+            usage: result.usage,
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function mistralListModels(args) {
+    try {
+        const apiKey = requireKey(args);
+        const data = await mistralGet(apiKey, "/models");
+        const models = data.data ?? [];
+        return {
+            count: models.length,
+            models: models.map((m) => ({
+                id: m.id,
+                owned_by: m.owned_by,
+                created: m.created ? new Date(m.created * 1000).toISOString() : null,
+                capabilities: m.capabilities ?? null,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function mistralCreateEmbedding(args) {
+    try {
+        const apiKey = requireKey(args);
+        const model = String(args.model ?? "mistral-embed");
+        const encodingFormat = String(args.encoding_format ?? "float");
+        let input;
+        if (typeof args.input === "string") {
+            input = args.input;
+        }
+        else if (Array.isArray(args.input)) {
+            input = args.input;
+        }
+        else {
+            throw new Error("input is required (a string or array of strings to embed).");
+        }
+        const body = { model, input, encoding_format: encodingFormat };
+        const result = await mistralPost(apiKey, "/embeddings", body);
+        return {
+            model: result.model,
+            embeddings: result.data.map((d) => ({
+                index: d.index,
+                dimensions: d.embedding.length,
+                embedding: d.embedding,
+            })),
+            usage: result.usage,
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=mistral-tool.js.map

package/dist/mistral-tool.js.map

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

package/dist/mixpanel-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function mixpanelTrackEvent(args: Record<string, unknown>): Promise<unknown>;
+export declare function mixpanelGetEvents(args: Record<string, unknown>): Promise<unknown>;
+export declare function mixpanelGetFunnels(args: Record<string, unknown>): Promise<unknown>;
+export declare function mixpanelGetRetention(args: Record<string, unknown>): Promise<unknown>;
+export declare function mixpanelExportData(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=mixpanel-tool.d.ts.map

package/dist/mixpanel-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixpanel-tool.d.ts","sourceRoot":"","sources":["../src/mixpanel-tool.ts"],"names":[],"mappings":"AA6DA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAexF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAevF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAcxF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB1F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBxF"}

package/dist/mixpanel-tool.js

@@ -0,0 +1,162 @@
+// Mixpanel API integration for the UnClick MCP server.
+// Uses the Mixpanel REST API via fetch - no external dependencies.
+// Users must supply a Service Account username and secret from mixpanel.com/settings/service-accounts.
+const MP_INGEST = "https://api.mixpanel.com";
+const MP_QUERY = "https://data.mixpanel.com/api/2.0";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function requireCreds(args) {
+    const username = String(args.service_account_username ?? "").trim();
+    const secret = String(args.service_account_secret ?? "").trim();
+    const projectId = String(args.project_id ?? "").trim();
+    if (!username)
+        throw new Error("service_account_username is required (from mixpanel.com/settings/service-accounts).");
+    if (!secret)
+        throw new Error("service_account_secret is required.");
+    if (!projectId)
+        throw new Error("project_id is required (numeric Mixpanel project ID).");
+    return { username, secret, projectId };
+}
+function basicAuth(username, secret) {
+    return `Basic ${Buffer.from(`${username}:${secret}`).toString("base64")}`;
+}
+async function mpGet(username, secret, baseUrl, path, params) {
+    const url = new URL(`${baseUrl}${path}`);
+    Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    const res = await fetch(url.toString(), {
+        headers: { Authorization: basicAuth(username, secret) },
+    });
+    const text = await res.text();
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        data = text;
+    }
+    if (!res.ok) {
+        const msg = typeof data === "object" && data !== null ? (data.error ?? JSON.stringify(data)) : String(data);
+        throw new Error(`Mixpanel error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+async function mpPost(username, secret, baseUrl, path, body) {
+    const form = new URLSearchParams(body);
+    const res = await fetch(`${baseUrl}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: basicAuth(username, secret),
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: form.toString(),
+    });
+    const text = await res.text();
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        data = text;
+    }
+    if (!res.ok) {
+        const msg = typeof data === "object" && data !== null ? (data.error ?? JSON.stringify(data)) : String(data);
+        throw new Error(`Mixpanel error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function mixpanelTrackEvent(args) {
+    const { username, secret } = requireCreds(args);
+    const event = String(args.event ?? "").trim();
+    if (!event)
+        throw new Error("event is required (event name to track).");
+    const properties = {
+        token: String(args.token ?? ""),
+        distinct_id: String(args.distinct_id ?? "anonymous"),
+        time: Math.floor(Date.now() / 1000),
+        ...(args.properties ?? {}),
+    };
+    const data = JSON.stringify([{ event, properties }]);
+    const encoded = Buffer.from(data).toString("base64");
+    return mpPost(username, secret, MP_INGEST, "/track", { data: encoded });
+}
+export async function mixpanelGetEvents(args) {
+    const { username, secret, projectId } = requireCreds(args);
+    const fromDate = String(args.from_date ?? new Date(Date.now() - 7 * 86400000).toISOString().split("T")[0]);
+    const toDate = String(args.to_date ?? new Date().toISOString().split("T")[0]);
+    const params = {
+        project_id: projectId,
+        from_date: fromDate,
+        to_date: toDate,
+        unit: String(args.unit ?? "day"),
+        type: String(args.type ?? "general"),
+    };
+    if (args.event)
+        params.event = JSON.stringify(Array.isArray(args.event) ? args.event : [String(args.event)]);
+    return mpGet(username, secret, MP_QUERY, "/events", params);
+}
+export async function mixpanelGetFunnels(args) {
+    const { username, secret, projectId } = requireCreds(args);
+    const funnelId = String(args.funnel_id ?? "").trim();
+    if (!funnelId)
+        throw new Error("funnel_id is required.");
+    const fromDate = String(args.from_date ?? new Date(Date.now() - 30 * 86400000).toISOString().split("T")[0]);
+    const toDate = String(args.to_date ?? new Date().toISOString().split("T")[0]);
+    return mpGet(username, secret, MP_QUERY, "/funnels", {
+        project_id: projectId,
+        funnel_id: funnelId,
+        from_date: fromDate,
+        to_date: toDate,
+        unit: String(args.unit ?? "day"),
+    });
+}
+export async function mixpanelGetRetention(args) {
+    const { username, secret, projectId } = requireCreds(args);
+    const fromDate = String(args.from_date ?? new Date(Date.now() - 30 * 86400000).toISOString().split("T")[0]);
+    const toDate = String(args.to_date ?? new Date().toISOString().split("T")[0]);
+    const params = {
+        project_id: projectId,
+        from_date: fromDate,
+        to_date: toDate,
+        retention_type: String(args.retention_type ?? "birth"),
+        unit: String(args.unit ?? "day"),
+    };
+    if (args.born_event)
+        params.born_event = String(args.born_event);
+    if (args.event)
+        params.event = String(args.event);
+    return mpGet(username, secret, MP_QUERY, "/retention", params);
+}
+export async function mixpanelExportData(args) {
+    const { username, secret, projectId } = requireCreds(args);
+    const fromDate = String(args.from_date ?? new Date(Date.now() - 1 * 86400000).toISOString().split("T")[0]);
+    const toDate = String(args.to_date ?? new Date().toISOString().split("T")[0]);
+    const params = {
+        project_id: projectId,
+        from_date: fromDate,
+        to_date: toDate,
+    };
+    if (args.event)
+        params.event = JSON.stringify(Array.isArray(args.event) ? args.event : [String(args.event)]);
+    if (args.where)
+        params.where = String(args.where);
+    if (args.limit)
+        params.limit = String(args.limit);
+    // Export returns NDJSON - return as raw text
+    const url = new URL(`${MP_QUERY}/export`);
+    Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    const res = await fetch(url.toString(), {
+        headers: { Authorization: basicAuth(username, secret) },
+    });
+    if (!res.ok)
+        throw new Error(`Mixpanel export error (${res.status})`);
+    const text = await res.text();
+    const lines = text.trim().split("\n").filter(Boolean);
+    const events = lines.map((l) => { try {
+        return JSON.parse(l);
+    }
+    catch {
+        return l;
+    } });
+    return { count: events.length, from_date: fromDate, to_date: toDate, events };
+}
+//# sourceMappingURL=mixpanel-tool.js.map