@eco-incorp/sauce 0.99.5 → 0.99.7

package/sdk/dist/cli/globals.js

@@ -0,0 +1,197 @@
+/**
+ * `sauce globals`: the names a program on one chain may use without declaring them — everything
+ * `routes.sourceGlobals` lists, which reads the same registries and the same resolver the compile
+ * path does. Nothing here adds or filters a name beyond what `--tokens`, `--protocols`,
+ * `--protocol`, `--stocks` and `--search` ask for. A chain's tokenized stocks (Ethereum has over a
+ * thousand) are counted, not listed, until `--stocks` lists them or `--search` finds one.
+ */
+import { getAddress, numberToHex } from "viem";
+import { sourceGlobals, } from "../routes/source-globals.js";
+import { STOCK_ISSUERS } from "../routes/stock-tokens.js";
+import { SVM_TOKEN_REGISTRY, TOKEN_REGISTRY } from "../routes/token-registry.js";
+import { TOKEN_2022_PROGRAM_ID } from "../svm/token-program.js";
+import { UsageError } from "./args.js";
+/** A token as `sauce globals --json` gives it: a stock's with its issuer's name and list. */
+function tokenJson(token) {
+    if (token.stock === undefined)
+        return token;
+    const issuer = STOCK_ISSUERS[token.stock.issuer];
+    return { ...token, stock: { ...token.stock, issuerName: issuer.name, source: issuer.source } };
+}
+/** What a search for `text` matches a token by: its symbol, and a stock's name, ticker and issuer,
+ *  or the ticker of a stock another issuer names that way. Coinbase names SpaceX "Space
+ *  Exploration Technologies Corp.", and Backed "SpaceX xStock": both are SPCX. */
+function searcher(text) {
+    const wanted = text.toLowerCase();
+    const has = (field) => field.toLowerCase().includes(wanted);
+    const tickers = new Set(Object.values(TOKEN_REGISTRY).flatMap((rows) => rows.flatMap((row) => row.stock !== undefined && has(row.stock.name) ? [row.stock.ticker] : [])));
+    return (token) => has(token.symbol) ||
+        has(token.mint ?? "") ||
+        (token.stock !== undefined &&
+            (has(token.stock.name) ||
+                has(token.stock.ticker) ||
+                has(STOCK_ISSUERS[token.stock.issuer].name) ||
+                tickers.has(token.stock.ticker)));
+}
+/** A define as JSON: an address-sized value as its checksummed address, a wider one (a Solana
+ *  mint's key) as 32 bytes of hex, anything else in decimal. */
+function defineValue(value) {
+    if (typeof value !== "bigint")
+        return value;
+    if (value >= 1n << 160n && value < 1n << 256n)
+        return numberToHex(value, { size: 32 });
+    return value >= 1n << 64n && value < 1n << 160n
+        ? getAddress(numberToHex(value, { size: 20 }))
+        : value.toString();
+}
+const squash = (text) => text.toLowerCase().replace(/[^a-z0-9]/g, "");
+function namespaceNamed(namespaces, interfaces, name) {
+    const wanted = squash(name);
+    const found = namespaces.find((ns) => ns.namespace === name) ??
+        namespaces.find((ns) => squash(ns.namespace) === wanted ||
+            (ns.kind === "protocol" && ns.protocols.some((slug) => squash(slug) === wanted)));
+    const key = found?.namespace;
+    const bound = interfaces.filter((one) => key === undefined
+        ? one.namespace === name ||
+            squash(one.namespace) === wanted ||
+            squash(one.protocol) === wanted
+        : one.namespace === key);
+    if (found === undefined && bound.length === 0) {
+        const names = [...new Set([...namespaces, ...interfaces].map((ns) => ns.namespace))].sort();
+        throw new UsageError(`--protocol: '${name}' is not a namespace a program can use here; the chain has ` +
+            (names.length === 0 ? "none" : names.join(", ")));
+    }
+    return { ...(found === undefined ? {} : { namespace: found }), interfaces: bound };
+}
+/** An interface's lines: how a program binds it, and with `methods` what it can call. */
+function interfaceLines(one, methods) {
+    return [
+        `${one.namespace}.${one.name}(<address>)  interface (${one.protocolName}): no fixed address`,
+        ...(methods
+            ? one.methods.map((method) => `  ${method.declaration}  ${method.stateMutability}`)
+            : []),
+    ];
+}
+function namespaceLines(ns, methods) {
+    const head = ns.kind === "family"
+        ? `${ns.namespace}  (alias over ${ns.protocols.join(", ")})`
+        : `${ns.namespace}  (${ns.name})`;
+    const width = Math.max(...ns.contracts.map((contract) => contract.name.length));
+    return [
+        head,
+        ...ns.contracts.flatMap((contract) => [
+            `  ${contract.name.padEnd(width)}  ${contract.address}${contract.default ? "  default" : ""}` +
+                (ns.kind === "family" ? `  (${contract.protocol})` : ""),
+            ...(methods
+                ? contract.methods.map((method) => `    ${method.declaration}  ${method.stateMutability}`)
+                : []),
+        ]),
+    ];
+}
+/** `sauce globals`: the chain's tokens, protocol namespaces, chain names and ambient functions. */
+export function globalsCommand(input) {
+    const globals = sourceGlobals(input.chain);
+    const named = input.protocol === undefined
+        ? undefined
+        : namespaceNamed(globals.protocols, globals.interfaces, input.protocol);
+    const one = named?.namespace;
+    const search = input.search?.trim();
+    if (input.search !== undefined && !search)
+        throw new UsageError("--search: give the text to find");
+    // No filter shows everything; any filter shows only what it names.
+    const all = !input.tokens && !input.protocols && named === undefined && !input.stocks && !search;
+    const showTokens = all || input.tokens || input.stocks === true || search !== undefined;
+    const showProtocols = all || input.protocols;
+    // The tokens listed: a search's matches, the chain's stocks, or its other tokens.
+    const stocks = globals.tokens.filter((token) => token.stock !== undefined);
+    const listed = search !== undefined
+        ? globals.tokens.filter(searcher(search))
+        : input.stocks === true
+            ? stocks
+            : globals.tokens.filter((token) => token.stock === undefined);
+    const { chain } = globals;
+    const text = [`${chain.key}: ${chain.slug}, chain id ${chain.id} (${chain.kind})`];
+    if (one !== undefined)
+        text.push("", ...namespaceLines(one, true));
+    for (const bound of named?.interfaces ?? [])
+        text.push("", ...interfaceLines(bound, true));
+    const svm = chain.kind === "svm";
+    // A devnet program compiles for the same chain, so its mints are not what a symbol resolves to:
+    // they are listed for it to pass as defines, which override the registry's.
+    const devnet = svm ? SVM_TOKEN_REGISTRY.devnet : [];
+    if (showTokens && svm) {
+        const rows = [...listed, ...devnet];
+        const width = Math.max(0, ...rows.map((token) => token.symbol.length));
+        const mintWidth = Math.max(0, ...rows.map((token) => (token.mint ?? "").length));
+        // A Token-2022 mint says so: its writes are the checked ones, and its accounts derive under it.
+        const line = (token) => `${token.symbol.padEnd(width)}  ${(token.mint ?? "").padEnd(mintWidth)}  ${token.address}  ` +
+            `${token.decimals} decimals${token.tokenProgram === TOKEN_2022_PROGRAM_ID ? ", Token-2022" : ""}`;
+        text.push("", `Tokens (${listed.length}): the symbol is the mint's 32-byte key, a value for the ` +
+            "@sauce/token functions: balanceOf(USDC, account)", ...listed.map((token) => `  ${line(token)}`), "  On devnet, pass a mint that differs as a define, which wins (--define USDC=0x…):", ...devnet.map((token) => `    ${line(token)}`), "  Any other mint: --define MINT=<mint, as 32-byte hex>. Token accounts are Account", "  parameters; USDC.transfer(…) and the other token methods are EVM-only.");
+    }
+    else if (showTokens) {
+        const what = search !== undefined
+            ? `Tokens matching '${search}' (${listed.length})`
+            : input.stocks === true
+                ? `Stock tokens (${listed.length}): tokenized stocks`
+                : `Tokens (${listed.length})`;
+        text.push("", `${what}: <Sym>.transfer(…), or the symbol as an address`);
+        const width = Math.max(0, ...listed.map((token) => token.symbol.length));
+        for (const { symbol, address, decimals, stock } of listed) {
+            // A stock with what it is, so a search for the company finds its token.
+            const about = stock === undefined
+                ? ""
+                : `  ${stock.name} (${stock.ticker}, ${STOCK_ISSUERS[stock.issuer].name})`;
+            text.push(`  ${symbol.padEnd(width)}  ${address}  ${decimals} decimals${about}`);
+        }
+        if (search === undefined && input.stocks !== true && stocks.length > 0) {
+            text.push(`  And ${stocks.length} stock tokens, named the same way: --stocks lists them, and ` +
+                "--search <text> finds one by symbol, name or ticker");
+        }
+        text.push("  Any other token: Token(0x…).transfer(…)");
+    }
+    if (showProtocols && svm) {
+        text.push("", "Protocols: none. Protocol namespaces are EVM contracts.");
+    }
+    else if (showProtocols) {
+        text.push("", `Protocols (${globals.protocols.length}): <Namespace>.<Contract>.<method>(…); ` +
+            "`sauce globals --protocol <name>` lists the methods");
+        for (const ns of globals.protocols)
+            text.push(...namespaceLines(ns, false).map((l) => `  ${l}`));
+        text.push("", `Interfaces (${globals.interfaces.length}): an ABI with no fixed address, bound to one the ` +
+            "program gives: <Namespace>.<Interface>(<address>).<method>(…)", ...globals.interfaces.map((bound) => `  ${bound.namespace}.${bound.name}  (${bound.protocolName})`));
+    }
+    if (all) {
+        text.push("", "Chains: open an intent with <Chain>(() => { … }), or qualify an accessor as <Chain>.<Namespace>", `  ${globals.chains.map((other) => other.key).join(", ")}`, "", svm
+            ? "Defines: chainId"
+            : "Defines: chainId, and <Namespace>_<Contract> for each contract's address");
+        for (const module of globals.modules) {
+            text.push("", `Functions from ${module.specifier} (no import):`);
+            for (const fn of module.functions)
+                text.push(`  ${fn}`);
+        }
+    }
+    return {
+        text: text.join("\n"),
+        json: {
+            chain,
+            ...(one === undefined ? {} : { protocol: one }),
+            ...(showTokens ? { tokens: listed.map(tokenJson) } : {}),
+            ...(showTokens && svm ? { devnetTokens: devnet } : {}),
+            // The interfaces asked for: every one beside the namespaces, or --protocol's own.
+            ...(showProtocols
+                ? { protocols: globals.protocols, interfaces: globals.interfaces }
+                : named !== undefined && named.interfaces.length > 0
+                    ? { interfaces: named.interfaces }
+                    : {}),
+            ...(all
+                ? {
+                    chains: globals.chains,
+                    defines: Object.fromEntries(Object.entries(globals.defines).map(([name, value]) => [name, defineValue(value)])),
+                    modules: globals.modules,
+                }
+                : {}),
+        },
+    };
+}
+//# sourceMappingURL=globals.js.map

