dtc-mcp 0.2.0 → 1.0.0

package/dist/docs/loader.d.ts

@@ -0,0 +1,40 @@
+export interface DocChunk {
+    /** Stable ID, used as MiniSearch primary key. */
+    id: string;
+    /** Short display title (e.g. "klaviyo.campaigns.list"). */
+    title: string;
+    /** "klaviyo" | "shopify" | "guide" */
+    platform: string;
+    /** "method" | "guide" | "type" — for filter UI down the road. */
+    category: string;
+    /** 1-line summary. */
+    summary: string;
+    /** Full markdown body (usage, params, example). */
+    content: string;
+    /** Optional tags for ranking boost. */
+    tags?: string[];
+}
+export interface DocsIndex {
+    version: string;
+    generatedAt: string;
+    chunks: DocChunk[];
+}
+/**
+ * Load the docs index from the most recent source available:
+ *   1. ~/.cache/dtc-mcp/docs.json
+ *   2. bundled data/docs.json (always present in the package)
+ *
+ * The cache check happens first so docs can be updated independently of npm
+ * releases — the dtc-mcp-docs repo refreshes the CDN copy on a daily cron.
+ */
+export declare function loadDocs(): Promise<DocsIndex>;
+/**
+ * Try to refresh the docs from the configured CDN. Returns the new index if
+ * it changed, null if 304 / unchanged / unreachable. Never throws — refresh
+ * failures must not break the MCP server, which can always fall back to the
+ * cached or bundled copy.
+ *
+ * Configure via `DTC_MCP_DOCS_URL`; set `DTC_MCP_DOCS_REFRESH=0` to disable
+ * background refreshes (offline mode).
+ */
+export declare function refreshDocs(): Promise<DocsIndex | null>;

package/dist/docs/loader.js

