@unclick/mcp-server 0.1.1 → 0.2.1

package/dist/bungie-tool.js

@@ -0,0 +1,138 @@
+// Bungie / Destiny 2 API integration.
+// Docs: https://bungie-net.github.io/
+// Env var: BUNGIE_API_KEY (header: X-API-Key)
+// Base URL: https://www.bungie.net/Platform/
+const BUNGIE_BASE = "https://www.bungie.net/Platform";
+// ─── API helper ───────────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? process.env.BUNGIE_API_KEY ?? "").trim();
+    if (!key) {
+        throw new Error("BUNGIE_API_KEY is required. Register at https://www.bungie.net/en/Application");
+    }
+    return key;
+}
+async function bungieFetch(path, apiKey, params = {}) {
+    const url = new URL(`${BUNGIE_BASE}${path}`);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), {
+        headers: {
+            "X-API-Key": apiKey,
+            "User-Agent": "UnClickMCP/1.0 (https://unclick.io)",
+        },
+    });
+    const body = (await res.json());
+    if (!res.ok || (body.ErrorCode !== undefined && Number(body.ErrorCode) !== 1)) {
+        throw new Error(`Bungie API error ${body.ErrorCode ?? res.status}: ${String(body.Message ?? body.ErrorStatus ?? "Unknown error")}`);
+    }
+    return body.Response;
+}
+// ─── bungie_search_player ─────────────────────────────────────────────────────
+// GET /Destiny2/SearchDestinyPlayer/{membershipType}/{displayName}/
+export async function bungieSearchPlayer(args) {
+    const key = requireKey(args);
+    const displayName = String(args.displayName ?? "").trim();
+    if (!displayName)
+        return { error: "displayName is required." };
+    const membershipType = String(args.membershipType ?? "-1");
+    const data = await bungieFetch(`/Destiny2/SearchDestinyPlayer/${encodeURIComponent(membershipType)}/${encodeURIComponent(displayName)}/`, key);
+    const results = Array.isArray(data) ? data : [];
+    return {
+        query: displayName,
+        count: results.length,
+        players: results.map((p) => ({
+            membership_id: p.membershipId,
+            membership_type: p.membershipType,
+            display_name: p.displayName,
+            bungie_global_display_name: p.bungieGlobalDisplayName ?? null,
+            bungie_global_display_name_code: p.bungieGlobalDisplayNameCode ?? null,
+            icon_path: p.iconPath ? `https://www.bungie.net${p.iconPath}` : null,
+        })),
+    };
+}
+// ─── bungie_get_profile ───────────────────────────────────────────────────────
+// GET /Destiny2/{membershipType}/Profile/{membershipId}/
+// components: 100=Profiles, 200=Characters, 204=CharacterEquipment
+export async function bungieGetProfile(args) {
+    const key = requireKey(args);
+    const membershipType = String(args.membershipType ?? "").trim();
+    const membershipId = String(args.membershipId ?? "").trim();
+    if (!membershipType)
+        return { error: "membershipType is required." };
+    if (!membershipId)
+        return { error: "membershipId is required." };
+    const components = String(args.components ?? "100,200,204");
+    const data = await bungieFetch(`/Destiny2/${encodeURIComponent(membershipType)}/Profile/${encodeURIComponent(membershipId)}/`, key, { components });
+    // Extract profile info
+    const profileData = data.profile ?? {};
+    const profileInfo = profileData.data ?? {};
+    const userInfo = profileInfo.userInfo ?? {};
+    // Extract character summaries
+    const charactersData = data.characters ?? {};
+    const charactersMap = charactersData.data ?? {};
+    const characters = Object.values(charactersMap).map((c) => ({
+        character_id: c.characterId,
+        membership_id: c.membershipId,
+        membership_type: c.membershipType,
+        class_type: c.classType,
+        race_type: c.raceType,
+        gender_type: c.genderType,
+        light: c.light,
+        level: c.levelProgression
+            ? c.levelProgression.level
+            : null,
+        minutes_played_total: c.minutesPlayedTotal,
+        date_last_played: c.dateLastPlayed,
+        emblem_path: c.emblemPath
+            ? `https://www.bungie.net${c.emblemPath}`
+            : null,
+    }));
+    return {
+        membership_id: userInfo.membershipId ?? membershipId,
+        membership_type: userInfo.membershipType ?? membershipType,
+        display_name: userInfo.displayName ?? null,
+        characters,
+    };
+}
+// ─── bungie_get_manifest ──────────────────────────────────────────────────────
+// GET /Destiny2/Manifest/
+export async function bungieGetManifest(args) {
+    const key = requireKey(args);
+    const data = await bungieFetch("/Destiny2/Manifest/", key);
+    return {
+        version: data.version,
+        mobile_asset_content_path: data.mobileAssetContentPath ?? null,
+        mobile_gear_asset_data_bases: data.mobileGearAssetDataBases ?? [],
+        mobile_world_content_paths: data.mobileWorldContentPaths ?? {},
+        json_world_content_paths: data.jsonWorldContentPaths ?? {},
+        mobile_clan_banner_database_path: data.mobileClanBannerDatabasePath ?? null,
+        mobile_gear_cdn: data.mobileGearCDN ?? {},
+    };
+}
+// ─── bungie_search_entities ───────────────────────────────────────────────────
+// GET /Destiny2/Armory/Search/{entityType}/{searchTerm}/
+export async function bungieSearchEntities(args) {
+    const key = requireKey(args);
+    const entityType = String(args.entityType ?? "").trim();
+    const searchTerm = String(args.searchTerm ?? "").trim();
+    if (!entityType)
+        return { error: "entityType is required (e.g. DestinyInventoryItemDefinition)." };
+    if (!searchTerm)
+        return { error: "searchTerm is required." };
+    const data = await bungieFetch(`/Destiny2/Armory/Search/${encodeURIComponent(entityType)}/${encodeURIComponent(searchTerm)}/`, key);
+    const results = data.results ?? [];
+    return {
+        entity_type: entityType,
+        query: searchTerm,
+        total: data.totalResults ?? results.length,
+        results: results.map((r) => ({
+            hash: r.hash,
+            entity_type: r.entityType,
+            display_properties: r.displayProperties ?? null,
+            has_icon: r.hasIcon,
+        })),
+    };
+}
+//# sourceMappingURL=bungie-tool.js.map