package/sdk/dist/cli/globals.js.map

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

package/sdk/dist/cli/init.d.ts

@@ -0,0 +1,34 @@
+import { type Agent, type SkillsSource, type TargetReport } from "./skills.js";
+/** Where `sauce init` puts the project's SauceScript programs: the directory its tsconfig covers. */
+export declare const PROGRAMS_DIR = "programs";
+/**
+ * The tsconfig.json of the programs directory: a TypeScript project of SauceScript files alone,
+ * with the package's declarations of the language (`<package>/sauce-script`) and its plugin, which
+ * drops what TypeScript reports on valid SauceScript (integer indexes, `1` beside `1n`, undeclared
+ * UPPER_CASE defines). Its own project, because those declarations name `require`, `crypto` and
+ * `eval` as SauceScript has them: kept out of the project's other TypeScript, they cannot change
+ * it. An editor takes a file's nearest tsconfig.json, so every program in the directory gets it.
+ */
+export declare function sauceScriptTsconfig(packageName: string): Record<string, unknown>;
+/** The files `sauce init` writes for `agents`, by path relative to the project. */
+export declare function scaffold(dir: string, source: SkillsSource, agents: readonly Agent[]): Record<string, string>;
+/**
+ * `sauce init <dir> --tsconfig`: only `<dir>/tsconfig.json`, the programs' TypeScript project of
+ * {@link sauceScriptTsconfig}, for a directory of programs in a project `init` did not write (or
+ * outside `programs/`). Never overwrites a different file without `force`.
+ */
+export declare function writeSauceScriptTsconfig(dir: string, packageName: string, force: boolean): {
+    readonly path: string;
+    readonly state: string;
+};
+export interface InitResult {
+    /** Each scaffold file, with whether it was `wrote`, `unchanged` or `overwrote`. */
+    readonly files: ReadonlyArray<{
+        readonly path: string;
+        readonly state: string;
+    }>;
+    readonly skills: readonly TargetReport[];
+}
+/** Scaffolds `dir` (created if absent) for `agents`, then installs their skills into it. */
+export declare function initProject(dir: string, source: SkillsSource, agents: readonly Agent[], force: boolean): InitResult;
+//# sourceMappingURL=init.d.ts.map

