@eco-incorp/sauce 0.99.6 → 0.99.8

package/mcp/dist/prompts.js

@@ -0,0 +1,153 @@
+/**
+ * Two prompts for the tasks an agent comes to Sauce for — writing a program and running it, and
+ * opening a cross-chain intent — each the workflow through this server's tools, with the skill the
+ * task starts from embedded, for a client that offers prompts but does not let its model read
+ * resources itself.
+ *
+ * Skills are named by directory and embedded only when the package ships them, so a renamed skill
+ * leaves the prompt pointing at the index rather than at nothing.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import * as z from "zod";
+import { shippedSkills, SKILLS_INDEX, WRITE_IT_YOURSELF } from "./resources.js";
+import { PACKAGED_SKILLS, supportedChainNames } from "./sdk.js";
+export const PROMPT_NAMES = ["sauce_write_program", "sauce_open_intent"];
+/** The resource for `dir`, embedded; or nothing when the package ships no such skill. */
+function embedded(skills, dir, root) {
+    const skill = skills.find((each) => each.dir === dir);
+    if (skill === undefined)
+        return [];
+    return [
+        {
+            role: "user",
+            content: {
+                type: "resource",
+                resource: {
+                    uri: skill.uri,
+                    mimeType: "text/markdown",
+                    text: readFileSync(join(root, skill.dir, "SKILL.md"), "utf8"),
+                },
+            },
+        },
+    ];
+}
+/** Whether a prompt's `chain` argument names Solana. */
+const solana = (chain) => chain !== undefined && /^(solana|sol|svm|mainnet-beta|1399811149)$/i.test(chain.trim());
+/** `dirs` as the skill resources to read, those the package ships. */
+const readList = (skills, dirs) => [
+    ...dirs.flatMap((dir) => skills.filter((skill) => skill.dir === dir).map((skill) => skill.uri)),
+    SKILLS_INDEX,
+].join(", ");
+export function registerPrompts(server, root = PACKAGED_SKILLS) {
+    const skills = shippedSkills(root);
+    server.registerPrompt("sauce_write_program", {
+        title: "Write, compile and run a Sauce program",
+        description: "Walks an agent through a Sauce program for a task, end to end with this server's " +
+            "tools: read the skills, look up the chain's names, compile, rehearse, and build the " +
+            "unsigned Pot deployment and cook for the user to sign.",
+        argsSchema: {
+            task: z.string().min(1).max(4000).describe("What the program should do, in plain words."),
+            chain: z.string().max(64).optional().describe("The chain it runs on (base, solana, 8453)."),
+        },
+    }, ({ task, chain }) => ({
+        description: "Write, compile, rehearse and build a Sauce program",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Write a Sauce program that does this${chain === undefined ? "" : ` on ${chain}`}: ${task}`,
+                        "",
+                        `Read the Sauce skills first (with sauce_skill, or as resources: ${readList(skills, solana(chain) ? ["sauce-overview", "sauce-solana", "sauce-cli"] : ["sauce-overview", "sauce-script", "sauce-cli"])}),`,
+                        "and follow them.",
+                        ...WRITE_IT_YOURSELF,
+                        "Then, with this server's tools:",
+                        "1. sauce_globals for the chain: use the token symbols and protocol namespaces it lists",
+                        "   rather than writing addresses. (A fixed sequence of protocol operations can be an",
+                        "   actions document in JSON instead: sauce_actions, and the sauce-actions skill.)",
+                        "2. sauce_compile until the program compiles; read any error and fix the line it names.",
+                        "3. sauce_simulate, with an endpoint (rpcUrl, or the server's own), to rehearse the",
+                        "   cook from the Pot's owner: check what it moved (or why it reverts) before going on.",
+                        "4. sauce_pot for the owner's Pot, and its deploy transaction if it is not deployed.",
+                        "5. sauce_tx for the unsigned cook transaction.",
+                        `Transactions are built only on ${supportedChainNames()}: on any other chain (a`,
+                        "preview chain) steps 1-3 work, and steps 4-5 return `refused` with the chain-support",
+                        "request to offer the user instead.",
+                        "Nothing here signs: hand the owner the unsigned transactions to sign and send with",
+                        "their own wallet, and never ask for a private key.",
+                    ].join("\n"),
+                },
+            },
+            ...embedded(skills, solana(chain) ? "sauce-solana" : "sauce-overview", root),
+        ],
+    }));
+    server.registerPrompt("sauce_open_intent", {
+        title: "Open a cross-chain intent",
+        description: "Walks an agent through a Sauce program that opens a cross-chain intent: read the " +
+            "intents skill, compile with the intent's deadline and creator, and build the unsigned " +
+            "transactions that publish and fund it (or the cook that opens it from a Pot).",
+        argsSchema: {
+            task: z
+                .string()
+                .min(1)
+                .max(4000)
+                .describe("What should happen on the destination chain, and the reward."),
+            source: z.string().max(64).optional().describe("The chain the intent is opened from."),
+            destination: z.string().max(64).optional().describe("The chain it is filled on."),
+        },
+    }, ({ task, source, destination }) => ({
+        description: "Open a Sauce cross-chain intent",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Write a Sauce program that opens a cross-chain intent" +
+                            (source === undefined ? "" : ` from ${source}`) +
+                            (destination === undefined ? "" : ` to ${destination}`) +
+                            `: ${task}`,
+                        "",
+                        `Read the Sauce skills first (with sauce_skill, or as resources: ${readList(skills, ["sauce-overview", "sauce-intents"])}),`,
+                        "and follow them.",
+                        ...WRITE_IT_YOURSELF,
+                        "Then, with this server's tools:",
+                        "1. sauce_globals for each chain involved, for its tokens and protocols. An intent",
+                        "   body names the destination's tokens by address (the skill says why).",
+                        "2. Price it: the reward must cover what the solver delivers on the destination, plus",
+                        "   the destination Kitchen's fee when the body runs a program there (sauce_pot with",
+                        "   that chain's rpcUrl reads it; pass it as intentExecutionFee). sauce_price reads a",
+                        "   pool's price for a swap in the body.",
+                        "3. sauce_compile with intentDeadline (Unix seconds, in the future) and intentCreator",
+                        "   until it compiles; sauce_inspect with the source alone lists each intent's route",
+                        "   and reward.",
+                        "4. For an intent fixed when it is built, rehearse both sides with the same inputs:",
+                        "   sauce_intent_publish with dryRun and from (the source, from the wallet that",
+                        "   funds the reward) and sauce_intent_fill with the destination's rpcUrl (a",
+                        "   solver's fill, where the body runs).",
+                        "5. sauce_intent_publish for the unsigned transfers of the reward into the intent's",
+                        "   vault and then Portal.publish, from the wallet that funds the reward: send the",
+                        "   transfers first, and publish once they have landed (intentFundVia publishAndFund",
+                        "   gives approvals and Portal.publishAndFund instead, for an intent built from a",
+                        "   solver's quote). Keep each intent's `record`. For an intent that measures a value",
+                        "   on chain: run the program on a Pot with sauce_tx.",
+                        "6. Once published: sauce_intent_status (with the record and rpcUrls for both chains)",
+                        "   says where it stands and what can happen next. If no solver fills it before its",
+                        "   deadline, sauce_intent_refund (from the reward's deadline) or sauce_intent_cancel",
+                        "   then sauce_intent_prove then sauce_intent_refund (sooner) returns the reward.",
+                        `Intents publish only between ${supportedChainNames()}, the chains this release`,
+                        "supports: an intent that involves a preview chain compiles and rehearses, and the",
+                        "tools that build its transactions return `refused` with the chain-support request to",
+                        "offer the user instead.",
+                        "Nothing here signs: hand the wallet's owner the unsigned transactions, in order, and",
+                        "never ask for a private key.",
+                    ].join("\n"),
+                },
+            },
+            ...embedded(skills, "sauce-intents", root),
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/mcp/dist/prompts.js.map

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

package/mcp/dist/reach.js

@@ -0,0 +1,98 @@
+/**
+ * The endpoints one tool call reaches: the `rpcUrl` the call carries, else the server's own from
+ * `--config`, else a plain refusal — and everything the call returns scrubbed of both.
+ *
+ * A caller's URL usually embeds the caller's API key, so it is treated as a secret for exactly as
+ * long as the call that carries it: never returned, never logged, and removed from every message
+ * the call produces, including an upstream error that quotes it (a provider's, or viem's). It is
+ * not added to the process-wide secrets, which would grow with every call a server answers.
+ *
+ * Over HTTP the URL is reached only through the guard (`guard.ts`), which checks where it leads at
+ * every connection; over stdio it is used as given, an http(s) URL — the caller is the server's
+ * own user, on the user's own machine.
+ */
+import { noEndpoint } from "./config.js";
+import { scrub, UsageError } from "./sdk.js";
+/** The forms a URL can reappear in a message: as given, normalized, and its parts that may be a
+ *  key — the host (some providers put the key there) and every path segment or query value that
+ *  looks like one. */
+function forms(raw) {
+    const found = new Set([raw, raw.trim()]);
+    try {
+        const url = new URL(raw.trim());
+        found.add(url.href);
+        found.add(url.href.replace(/\/$/, ""));
+        found.add(`${url.host}${url.pathname}`);
+        if (url.hostname.includes("."))
+            found.add(url.hostname);
+        for (const part of [
+            ...url.pathname.split("/"),
+            ...[...url.searchParams.values()],
+            url.username,
+            url.password,
+        ]) {
+            // A key is long and usually has digits: not `solana` or `base-mainnet`, which a result may
+            // rightly contain.
+            if (part.length >= 20 || (part.length >= 12 && /\d/.test(part))) {
+                found.add(part);
+                found.add(encodeURIComponent(part));
+            }
+        }
+    }
+    catch {
+        // Not a URL: the text as given is all there is to take out.
+    }
+    return [...found].filter((form) => form.length >= 4).sort((a, b) => b.length - a.length);
+}
+const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+export function callReach(endpoints, guard) {
+    const secrets = new Set();
+    const routes = [];
+    const remember = (text) => {
+        for (const form of forms(text))
+            secrets.add(form);
+    };
+    const endpoint = async (chain, given) => {
+        if (given === undefined)
+            return endpoints.endpoint(chain);
+        // Before anything can fail and quote it.
+        remember(given);
+        if (guard !== undefined) {
+            const routed = await guard.route(given);
+            routes.push(routed);
+            remember(routed.url);
+            return routed.url;
+        }
+        let url;
+        try {
+            url = new URL(given.trim());
+        }
+        catch {
+            throw new UsageError("rpcUrl is not a URL");
+        }
+        if (url.protocol !== "https:" && url.protocol !== "http:") {
+            throw new UsageError("rpcUrl must be an http(s) URL");
+        }
+        return given.trim();
+    };
+    return {
+        endpoint,
+        require: async (chain, given, what) => {
+            const url = await endpoint(chain, given);
+            if (url === undefined)
+                throw noEndpoint(chain, endpoints, what);
+            return url;
+        },
+        scrub: (text) => {
+            let out = scrub(text);
+            for (const secret of secrets)
+                out = out.replace(new RegExp(escape(secret), "gi"), "[redacted]");
+            return out;
+        },
+        release: () => {
+            for (const routed of routes.splice(0))
+                routed.release();
+        },
+    };
+}
+//# sourceMappingURL=reach.js.map

package/mcp/dist/reach.js.map

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

package/mcp/dist/resources.js

@@ -0,0 +1,154 @@
+/**
+ * The agent skills this package ships, served as resources: every file under the package's
+ * `skills/` — each skill's `SKILL.md`, its `references/` and its `examples/` — at
+ * `sauce://skills/<skill>/<path>`, and an index of them at `sauce://skills/index`. They are the
+ * same files `sauce skills install` copies into a project, read from the package as they are, so an
+ * agent with only this server reads what an agent with the installed skills reads.
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { PACKAGED_SKILLS } from "./sdk.js";
+export const SKILLS_SCHEME = "sauce://skills/";
+export const SKILLS_INDEX = `${SKILLS_SCHEME}index`;
+/**
+ * How an agent writes a program, as the server's instructions, the prompts and the skill tools say
+ * it (the sauce-overview skill says it in full): it writes the program itself, never from a copied
+ * example, calls things directly, and heads the file with how to run it.
+ */
+export const WRITE_IT_YOURSELF = [
+    "WRITE EACH PROGRAM YOURSELF, in SauceScript, for the task as asked. The skills teach the",
+    "language, each chain's names and the patterns; their examples show idioms and the rules a",
+    "correct program follows, and are not templates to copy, adapt or choose between. Never ask",
+    "the user which example or existing file to start from: ask only for facts the request leaves",
+    "open (an amount, a price limit, a recipient, the chain), then decide, write the program and",
+    "rehearse it with sauce_simulate. Call typed bindings, namespaces and library functions",
+    "directly: no helper around a single call, and no raw selector through evm.static and",
+    "abi.decode where a binding or namespace exists; keep a helper only for real logic used more",
+    "than once. Head every program with a comment: what it does; the sauce command that runs it,",
+    "with --args naming every main parameter in order; one line per parameter with its type,",
+    "meaning and units (smallest units: 5000000000 is 5,000 USDC); and a concrete example on a",
+    "supported chain.",
+];
+export const ACTIONS_SCHEMA = "sauce://actions/schema.json";
+/** The schema the package ships beside `actions/dist`, two levels above this module. */
+const ACTIONS_SCHEMA_FILE = fileURLToPath(new URL("../../actions/action-program.schema.json", import.meta.url));
+const MIME = [
+    [/\.md$/, "text/markdown"],
+    [/\.json$/, "application/json"],
+    [/\.(?:m?ts|js)$/, "text/typescript"],
+];
+const mimeOf = (path) => MIME.find(([pattern]) => pattern.test(path))?.[1] ?? "text/plain";
+/** A skill's `name` and `description`, from its SKILL.md frontmatter (agentskills.io). */
+function frontmatter(text) {
+    const match = /^---\r?\n([^]*?)\r?\n---/.exec(text);
+    const fields = {};
+    for (const line of (match?.[1] ?? "").split(/\r?\n/)) {
+        const field = /^(name|description):\s*(.*)$/.exec(line);
+        if (field !== null)
+            fields[field[1]] = field[2].replace(/^(["'])(.*)\1$/, "$2");
+    }
+    return fields;
+}
+let cached;
+/** The shipped skills, read once: the package's files do not change while it runs. */
+export function shippedSkills(dir = PACKAGED_SKILLS) {
+    if (dir === PACKAGED_SKILLS && cached !== undefined)
+        return cached;
+    const paths = readdirSync(dir, { recursive: true, withFileTypes: true })
+        .filter((entry) => entry.isFile())
+        .map((entry) => relative(dir, join(entry.parentPath, entry.name)).split(sep).join("/"))
+        // In a skill's directory, and no dotfile (an editor's or a file manager's, never shipped).
+        .filter((path) => path.includes("/") && !path.split("/").some((part) => part.startsWith(".")))
+        .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+    const dirs = [...new Set(paths.map((path) => path.split("/")[0]))].filter((skill) => paths.includes(`${skill}/SKILL.md`));
+    const skills = dirs.map((skill) => {
+        const meta = frontmatter(readFileSync(join(dir, skill, "SKILL.md"), "utf8"));
+        const files = paths
+            .filter((path) => path.startsWith(`${skill}/`))
+            .map((path) => ({ uri: `${SKILLS_SCHEME}${path}`, path, skill, mimeType: mimeOf(path) }));
+        return {
+            dir: skill,
+            name: meta.name ?? skill,
+            description: meta.description ?? "",
+            uri: `${SKILLS_SCHEME}${skill}/SKILL.md`,
+            // SKILL.md first: it is the file the rest hang from.
+            files: [
+                ...files.filter((file) => file.path === `${skill}/SKILL.md`),
+                ...files.filter((file) => file.path !== `${skill}/SKILL.md`),
+            ],
+        };
+    });
+    if (dir === PACKAGED_SKILLS)
+        cached = skills;
+    return skills;
+}
+/** The index: each skill, what it is for, and the files it holds. */
+export function skillsIndex(skills) {
+    return [
+        "# Sauce agent skills",
+        "",
+        "Each skill is a SKILL.md and the files it refers to. When a task matches a skill below,",
+        "read its SKILL.md and follow it; it names any further file to read, by a path relative to",
+        `itself — \`references/x.md\` in skill \`s\` is ${SKILLS_SCHEME}s/references/x.md.`,
+        "",
+        ...skills.flatMap((skill) => [
+            `## ${skill.name}`,
+            "",
+            skill.description,
+            "",
+            ...skill.files.map((file) => `- ${file.uri}`),
+            "",
+        ]),
+    ].join("\n");
+}
+const indexes = new WeakMap();
+export function registerResources(server, dir = PACKAGED_SKILLS) {
+    const skills = shippedSkills(dir);
+    const index = () => {
+        const built = indexes.get(skills) ?? skillsIndex(skills);
+        indexes.set(skills, built);
+        return built;
+    };
+    server.registerResource("skills-index", SKILLS_INDEX, {
+        title: "Sauce agent skills: index",
+        description: "Every Sauce agent skill, when to use it, and the files it holds. Read it first, then " +
+            "the SKILL.md of the skill the task needs (sauce-overview to begin).",
+        mimeType: "text/markdown",
+    }, (uri) => ({
+        contents: [{ uri: uri.href, mimeType: "text/markdown", text: index() }],
+    }));
+    server.registerResource("action-program-schema", ACTIONS_SCHEMA, {
+        title: "Action program JSON Schema",
+        description: "The JSON Schema an action program (the document sauce_actions takes) is validated " +
+            "against: every action type and its fields.",
+        mimeType: "application/schema+json",
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/schema+json",
+                text: readFileSync(ACTIONS_SCHEMA_FILE, "utf8"),
+            },
+        ],
+    }));
+    for (const skill of skills) {
+        for (const file of skill.files) {
+            const main = file.path === `${skill.dir}/SKILL.md`;
+            server.registerResource(main ? skill.name : file.path, file.uri, {
+                title: main ? `Skill: ${skill.name}` : file.path,
+                description: main ? skill.description : `${file.path}, from the ${skill.name} skill`,
+                mimeType: file.mimeType,
+            }, (uri) => ({
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: file.mimeType,
+                        text: readFileSync(join(dir, file.path), "utf8"),
+                    },
+                ],
+            }));
+        }
+    }
+}
+//# sourceMappingURL=resources.js.map

package/mcp/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,aAAa,OAAO,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,0FAA0F;IAC1F,2FAA2F;IAC3F,4FAA4F;IAC5F,8FAA8F;IAC9F,6FAA6F;IAC7F,wFAAwF;IACxF,sFAAsF;IACtF,6FAA6F;IAC7F,6FAA6F;IAC7F,yFAAyF;IACzF,2FAA2F;IAC3F,kBAAkB;CACnB,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAC5D,wFAAwF;AACxF,MAAM,mBAAmB,GAAG,aAAa,CACvC,IAAI,GAAG,CAAC,0CAA0C,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CACrE,CAAC;AAoBF,MAAM,IAAI,GAA6C;IACrD,CAAC,OAAO,EAAE,eAAe,CAAC;IAC1B,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAC/B,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;AAEpE,0FAA0F;AAC1F,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,IAAI,MAAoC,CAAC;AAEzC,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,MAAc,eAAe;IACzD,IAAI,GAAG,KAAK,eAAe,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACnE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACrE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;SACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvF,2FAA2F;SAC1F,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;SAC7F,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACnF,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,WAAW,CAAC,CACpC,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,KAAK;aAChB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;aAC9C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,aAAa,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5F,OAAO;YACL,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,GAAG,EAAE,GAAG,aAAa,GAAG,KAAK,WAAW;YACxC,qDAAqD;YACrD,KAAK,EAAE;gBACL,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,WAAW,CAAC;gBAC5D,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,WAAW,CAAC;aAC7D;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,GAAG,KAAK,eAAe;QAAE,MAAM,GAAG,MAAM,CAAC;IAE7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,OAAO;QACL,sBAAsB;QACtB,EAAE;QACF,yFAAyF;QACzF,2FAA2F;QAC3F,kDAAkD,aAAa,oBAAoB;QACnF,EAAE;QACF,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC,IAAI,EAAE;YAClB,EAAE;YACF,KAAK,CAAC,WAAW;YACjB,EAAE;YACF,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7C,EAAE;SACH,CAAC;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAA4B,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAc,eAAe;IAChF,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,GAAW,EAAE;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE3B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CACrB,cAAc,EACd,YAAY,EACZ;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,uFAAuF;YACvF,qEAAqE;QACvE,QAAQ,EAAE,eAAe;KAC1B,EACD,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACR,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;KACxE,CAAC,CACH,CAAC;IACF,MAAM,CAAC,gBAAgB,CACrB,uBAAuB,EACvB,cAAc,EACd;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,oFAAoF;YACpF,4CAA4C;QAC9C,QAAQ,EAAE,yBAAyB;KACpC,EACD,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACR,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,yBAAyB;gBACnC,IAAI,EAAE,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC;aAChD;SACF;KACF,CAAC,CACH,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;YACnD,MAAM,CAAC,gBAAgB,CACrB,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAC7B,IAAI,CAAC,GAAG,EACR;gBACE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;gBAChD,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,cAAc,KAAK,CAAC,IAAI,QAAQ;gBACpF,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,EACD,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACR,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;qBACjD;iBACF;aACF,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/mcp/dist/sdk.js

@@ -0,0 +1,34 @@
+/**
+ * The one place this server reaches into the SDK: the `sauce` command's own modules, as the SDK's
+ * build emits them. Every tool calls the function the matching `sauce` command calls — compile,
+ * tx, simulate, pot, globals, inspect, verify, publish — with the same inputs, so the two front
+ * ends cannot drift. Nothing here is reimplemented.
+ *
+ * By relative path into `sdk/dist`, the one spelling that resolves in the repository and in the
+ * published tarball, where `mcp/dist` and `sdk/dist` are siblings (as `actions` reaches the SDK).
+ * An actions document is lowered by the CLI's `actions.ts`, which loads `actions/dist` itself.
+ */
+export { actionsCommand, actionsProgram } from "../../sdk/dist/cli/actions.js";
+export { addressDefinesOf, CliError, parseAddress, parseChain, parseDefineMap, parseLamports, parseSalt, parseUnixSeconds, parseVia, parseWei, UsageError, } from "../../sdk/dist/cli/args.js";
+export { connect, endpointFor, kitchenFee, potState, registeredBalances, } from "../../sdk/dist/cli/chain.js";
+export { compileCommand, compileProgram, pastDeadline, potCommand, programChains, txCommand, } from "../../sdk/dist/cli/commands.js";
+export { globalsCommand } from "../../sdk/dist/cli/globals.js";
+export { assumedBalances, definesReach, fundingFor, potTarget, programChain, withoutShebang, } from "../../sdk/dist/cli/inputs.js";
+export { inspectCommand, inspectFile } from "../../sdk/dist/cli/inspect.js";
+export { MAX_V4_KEYS, parseV4Key, poolsCommand } from "../../sdk/dist/cli/pools.js";
+export { priceCommand, pricedChain, priceGiven, resolvePriceTokens, tokenGiven, } from "../../sdk/dist/cli/price.js";
+export { defineLabels, fillCommand, fillTargets, } from "../../sdk/dist/cli/fill.js";
+export { buildCancel, buildClaim, buildFill, buildProve, buildRefund, importIntents, INTENT_SCHEMA, intentOf, intentRecord, intentStatus, } from "../../sdk/dist/cli/lifecycle.js";
+export { publishCommand } from "../../sdk/dist/cli/publish.js";
+export { scrub, secret } from "../../sdk/dist/cli/signer.js";
+export { CHAIN_SUPPORT_ISSUES_URL, CHAIN_SUPPORT_NEW_ISSUE_URL, chainSupport, chainSupportRequest, previewRefusal, PreviewChainError, requireSupported, supportedChainNames, } from "../../sdk/dist/cli/support.js";
+export { HOT_WALLET, openWallet } from "../../sdk/dist/cli/wallet-commands.js";
+export { checkPlan, planChain, plannedTransactions, sendPlan, } from "../../sdk/dist/cli/wallet-send.js";
+export { noPolicyNote, PolicyRefusal, readPolicy } from "../../sdk/dist/cli/policy.js";
+export { walletName, WalletStore } from "../../sdk/dist/cli/wallets.js";
+export { simulateCommand } from "../../sdk/dist/cli/simulate.js";
+export { PACKAGED_SKILLS, targetsFor as skillTargets } from "../../sdk/dist/cli/skills.js";
+export { parseAccounts, parsePubkey, svmPotCommand, svmPotExists, svmPotTokenAccounts, svmSimulateCommand, svmTxCommand, svmVerifyCommand, } from "../../sdk/dist/cli/solana.js";
+export { parsePin, verifyCommand } from "../../sdk/dist/cli/verify.js";
+export { CANONICAL_CHAINS, requireChain, } from "../../sdk/dist/chains/canonical.js";
+//# sourceMappingURL=sdk.js.map

package/mcp/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,OAAO,EACP,WAAW,EACX,UAAU,EACV,QAAQ,EACR,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,EACb,SAAS,GAMV,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAO5E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,UAAU,GACX,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,GAEZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,GAEb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EACL,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,QAAQ,GACT,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAmB,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EACL,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GAEjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,YAAY,GAEb,MAAM,oCAAoC,CAAC"}

package/mcp/dist/server.js

@@ -0,0 +1,119 @@
+/**
+ * The Sauce MCP server: the `sauce` command's read-only tools, the agent skills as resources, and
+ * two task prompts — and, over stdio with `--wallets`, the wallet tools. One server per connection
+ * — over stdio, one for the process; over Streamable HTTP, one per request, stateless, and never
+ * with wallets.
+ */
+import { readFileSync } from "node:fs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CHAIN_SUPPORT_NEW_ISSUE_URL, supportedChainNames } from "./sdk.js";
+import { registerPrompts } from "./prompts.js";
+import { registerResources, SKILLS_INDEX, WRITE_IT_YOURSELF } from "./resources.js";
+import { registerSkillTools } from "./skilltools.js";
+import { registerIntentTools } from "./intents.js";
+import { registerTools } from "./tools.js";
+import { registerWalletTools } from "./wallets.js";
+let manifest;
+/** This package's name and version, from the manifest at its root, two levels above this module
+ *  in `mcp/{src,dist}` — read once: a stateless HTTP server builds a server per request. */
+export function packageInfo() {
+    manifest ??= JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
+    return manifest;
+}
+/** What the server tells a client about itself when it connects. */
+export function instructions(endpoints, wallets) {
+    return [
+        "Sauce compiles SauceScript — a checked subset of TypeScript, in .sauce.ts files — into",
+        "programs that run atomically in one transaction: on an EVM chain through the owner's Pot",
+        "(Pot.cook), on Solana through the Kitchen.",
+        "",
+        "Read the agent skills first: sauce_skills lists them, sauce_skill returns one (or one",
+        `section of it). Start with sauce-overview. The same files are resources (${SKILLS_INDEX}).`,
+        "For TypeScript against the SDK, or the sauce command, sauce_dev returns the package's own",
+        "documents. To set a project up for a coding agent, call sauce_install_skills.",
+        "",
+        ...WRITE_IT_YOURSELF,
+        "",
+        "To write and run a program:",
+        "1. sauce_globals for the chain (tokens, protocols): call names, never invent addresses.",
+        "   A fixed sequence of protocol operations can be an actions document in JSON instead:",
+        "   sauce_actions (the sauce-actions skill says how).",
+        "2. sauce_compile until it compiles; entryParams is what main takes, as args.",
+        "3. sauce_pools with rpcUrl for a pair's pools, their prices and depth, before a swap;",
+        "   sauce_price for a swap's price limits (with pool and rpcUrl, from the pool now).",
+        "4. sauce_pot for the owner's Pot: its address, its unsigned deployment, and, with rpcUrl,",
+        "   whether it exists, the Kitchen's fee and what the Pot holds.",
+        "5. sauce_simulate with rpcUrl: the cook rehearsed (any owner will do; nothing is signed).",
+        "6. sauce_tx for the unsigned cook, for the owner to sign. An intent fixed when it is built",
+        "   publishes from a wallet instead: sauce_intent_publish, and sauce_intent_fill with dryRun",
+        "   rehearses a solver filling it on its destination.",
+        "",
+        "An intent's life after it is published: sauce_intent_status says where it stands and what",
+        "can happen next (`can`); sauce_intent_fill (with the solver as from), sauce_intent_prove,",
+        "sauce_intent_claim, sauce_intent_refund and sauce_intent_cancel build each step unsigned;",
+        "sauce_intent_import reads one back from its transaction. This server keeps no intents: pass",
+        "the intent's `record` (sauce_intent_publish and sauce_intent_import return it), or txHash",
+        "and its source chain, and rpcUrls with both chains' endpoints.",
+        "",
+        ...(wallets === undefined
+            ? [
+                "NOTHING HERE SIGNS OR SENDS. Every transaction comes back unsigned, for the user to sign",
+                "with their own wallet; never ask anyone for a private key or a seed phrase.",
+            ]
+            : [
+                "THIS SERVER SIGNS ONLY WITH THE WALLETS IN ITS WALLET DIRECTORY, unlocked by the password",
+                `source it was started with (${wallets.source}). sauce_wallet_list names them;`,
+                "sauce_wallet_create makes one (evm, or solana) and returns its address, never its key.",
+                "Build a transaction for the wallet's address (owner, or from), rehearse it",
+                "(sauce_simulate), then pass the building tool's whole result to sauce_wallet_send, which",
+                "rehearses it again, holds it to the wallet's policy, signs and sends it. Every other",
+                "transaction still comes back unsigned. These are hot wallets: keep small balances in",
+                "them. Never ask anyone for a private key, a seed phrase or the password: no tool takes",
+                "or returns one.",
+            ]),
+        "",
+        `CHAINS. This release builds transactions only on ${supportedChainNames()}. Every other`,
+        "chain is a preview chain (sauce_chains gives each chain's `support`): sauce_compile,",
+        "sauce_actions, sauce_simulate, sauce_inspect, sauce_globals, sauce_price, the dry runs",
+        "(sauce_intent_publish and sauce_intent_fill with dryRun) and the reads (sauce_pools,",
+        "sauce_pot's prediction, sauce_intent_status, sauce_intent_import) work on it, so you can",
+        "prototype any protocol on any chain. A tool that would return a transaction there —",
+        "sauce_tx, sauce_pot's deployment, sauce_actions' cook, sauce_intent_publish, and the intent",
+        "steps on the chain they are sent on — returns `refused` instead: the supported chains and,",
+        "for that chain, a search for an existing chain-support request on GitHub, a prefilled new",
+        "one, and the title, body and comment to post. Tell the user, and offer to find or open that",
+        "request (or to add their use case to it) with the text given; do not build the transaction",
+        "another way.",
+        `Requests: ${CHAIN_SUPPORT_NEW_ISSUE_URL}`,
+        "",
+        "A tool that reads a chain takes rpcUrl, an endpoint for that call; it is never echoed.",
+        endpoints.chainIds.length === 0
+            ? "This server has no endpoint of its own: without rpcUrl, sauce_simulate, transaction " +
+                "hashes and a Solana sauce_tx are unavailable, and an EVM sauce_tx needs `value`."
+            : `This server has its own endpoints for chains ${endpoints.chainIds.join(", ")}.`,
+    ].join("\n");
+}
+export function createSauceServer(options) {
+    const { name, version } = packageInfo();
+    if (options.wallets !== undefined && options.guard !== undefined) {
+        throw new Error("internal: wallets are served over stdio only, and the guard is HTTP's");
+    }
+    const server = new McpServer({ name: "sauce", title: `Sauce (${name})`, version }, {
+        capabilities: { tools: {}, resources: {}, prompts: {} },
+        instructions: instructions(options.endpoints, options.wallets),
+    });
+    const tools = {
+        endpoints: options.endpoints,
+        ...(options.guard === undefined ? {} : { guard: options.guard }),
+        ...(options.wallets === undefined ? {} : { wallets: options.wallets }),
+    };
+    registerTools(server, tools);
+    registerIntentTools(server, tools);
+    if (options.wallets !== undefined)
+        registerWalletTools(server, { ...tools, wallets: options.wallets });
+    registerSkillTools(server, options.skillsDir);
+    registerResources(server, options.skillsDir);
+    registerPrompts(server, options.skillsDir);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/mcp/dist/server.js.map

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