@melra/cli 0.3.0-alpha.10

package/dist/conformance.js

@@ -0,0 +1,381 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * The compatibility suite, run against a live endpoint rather than a build.
+ *
+ * A runtime that speaks these tools is asking to be trusted with real effects,
+ * and "it has the right tool names" is not that claim. This drives one probe
+ * effect through the whole pipeline over an actual transport and reports the
+ * highest level the endpoint earned:
+ *
+ *   L1 typed effects     — every effect is a strict, bounded, typed request
+ *   L2 governed effects  — policy and approval decide before anything runs
+ *   L3 verified effects  — nothing is success without evidence, and every
+ *                          effect leaves a receipt
+ *
+ * Levels are cumulative and ordered by what they let you conclude, so the
+ * report names the highest level with no failed check at or below it. A
+ * runtime claims a level by publishing this report.
+ *
+ * Read `notProven` before quoting a result. This is a black-box check of one
+ * endpoint: it can show that the endpoint governs the effects it is asked for,
+ * and it cannot show that the harness on the other side has no second way to
+ * reach the same disk.
+ */
+import { randomBytes } from "node:crypto";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { PRODUCT_VERSION } from "@melra/protocol";
+export const CONFORMANCE_SUITE = "melra-conformance/1";
+const LEVEL_NAMES = {
+    0: "none",
+    1: "L1 typed effects",
+    2: "L2 governed effects",
+    3: "L3 verified effects",
+};
+/** The kernel surface. A harness adapter may add tools; it may not remove one. */
+const KERNEL_TOOLS = [
+    "melra_capabilities",
+    "melra_plan",
+    "melra_execute",
+    "melra_task_status",
+    "melra_task_cancel",
+    "melra_receipt",
+    "melra_workflow_plan",
+    "melra_workflow_advance",
+    "melra_workflow_status",
+    "melra_workflow_cancel",
+    "melra_workflow_control",
+];
+const NOT_PROVEN = [
+    "That the harness has no second, ungoverned path to the same systems. A harness holding both a MELRA terminal and a native one makes the kernel optional, and an optional boundary is not a trust boundary. Nothing observable from this side distinguishes the two.",
+    "That the endpoint's own policy is well chosen. The suite checks that policy is consulted and obeyed, not that it says the right thing.",
+    "Anything about effects this suite does not exercise. It probes one file effect end to end; browser, terminal, computer, and memory adapters are out of scope.",
+];
+function must(condition, detail) {
+    if (condition !== true)
+        throw new Error(detail);
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** A field the report needs from an untyped reply, or a failed check saying so. */
+function field(source, path) {
+    let value = source;
+    for (const key of path.split(".")) {
+        if (typeof value !== "object" || value === null || !(key in value)) {
+            throw new Error(`reply has no ${path}`);
+        }
+        value = value[key];
+    }
+    return value;
+}
+/**
+ * Every call goes through here, and none of them throws.
+ *
+ * A refusal is a result in this suite — "the endpoint said no" is what half the
+ * checks are looking for — so the transport's own error signalling has to be
+ * data rather than control flow. `ok` is false for both a tool that answered
+ * with `isError` and a protocol-level failure, because from the caller's side
+ * those are the same fact: the effect did not happen.
+ */
+function caller(client) {
+    return async (name, args) => {
+        try {
+            const result = (await client.callTool({ name, arguments: args }));
+            const text = result.content?.find((item) => item.type === "text")?.text ?? "";
+            if (result.isError === true)
+                return { ok: false, value: {}, text };
+            return {
+                ok: true,
+                value: JSON.parse(text),
+                text,
+            };
+        }
+        catch (error) {
+            return { ok: false, value: {}, text: message(error) };
+        }
+    };
+}
+export async function runConformance(options = {}) {
+    const claim = options.claim ?? 3;
+    const client = new Client({
+        name: "melra-conformance",
+        version: PRODUCT_VERSION,
+    });
+    const target = await connect(client, options);
+    const call = caller(client);
+    const checks = [];
+    const check = async (level, name, run) => {
+        try {
+            checks.push({ level, name, passed: true, detail: await run() });
+        }
+        catch (error) {
+            checks.push({ level, name, passed: false, detail: message(error) });
+        }
+    };
+    // Unique per run, so the suite can never collide with — or delete — a file
+    // that was already there. Flat rather than in a directory, so cleanup is one
+    // named file and never a recursive delete of something a user owns.
+    const probe = `melra-conformance-${randomBytes(4).toString("hex")}.txt`;
+    const marker = `melra conformance ${CONFORMANCE_SUITE}\n`;
+    const write = {
+        kind: "file",
+        action: "write",
+        path: probe,
+        content: marker,
+    };
+    let probeWritten = false;
+    let approvalId;
+    let phrase;
+    let writeTaskId;
+    await check(1, "kernel-tools-present", async () => {
+        const listed = (await client.listTools()).tools.map((tool) => tool.name);
+        const missing = KERNEL_TOOLS.filter((tool) => !listed.includes(tool));
+        must(missing.length === 0, `missing tools: ${missing.join(", ")}`);
+        return `${KERNEL_TOOLS.length} kernel tools present of ${listed.length} offered`;
+    });
+    await check(1, "capabilities-describe-the-surface", async () => {
+        const reply = await call("melra_capabilities", {});
+        must(reply.ok, reply.text);
+        const version = field(reply.value, "version");
+        const file = field(reply.value, "operations.file");
+        for (const action of ["read", "write", "delete"]) {
+            must(file.includes(action), `operations.file omits ${action}`);
+        }
+        return `version ${version}, ${file.length} file actions declared`;
+    });
+    await check(1, "unknown-field-rejected", async () => {
+        const reply = await call("melra_plan", {
+            goal: "Conformance: an operation carrying a field the schema does not know",
+            operation: { ...write, unexpected: true },
+        });
+        must(!reply.ok, "an unknown operation field was accepted");
+        return "strict schema refused an unrecognised field";
+    });
+    await check(1, "incomplete-operation-rejected", async () => {
+        const reply = await call("melra_plan", {
+            goal: "Conformance: an operation missing a required field",
+            operation: { kind: "file", action: "write", content: marker },
+        });
+        must(!reply.ok, "an operation with no path was accepted");
+        return "schema refused an operation missing a required field";
+    });
+    await check(1, "plan-returns-an-effect-contract", async () => {
+        const reply = await call("melra_plan", {
+            goal: "Conformance: read the capabilities of this endpoint",
+            operation: { kind: "system", action: "info" },
+        });
+        must(reply.ok, reply.text);
+        const capability = field(reply.value, "contract.capability");
+        const effect = field(reply.value, "contract.effect");
+        must(effect === "read", `a system info read was classified ${effect}`);
+        return `contract ${field(reply.value, "contract.contractVersion")} for ${capability} (${effect})`;
+    });
+    await check(2, "mutation-is-held-for-approval", async () => {
+        const reply = await call("melra_plan", {
+            goal: "Conformance: write the probe file",
+            operation: write,
+        });
+        must(reply.ok, reply.text);
+        writeTaskId = field(reply.value, "id");
+        const outcome = field(reply.value, "policyDecision.outcome");
+        must(outcome === "confirm", `policy answered ${outcome}; L2 needs a mutation to be gated (policy.mutations: "confirm")`);
+        must(field(reply.value, "status") === "awaiting_approval", "a gated mutation was not left awaiting approval");
+        approvalId = field(reply.value, "approval.approvalId");
+        phrase = field(reply.value, "approval.phrase");
+        must(field(reply.value, "approval.taskId") === writeTaskId, "the approval challenge is not scoped to this task");
+        must(/^[a-f0-9]{64}$/.test(field(reply.value, "approval.actionDigest")), "the approval challenge carries no action digest");
+        return "planning a mutation produced a task-scoped approval challenge";
+    });
+    await check(2, "no-approval-is-refused", async () => {
+        must(writeTaskId !== undefined, "no planned mutation to execute");
+        const reply = await call("melra_execute", { taskId: writeTaskId });
+        must(!reply.ok, "a gated mutation executed with no approval at all");
+        return `refused: ${reply.text}`;
+    });
+    await check(2, "wrong-phrase-is-refused", async () => {
+        must(writeTaskId !== undefined, "no planned mutation to execute");
+        must(phrase !== undefined && approvalId !== undefined, "no challenge issued");
+        const reply = await call("melra_execute", {
+            taskId: writeTaskId,
+            approval: { approvalId, phrase: `${phrase} and also this` },
+        });
+        must(!reply.ok, "a gated mutation executed on a phrase that was not the one issued");
+        return `refused: ${reply.text}`;
+    });
+    await check(2, "refused-effects-did-not-happen", async () => {
+        const reply = await call("melra_plan", {
+            goal: "Conformance: confirm the refused write left nothing behind",
+            operation: { kind: "file", action: "read", path: probe },
+        });
+        must(reply.ok, reply.text);
+        const executed = await call("melra_execute", {
+            taskId: field(reply.value, "id"),
+        });
+        const status = executed.ok
+            ? field(executed.value, "task.status")
+            : "refused";
+        must(status !== "verified_success", "the probe file exists, so a refused mutation ran anyway");
+        return "two refusals, and the file they would have created does not exist";
+    });
+    await check(2, "freeform-constraints-are-denied-as-a-result", async () => {
+        const reply = await call("melra_plan", {
+            goal: "Conformance: a limit expressed as prose",
+            operation: { kind: "system", action: "info" },
+            constraints: ["do not touch anything important"],
+        });
+        // Denial has to be a normal result. A harness that cannot tell "policy said
+        // no" from "the call failed" will retry a denial as if it were a blip.
+        must(reply.ok, `a policy denial came back as a transport error: ${reply.text}`);
+        must(field(reply.value, "status") === "policy_blocked", "prose constraints were not denied");
+        const blocked = field(reply.value, "id");
+        const executed = await call("melra_execute", { taskId: blocked });
+        must(executed.ok, `executing a blocked task errored: ${executed.text}`);
+        must(field(executed.value, "task.status") === "policy_blocked", "a blocked task ran when executed anyway");
+        must(executed.value.receipt === undefined, "a blocked task produced an execution receipt");
+        return `denied with ${field(reply.value, "policyDecision.reason")}, and still denied at execute`;
+    });
+    await check(3, "approved-mutation-verifies", async () => {
+        must(writeTaskId !== undefined, "no planned mutation to execute");
+        must(phrase !== undefined && approvalId !== undefined, "no challenge issued");
+        const reply = await call("melra_execute", {
+            taskId: writeTaskId,
+            approval: { approvalId, phrase },
+        });
+        must(reply.ok, reply.text);
+        probeWritten = true;
+        const status = field(reply.value, "task.status");
+        must(status === "verified_success", `approved mutation ended ${status}`);
+        const result = field(reply.value, "certificate.result");
+        must(result === "VERIFIED_SUCCESS", `certificate says ${result}`);
+        must(/^[a-f0-9]{64}$/.test(field(reply.value, "certificate.digest")), "the certificate carries no SHA-256 digest");
+        const evidence = field(reply.value, "certificate.evidence");
+        must(evidence.length > 0, "verified success with no evidence at all");
+        must(evidence.every((item) => item.passed), `verified success over failing evidence: ${JSON.stringify(evidence)}`);
+        return `${status} on ${evidence.length} passing evidence item(s)`;
+    });
+    await check(3, "the-effect-really-happened", async () => {
+        const reply = await call("melra_plan", {
+            goal: "Conformance: read back what the approved write claims to have done",
+            operation: { kind: "file", action: "read", path: probe },
+        });
+        must(reply.ok, reply.text);
+        const executed = await call("melra_execute", {
+            taskId: field(reply.value, "id"),
+        });
+        must(executed.ok, executed.text);
+        must(field(executed.value, "task.status") === "verified_success", "reading the file the kernel says it wrote did not verify");
+        must(field(executed.value, "output.content") === marker, "the file exists but does not hold what was approved");
+        return "the approved bytes are on disk, read back through the kernel";
+    });
+    await check(3, "the-receipt-outlives-the-call", async () => {
+        must(writeTaskId !== undefined, "no executed mutation to read back");
+        const status = await call("melra_task_status", { taskId: writeTaskId });
+        must(status.ok, status.text);
+        must(field(status.value, "status") === "verified_success", "the durable record disagrees with what execute returned");
+        const receiptIds = field(status.value, "receiptIds");
+        must(receiptIds.length === 1, `${receiptIds.length} receipts for one effect`);
+        const reply = await call("melra_receipt", { taskId: writeTaskId });
+        must(reply.ok, reply.text);
+        const receipts = field(reply.value, "receipts");
+        must(receipts.length === 1, `${receipts.length} receipts returned`);
+        must(receipts[0]?.receiptId === receiptIds[0], "the receipt read back is not the one the task records");
+        must(field(reply.value, "certificate.result") === "VERIFIED_SUCCESS", "no verified certificate survived the call");
+        return `receipt ${receipts[0]?.receiptId} for ${receipts[0]?.capability}, still readable after other tasks ran`;
+    });
+    // Last, because it is also the cleanup: a destructive effect gated by its own
+    // approval, verified by the file being gone.
+    await check(3, "destructive-effects-are-gated-and-verified", async () => {
+        must(probeWritten, "nothing was written, so nothing is left to delete");
+        const reply = await call("melra_plan", {
+            goal: "Conformance: remove the probe file",
+            operation: { kind: "file", action: "delete", path: probe },
+        });
+        must(reply.ok, reply.text);
+        const effect = field(reply.value, "policyDecision.effect");
+        must(effect === "destructive", `deleting a file was classified ${effect}`);
+        must(field(reply.value, "policyDecision.risk") === "high", "a destructive effect was not classified high risk");
+        must(field(reply.value, "status") === "awaiting_approval", "a destructive effect was not gated");
+        const executed = await call("melra_execute", {
+            taskId: field(reply.value, "id"),
+            approval: {
+                approvalId: field(reply.value, "approval.approvalId"),
+                phrase: field(reply.value, "approval.phrase"),
+            },
+        });
+        must(executed.ok, executed.text);
+        must(field(executed.value, "task.status") === "verified_success", "the delete did not verify");
+        probeWritten = false;
+        return "a destructive effect needed its own approval and verified as absent";
+    });
+    await client.close();
+    const failedLevels = new Set(checks.filter((entry) => !entry.passed).map((entry) => entry.level));
+    let level = 0;
+    for (const candidate of [1, 2, 3]) {
+        if (failedLevels.has(candidate))
+            break;
+        level = candidate;
+    }
+    return {
+        report: {
+            suite: CONFORMANCE_SUITE,
+            runner: PRODUCT_VERSION,
+            target,
+            level,
+            claimed: claim,
+            claim: LEVEL_NAMES[level],
+            passed: checks.filter((entry) => entry.passed).length,
+            of: checks.length,
+            checks,
+            notProven: NOT_PROVEN,
+            // Only ever set when a level-3 check failed between writing the probe and
+            // deleting it. Saying where it is beats silently leaving it.
+            ...(probeWritten ? { uncleanedProbeFile: probe } : {}),
+        },
+        failed: level < claim,
+    };
+}
+async function connect(client, options) {
+    if (options.url !== undefined) {
+        // Forgiving about the one thing people get wrong: `serve --http` prints both
+        // the console URL and the MCP URL, and only one of them is an endpoint.
+        const url = new URL(options.url.endsWith("/mcp") ? options.url : `${options.url.replace(/\/$/, "")}/mcp`);
+        await client.connect(
+        // ponytail: the SDK declares `sessionId?: string` on this transport, which
+        // `exactOptionalPropertyTypes` reads as incompatible with the `Transport`
+        // it implements. Cast here rather than loosen the flag for the package.
+        new StreamableHTTPClientTransport(url, {
+            ...(options.token === undefined
+                ? {}
+                : {
+                    requestInit: {
+                        headers: { authorization: `Bearer ${options.token}` },
+                    },
+                }),
+        }));
+        return { transport: "http", url: url.href, authenticated: options.token !== undefined };
+    }
+    const command = options.command ?? process.execPath;
+    const args = options.args ??
+        (options.command === undefined
+            ? // Reproduce how this process was started, loaders included, so the same
+                // command works from `dist/bin.js` and from `tsx src/index.ts`.
+                [...process.execArgv, process.argv[1] ?? "", "serve"]
+            : ["serve"]);
+    await client.connect(new StdioClientTransport({
+        command,
+        args,
+        // The SDK forwards a small allowlist by default, which would drop every
+        // MELRA_* variable and quietly check a server configured differently from
+        // the one the operator runs. The point is to check *their* endpoint.
+        env: options.env ?? inheritedEnvironment(),
+        stderr: "pipe",
+    }));
+    return { transport: "stdio", command, args };
+}
+function inheritedEnvironment() {
+    return Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined));
+}
+//# sourceMappingURL=conformance.js.map