package/sdk/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAmBA,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAarB,qGAAqG;AACrG,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBhF;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,SAAS,KAAK,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgExB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAoBnD;AAED,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAMD,4FAA4F;AAC5F,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,KAAK,EAAE,OAAO,GACb,UAAU,CAgCZ"}

package/sdk/dist/cli/init.js

@@ -0,0 +1,181 @@
+/**
+ * `sauce init`: a project that needs nothing but this package — a manifest pinning it, agent
+ * instructions every coding agent reads, a `.gitignore` for the local config that holds
+ * endpoints, a placeholder example of that config, a `programs/` directory whose tsconfig.json
+ * gives an editor SauceScript's names (`sauceScriptTsconfig`), and the agent skills (`skills.ts`).
+ *
+ * The instructions are `AGENTS.md`, which Codex, Cursor, Copilot and Claude Code read
+ * (agents.md). Claude Code reads it only while no `CLAUDE.md` exists, and Gemini CLI reads
+ * `GEMINI.md`, so for those two agents `init` adds the one-line file each documents for sharing it:
+ * `@AGENTS.md` (code.claude.com/docs/en/memory) and `@./AGENTS.md` (geminicli.com, GEMINI.md
+ * imports).
+ *
+ * It overwrites nothing without `--force`: every file it would write that already exists with
+ * other content is listed and the whole scaffold refused, before anything is written.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { CliError } from "./args.js";
+import { installTarget, targetsFor, withoutBlock, } from "./skills.js";
+/** A package name npm accepts, from a directory's name. */
+function packageNameOf(dir) {
+    const name = basename(resolve(dir))
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^[._-]+/, "")
+        .replace(/-+$/, "");
+    return name === "" ? "sauce-project" : name;
+}
+/** Where `sauce init` puts the project's SauceScript programs: the directory its tsconfig covers. */
+export const PROGRAMS_DIR = "programs";
+/**
+ * The tsconfig.json of the programs directory: a TypeScript project of SauceScript files alone,
+ * with the package's declarations of the language (`<package>/sauce-script`) and its plugin, which
+ * drops what TypeScript reports on valid SauceScript (integer indexes, `1` beside `1n`, undeclared
+ * UPPER_CASE defines). Its own project, because those declarations name `require`, `crypto` and
+ * `eval` as SauceScript has them: kept out of the project's other TypeScript, they cannot change
+ * it. An editor takes a file's nearest tsconfig.json, so every program in the directory gets it.
+ */
+export function sauceScriptTsconfig(packageName) {
+    return {
+        compilerOptions: {
+            target: "ES2022",
+            lib: ["ES2022"],
+            module: "ESNext",
+            moduleResolution: "Bundler",
+            // Each program is a module of its own: two programs' `main` never collide.
+            moduleDetection: "force",
+            // Only SauceScript's names: no Node, no DOM.
+            types: [`${packageName}/sauce-script`],
+            // An unannotated helper parameter is a number in SauceScript, not an error.
+            strict: true,
+            noImplicitAny: false,
+            noEmit: true,
+            allowImportingTsExtensions: true,
+            // A JSON import is a contract binding, which the declarations type, not the file's JSON.
+            resolveJsonModule: false,
+            skipLibCheck: true,
+            // Loaded by an editor running the project's own TypeScript (node_modules/typescript).
+            plugins: [{ name: `${packageName}/sdk/dist/sauce-script/ts-plugin.cjs` }],
+        },
+        include: ["**/*.sauce.ts"],
+    };
+}
+/** The files `sauce init` writes for `agents`, by path relative to the project. */
+export function scaffold(dir, source, agents) {
+    const manifest = {
+        name: packageNameOf(dir),
+        version: "0.0.0",
+        private: true,
+        type: "module",
+        engines: { node: ">=24" },
+        // Exactly the version that scaffolded it: the skills installed beside it describe this one.
+        dependencies: { [source.packageName]: source.version },
+        // The TypeScript an editor runs for the programs' plugin: the project's own.
+        devDependencies: { typescript: source.typescript ?? "^5.7.0" },
+    };
+    return {
+        "package.json": `${JSON.stringify(manifest, null, 2)}\n`,
+        "AGENTS.md": [
+            "# AGENTS.md",
+            "",
+            `This project writes Sauce programs with \`${source.packageName}\`, pinned in \`package.json\`.`,
+            "",
+            "- Use the agent skills the package installed (`npx sauce skills status` lists them).",
+            "  Start with `sauce-overview`, which says what Sauce is and which skill covers a task;",
+            "  `sauce-cli` covers compiling a program, rehearsing it and running it on a Pot. They",
+            "  describe the pinned version of the package.",
+            "- Run the package's CLI as `npx sauce` (`npx sauce --help`). `sauce simulate` rehearses a",
+            "  program with no key, `sauce run` signs and sends it, and `sauce tx` prints the unsigned",
+            "  transaction for a wallet.",
+            `- Write programs in \`${PROGRAMS_DIR}/\`, as \`*.sauce.ts\`. Its \`tsconfig.json\` gives an editor`,
+            "  SauceScript's names (its types and builtins, the chains, token symbols, protocol",
+            "  namespaces and the package's ABIs) and a TypeScript plugin that drops what TypeScript",
+            "  reports on valid SauceScript: integer indexes, `1` beside `1n`, undeclared UPPER_CASE",
+            "  defines. The plugin loads where the editor runs the project's own TypeScript. The compile",
+            "  (`npx sauce compile <file> --chain <chain>`) is what decides.",
+            "- Keep RPC URLs and keys out of tracked files. RPC URLs go in `sauce.config.json`, which is",
+            "  gitignored (start from `sauce.config.example.json`), and reach the CLI as",
+            "  `--config sauce.config.json`. Sign with a keystore (`--keystore`), not a key on the",
+            "  command line.",
+            "- After upgrading the package, run `npx sauce skills update`; `npx sauce skills status`",
+            "  fails while the skills are outdated.",
+            "",
+        ].join("\n"),
+        ...(agents.includes("claude") ? { "CLAUDE.md": "@AGENTS.md\n" } : {}),
+        ...(agents.includes("gemini") ? { "GEMINI.md": "@./AGENTS.md\n" } : {}),
+        ".gitignore": [
+            "node_modules/",
+            "",
+            "# Local configuration: RPC URLs, and anything secret. Commit the example, never these.",
+            "sauce.config.json",
+            ".env",
+            ".env.*",
+            "",
+        ].join("\n"),
+        "sauce.config.example.json": `${JSON.stringify({
+            rpcUrls: {
+                "1": "<RPC_URL for Ethereum>",
+                "8453": "<RPC_URL for Base>",
+            },
+        }, null, 2)}\n`,
+        [`${PROGRAMS_DIR}/tsconfig.json`]: `${JSON.stringify(sauceScriptTsconfig(source.packageName), null, 2)}\n`,
+    };
+}
+/**
+ * `sauce init <dir> --tsconfig`: only `<dir>/tsconfig.json`, the programs' TypeScript project of
+ * {@link sauceScriptTsconfig}, for a directory of programs in a project `init` did not write (or
+ * outside `programs/`). Never overwrites a different file without `force`.
+ */
+export function writeSauceScriptTsconfig(dir, packageName, force) {
+    const path = join(dir, "tsconfig.json");
+    const content = `${JSON.stringify(sauceScriptTsconfig(packageName), null, 2)}\n`;
+    const state = !existsSync(path)
+        ? "wrote"
+        : readFileSync(path, "utf8") === content
+            ? "unchanged"
+            : "overwrote";
+    if (state === "overwrote" && !force) {
+        throw new CliError(`${path} already exists with other content: pass --force to replace it with SauceScript's ` +
+            "project, or merge its compilerOptions (`types`, `plugins`) and include into it");
+    }
+    if (state !== "unchanged") {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(path, content);
+    }
+    return { path, state };
+}
+/** A file as `init` compares it: `AGENTS.md` without the skills block, which is not its own. */
+const comparable = (path, text) => path === "AGENTS.md" ? withoutBlock(text).trimEnd() : text;
+/** Scaffolds `dir` (created if absent) for `agents`, then installs their skills into it. */
+export function initProject(dir, source, agents, force) {
+    const files = scaffold(dir, source, agents);
+    const states = Object.entries(files).map(([path, content]) => {
+        const target = join(dir, path);
+        const state = !existsSync(target)
+            ? "wrote"
+            : comparable(path, readFileSync(target, "utf8")) === comparable(path, content).trimEnd() ||
+                readFileSync(target, "utf8") === content
+                ? "unchanged"
+                : "overwrote";
+        return { path, content, state };
+    });
+    const conflicts = states.filter((file) => file.state === "overwrote").map((file) => file.path);
+    if (conflicts.length > 0 && !force) {
+        throw new CliError(`${dir} already has files init would overwrite:\n` +
+            conflicts.map((path) => `  ${path}`).join("\n") +
+            "\nPass --force to overwrite them.");
+    }
+    mkdirSync(dir, { recursive: true });
+    for (const file of states) {
+        if (file.state === "unchanged")
+            continue;
+        mkdirSync(dirname(join(dir, file.path)), { recursive: true });
+        writeFileSync(join(dir, file.path), file.content);
+    }
+    return {
+        files: states.map(({ path, state }) => ({ path, state })),
+        skills: targetsFor(agents).map((target) => installTarget(dir, source, target)),
+    };
+}
+//# sourceMappingURL=init.js.map

