@intent-engine/cli 0.1.22 → 0.1.26

package/dist/src/commands.js

@@ -1,7 +1,6 @@
-import { createNoopSigner, getBase58Decoder, getBase64Decoder, getBase64Encoder, isSignerRole, isWritableRole, } from "@solana/kit";
-import { buildAcceptAdmin, buildAdvanceEpoch, buildProposeAdmin, buildUpdateConfig, buildAdvanceNonce, buildCancelIntent, buildInitConfig, buildLowerPause, buildRaisePause, buildUpdateEconomics, decodeEvent, findConfigPda, findIntentPda, findUserStatePda, feeBpsFor, findVaultPda, getIntentDecoder, IntentStatus, getUserStateDecoder, kindBit, nextEpoch, PAUSE_CREATE, PAUSE_FILL, U64_MAX, } from "@intent-engine/core";
-import { decodeLookupTable, issuePricer, jitoBundles, jupiterPricer, remembering, solverTableAccounts, tick, tipAccount, } from "@intent-engine/solver";
-import { chainTime, clusterDomain, createdAccount, loadConfig, loadIntent, memoized, tokenAmountOf, tokenProgramOf, } from "@intent-engine/client";
+import { buildAdvanceEpoch, buildAdvanceNonce, buildCancelIntent, buildCloseIntent, findIntentPda, findUserStatePda, findVaultPda, getUserStateDecoder, nextEpoch, } from "@intent-engine/core";
+import { solverTableAccounts, tick } from "@intent-engine/solver";
+import { clusterDomain, createdAccount, loadConfig, loadIntent, tokenAccountIfMissing, tokenProgramOf, } from "@intent-engine/client";
 import { agentServer } from "./agent/mcp.js";
 import { claimsOf } from "./agent/claims.js";
 import { budgetOf } from "./agent/budget.js";
@@ -10,283 +9,23 @@ import { relayOf } from "./agent/relay.js";
 import { usageOf } from "./args.js";
 import { VERSION } from "./version.js";
 import { balances, defaultMints, setup } from "./wallet.js";
-import { prepare } from "./agent/prepare.js";
-import { KIND_NAMES, KINDS, preparedView } from "./agent/shapes.js";
-import { prepareCreate } from "./agent/create.js";
-import { getMandate, prepareAgentCreate, prepareMandate, prepareRevokeMandate } from "./agent/mandate.js";
-import { listIntents } from "./agent/read.js";
-import { prepareSignedIntent, previewSignedIntent, submitSignedIntent } from "./agent/signed.js";
-import { approval, ask, finish, FlowRefused, hasTokens, inRaw, NOT_SENT, perform, signMessage } from "./flows.js";
-import { loadMandate } from "./agent/mandate.js";
-import { RELAY_MAX_TTL } from "./args.js";
+import { FlowRefused } from "./flows.js";
 import { describeIntent, quoteOf, sameBytes } from "./accounts.js";
 import { closing, crank, expiring } from "./crank.js";
-import { priceOf, withPriority } from "./compute.js";
+import { withPriority } from "./compute.js";
 import { createTreasuryAccounts, intentInputMints, treasuryView } from "./treasury.js";
-const SOLVER_ROUTE_ACCOUNTS = 40;
-export const configExists = (config) => `the engine is already set up on this cluster (config ${config}); change it with update-config, set-economics, raise-pause or lower-pause`;
-export const ENV_JUPITER_KEY = "JUPITER_API_KEY";
-export const JUPITER_DOMAIN = "jup.ag";
-export function jupiterHost(url) {
-    const host = new URL(url).hostname;
-    return host === JUPITER_DOMAIN || host.endsWith(`.${JUPITER_DOMAIN}`);
-}
+import { artifactSha256, judge } from "./judge.js";
+import { adminCommand, previewed } from "./admin-commands.js";
+import { jobCommand } from "./job-commands.js";
+import { engineEvents } from "./event-feed.js";
+import { SOLVER_TABLE_NEXT, solverOptions } from "./solve-commands.js";
+import { flowCommand } from "./flow-commands.js";
+export { AUTHORITY_NEXT, configExists } from "./admin-commands.js";
+export { NOT_RELEASED } from "./job-commands.js";
+export { follow, followGap } from "./event-feed.js";
+export { decodedChanges, ENV_JUPITER_KEY, IN_FLIGHT_SECONDS, JUPITER_DOMAIN, jupiterHost, REFRESH_AFTER_SECONDS, SOLVER_TABLE_NEXT, stillOpen, watchSolve, } from "./solve-commands.js";
 export * from "./accounts.js";
 export * from "./crank.js";