package/dist/conformance.js.map

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

package/dist/environment.d.ts

@@ -0,0 +1,22 @@
+export interface CliEnvironment {
+    workspaceRoot: string;
+    dataDirectory: string;
+    unhinged: boolean;
+    policyPath?: string;
+    browserExecutablePath?: string;
+    browserCdpEndpoint?: string;
+    browserCdpContextIndex?: number;
+    browserHarPath?: string;
+    browserHarReplayPath?: string;
+    browserProfileDir?: string;
+}
+export interface CliEnvironmentDefaults {
+    cwd: string;
+    home: string;
+}
+export declare function serverLaunch(moduleDirectory: string, version: string): {
+    command: string;
+    args: string[];
+};
+export declare function parseCliEnvironment(source: NodeJS.ProcessEnv, defaults?: CliEnvironmentDefaults): CliEnvironment;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,wBAAgB,YAAY,CAC1B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAIrC;AA0CD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,UAAU,EACzB,QAAQ,GAAE,sBAGT,GACA,cAAc,CAwDhB"}

package/dist/environment.js

@@ -0,0 +1,109 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+import { homedir } from "node:os";
+import { isAbsolute, join, resolve } from "node:path";
+import { unhingedFromEnvironment } from "@melra/server";
+// A generated client config has to name a command the client can actually
+// spawn. `npx` runs the CLI out of its own cache and leaves nothing on PATH,
+// so `melra` would fail to start for exactly the users who took the shortest
+// install path. Pin the version that wrote the config, so the client keeps
+// launching the same server until someone changes it.
+export function serverLaunch(moduleDirectory, version) {
+    return /[\\/]_npx[\\/]/.test(moduleDirectory)
+        ? { command: "npx", args: ["-y", `@melra/cli@${version}`, "serve"] }
+        : { command: "melra", args: ["serve"] };
+}
+function cdpEndpoint(value) {
+    if (value === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new Error("browser_cdp_endpoint_invalid");
+    }
+    if (!["http:", "https:"].includes(parsed.protocol) ||
+        parsed.username !== "" ||
+        parsed.password !== "" ||
+        parsed.search !== "" ||
+        parsed.hash !== "") {
+        throw new Error("browser_cdp_endpoint_invalid");
+    }
+    return parsed.href;
+}
+function cdpContextIndex(value) {
+    if (value === undefined)
+        return undefined;
+    if (!/^-?\d+$/.test(value)) {
+        throw new Error("browser_cdp_context_index_invalid");
+    }
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < -1) {
+        throw new Error("browser_cdp_context_index_invalid");
+    }
+    return parsed;
+}
+function harPath(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isAbsolute(value)) {
+        throw new Error("browser_har_path_must_be_absolute");
+    }
+    return resolve(value);
+}
+export function parseCliEnvironment(source, defaults = {
+    cwd: process.cwd(),
+    home: homedir(),
+}) {
+    const endpoint = cdpEndpoint(source.MELRA_BROWSER_CDP_ENDPOINT);
+    const contextIndex = cdpContextIndex(source.MELRA_BROWSER_CDP_CONTEXT_INDEX);
+    const recordHarPath = harPath(source.MELRA_BROWSER_HAR_PATH);
+    const replayHarPath = harPath(source.MELRA_BROWSER_HAR_REPLAY);
+    const profileDir = source.MELRA_BROWSER_PROFILE;
+    if (profileDir !== undefined && !isAbsolute(profileDir)) {
+        throw new Error("browser_profile_must_be_absolute");
+    }
+    if (endpoint !== undefined && profileDir !== undefined) {
+        // An attached browser already has whatever profile it was started with;
+        // pointing at a second one would silently do nothing.
+        throw new Error("browser_cdp_cannot_use_profile");
+    }
+    if (endpoint !== undefined && recordHarPath !== undefined) {
+        throw new Error("browser_cdp_cannot_start_har_recording");
+    }
+    if (endpoint !== undefined && replayHarPath !== undefined) {
+        // Replay serves requests from the archive, which means never opening the
+        // socket an attached browser is already holding open.
+        throw new Error("browser_cdp_cannot_replay_har");
+    }
+    if (recordHarPath !== undefined && replayHarPath !== undefined) {
+        throw new Error("browser_har_replay_cannot_record");
+    }
+    if (contextIndex !== undefined && endpoint === undefined) {
+        throw new Error("browser_cdp_context_requires_endpoint");
+    }
+    return {
+        workspaceRoot: resolve(source.MELRA_WORKSPACE ?? defaults.cwd),
+        dataDirectory: resolve(source.MELRA_HOME ?? join(defaults.home, ".melra")),
+        unhinged: unhingedFromEnvironment(source),
+        ...(source.MELRA_POLICY === undefined
+            ? {}
+            : { policyPath: resolve(source.MELRA_POLICY) }),
+        ...(source.MELRA_BROWSER === undefined
+            ? {}
+            : { browserExecutablePath: resolve(source.MELRA_BROWSER) }),
+        ...(endpoint === undefined ? {} : { browserCdpEndpoint: endpoint }),
+        ...(contextIndex === undefined
+            ? {}
+            : { browserCdpContextIndex: contextIndex }),
+        ...(recordHarPath === undefined ? {} : { browserHarPath: recordHarPath }),
+        ...(replayHarPath === undefined
+            ? {}
+            : { browserHarReplayPath: replayHarPath }),
+        ...(profileDir === undefined
+            ? {}
+            : { browserProfileDir: resolve(profileDir) }),
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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