@arcnow/mcp 0.1.0

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The MCP surface: a thin wrapper over {@link listTools} and {@link callTool}.
+ *
+ * Everything that decides anything lives in `tools/`, which is why this file is
+ * short and why the test suite never has to stand up a transport to prove a
+ * property of the server.
+ *
+ * @module
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { ServerConfig } from "./config.js";
+import type { ArcNowPort } from "./sdk-port.js";
+export declare const SERVER_NAME = "arcnow-io";
+export declare const SERVER_VERSION = "0.1.0";
+/**
+ * What the model is told before it sees a single tool.
+ *
+ * Three things, because these are the three that produce expensive mistakes:
+ * the mode, so it never offers to do something this server cannot; the decimal
+ * trap, so it never quotes a price out by a factor of a trillion; and the key
+ * rule, so it never asks a user to paste one into a chat.
+ */
+export declare function instructionsFor(config: ServerConfig): string;
+export declare function createServer(port: ArcNowPort, config: ServerConfig): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA0D5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CA2B3E"}

package/dist/server.js

@@ -0,0 +1,103 @@
+/**
+ * The MCP surface: a thin wrapper over {@link listTools} and {@link callTool}.
+ *
+ * Everything that decides anything lives in `tools/`, which is why this file is
+ * short and why the test suite never has to stand up a transport to prove a
+ * property of the server.
+ *
+ * @module
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { capsSummary } from "./tools/spend.js";
+import { callTool, listTools } from "./tools/index.js";
+export const SERVER_NAME = "arcnow-io";
+export const SERVER_VERSION = "0.1.0";
+/**
+ * What the model is told before it sees a single tool.
+ *
+ * Three things, because these are the three that produce expensive mistakes:
+ * the mode, so it never offers to do something this server cannot; the decimal
+ * trap, so it never quotes a price out by a factor of a trillion; and the key
+ * rule, so it never asks a user to paste one into a chat.
+ */
+export function instructionsFor(config) {
+    const mode = config.canWrite
+        ? "This server HAS WRITES ENABLED. It can launch tokens, buy, sell and migrate, signing "
+            + `as ${config.signerAddress ?? "an address it was configured with"}. Its operator capped `
+            + `any single write per quote token: ${capsSummary(config)}. A quote with no cap is refused `
+            + "for every launch and buy — do not offer one in it. Quote before you act, show the "
+            + "user the cost, and get their agreement — especially for a launch, which is "
+            + "irreversible in every respect: name, symbol, supply, curve and graduation venue are "
+            + "fixed at the launch transaction and no contract anywhere can change them afterwards."
+        : "This server is READ-ONLY. It cannot sign, spend, launch or trade, and the write tools "
+            + "are not published. Do not offer to buy, sell or launch anything. Enabling writes is "
+            + "the operator's decision, made by restarting the server — it is not something that "
+            + "can be granted during a conversation.";
+    return [
+        `arcnow.io on Arc (${config.network}) — bonding-curve token launches, trading and `
+            + "graduation, read straight from the contracts.",
+        "",
+        mode,
+        "",
+        "NEVER ask anyone for a private key, and never put one in a tool argument. No tool here "
+            + "takes one, and an argument named like a credential is refused rather than ignored. A "
+            + "tool call is written into a transcript; a key that has been through a transcript has "
+            + "been published and must be rotated. Signing is configured in the server's environment "
+            + "by whoever starts it.",
+        "",
+        "MONEY ON THIS CHAIN. Every token is priced for life in ONE quote token, fixed at its "
+            + "launch: native USDC — the gas currency, 18 decimals, paid as msg.value — or an allowlisted "
+            + "ERC-20 such as EURC (6 decimals), pulled with an exact ERC-20 approval. arcnow_token names "
+            + "a token's quote; arcnow_quote_tokens lists the ones a launch may use. Every amount a tool "
+            + "takes or reports is in that token's own quote, and is labelled with its symbol: never "
+            + "read a EURC figure as dollars, and never add amounts of two quotes together. Amounts cross "
+            + "these tools as decimal strings in whole units (\"25\", \"1.5\") with no more decimals than "
+            + "the quote has — never as JSON numbers, which cannot hold 18 decimals. Gas is always native "
+            + "USDC. The USDC ERC-20 predeploy is native USDC's 6-decimal view, pays for nothing, and is "
+            + "not a quote token.",
+        "",
+        "PRICES. A curve's spot price is the marginal price of the next infinitesimal token, not "
+            + "what an order fills at — the curve integrates price across an order. Answer \"what "
+            + "would 50 EURC get me\" with arcnow_quote_buy, never by multiplying.",
+        "",
+        "GRADUATION. A curve retires permanently once it collects its target, and the buy that "
+            + "fills it migrates the curve into a Uniswap v4 pool in that same transaction. From then "
+            + "on the token trades in that pool, through arcnow.io's router, and the quote and trade "
+            + "tools route there on their own — every pool quote says it is one, and names the pool's "
+            + "own LP fee on top of arcnow.io's 1%. Where a token graduates to is snapshotted into its "
+            + "own curve at launch: ask the curve, not a network-wide list. A token can be graduated "
+            + "and NOT migrated — trading over, no market anywhere — until somebody runs the "
+            + "permissionless migrate().",
+        "",
+        "SELLING IN A POOL needs an ERC-20 approval to the router first: a separate transaction "
+            + "granting it spending rights. arcnow_sell grants one only when told to (approveRouter: "
+            + "true), only for exactly the amount being sold, and reports it. Tell the user about the "
+            + "approval before you set that flag.",
+        "",
+        "There is no arcnow.io mainnet. If someone asks for one, say so; do not substitute an "
+            + "address from anywhere.",
+    ].join("\n");
+}
+export function createServer(port, config) {
+    const ctx = { port, config };
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} }, instructions: instructionsFor(config) });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: listTools(config).map((tool) => ({
+            name: tool.name,
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: tool.annotations,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const result = await callTool(request.params.name, request.params.arguments, ctx);
+        return {
+            content: [{ type: "text", text: result.text }],
+            ...(result.isError === true ? { isError: true } : {}),
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Turning whatever went wrong into something a model can act on.
+ *
+ * The SDK's errors are already good — decoded by selector across every pinned
+ * ABI, carrying their parameters and a sentence saying what to do — so the job
+ * here is mostly to not lose them, and to add the one thing the SDK cannot
+ * know: which tool was being run.
+ *
+ * # Three kinds of failure, said as three different things
+ *
+ * - **The chain said no:** a decoded contract error, or one of the SDK's codes
+ *   for a revert (`WrappedRevert`, `UnknownRevert`, `RevertString`, `Panic`,
+ *   `EmptyRevert`). "failed on-chain".
+ * - **The SDK refused before building a transaction:** every other code in the
+ *   SDK's own `SDK_ERROR_CODES` — an unknown curve, platform or hook version, an address
+ *   that is not a curve. "refused".
+ * - **The question never reached the chain:** `RpcFailure`. "could not reach the
+ *   chain" — a rate limit or a timeout, which says nothing about the token.
+ *
+ * A revert that came back through Uniswap v4's `WrappedError` keeps the layers
+ * it came through, which the SDK decodes onto `details.wrappedBy` — including
+ * which transfer out of the PoolManager failed.
+ *
+ * Its own module, rather than a function in the dispatcher, because a write
+ * tool sometimes has to render an error *inside* a report: a pool sell whose
+ * router approval went through and whose swap then did not has to say both.
+ *
+ * @module
+ */
+export declare function renderError(tool: string, error: unknown): string;
+/**
+ * A pool quote or trade, rendered — naming what failed when the SDK could.
+ *
+ * Uniswap v4 wraps a failing hook call, and a failing transfer out of the
+ * PoolManager, in `WrappedError`. The SDK unwraps it: a known inner error keeps
+ * its own code, and an empty reason is `WrappedRevert`, whose layers the SDK
+ * decodes — `NativeTransferFailed` or `ERC20TransferFailed` for a transfer.
+ *
+ * This server adds no cause of its own on top. It says which transfer failed
+ * when a layer names one, tells the model which tool to use next, and shows the
+ * SDK's explanation and the layers once, beneath.
+ */
+export declare function renderPoolError(tool: string, side: "buy" | "sell", error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/tools/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA6CH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAgChE;AAoJD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAwB1F"}

package/dist/tools/errors.js

@@ -0,0 +1,231 @@
+/**
+ * Turning whatever went wrong into something a model can act on.
+ *
+ * The SDK's errors are already good — decoded by selector across every pinned
+ * ABI, carrying their parameters and a sentence saying what to do — so the job
+ * here is mostly to not lose them, and to add the one thing the SDK cannot
+ * know: which tool was being run.
+ *
+ * # Three kinds of failure, said as three different things
+ *
+ * - **The chain said no:** a decoded contract error, or one of the SDK's codes
+ *   for a revert (`WrappedRevert`, `UnknownRevert`, `RevertString`, `Panic`,
+ *   `EmptyRevert`). "failed on-chain".
+ * - **The SDK refused before building a transaction:** every other code in the
+ *   SDK's own `SDK_ERROR_CODES` — an unknown curve, platform or hook version, an address
+ *   that is not a curve. "refused".
+ * - **The question never reached the chain:** `RpcFailure`. "could not reach the
+ *   chain" — a rate limit or a timeout, which says nothing about the token.
+ *
+ * A revert that came back through Uniswap v4's `WrappedError` keeps the layers
+ * it came through, which the SDK decodes onto `details.wrappedBy` — including
+ * which transfer out of the PoolManager failed.
+ *
+ * Its own module, rather than a function in the dispatcher, because a write
+ * tool sometimes has to render an error *inside* a report: a pool sell whose
+ * router approval went through and whose swap then did not has to say both.
+ *
+ * @module
+ */
+import { AmountParseError, isArcNowError, SDK_ERROR_CODES, WRAPPED_ERROR_SELECTOR, } from "@arcnow/sdk";
+import { addr, note, report, section } from "../format.js";
+import { QuoteInputError } from "./quote.js";
+import { NotACurveOrTokenError, NotArcNowError } from "./resolve.js";
+/** The SDK's codes for a revert it decoded, or could not: the chain refused. */
+const REVERT_CODES = new Set([
+    "WrappedRevert", "UnknownRevert", "RevertString", "Panic", "EmptyRevert",
+]);
+/** Every code the SDK raises itself, as opposed to a contract error's name. */
+const SDK_CODES = new Set(SDK_ERROR_CODES);
+/**
+ * What a quote-token contract error means, for a model deciding what to tell a
+ * user. Only the ones whose name alone does not say what to do next.
+ */
+const QUOTE_ERROR_NOTES = {
+    QuoteTokenNotSupported: "The launchpad does not accept this quote token for a launch. Nothing was launched. "
+        + "arcnow_quote_tokens lists what its quote registry accepts; launch in one of those, or in "
+        + "native USDC. If an ERC-20 approve was sent first, it still stands.",
+    QuoteNotEnabledOnPlatform: "This platform serves no curve template for that quote, so it cannot launch in it. Nothing "
+        + "was launched. Launch in a quote the platform enables — native USDC always is on "
+        + "arcnow.io's own — or under another platform.",
+    MigratorDoesNotSupportQuote: "The graduation venue chosen cannot migrate a curve priced in this quote. Nothing was launched.",
+    LaunchFeeAboveMaximum: "The launch fee for this quote was raised after it was quoted, and the launch refused to pay "
+        + "more than the fee it was shown. Nothing was launched. Re-quote and show the new total.",
+    QuoteTransferShortfall: "The quote token delivered less than the amount pulled — a token that takes a fee on "
+        + "transfer, or a paused or blocklisted account. Nothing was traded.",
+};
+export function renderError(tool, error) {
+    if (error instanceof QuoteInputError)
+        return error.message;
+    if (error instanceof NotACurveOrTokenError)
+        return notACurveOrToken(tool, error.refusal);
+    if (isArcNowError(error)) {
+        if (error.code === "QuoteTransferOutOfGas")
+            return quoteTransferOutOfGas(tool, error);
+        if (error.code === "UnknownCurveVersion")
+            return unknownCurveVersion(tool, error);
+        if (error.code === "RpcFailure")
+            return transportFailure(tool, error);
+        if (SDK_CODES.has(error.code) && !REVERT_CODES.has(error.code))
+            return sdkRefusal(tool, error);
+        const args = Object.entries(error.args);
+        return report(`${tool} failed on-chain: ${error.code}`, error.message, args.length === 0
+            ? undefined
+            : `Details: ${args.map(([k, v]) => `${k}=${String(v)}`).join(", ")}`, wrapperSection(error), QUOTE_ERROR_NOTES[error.code] === undefined ? undefined : note(QUOTE_ERROR_NOTES[error.code] ?? ""));
+    }
+    if (error instanceof NotArcNowError)
+        return error.message;
+    if (error instanceof AmountParseError) {
+        return report(`${tool}: that amount could not be read.`, error.message, note("Amounts here are decimal strings in whole units — \"25\", \"1.5\" — not raw "
+            + "integers and not JSON numbers. Token quantities have 18 decimals; an amount of a quote "
+            + "token has that quote's own — native USDC 18, EURC 6 — and an amount with more decimal "
+            + "places than that is rejected rather than quietly truncated."));
+    }
+    if (error instanceof Error)
+        return `${tool} failed: ${error.message}`;
+    return `${tool} failed: ${String(error)}`;
+}
+function detail(error, key) {
+    const value = error.details[key];
+    return typeof value === "string" ? value : undefined;
+}
+const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+function sdkRefusal(tool, error) {
+    const details = Object.entries(error.details)
+        .filter(([key, value]) => key !== "wrappedBy"
+        && (typeof value === "string" || typeof value === "number" || typeof value === "bigint"));
+    return report(`${tool} refused: ${error.code}`, error.message, details.length === 0
+        ? undefined
+        : `Details: ${details.map(([k, v]) => `${k}=${typeof v === "string" && ADDRESS.test(v) ? addr(v) : String(v)}`).join(", ")}`, error.code === "ReadOnlyClient"
+        ? note("That means this server has no signer even though a write tool ran, which "
+            + "should not be reachable — report it rather than retrying.")
+        : error.code === "QuoteAmountNotRepresentable"
+            ? note("The SDK refused this call itself, before building its transaction: the amount is "
+                + "not a whole number of its quote token's raw units, and an ERC-20 cannot move a "
+                + "fraction of one. Pass an amount with no more decimals than the quote has.")
+            : error.code === "QuoteTokenMismatch"
+                ? note("The SDK refused this call itself, before building its transaction: an amount of "
+                    + "one quote token was offered where another is priced. Nothing converts between "
+                    + "quotes here.")
+                : note("The SDK refused this call itself, before building its transaction."));
+}
+/**
+ * An ERC-20 trade or launch that ran out of gas inside a fee-share transfer.
+ *
+ * The contracts' gas guard on ERC-20 fee shares (contracts#23,
+ * `QuoteTransfer.tryPushBounded`) reverts with no data when too little gas is
+ * left, and the SDK names that `QuoteTransferOutOfGas`. It is a gas limit too
+ * tight — not an unknown revert, and not a refusal made before anything was
+ * attempted — so it is said as exactly that, with the one thing to do about it.
+ */
+function quoteTransferOutOfGas(tool, error) {
+    const quote = detail(error, "quoteToken");
+    const limit = error.details.gasLimit;
+    return report(`${tool} failed on-chain: QuoteTransferOutOfGas — the transaction ran out of gas paying an `
+        + `ERC-20 fee share${quote === undefined ? "" : ` in the quote token ${addr(quote)}`}.`, error.message, section("details", [
+        ["quote token", quote === undefined ? "(not reported)" : addr(quote)],
+        ["gas limit", typeof limit === "bigint" || typeof limit === "number"
+                ? `gasLimit=${limit.toString()}`
+                : "none set — the node's estimate plus the SDK's headroom"],
+    ]), note("arcnow.io's contracts send each ERC-20 fee share through a gas guard that reverts with no "
+        + "data when too little gas is left for the transfer, so this is a gas limit too tight for the "
+        + "transfers, not a rejection of the trade and nothing wrong with the token. To fix it, leave "
+        + "the gas limit unset, or raise it: with none set the SDK sends the node's estimate plus a "
+        + "fifth — at least 150,000 more for a curve trade or a launch, at least 400,000 more for a "
+        + "pool swap — and a trade that graduates the curve gets 8,000,000. A trade "
+        + "is simulated before it is sent, so this normally means nothing was sent; check the balance "
+        + "before retrying anyway."));
+}
+function transportFailure(tool, error) {
+    return report(`${tool} could not reach the chain: RpcFailure`, error.message, note("This is the transport — the endpoint, a rate limit or a timeout — and it says "
+        + "nothing about the address, the token or the trade. If it happened while a transaction "
+        + "was being sent, check the balance before trying again; otherwise try again after a "
+        + "pause."));
+}
+function notACurveOrToken(tool, refusal) {
+    return report(`${tool} refused: AddressIsNotACurve — this address is not an arcnow.io bonding curve, and `
+        + "it is not an arcnow.io token either.", refusal.message, note("Read as a token, it named no arcnow.io curve. Nothing was quoted and nothing was sent. "
+        + "A launch gives two addresses — the token and its curve — and either one works here; "
+        + "anything else, an ordinary ERC-20 such as the USDC interface predeploy included, does "
+        + "not."));
+}
+/** What the SDK refused, by the component whose `VERSION()` it read. */
+const REFUSED_COMPONENT = {
+    "bonding-curve": "this curve",
+    "platform-config": "this platform",
+    "platform-registry": "this platform registry",
+    "quote-registry": "this quote registry",
+    "launchpad": "this launchpad",
+    "arc-now-fee-hook": "this fee hook",
+};
+function unknownCurveVersion(tool, error) {
+    const version = detail(error, "version") ?? "(not reported)";
+    const component = detail(error, "component") ?? "bonding-curve";
+    const what = REFUSED_COMPONENT[component] ?? `this ${component}`;
+    return report(`${tool} refused: UnknownCurveVersion — ${what} answers VERSION() `
+        + `${JSON.stringify(version)}, which is not a version this server prices.`, error.message, note("Nothing was quoted and nothing was sent. arcnow.io has one bonding curve, the "
+        + "constant-product arcnow/bonding-curve@3.x.x, priced in a quote token and launched under "
+        + "arcnow/platform-config@3.x.x platforms through arcnow/launchpad@3.x.x, whose quote "
+        + "registry is arcnow/quote-registry@1.x.x. Any other version — the 2.x contracts Arc "
+        + "testnet ran until the multi-quote reset and the retired linear curve, @1.x.x, included "
+        + "— is refused rather "
+        + "than priced, because another build can keep another quantity in the same slots and a "
+        + "guess would be a plausible, wrong number. Do not estimate a price for it some other way."));
+}
+/** The `WrappedError` layers the SDK peeled off a revert, outermost first. */
+function wrappedLayers(error) {
+    const layers = error.details.wrappedBy;
+    return Array.isArray(layers) ? layers : [];
+}
+function wrapperSection(error) {
+    const layers = wrappedLayers(error);
+    if (layers.length === 0)
+        return undefined;
+    const rows = layers.map((layer, index) => [
+        index === 0 ? "wrapped by" : "inside that",
+        `${layer.selectorName ?? layer.selector} on ${addr(layer.target)}`
+            + (layer.detailsName === undefined ? "" : ` (${layer.detailsName})`),
+    ]);
+    if (error.code === "WrappedRevert") {
+        const reason = detail(error, "reason");
+        rows.push(["inner revert", reason === undefined
+                ? "not reported"
+                : reason === "0x"
+                    ? "no data at all"
+                    : `${reason} — in none of the ABIs the SDK carries`]);
+    }
+    return section(`Uniswap v4 WrappedError (${WRAPPED_ERROR_SELECTOR}) layers, outermost first`, rows);
+}
+/**
+ * A pool quote or trade, rendered — naming what failed when the SDK could.
+ *
+ * Uniswap v4 wraps a failing hook call, and a failing transfer out of the
+ * PoolManager, in `WrappedError`. The SDK unwraps it: a known inner error keeps
+ * its own code, and an empty reason is `WrappedRevert`, whose layers the SDK
+ * decodes — `NativeTransferFailed` or `ERC20TransferFailed` for a transfer.
+ *
+ * This server adds no cause of its own on top. It says which transfer failed
+ * when a layer names one, tells the model which tool to use next, and shows the
+ * SDK's explanation and the layers once, beneath.
+ */
+export function renderPoolError(tool, side, error) {
+    if (!isArcNowError(error) || error.code !== "WrappedRevert") {
+        return renderError(tool, error);
+    }
+    const failed = wrappedLayers(error).map((layer) => layer.detailsName);
+    const transfer = failed.includes("NativeTransferFailed")
+        ? "a native USDC transfer"
+        : failed.includes("ERC20TransferFailed") ? "an ERC-20 transfer" : undefined;
+    return report(transfer === undefined
+        ? `${tool}: the pool refused this ${side}, for a reason the SDK could not decode.`
+        : `${tool}: the pool refused this ${side} — ${transfer} out of the PoolManager failed `
+            + "inside the swap.", note(transfer === undefined
+        ? "A call inside the swap reverted with a reason the SDK could not decode; the layers "
+            + "below name which call. Nothing here says what the cause was. A smaller amount may go "
+            + `through; quote it first with arcnow_quote_${side}.`
+        : "The SDK decoded which transfer failed and gives its reason below. Before trying again, "
+            + `quote a smaller amount with arcnow_quote_${side}, and do not tell the user the pool `
+            + "is empty or broken: nothing here shows either."), note("A trade is simulated before it is sent, so a revert reported like this normally "
+        + "means nothing was sent. Check the balance before retrying anyway."), renderError(tool, error));
+}
+//# sourceMappingURL=errors.js.map

package/dist/tools/errors.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The tool registry, and the one place a call is dispatched.
+ *
+ * `listTools` and `callTool` here are plain functions over plain data. The MCP
+ * transport in `server.ts` is a thin wrapper around them, which is what lets
+ * the whole surface — what is published in each mode, what a refusal says, how
+ * an on-chain revert is rendered — be tested without a transport, a client or a
+ * chain.
+ *
+ * @module
+ */
+import type { ServerConfig } from "../config.js";
+import { renderError } from "./errors.js";
+import type { AnyTool, ToolContext, ToolOutput } from "./schema.js";
+export { renderError };
+/** Every tool this server knows about, in either mode. */
+export declare const ALL_TOOLS: readonly AnyTool[];
+/**
+ * What the client is told exists.
+ *
+ * In read-only mode the write tools are **not listed**. A model offered a
+ * `arcnow_launch` it cannot use will try it, and the interesting failure is not
+ * the one where a tool exists and refuses — it is the one where a user is told
+ * "I could launch that for you" on the strength of a tool listing. So they are
+ * absent from the list, and still refused by name if called anyway, because a
+ * client may have cached an older list.
+ */
+export declare function listTools(config: ServerConfig): readonly AnyTool[];
+export declare function findTool(name: string): AnyTool | undefined;
+/**
+ * Run one tool call. Never throws: an MCP tool error is a result with
+ * `isError`, so the model can read what went wrong and do something else.
+ */
+export declare function callTool(name: string, args: unknown, ctx: ToolContext): Promise<ToolOutput>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,0DAA0D;AAC1D,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAAoC,CAAC;AAE7E;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,OAAO,EAAE,CAElE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE1D;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAqBrB"}

package/dist/tools/index.js

@@ -0,0 +1,59 @@
+/**
+ * The tool registry, and the one place a call is dispatched.
+ *
+ * `listTools` and `callTool` here are plain functions over plain data. The MCP
+ * transport in `server.ts` is a thin wrapper around them, which is what lets
+ * the whole surface — what is published in each mode, what a refusal says, how
+ * an on-chain revert is rendered — be tested without a transport, a client or a
+ * chain.
+ *
+ * @module
+ */
+import { renderError } from "./errors.js";
+import { READ_TOOLS } from "./read.js";
+import { WRITE_TOOLS, writeRefusal } from "./write.js";
+export { renderError };
+/** Every tool this server knows about, in either mode. */
+export const ALL_TOOLS = [...READ_TOOLS, ...WRITE_TOOLS];
+/**
+ * What the client is told exists.
+ *
+ * In read-only mode the write tools are **not listed**. A model offered a
+ * `arcnow_launch` it cannot use will try it, and the interesting failure is not
+ * the one where a tool exists and refuses — it is the one where a user is told
+ * "I could launch that for you" on the strength of a tool listing. So they are
+ * absent from the list, and still refused by name if called anyway, because a
+ * client may have cached an older list.
+ */
+export function listTools(config) {
+    return config.canWrite ? ALL_TOOLS : READ_TOOLS;
+}
+export function findTool(name) {
+    return ALL_TOOLS.find((tool) => tool.name === name);
+}
+/**
+ * Run one tool call. Never throws: an MCP tool error is a result with
+ * `isError`, so the model can read what went wrong and do something else.
+ */
+export async function callTool(name, args, ctx) {
+    const tool = findTool(name);
+    if (tool === undefined) {
+        return {
+            isError: true,
+            text: `There is no tool called ${name} on this server. It has: `
+                + `${listTools(ctx.config).map((t) => t.name).join(", ")}.`,
+        };
+    }
+    // The gate. It is here, in dispatch, and not inside each write handler —
+    // one check that cannot be forgotten when a seventh write tool is added.
+    if (tool.access === "write" && !ctx.config.canWrite) {
+        return writeRefusal(name);
+    }
+    try {
+        return await tool.run(args, ctx);
+    }
+    catch (error) {
+        return { isError: true, text: renderError(name, error) };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,SAAS,GAAuB,CAAC,GAAG,UAAU,EAAE,GAAG,WAAW,CAAC,CAAC;AAE7E;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,IAAa,EACb,GAAgB;IAEhB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,2BAA2B,IAAI,2BAA2B;kBAC5D,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAC9D,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/tools/launch-params.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Turning launch arguments into the SDK's `LaunchParams`.
+ *
+ * Shared by `arcnow_quote_launch` and `arcnow_launch` on purpose: the quote a
+ * user is shown and the transaction that is sent have to be built from the same
+ * function, or the quote is describing something slightly different from what
+ * happens. The only difference between the two is `minTokensOut`, which a quote
+ * does not use and a launch must not omit.
+ *
+ * **The launch's quote is the initial buy's token.** The SDK has no separate
+ * quote field to disagree with it: `initialBuy` is parsed, exactly, in the quote
+ * the `quote` argument named, and a zero initial buy is zero of that quote.
+ *
+ * @module
+ */
+import type { LaunchParams, QuoteTokenInfo } from "@arcnow/sdk";
+import { Tokens } from "@arcnow/sdk";
+export interface LaunchArgs {
+    readonly name: string;
+    readonly symbol: string;
+    readonly metadataUri: string;
+    readonly initialBuy: string;
+    readonly platform?: string | undefined;
+    readonly migrator?: string | undefined;
+}
+export declare function launchParams(args: LaunchArgs, quote: QuoteTokenInfo, minTokensOut?: Tokens): LaunchParams;
+//# sourceMappingURL=launch-params.d.ts.map

package/dist/tools/launch-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-params.d.ts","sourceRoot":"","sources":["../../src/tools/launch-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,cAAc,EACrB,YAAY,GAAE,MAAoB,GACjC,YAAY,CAUd"}

package/dist/tools/launch-params.js

@@ -0,0 +1,29 @@
+/**
+ * Turning launch arguments into the SDK's `LaunchParams`.
+ *
+ * Shared by `arcnow_quote_launch` and `arcnow_launch` on purpose: the quote a
+ * user is shown and the transaction that is sent have to be built from the same
+ * function, or the quote is describing something slightly different from what
+ * happens. The only difference between the two is `minTokensOut`, which a quote
+ * does not use and a launch must not omit.
+ *
+ * **The launch's quote is the initial buy's token.** The SDK has no separate
+ * quote field to disagree with it: `initialBuy` is parsed, exactly, in the quote
+ * the `quote` argument named, and a zero initial buy is zero of that quote.
+ *
+ * @module
+ */
+import { Tokens } from "@arcnow/sdk";
+import { parseQuoteAmount } from "./quote.js";
+export function launchParams(args, quote, minTokensOut = Tokens.ZERO) {
+    return {
+        name: args.name,
+        symbol: args.symbol,
+        metadataUri: args.metadataUri,
+        initialBuy: parseQuoteAmount(quote, args.initialBuy, "initialBuy"),
+        minTokensOut,
+        ...(args.platform === undefined ? {} : { platform: args.platform }),
+        ...(args.migrator === undefined ? {} : { migrator: args.migrator }),
+    };
+}
+//# sourceMappingURL=launch-params.js.map

package/dist/tools/launch-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-params.js","sourceRoot":"","sources":["../../src/tools/launch-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAW9C,MAAM,UAAU,YAAY,CAC1B,IAAgB,EAChB,KAAqB,EACrB,eAAuB,MAAM,CAAC,IAAI;IAElC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;QAClE,YAAY;QACZ,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAmB,EAAE,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAmB,EAAE,CAAC;KAC/E,CAAC;AACJ,CAAC"}