@@ -0,0 +1,110 @@
+import { readFile, writeFile, mkdir, stat } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { homedir } from "node:os";
+import { log } from "../config.js";
+const DEFAULT_DOCS_URL = "https://cdn.jsdelivr.net/gh/rafaelsztutman/dtc-mcp-docs@latest/docs.json";
+function bundledPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "..", "data", "docs.json");
+}
+function cacheDir() {
+    return resolve(homedir(), ".cache", "dtc-mcp");
+}
+function cacheFile() {
+    return resolve(cacheDir(), "docs.json");
+}
+function etagFile() {
+    return resolve(cacheDir(), "docs.etag");
+}
+async function readJsonIfExists(path) {
+    try {
+        await stat(path);
+        const text = await readFile(path, "utf8");
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+async function readEtag() {
+    try {
+        return (await readFile(etagFile(), "utf8")).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load the docs index from the most recent source available:
+ *   1. ~/.cache/dtc-mcp/docs.json
+ *   2. bundled data/docs.json (always present in the package)
+ *
+ * The cache check happens first so docs can be updated independently of npm
+ * releases — the dtc-mcp-docs repo refreshes the CDN copy on a daily cron.
+ */
+export async function loadDocs() {
+    const cached = await readJsonIfExists(cacheFile());
+    if (cached) {
+        log("debug", "Docs loaded from cache", { version: cached.version });
+        return cached;
+    }
+    const bundled = await readJsonIfExists(bundledPath());
+    if (bundled) {
+        log("debug", "Docs loaded from bundle", { version: bundled.version });
+        return bundled;
+    }
+    throw new Error(`No docs index found. Expected ${bundledPath()} to be present in the package.`);
+}
+/**
+ * Try to refresh the docs from the configured CDN. Returns the new index if
+ * it changed, null if 304 / unchanged / unreachable. Never throws — refresh
+ * failures must not break the MCP server, which can always fall back to the
+ * cached or bundled copy.
+ *
+ * Configure via `DTC_MCP_DOCS_URL`; set `DTC_MCP_DOCS_REFRESH=0` to disable
+ * background refreshes (offline mode).
+ */
+export async function refreshDocs() {
+    if (process.env.DTC_MCP_DOCS_REFRESH === "0")
+        return null;
+    const url = process.env.DTC_MCP_DOCS_URL ?? DEFAULT_DOCS_URL;
+    try {
+        const etag = await readEtag();
+        const headers = { Accept: "application/json" };
+        if (etag)
+            headers["If-None-Match"] = etag;
+        const res = await fetch(url, { headers });
+        if (res.status === 304) {
+            log("debug", "Docs unchanged (304)");
+            return null;
+        }
+        if (!res.ok) {
+            log("warn", "Docs refresh failed", { status: res.status });
+            return null;
+        }
+        const text = await res.text();
+        const next = JSON.parse(text);
+        if (!Array.isArray(next.chunks)) {
+            log("warn", "Docs refresh returned malformed payload");
+            return null;
+        }
+        await mkdir(cacheDir(), { recursive: true });
+        await writeFile(cacheFile(), text, "utf8");
+        const newEtag = res.headers.get("etag");
+        if (newEtag)
+            await writeFile(etagFile(), newEtag, "utf8");
+        log("info", "Docs refreshed", {
+            version: next.version,
+            chunks: next.chunks.length,
+        });
+        return next;
+    }
+    catch (e) {
+        log("debug", "Docs refresh error", {
+            error: e instanceof Error ? e.message : String(e),
+        });
+        return null;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/docs/loader.js.map

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

package/dist/docs/search.d.ts

@@ -0,0 +1,47 @@
+import { type DocChunk } from "./loader.js";
+export interface SearchHit {
+    id: string;
+    title: string;
+    platform: string;
+    category: string;
+    summary: string;
+    /** Full markdown body of the chunk. */
+    content: string;
+    score: number;
+}
+export declare function search(query: string, options?: {
+    limit?: number;
+    platform?: string;
+}): Promise<{
+    version: string;
+    hits: SearchHit[];
+}>;
+export interface DocByIdResult {
+    version: string;
+    found: boolean;
+    chunk?: DocChunk;
+}
+/**
+ * Fetch one chunk by exact ID. Used by the `read_doc` MCP tool — Anthropic's
+ * "filesystem-as-API" pattern adapted to the docs layer. Cheaper and more
+ * deterministic than `search` when the LLM already knows the path.
+ */
+export declare function readById(id: string): Promise<DocByIdResult>;
+export interface DocListResult {
+    version: string;
+    count: number;
+    paths: Array<{
+        id: string;
+        title: string;
+        platform: string;
+        category: string;
+        summary: string;
+    }>;
+}
+/**
+ * List all chunk IDs (with one-line summaries). Used by `read_doc()` with no
+ * argument so the LLM can discover what's available without a search query.
+ */
+export declare function listPaths(options?: {
+    platform?: string;
+}): Promise<DocListResult>;

package/dist/docs/search.js

@@ -0,0 +1,101 @@
+import MiniSearch from "minisearch";
+import { loadDocs, refreshDocs } from "./loader.js";
+let state = null;
+let loadPromise = null;
+function buildIndex(docs) {
+    const index = new MiniSearch({
+        idField: "id",
+        fields: ["title", "summary", "content", "tags", "platform"],
+        storeFields: ["title", "platform", "category", "summary"],
+        searchOptions: {
+            boost: { title: 3, summary: 2, content: 1, platform: 1.5 },
+            fuzzy: 0.2,
+            prefix: true,
+            combineWith: "AND",
+        },
+    });
+    index.addAll(docs.chunks);
+    const chunks = new Map(docs.chunks.map((c) => [c.id, c]));
+    return { index, chunks, version: docs.version };
+}
+async function ensureIndex() {
+    if (state)
+        return state;
+    if (loadPromise)
+        return loadPromise;
+    loadPromise = (async () => {
+        const docs = await loadDocs();
+        state = buildIndex(docs);
+        // Fire-and-forget background refresh. If a newer version is available
+        // we swap the in-memory index for it without blocking the first query.
+        void refreshDocs().then((next) => {
+            if (next)
+                state = buildIndex(next);
+        });
+        return state;
+    })();
+    return loadPromise;
+}
+export async function search(query, options = {}) {
+    const limit = options.limit ?? 5;
+    const st = await ensureIndex();
+    const trimmed = query.trim();
+    if (!trimmed) {
+        return { version: st.version, hits: [] };
+    }
+    const results = st.index.search(trimmed, {
+        filter: options.platform
+            ? (r) => r.platform.toLowerCase() === options.platform.toLowerCase()
+            : undefined,
+    });
+    const hits = results.slice(0, limit).map((r) => {
+        const chunk = st.chunks.get(r.id);
+        return {
+            id: r.id,
+            title: chunk?.title ?? r.title,
+            platform: chunk?.platform ?? r.platform,
+            category: chunk?.category ?? r.category,
+            summary: chunk?.summary ?? r.summary,
+            content: chunk?.content ?? "",
+            score: r.score,
+        };
+    });
+    return { version: st.version, hits };
+}
+/**
+ * Fetch one chunk by exact ID. Used by the `read_doc` MCP tool — Anthropic's
+ * "filesystem-as-API" pattern adapted to the docs layer. Cheaper and more
+ * deterministic than `search` when the LLM already knows the path.
+ */
+export async function readById(id) {
+    const st = await ensureIndex();
+    const chunk = st.chunks.get(id);
+    return {
+        version: st.version,
+        found: !!chunk,
+        chunk,
+    };
+}
+/**
+ * List all chunk IDs (with one-line summaries). Used by `read_doc()` with no
+ * argument so the LLM can discover what's available without a search query.
+ */
+export async function listPaths(options = {}) {
+    const st = await ensureIndex();
+    const platform = options.platform?.toLowerCase();
+    const paths = [];
+    for (const chunk of st.chunks.values()) {
+        if (platform && chunk.platform.toLowerCase() !== platform)
+            continue;
+        paths.push({
+            id: chunk.id,
+            title: chunk.title,
+            platform: chunk.platform,
+            category: chunk.category,
+            summary: chunk.summary,
+        });
+    }
+    paths.sort((a, b) => a.id.localeCompare(b.id));
+    return { version: st.version, count: paths.length, paths };
+}
+//# sourceMappingURL=search.js.map

package/dist/docs/search.js.map

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

package/dist/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createServer } from "./server.js";
-// Load .env for local development (not needed in .mcpb — env vars come from user_config)
+// Local-dev convenience: load .env if present. .mcpb installs pass user_config
+// through process.env directly, so this is a no-op there.
 import("dotenv")
     .then(async (m) => {
     const { fileURLToPath } = await import("url");
@@ -16,5 +17,5 @@ server.connect(transport).catch((err) => {
     console.error("[dtc-mcp] fatal: failed to connect:", err);
     process.exit(1);
 });
-console.error("[dtc-mcp] server running");
+console.error("[dtc-mcp] v1.0.0 ready");
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,yFAAyF;AACzF,MAAM,CAAC,QAAQ,CAAC;KACb,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;IAChB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC,CAAC;KACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAEnB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC/C,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,+EAA+E;AAC/E,0DAA0D;AAC1D,MAAM,CAAC,QAAQ,CAAC;KACb,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;IAChB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC,CAAC;KACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAEnB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC/C,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/sandbox/bridge.d.ts

@@ -0,0 +1,2 @@
+export declare const methodPaths: string[];
+export declare function invoke(path: string, args: unknown[]): Promise<unknown>;

package/dist/sandbox/bridge.js

@@ -0,0 +1,101 @@
+import { klaviyoGet, klaviyoPost, klaviyoPaginate, getConversionMetricId, } from "../sdk/klaviyo/host.js";
+import { shopifyGql, shopifyQL, shopifyTimezone, } from "../sdk/shopify/host.js";
+import { isShopifyConfigured } from "../config.js";
+function requireShopify() {
+    if (!isShopifyConfigured()) {
+        throw new Error("Shopify not configured. Set SHOPIFY_STORE + SHOPIFY_CLIENT_ID + SHOPIFY_CLIENT_SECRET, or SHOPIFY_STORE + SHOPIFY_ACCESS_TOKEN (legacy).");
+    }
+}
+/**
+ * Registry of methods the sandbox can invoke. Every entry is an exact path
+ * that maps to a host function. Unknown paths are rejected — the sandbox can
+ * never reach into arbitrary host code.
+ *
+ * Paths are also exported as `methodPaths` so the in-isolate proxy template
+ * can mirror this surface as typed namespaces.
+ */
+const handlers = {
+    // Low-level Klaviyo escape hatches
+    "klaviyo.get": (args) => {
+        const [path, options] = args;
+        return klaviyoGet(path, options);
+    },
+    "klaviyo.post": (args) => {
+        const [path, body, options] = args;
+        return klaviyoPost(path, body, options);
+    },
+    "klaviyo.paginate": (args) => {
+        const [path, options] = args;
+        return klaviyoPaginate(path, options);
+    },
+    "klaviyo.getConversionMetricId": () => getConversionMetricId(),
+    // Convenience helpers (sugar over the escape hatches; same rate-limit + cache path)
+    "klaviyo.campaigns.list": (args) => {
+        const [params] = args;
+        return klaviyoGet("campaigns", { params });
+    },
+    "klaviyo.campaigns.get": (args) => {
+        const [id, params] = args;
+        return klaviyoGet(`campaigns/${id}`, { params });
+    },
+    "klaviyo.flows.list": (args) => {
+        const [params] = args;
+        return klaviyoGet("flows", { params });
+    },
+    "klaviyo.flows.get": (args) => {
+        const [id, params] = args;
+        return klaviyoGet(`flows/${id}`, { params });
+    },
+    "klaviyo.lists.list": (args) => {
+        const [params] = args;
+        return klaviyoGet("lists", { params });
+    },
+    "klaviyo.segments.list": (args) => {
+        const [params] = args;
+        return klaviyoGet("segments", { params });
+    },
+    "klaviyo.profiles.list": (args) => {
+        const [params] = args;
+        return klaviyoGet("profiles", { params });
+    },
+    "klaviyo.events.list": (args) => {
+        const [params] = args;
+        return klaviyoGet("events", { params });
+    },
+    "klaviyo.metrics.list": (args) => {
+        const [params] = args;
+        return klaviyoGet("metrics", { params });
+    },
+    "klaviyo.reporting.campaignValues": (args) => {
+        const [body] = args;
+        return klaviyoPost("campaign-values-reports", body, { tier: "reporting" });
+    },
+    "klaviyo.reporting.flowValues": (args) => {
+        const [body] = args;
+        return klaviyoPost("flow-values-reports", body, { tier: "reporting" });
+    },
+    // Shopify
+    "shopify.gql": (args) => {
+        requireShopify();
+        const [query, options] = args;
+        return shopifyGql(query, options);
+    },
+    "shopify.ql": (args) => {
+        requireShopify();
+        const [ql] = args;
+        return shopifyQL(ql);
+    },
+    "shopify.timezone": () => {
+        requireShopify();
+        return shopifyTimezone();
+    },
+};
+export const methodPaths = Object.keys(handlers);
+export async function invoke(path, args) {
+    const handler = handlers[path];
+    if (!handler) {
+        throw new Error(`Unknown SDK method: ${path}. Use search_docs to find valid methods.`);
+    }
+    return handler(args);
+}
+//# sourceMappingURL=bridge.js.map

package/dist/sandbox/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/sandbox/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,eAAe,EACf,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD,SAAS,cAAc;IACrB,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,0IAA0I,CAC3I,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,QAAQ,GAA4B;IACxC,mCAAmC;IACnC,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE;QACtB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAkG,CAAC;QAC3H,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE;QACvB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,IAI7B,CAAC;QACF,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAOvB,CAAC;QACF,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,+BAA+B,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAE;IAE9D,oFAAoF;IACpF,wBAAwB,EAAE,CAAC,IAAI,EAAE,EAAE;QACjC,MAAM,CAAC,MAAM,CAAC,GAAG,IAA4C,CAAC;QAC9D,OAAO,UAAU,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,IAAoD,CAAC;QAC1E,OAAO,UAAU,CAAC,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,IAA4C,CAAC;QAC9D,OAAO,UAAU,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,IAAoD,CAAC;QAC1E,OAAO,UAAU,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,IAA4C,CAAC;QAC9D,OAAO,UAAU,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,CAAC,GAAG,IAA4C,CAAC;QAC9D,OAAO,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,CAAC,GAAG,IAA4C,CAAC;QAC9D,OAAO,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC9B,MAAM,CAAC,MAAM,CAAC,GAAG,IAA4C,CAAC;QAC9D,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,sBAAsB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC/B,MAAM,CAAC,MAAM,CAAC,GAAG,IAA4C,CAAC;QAC9D,OAAO,UAAU,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,kCAAkC,EAAE,CAAC,IAAI,EAAE,EAAE;QAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,IAAiC,CAAC;QACjD,OAAO,WAAW,CAAC,yBAAyB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,8BAA8B,EAAE,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAiC,CAAC;QACjD,OAAO,WAAW,CAAC,qBAAqB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,UAAU;IACV,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE;QACtB,cAAc,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAGxB,CAAC;QACF,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;QACrB,cAAc,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,CAAC,GAAG,IAAgB,CAAC;QAC9B,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IACD,kBAAkB,EAAE,GAAG,EAAE;QACvB,cAAc,EAAE,CAAC;QACjB,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,IAAe;IACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,0CAA0C,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/dist/sandbox/node-discovery.d.ts

@@ -0,0 +1,7 @@
+export interface DiscoveredNode {
+    path: string;
+    version: string;
+    major: number;
+    source: string;
+}
+export declare function discoverNode(): Promise<DiscoveredNode | null>;