-const SIGNED_FILE_VERSION = 1;
-export const SOLVER_TABLE_NEXT = "put these in an address lookup table you own (solana address-lookup-table create, then extend with them) and pass it to solve with --lookup-table";
-function relayAnything(signer, mint) {
-    return relayOf(signer, {
-        maxLamports: U64_MAX,
-        maxTtl: BigInt(RELAY_MAX_TTL),
-        perHour: Number.MAX_SAFE_INTEGER,
-        hourlyLamports: U64_MAX,
-        fees: new Map([[mint, 0n]]),
-    });
-}
-async function rawFlowInput(transport, flow, input, signer) {
-    if (flow === "approve" || flow === "revoke-approval") {
-        const mint = input["mint"];
-        return inRaw(transport, input, mint, mint);
-    }
-    if (flow === "mandate-use") {
-        if (!hasTokens(input)) {
-            return input;
-        }
-        const owner = input["owner"];
-        const id = input["id"] === undefined ? 0n : BigInt(input["id"]);
-        const { mandate } = await loadMandate(transport, owner, signer, id);
-        return inRaw(transport, input, mandate.inputMint, mandate.outputMint);
-    }
-    if (flow === "mandate-revoke") {
-        return input;
-    }
-    return inRaw(transport, input, input["input_mint"], input["output_mint"]);
-}
-function context(transport, relay = undefined) {
-    return { transport, relay, agent: undefined, claims: claimsOf() };
-}
-export const AUTHORITY_NEXT = "import transaction_base58 into the multisig as a proposal (its blockhash and fee payer are replaced there), or build one from instructions; it carries no compute budget so it can run from a vault";
-function instructionView(ix) {
-    return {
-        program: ix.programAddress,
-        accounts: (ix.accounts ?? []).map((meta) => ({
-            address: meta.address,
-            signer: isSignerRole(meta.role),
-            writable: isWritableRole(meta.role),
-        })),
-        data: getBase64Decoder().decode(ix.data ?? new Uint8Array()),
-    };
-}
-const kindList = (mask) => KINDS.filter((kind) => (mask & kindBit(kind)) !== 0n)
-    .map((kind) => KIND_NAMES[kind])
-    .join(", ") || "none";
-const pauseList = (flags) => [...((flags & PAUSE_CREATE) !== 0 ? ["creating"] : []), ...((flags & PAUSE_FILL) !== 0 ? ["filling"] : [])].join(" and ") ||
-    "nothing";
-async function administer(transport, runtime, by, build, summary, extra = {}) {
-    if ("keypair" in by) {
-        const signer = await runtime.loadSigner(by.keypair);
-        const instructions = await build(signer);
-        const described = { ...extra, summary: summary(signer.address) };
-        if (!by.yes) {
-            const simulated = await prepare(transport, instructions, signer.address);
-            return { ...described, sent: false, units_consumed: simulated.unitsConsumed, next: NOT_SENT };
-        }
-        return { ...described, sent: true, signature: await transport.send(instructions, signer) };
-    }
-    const instructions = await build(createNoopSigner(by.authority));
-    const unbudgeted = { ...transport, budget: async (ixs) => [...ixs] };
-    const view = preparedView(await prepare(unbudgeted, instructions, by.authority));
-    return {
-        ...extra,
-        summary: summary(by.authority),
-        unsigned: {
-            ...view,
-            transaction_base58: getBase58Decoder().decode(getBase64Encoder().encode(view.transaction)),
-            instructions: instructions.map(instructionView),
-            next: AUTHORITY_NEXT,
-        },
-    };
-}
-async function engineEvents(transport, limit) {
-    return (await transport.engineTransactions(limit)).map((tx) => ({
-        signature: tx.signature,
-        slot: tx.slot,
-        blockTime: tx.blockTime,
-        failed: tx.failed,
-        events: tx.failed ? [] : tx.emitted.map(decodeEvent).filter((e) => e !== null),
-    }));
-}
-export const followGap = (limit) => `more than ${limit} engine transactions landed since the last poll, so some were not shown; raise --limit or lower --interval`;
-export async function follow(transport, runtime, limit, interval, emit) {
-    let seen = new Set();
-    let shown = 0;
-    do {
-        const fetched = await engineEvents(transport, limit);
-        const fresh = fetched.filter((tx) => !seen.has(tx.signature)).reverse();
-        if (seen.size > 0 && fetched.length >= limit && fresh.length === fetched.length) {
-            emit({ gap: true, warning: followGap(limit) });
-        }
-        for (const tx of fresh) {
-            emit(tx);
-            shown++;
-        }
-        seen = new Set(fetched.map((tx) => tx.signature));
-    } while (await runtime.sleep(interval));
-    return shown;
-}
-export const IN_FLIGHT_SECONDS = 90n;
-export const REFRESH_AFTER_SECONDS = 60n;
-export function decodedChanges(changed) {
-    const intents = [];
-    const unreadable = [];
-    for (const { address, data } of changed) {
-        try {
-            intents.push({ address, intent: getIntentDecoder().decode(data) });
-        }
-        catch {
-            unreadable.push(address);
-        }
-    }
-    return { intents, unreadable };
-}
-export async function stillOpen(transport, intents) {
-    const views = await transport.getAccounts(intents);
-    return intents.filter((_, i) => {
-        const view = views[i];
-        return view !== null && view !== undefined && getIntentDecoder().decode(view.data).status === IntentStatus.Open;
-    });
-}
-export async function watchSolve(command, interval, runtime, emit) {
-    const transport = withPriority(runtime.transport(command.url), command.priority);
-    const options = await solverOptions(command, runtime, transport);
-    const chain = remembering(options.chain);
-    const live = {
-        ...options,
-        chain,
-        send: command.jito === undefined ? async (wire) => ({ signature: await transport.submitWire(wire), confirmed: false }) : options.send,
-    };
-    const changes = runtime.intentChanges(command.url);
-    const inFlight = new Map();
-    const failing = new Map();
-    let scannedAt = null;
-    let acted = 0;
-    try {
-        for (let changed = []; changed !== null; changed = await changes.wait(interval)) {
-            const now = runtime.now();
-            const began = performance.now();
-            let full = false;
-            try {
-                full = changed.length === 0 || scannedAt === null || now - scannedAt >= BigInt(interval);
-                const decoded = full ? { intents: await chain.intents(), unreadable: [] } : decodedChanges(changed);
-                if (full) {
-                    scannedAt = now;
-                }
-                if (decoded.unreadable.length > 0) {
-                    emit({ at: now, scan: "changed", unreadable: decoded.unreadable });
-                }
-                const listed = decoded.intents;
-                for (const [intent, until] of inFlight) {
-                    if (until <= now) {
-                        inFlight.delete(intent);
-                    }
-                }
-                const due = listed.filter(({ address }) => !inFlight.has(address));
-                const { filled, sent, failed } = await tick({ ...live, chain: { ...chain, intents: async () => due } });
-                for (const { intent } of sent) {
-                    inFlight.set(intent, now + IN_FLIGHT_SECONDS);
-                }
-                if (filled.length + sent.length + failed.length > 0) {
-                    emit({ at: now, scan: full ? "full" : "changed", ms: Math.round(performance.now() - began), filled, sent, failed });
-                    acted += filled.length + sent.length;
-                }
-                for (const [intent, at] of failing) {
-                    if (now - at >= REFRESH_AFTER_SECONDS * 10n) {
-                        failing.delete(intent);
-                    }
-                }
-                const open = await stillOpen(transport, failed.map((f) => f.intent));
-                const refresh = open.filter((intent) => {
-                    const at = failing.get(intent);
-                    return at === undefined || now - at >= REFRESH_AFTER_SECONDS;
-                });
-                if (refresh.length > 0) {
-                    refresh.forEach((intent) => failing.set(intent, now));
-                    chain.forget();
-                }
-            }
-            catch (error) {
-                chain.forget();
-                emit({ at: now, scan: full ? "full" : "changed", error: error instanceof Error ? error.message : String(error) });
-            }
-        }
-    }
-    finally {
-        changes.close();
-    }
-    return acted;
-}
-async function solverOptions(command, runtime, transport) {
-    const solver = await runtime.loadSigner(command.keypair);
-    let latest;
-    const chain = {
-        config: async () => (await loadConfig(transport)).config,
-        intents: async () => (await transport.intents()).map(({ address, data }) => ({ address, intent: getIntentDecoder().decode(data) })),
-        now: () => chainTime(transport),
-        tokenProgram: (mint) => tokenProgramOf(transport, mint),
-        exists: async (address) => (await createdAccount(transport, address)) !== null,
-        tokenAmount: async (address) => tokenAmountOf((await transport.getAccount(address))?.data ?? null) ?? 0n,
-        lookupTables: async (addresses) => {
-            const tables = {};
-            for (const address of addresses) {
-                const view = await transport.getAccount(address);
-                if (view === null) {
-                    throw new Error(`lookup table ${address} does not exist`);
-                }
-                tables[address] = decodeLookupTable(view.data);
-            }
-            return tables;
-        },
-        blockhash: async () => {
-            latest = await transport.latestBlockhash();
-            return latest;
-        },
-    };
-    const bundle = command.jito === undefined ? undefined : jitoBundles({ url: command.jito, fetch: runtime.fetch });
-    return {
-        chain,
-        pricer: command.jupiter === undefined
-            ? issuePricer(await Promise.all(command.issue.map(async (route) => ({ ...route, outputTokenProgram: await tokenProgramOf(transport, route.outputMint) }))))
-            : jupiterPricer({
-                baseUrl: command.jupiter,
-                fetch: runtime.fetch,
-                slippageBps: command.slippageBps,
-                maxAccounts: SOLVER_ROUTE_ACCOUNTS,
-                ...(runtime.env[ENV_JUPITER_KEY] === undefined || !jupiterHost(command.jupiter)
-                    ? {}
-                    : { apiKey: runtime.env[ENV_JUPITER_KEY] }),
-                ...(command.routeProgram === undefined ? {} : { swapPrograms: new Set([command.routeProgram]) }),
-            }),
-        solver,
-        strategy: { minProfit: command.minProfit, maxFeeBps: command.maxFeeBps },
-        tip: command.tipLamports === 0n ? null : { account: tipAccount(runtime.entropy()), lamports: command.tipLamports },
-        lookupTables: command.lookupTables,
-        unitPrice: (instructions) => priceOf(transport, command.priority, instructions),
-        simulate: async (wire, watch) => {
-            const simulated = await transport.simulate(wire, watch);
-            return { err: simulated.err, unitsConsumed: simulated.unitsConsumed, balances: simulated.accounts.map(tokenAmountOf) };
-        },
-        send: async (wire) => {
-            if (bundle !== undefined) {
-                return { signature: await bundle([wire]), confirmed: false };
-            }
-            if (latest === undefined) {
-                throw new Error("no blockhash was fetched for this transaction");
-            }
-            return { signature: await transport.sendWire(wire, latest), confirmed: true };
-        },
-    };
-}
 export async function run(command, runtime) {
     if (command.name === "help") {
         return usageOf(command.verb);
@@ -294,6 +33,9 @@ export async function run(command, runtime) {
     if (command.name === "version") {
         return { version: VERSION };
     }
+    if (command.name === "hash") {
+        return { artifact: command.artifact, sha256: await artifactSha256(command.artifact) };
+    }
     if (command.name === "pda") {
         const [intent] = await findIntentPda({ owner: command.owner, nonce: command.nonce });
         const [vault] = await findVaultPda({ intent });
@@ -312,11 +54,11 @@ export async function run(command, runtime) {
                 };
             const wallet = command.wallet === null
                 ? {}
-                : { wallet: { url: command.url, files: runtime, env: runtime.env, sleep: runtime.sleep, now: runtime.now, limits: walletGuard(command.wallet) } };
+                : { wallet: { url: command.url, files: runtime, env: runtime.env, sleep: runtime.sleep, now: runtime.now, limits: walletGuard(command.wallet, runtime.saleBook) } };
             if (command.wallet !== null) {
                 transport.engineTransactions(ESTIMATE_SCAN).catch(() => undefined);
             }
-            await runtime.serve(agentServer({ transport, relay, agent, claims: claimsOf(), ...wallet }));
+            await runtime.serve(agentServer({ transport, relay, agent, claims: claimsOf(), url: command.url, ...wallet }));
             return null;
         }
         case "setup":
@@ -342,24 +84,41 @@ export async function run(command, runtime) {
         }
         case "cancel": {
             const owner = await runtime.loadSigner(command.keypair);
-            const { intent } = await loadIntent(transport, owner.address, command.nonce);
-            const ix = await buildCancelIntent({
-                owner,
-                nonce: command.nonce,
-                inputMint: intent.inputMint,
-                tokenProgram: await tokenProgramOf(transport, intent.inputMint),
-            });
-            return { signature: await transport.send([ix], owner) };
+            const { address, intent } = await loadIntent(transport, owner.address, command.nonce);
+            const ref = { nonce: command.nonce, inputMint: intent.inputMint, tokenProgram: await tokenProgramOf(transport, intent.inputMint) };
+            const refund = await tokenAccountIfMissing(transport, owner, owner.address, intent.inputMint, ref.tokenProgram);
+            const instructions = [
+                ...refund.create,
+                await buildCancelIntent({ ...ref, owner }),
+                ...(command.close ? [await buildCloseIntent({ ...ref, owner: owner.address, cranker: owner, rentPayer: intent.rentPayer })] : []),
+            ];
+            const summary = [
+                `Cancels intent ${address} (nonce ${command.nonce}); nobody can fill it afterwards`,
+                `Returns what is left in escrow to ${refund.address}, the owner's token account for ${intent.inputMint}`,
+                ...(refund.create.length > 0 ? [`Creates ${refund.address} first, since it is missing; the owner pays its rent`] : []),
+                ...(command.close ? [`Closes the intent in the same transaction and returns its rent and bounty to ${intent.rentPayer}, who paid them; it can no longer be read afterwards`] : []),
+            ];
+            return previewed(transport, instructions, owner, { intent: address, summary }, command.yes);
         }
         case "expire": {
             const cranker = await runtime.loadSigner(command.keypair);
             const { address, intent } = await loadIntent(transport, command.owner, command.nonce);
-            return { signature: await transport.send(await expiring(transport, cranker, address, intent, "always", false), cranker) };
+            const instructions = await expiring(transport, cranker, address, intent, "always", false);
+            const summary = [
+                `Expires intent ${address} (nonce ${command.nonce}) and returns what is left in escrow to its owner ${command.owner}`,
+                ...(instructions.length > 1 ? [`Creates a token account for the owner to take the refund; ${cranker.address} pays its rent`] : []),
+            ];
+            return previewed(transport, instructions, cranker, { intent: address, summary }, command.yes);
         }
         case "close": {
             const payer = await runtime.loadSigner(command.keypair);
             const { address, intent } = await loadIntent(transport, command.owner, command.nonce);
-            return { signature: await transport.send(await closing(transport, payer, address, intent, "always"), payer) };
+            const instructions = await closing(transport, payer, address, intent, "always");
+            const summary = [
+                `Closes intent ${address} (nonce ${command.nonce}) and returns its rent; it can no longer be read afterwards`,
+                ...(instructions.length > 1 ? [`Creates a token account for the owner to take what is left in escrow; ${payer.address} pays its rent`] : []),
+            ];
+            return previewed(transport, instructions, payer, { intent: address, summary }, command.yes);
         }
         case "follow":
             throw new FlowRefused("events --follow streams to the terminal and runs only from the command line");
@@ -368,6 +127,15 @@ export async function run(command, runtime) {
             const notable = transactions.reduce((n, tx) => n + tx.events.filter((e) => e.notable === true).length, 0);
             return { notable, transactions };
         }
+        case "jobs":
+        case "deliver":
+        case "receipt":
+        case "record-delivery":
+        case "deliveries":
+            return jobCommand(command, runtime, transport);
+        case "judge": {
+            return judge(command, runtime, transport);
+        }
         case "treasury": {
             const view = await treasuryView(transport, command.mints ?? (await intentInputMints(transport)));
             if (!command.create || command.keypair === undefined) {
@@ -388,69 +156,14 @@ export async function run(command, runtime) {
             const cranker = await runtime.loadSigner(command.keypair);
             return crank(transport, cranker, command.dryRun, command.fundAccounts);
         }
-        case "init-config": {
-            const [config] = await findConfigPda();
-            if ((await transport.getAccount(config)) !== null) {
-                throw new Error(configExists(config));
-            }
-            const domain = await clusterDomain(transport);
-            return administer(transport, runtime, command.by, async (authority) => [
-                await buildInitConfig({
-                    authority,
-                    domain,
-                    guardian: command.guardian,
-                    feeRecipient: command.feeRecipient,
-                    enabledKinds: command.enabledKinds,
-                    feeBps: command.feeBps,
-                    paused: command.paused,
-                }),
-            ], () => [
-                `Creates the engine config ${config} for this cluster (domain ${getBase58Decoder().decode(domain)}) with the signer as admin`,
-                `Guardian: ${command.guardian}`,
-                `Fee recipient: ${command.feeRecipient}`,
-                `Fee: ${command.feeBps} bps`,
-                `Enabled kinds: ${kindList(command.enabledKinds)}`,
-                `Paused: ${pauseList(command.paused)}`,
-            ], { config, domain });
-        }
+        case "init-config":
         case "raise-pause":
-            return administer(transport, runtime, command.by, async (authority) => [await buildRaisePause({ authority, flags: command.flags })], () => [`Pauses ${pauseList(command.flags)} for every intent until the admin lowers the pause`]);
         case "lower-pause":
-            return administer(transport, runtime, command.by, async (admin) => [await buildLowerPause({ admin, flags: command.flags })], () => [`Resumes ${pauseList(command.flags)}`]);
-        case "update-config": {
-            const { config } = await loadConfig(transport);
-            const c = command.change;
-            const update = {
-                guardian: c.guardian ?? config.guardian,
-                feeRecipient: c.feeRecipient ?? config.feeRecipient,
-                feeBps: c.feeBps ?? config.feeBps,
-                enabledKinds: c.enabledKinds ?? config.enabledKinds,
-                fillDisabledKinds: c.fillDisabledKinds ?? config.fillDisabledKinds,
-            };
-            const changes = [
-                ...(update.guardian === config.guardian ? [] : [`Guardian: ${config.guardian} -> ${update.guardian}`]),
-                ...(update.feeRecipient === config.feeRecipient ? [] : [`Fee recipient: ${config.feeRecipient} -> ${update.feeRecipient}`]),
-                ...(update.feeBps === config.feeBps ? [] : [`Fee: ${config.feeBps} -> ${update.feeBps} bps`]),
-                ...(update.enabledKinds === config.enabledKinds
-                    ? []
-                    : [`Enabled kinds: ${kindList(config.enabledKinds)} -> ${kindList(update.enabledKinds)}`]),
-                ...(update.fillDisabledKinds === config.fillDisabledKinds
-                    ? []
-                    : [`Fills stopped for: ${kindList(config.fillDisabledKinds)} -> ${kindList(update.fillDisabledKinds)}`]),
-            ];
-            return administer(transport, runtime, command.by, async (admin) => [await buildUpdateConfig({ admin, update })], () => (changes.length === 0 ? ["Changes nothing: every setting already has the value given"] : changes), { update });
-        }
-        case "propose-admin": {
-            const { config } = await loadConfig(transport);
-            return administer(transport, runtime, command.by, async (admin) => [await buildProposeAdmin({ admin, pendingAdmin: command.pendingAdmin })], () => [
-                `Proposes ${command.pendingAdmin} as the next admin in place of ${config.admin}`,
-                "Nothing changes until that key accepts; a later proposal replaces this one",
-            ]);
-        }
-        case "accept-admin": {
-            const { config } = await loadConfig(transport);
-            return administer(transport, runtime, command.by, async (pendingAdmin) => [await buildAcceptAdmin({ pendingAdmin })], (signer) => [`Makes ${signer} the admin in place of ${config.admin}`]);
-        }
+        case "update-config":
+        case "propose-admin":
+        case "accept-admin":
+        case "set-economics":
+            return adminCommand(command, runtime, transport);
         case "advance-nonce": {
             const owner = await runtime.loadSigner(command.keypair);
             const ix = await buildAdvanceNonce({ owner, nonceBase: command.base });
@@ -458,83 +171,11 @@ export async function run(command, runtime) {
         }
         case "solve":
             return tick(await solverOptions(command, runtime, transport));
-        case "set-economics": {
-            const { config } = await loadConfig(transport);
-            const e = command.economics;
-            const kindFees = KINDS.filter((kind) => (BigInt(e.kindFeeMask) & kindBit(kind)) !== 0n)
-                .map((kind) => `${KIND_NAMES[kind]} ${feeBpsFor({ feeBps: config.feeBps, ...e }, kind)} bps`)
-                .join(", ");
-            return administer(transport, runtime, command.by, async (admin) => [await buildUpdateEconomics({ admin, economics: e })], () => [
-                `Crank bounty: ${config.crankBounty} -> ${e.crankBounty} lamports per intent`,
-                `Create fee: ${config.createFee} -> ${e.createFee} lamports per intent`,
-                `Partner cut: ${config.partnerCutBps} -> ${e.partnerCutBps} bps of each partner fee`,
-                `Kind fees: ${kindFees === "" ? "none; every kind pays the base fee" : kindFees}`,
-            ]);
-        }
-        case "flow": {
-            const signer = await runtime.loadSigner(command.keypair);
-            const reading = memoized(transport);
-            const ctx = context(reading);
-            const raw = await rawFlowInput(reading, command.flow, command.input, signer.address);
-            switch (command.flow) {
-                case "create":
-                    return perform(prepareCreate, ctx, { owner: signer.address, ...raw }, signer, command.yes);
-                case "mandate-grant":
-                    return perform(prepareMandate, ctx, { owner: signer.address, ...raw }, signer, command.yes);
-                case "mandate-revoke":
-                    return perform(prepareRevokeMandate, ctx, { owner: signer.address, ...raw }, signer, command.yes);
-                case "mandate-use":
-                    return perform(prepareAgentCreate, ctx, { agent: signer.address, ...raw }, signer, command.yes);
-                case "approve":
-                case "revoke-approval": {
-                    const input = raw;
-                    return approval(transport, signer, input.mint, input.amount === undefined ? undefined : BigInt(input.amount), command.yes);
-                }
-            }
-            throw new FlowRefused(`unknown flow ${String(command.flow)}`);
-        }
-        case "lookup": {
-            const owner = command.input["owner"] ??
-                (command.keypair === undefined ? undefined : (await runtime.loadSigner(command.keypair)).address);
-            if (owner === undefined) {
-                throw new FlowRefused("name the owner with --owner or --keypair");
-            }
-            const action = command.lookup === "list" ? listIntents : getMandate;
-            return ask(action, context(transport), { ...command.input, owner });
-        }
-        case "signed-prepare": {
-            const owner = await runtime.loadSigner(command.keypair);
-            const input = await inRaw(transport, command.input, command.input["input_mint"], command.input["output_mint"]);
-            if (command.yes && (await runtime.readText(command.out).then(() => true, () => false))) {
-                throw new FlowRefused(`${command.out} already exists; choose another --out`);
-            }
-            const value = await ask(prepareSignedIntent, context(transport), { owner: owner.address, ...input });
-            if (!command.yes) {
-                return finish(transport, value, owner, false);
-            }
-            const signature = await signMessage(owner, value["message"]);
-            const shown = await finish(transport, value, owner, true);
-            await runtime.writeText(command.out, `${JSON.stringify({ version: SIGNED_FILE_VERSION, submit: value["submit"], signature }, null, 2)}\n`);
-            return { ...shown, saved: command.out };
-        }
-        case "signed-submit": {
-            const relayer = await runtime.loadSigner(command.keypair);
-            let saved;
-            try {
-                saved = JSON.parse(await runtime.readText(command.file));
-            }
-            catch {
-                throw new FlowRefused(`${command.file} is not a signed intent file`);
-            }
-            if (saved.version !== SIGNED_FILE_VERSION || saved.submit === undefined || typeof saved.signature !== "string") {
-                throw new FlowRefused(`${command.file} is not a signed intent file`);
-            }
-            const signed = { ...saved.submit, signature: saved.signature };
-            if (!command.yes) {
-                return { ...(await ask(previewSignedIntent, context(transport), signed)), sent: false, next: NOT_SENT };
-            }
-            return { ...(await ask(submitSignedIntent, context(transport, relayAnything(relayer, String(saved.submit["input_mint"]))), signed)), sent: true };
-        }
+        case "flow":
+        case "lookup":
+        case "signed-prepare":
+        case "signed-submit":
+            return flowCommand(command, runtime, transport);
         case "advance-epoch": {
             const owner = await runtime.loadSigner(command.keypair);
             const [userState] = await findUserStatePda({ owner: owner.address });