package/sdk/dist/cli/init.js.map

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

package/sdk/dist/cli/inputs.d.ts

@@ -0,0 +1,72 @@
+/**
+ * What a command's input means, given as plain values: the chain a program runs on, whether its
+ * defines reach it, the Pot a cook runs on, and the funding and assumed balances a cook carries.
+ *
+ * `run.ts` reads these values from the command line and `sauce mcp` (`mcp/`) from a tool's
+ * arguments; both hand them here, so the rules are one set whichever front end a program comes
+ * through. The messages name the CLI's flags, which the MCP tools mirror by name.
+ */
+import type { Address } from "viem";
+import type { PrivateKeyAccount } from "viem/accounts";
+import { type CanonicalChain } from "../chains/canonical.js";
+import type { Approver, CookInput, PotInput } from "./commands.js";
+import { type FundRequest } from "./funding.js";
+/**
+ * A program's text with a leading `#!` line blanked: each of its characters a space, so every
+ * offset and line number after it — the compiler's diagnostics, a `// @chain` header — is the
+ * file's own. A program file may start with one to run as a command (`#!/usr/bin/env -S npx -y
+ * @eco-incorp/sauce simulate`); the compiler accepts it only as the very first bytes, and the SDK
+ * puts imports above the program, so it is blanked before the compile sees it.
+ */
+export declare function withoutShebang(text: string): string;
+/**
+ * The chain a program runs on: `given.chain`, else the file's `// @chain`, else — for a `svm`
+ * target given or in its `// @target` alone — the one SVM chain, else `fallback`. A target that
+ * disagrees with the chain is an error, wherever either came from.
+ */
+export declare function programChain(given: {
+    readonly chain?: string;
+    readonly target?: string;
+}, file: string, text: string, fallback?: CanonicalChain): CanonicalChain;
+/**
+ * Refuses a define the program would never see. A file with no `function main` is a script: its
+ * top-level statements are the entry's body, so a `const` there is the script's own local, and a
+ * define of the same name — which replaces a MODULE-level const — would be silently ignored.
+ */
+export declare function definesReach(file: string, text: string, names: readonly string[]): void;
+/** The Pot a cook names: by address, or by its owner and salt. */
+export interface PotGiven {
+    readonly pot?: string | undefined;
+    readonly owner?: string | undefined;
+    readonly salt?: string | undefined;
+    readonly saltHex?: string | undefined;
+}
+/**
+ * The Pot a cook runs on: `pot`, or derived from `owner` — or, when `signer` is given (a run), from
+ * the signer, whose Pot it must be anyway.
+ */
+export declare function potTarget(given: PotGiven, signer?: Address): PotInput;
+/** `--fund`, `--fund-mode` and `--sweep`, and what the cook may do about them. */
+export interface FundingGiven {
+    readonly chain: CanonicalChain;
+    readonly rpcUrl: string;
+    /** `--fund` values, `<TOKEN|address>:<amount>`. */
+    readonly fund: readonly string[];
+    readonly mode?: string;
+    readonly sweep: boolean;
+    /** May the run approve and transfer before the cook (`run`), or only report (`simulate`)? */
+    readonly send: boolean;
+    /** Who signs the pulls; absent, a simulation credits the Pot instead. */
+    readonly account?: PrivateKeyAccount;
+    /** Who approves the transactions a run sends before its cook (`--auto-approve`, or a person). */
+    readonly approver: Approver;
+}
+/**
+ * The funding a cook carries, as the callback `runCommand`/`simulateCommand` call once the Pot is
+ * there; `undefined` with nothing to fund. Everything about the requests is checked here, before
+ * anything is sent.
+ */
+export declare function fundingFor(given: FundingGiven): CookInput["fund"];
+/** `--assume-balance` values, `<TOKEN|address>:<amount>`, each named once. */
+export declare function assumedBalances(raws: readonly string[], chain: CanonicalChain): FundRequest[];
+//# sourceMappingURL=inputs.d.ts.map

package/sdk/dist/cli/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/cli/inputs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAW/E,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CA0BhB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAavF;AAED,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAmBrE;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,iGAAiG;IACjG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CA4DjE;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,GAAG,WAAW,EAAE,CAW7F"}