package/dist/bungie-tool.js.map

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

package/dist/calculator-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function calculateTip(args: Record<string, unknown>): unknown;
+export declare function calculateMortgage(args: Record<string, unknown>): unknown;
+export declare function calculateBmi(args: Record<string, unknown>): unknown;
+export declare function calculateCompoundInterest(args: Record<string, unknown>): unknown;
+export declare function convertCurrencyEstimate(args: Record<string, unknown>): unknown;
+//# sourceMappingURL=calculator-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculator-tool.d.ts","sourceRoot":"","sources":["../src/calculator-tool.ts"],"names":[],"mappings":"AAKA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBnE;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAgCxE;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA6BnE;AAID,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAmChF;AAsCD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA6B9E"}

package/dist/calculator-tool.js

@@ -0,0 +1,196 @@
+// Math and financial calculators.
+// No API required -- pure computation.
+// ─── calculate_tip ────────────────────────────────────────────────────────────
+export function calculateTip(args) {
+    const bill = Number(args.bill ?? 0);
+    const tipPercent = Number(args.tip_percent ?? 18);
+    const splitWays = Math.max(1, Math.round(Number(args.split_ways ?? 1)));
+    if (bill <= 0)
+        return { error: "bill must be a positive number." };
+    if (tipPercent < 0)
+        return { error: "tip_percent must be non-negative." };
+    const tipAmount = bill * (tipPercent / 100);
+    const total = bill + tipAmount;
+    const perPerson = total / splitWays;
+    const tipPerPerson = tipAmount / splitWays;
+    return {
+        bill,
+        tip_percent: tipPercent,
+        tip_amount: round2(tipAmount),
+        total: round2(total),
+        split_ways: splitWays,
+        per_person: round2(perPerson),
+        tip_per_person: round2(tipPerPerson),
+    };
+}
+// ─── calculate_mortgage ───────────────────────────────────────────────────────
+export function calculateMortgage(args) {
+    const loanAmount = Number(args.loan_amount ?? 0);
+    const annualRate = Number(args.annual_rate ?? 0);
+    const termYears = Number(args.term_years ?? 0);
+    if (loanAmount <= 0)
+        return { error: "loan_amount must be a positive number." };
+    if (annualRate < 0)
+        return { error: "annual_rate must be non-negative." };
+    if (termYears <= 0)
+        return { error: "term_years must be a positive number." };
+    const n = termYears * 12;
+    let monthlyPayment;
+    if (annualRate === 0) {
+        monthlyPayment = loanAmount / n;
+    }
+    else {
+        const r = annualRate / 100 / 12;
+        monthlyPayment = (loanAmount * r * Math.pow(1 + r, n)) / (Math.pow(1 + r, n) - 1);
+    }
+    const totalPaid = monthlyPayment * n;
+    const totalInterest = totalPaid - loanAmount;
+    return {
+        loan_amount: loanAmount,
+        annual_rate_percent: annualRate,
+        term_years: termYears,
+        term_months: n,
+        monthly_payment: round2(monthlyPayment),
+        total_paid: round2(totalPaid),
+        total_interest: round2(totalInterest),
+        interest_to_principal_ratio: round2(totalInterest / loanAmount),
+    };
+}
+// ─── calculate_bmi ────────────────────────────────────────────────────────────
+export function calculateBmi(args) {
+    const weightKg = Number(args.weight_kg ?? 0);
+    const heightCm = Number(args.height_cm ?? 0);
+    if (weightKg <= 0)
+        return { error: "weight_kg must be a positive number." };
+    if (heightCm <= 0)
+        return { error: "height_cm must be a positive number." };
+    const heightM = heightCm / 100;
+    const bmi = weightKg / (heightM * heightM);
+    let category;
+    if (bmi < 18.5)
+        category = "Underweight";
+    else if (bmi < 25)
+        category = "Normal weight";
+    else if (bmi < 30)
+        category = "Overweight";
+    else if (bmi < 35)
+        category = "Obese (Class I)";
+    else if (bmi < 40)
+        category = "Obese (Class II)";
+    else
+        category = "Obese (Class III)";
+    const healthyWeightMin = round2(18.5 * heightM * heightM);
+    const healthyWeightMax = round2(24.9 * heightM * heightM);
+    return {
+        weight_kg: weightKg,
+        height_cm: heightCm,
+        bmi: round2(bmi),
+        category,
+        healthy_weight_range_kg: { min: healthyWeightMin, max: healthyWeightMax },
+        note: "BMI is a screening tool, not a diagnostic measure. Consult a healthcare provider for medical advice.",
+    };
+}
+// ─── calculate_compound_interest ─────────────────────────────────────────────
+export function calculateCompoundInterest(args) {
+    const principal = Number(args.principal ?? 0);
+    const annualRate = Number(args.annual_rate ?? 0);
+    const years = Number(args.years ?? 0);
+    const compoundsPerYear = Math.max(1, Number(args.compounds_per_year ?? 12));
+    if (principal <= 0)
+        return { error: "principal must be a positive number." };
+    if (annualRate < 0)
+        return { error: "annual_rate must be non-negative." };
+    if (years <= 0)
+        return { error: "years must be a positive number." };
+    const r = annualRate / 100;
+    const finalAmount = principal * Math.pow(1 + r / compoundsPerYear, compoundsPerYear * years);
+    const totalInterest = finalAmount - principal;
+    const effectiveAnnualRate = (Math.pow(1 + r / compoundsPerYear, compoundsPerYear) - 1) * 100;
+    const compoundLabel = {
+        1: "annually",
+        2: "semi-annually",
+        4: "quarterly",
+        12: "monthly",
+        52: "weekly",
+        365: "daily",
+    };
+    return {
+        principal,
+        annual_rate_percent: annualRate,
+        years,
+        compounds_per_year: compoundsPerYear,
+        compound_frequency: compoundLabel[compoundsPerYear] ?? `${compoundsPerYear}x per year`,
+        final_amount: round2(finalAmount),
+        total_interest: round2(totalInterest),
+        growth_factor: round4(finalAmount / principal),
+        effective_annual_rate_percent: round4(effectiveAnnualRate),
+    };
+}
+// ─── convert_currency_estimate ────────────────────────────────────────────────
+// Hardcoded approximate rates relative to USD (updated periodically -- not real-time).
+const APPROX_RATES_TO_USD = {
+    USD: 1,
+    EUR: 1.08,
+    GBP: 1.27,
+    JPY: 0.0067,
+    AUD: 0.64,
+    CAD: 0.74,
+    CHF: 1.12,
+    CNY: 0.138,
+    INR: 0.012,
+    MXN: 0.058,
+    BRL: 0.20,
+    SGD: 0.74,
+    HKD: 0.128,
+    KRW: 0.00073,
+    NZD: 0.60,
+    SEK: 0.096,
+    NOK: 0.094,
+    DKK: 0.145,
+    ZAR: 0.054,
+    TRY: 0.029,
+    AED: 0.272,
+    THB: 0.028,
+    MYR: 0.225,
+    IDR: 0.000063,
+    PLN: 0.247,
+    CZK: 0.044,
+    HUF: 0.0027,
+    ILS: 0.275,
+    SAR: 0.267,
+    PHP: 0.0175,
+};
+export function convertCurrencyEstimate(args) {
+    const amount = Number(args.amount ?? 0);
+    const from = String(args.from_currency ?? "").toUpperCase().trim();
+    const to = String(args.to_currency ?? "").toUpperCase().trim();
+    if (amount <= 0)
+        return { error: "amount must be a positive number." };
+    if (!from)
+        return { error: "from_currency is required (e.g. USD, EUR, AUD)." };
+    if (!to)
+        return { error: "to_currency is required (e.g. USD, EUR, AUD)." };
+    if (!APPROX_RATES_TO_USD[from]) {
+        return { error: `Currency "${from}" not in approximate rate table. Supported: ${Object.keys(APPROX_RATES_TO_USD).join(", ")}.` };
+    }
+    if (!APPROX_RATES_TO_USD[to]) {
+        return { error: `Currency "${to}" not in approximate rate table. Supported: ${Object.keys(APPROX_RATES_TO_USD).join(", ")}.` };
+    }
+    const amountInUsd = amount * APPROX_RATES_TO_USD[from];
+    const converted = amountInUsd / APPROX_RATES_TO_USD[to];
+    const rate = APPROX_RATES_TO_USD[from] / APPROX_RATES_TO_USD[to];
+    return {
+        amount,
+        from_currency: from,
+        to_currency: to,
+        converted_amount: round4(converted),
+        approximate_rate: round6(rate),
+        disclaimer: "APPROXIMATE RATES ONLY. These are hardcoded estimates and may not reflect current market rates. Use a real-time currency API (e.g. openexchangerates) for exact conversion.",
+        supported_currencies: Object.keys(APPROX_RATES_TO_USD),
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function round2(n) { return Math.round(n * 100) / 100; }
+function round4(n) { return Math.round(n * 10000) / 10000; }
+function round6(n) { return Math.round(n * 1000000) / 1000000; }
+//# sourceMappingURL=calculator-tool.js.map

package/dist/calculator-tool.js.map

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

package/dist/carboninterface-tool.d.ts

@@ -0,0 +1,5 @@
+export declare function estimateFlightEmissions(args: Record<string, unknown>): Promise<unknown>;
+export declare function estimateVehicleEmissions(args: Record<string, unknown>): Promise<unknown>;
+export declare function estimateElectricityEmissions(args: Record<string, unknown>): Promise<unknown>;
+export declare function carbonInterfaceAction(action: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=carboninterface-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"carboninterface-tool.d.ts","sourceRoot":"","sources":["../src/carboninterface-tool.ts"],"names":[],"mappings":"AA+CA,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA4ClB;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmClB;AAID,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/carboninterface-tool.js

@@ -0,0 +1,143 @@
+// ─── Carbon Interface Emissions Calculator ────────────────────────────────────
+// Carbon Interface API for carbon footprint estimates.
+// Auth: CARBONINTERFACE_API_KEY env or api_key arg (Bearer token).
+// Docs: https://docs.carboninterface.com/
+const CI_BASE = "https://www.carboninterface.com/api/v1";
+// ─── API helper ──────────────────────────────────────────────────────────────
+function getKey(args) {
+    const key = String(args.api_key ?? process.env.CARBONINTERFACE_API_KEY ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required (or set CARBONINTERFACE_API_KEY env).");
+    return key;
+}
+async function ciFetch(path, body, apiKey) {
+    const res = await fetch(`${CI_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            "Authorization": `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        const msg = err.message ?? err.error ?? `HTTP ${res.status}`;
+        throw new Error(`Carbon Interface API error: ${String(msg)}`);
+    }
+    return res.json();
+}
+// ─── Operations ──────────────────────────────────────────────────────────────
+export async function estimateFlightEmissions(args) {
+    const apiKey = getKey(args);
+    // legs: array of { departure_airport, destination_airport, cabin_class? }
+    const legs = args.legs;
+    const passengers = Number(args.passengers ?? 1);
+    if (!Array.isArray(legs) || legs.length === 0) {
+        throw new Error("legs is required — array of { departure_airport, destination_airport } " +
+            "(IATA codes, e.g. [{departure_airport:'SFO', destination_airport:'LAX'}]).");
+    }
+    const mappedLegs = legs.map((leg) => {
+        const departure = String(leg.departure_airport ?? leg.from ?? "").toUpperCase();
+        const destination = String(leg.destination_airport ?? leg.to ?? "").toUpperCase();
+        const cabin_class = String(leg.cabin_class ?? "economy").toLowerCase();
+        if (!departure || !destination) {
+            throw new Error("Each leg requires departure_airport and destination_airport.");
+        }
+        return { departure_airport: departure, destination_airport: destination, cabin_class };
+    });
+    const data = await ciFetch("/estimates", { type: "flight", passengers, legs: mappedLegs }, apiKey);
+    const attrs = data.data.attributes;
+    return {
+        id: data.data.id,
+        type: "flight",
+        passengers,
+        legs: mappedLegs,
+        carbon_g: attrs.carbon_g,
+        carbon_lb: attrs.carbon_lb,
+        carbon_kg: attrs.carbon_kg,
+        carbon_mt: attrs.carbon_mt,
+        distance_value: attrs.distance_value ?? null,
+        distance_unit: attrs.distance_unit ?? null,
+        estimated_at: attrs.estimated_at ?? null,
+    };
+}
+export async function estimateVehicleEmissions(args) {
+    const apiKey = getKey(args);
+    const distanceValue = Number(args.distance_value ?? args.distance ?? 0);
+    const distanceUnit = String(args.distance_unit ?? "km").toLowerCase();
+    const vehicleModelId = String(args.vehicle_model_id ?? "").trim();
+    if (!distanceValue)
+        throw new Error("distance_value is required.");
+    if (!vehicleModelId) {
+        throw new Error("vehicle_model_id is required. " +
+            "Use the Carbon Interface API to look up vehicle models by make/model/year.");
+    }
+    const data = await ciFetch("/estimates", {
+        type: "vehicle",
+        distance_unit: distanceUnit,
+        distance_value: distanceValue,
+        vehicle_model_id: vehicleModelId,
+    }, apiKey);
+    const attrs = data.data.attributes;
+    return {
+        id: data.data.id,
+        type: "vehicle",
+        vehicle_model_id: vehicleModelId,
+        distance_value: attrs.distance_value ?? distanceValue,
+        distance_unit: attrs.distance_unit ?? distanceUnit,
+        carbon_g: attrs.carbon_g,
+        carbon_lb: attrs.carbon_lb,
+        carbon_kg: attrs.carbon_kg,
+        carbon_mt: attrs.carbon_mt,
+        estimated_at: attrs.estimated_at ?? null,
+    };
+}
+export async function estimateElectricityEmissions(args) {
+    const apiKey = getKey(args);
+    const electricityValue = Number(args.electricity_value ?? args.kwh ?? 0);
+    const electricityUnit = String(args.electricity_unit ?? "kwh").toLowerCase();
+    const country = String(args.country ?? "").trim().toLowerCase();
+    const state = String(args.state ?? "").trim().toLowerCase();
+    if (!electricityValue)
+        throw new Error("electricity_value (kWh) is required.");
+    if (!country)
+        throw new Error("country is required (ISO 3166-1 alpha-2, e.g. 'us', 'gb').");
+    const body = {
+        type: "electricity",
+        electricity_unit: electricityUnit,
+        electricity_value: electricityValue,
+        country,
+    };
+    if (state)
+        body.state = state;
+    const data = await ciFetch("/estimates", body, apiKey);
+    const attrs = data.data.attributes;
+    return {
+        id: data.data.id,
+        type: "electricity",
+        country,
+        state: state || null,
+        electricity_value: attrs.electricity_value ?? electricityValue,
+        electricity_unit: attrs.electricity_unit ?? electricityUnit,
+        carbon_g: attrs.carbon_g,
+        carbon_lb: attrs.carbon_lb,
+        carbon_kg: attrs.carbon_kg,
+        carbon_mt: attrs.carbon_mt,
+        estimated_at: attrs.estimated_at ?? null,
+    };
+}
+// ─── Public dispatcher ────────────────────────────────────────────────────────
+export async function carbonInterfaceAction(action, args) {
+    switch (action) {
+        case "estimate_flight_emissions": return estimateFlightEmissions(args);
+        case "estimate_vehicle_emissions": return estimateVehicleEmissions(args);
+        case "estimate_electricity_emissions": return estimateElectricityEmissions(args);
+        default:
+            return {
+                error: `Unknown Carbon Interface action: "${action}". ` +
+                    "Valid: estimate_flight_emissions, estimate_vehicle_emissions, estimate_electricity_emissions.",
+            };
+    }
+}
+//# sourceMappingURL=carboninterface-tool.js.map

package/dist/carboninterface-tool.js.map

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

package/dist/chessdotcom-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function chessPlayer(args: Record<string, unknown>): Promise<unknown>;
+export declare function chessPlayerStats(args: Record<string, unknown>): Promise<unknown>;
+export declare function chessPlayerGames(args: Record<string, unknown>): Promise<unknown>;
+export declare function chessPuzzlesRandom(_args: Record<string, unknown>): Promise<unknown>;
+export declare function chessLeaderboards(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=chessdotcom-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chessdotcom-tool.d.ts","sourceRoot":"","sources":["../src/chessdotcom-tool.ts"],"names":[],"mappings":"AA4BA,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA0ClB;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAwDlB"}