@intent-engine/cli 0.1.22 → 0.1.26

package/dist/src/admin-commands.d.ts

@@ -0,0 +1,12 @@
+import { type Address, type Instruction, type KeyPairSigner } from "@solana/kit";
+import { type Transport } from "@intent-engine/client";
+import type { Command } from "./command-types.js";
+import type { Runtime } from "./runtime.js";
+export declare const configExists: (config: Address) => string;
+export declare 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";
+export declare function previewed(transport: Transport, instructions: Instruction[], signer: KeyPairSigner, shown: object, yes: boolean): Promise<object>;
+type AdminCommand = Extract<Command, {
+    name: "init-config" | "raise-pause" | "lower-pause" | "update-config" | "propose-admin" | "accept-admin" | "set-economics";
+}>;
+export declare function adminCommand(command: AdminCommand, runtime: Runtime, transport: Transport): Promise<object>;
+export {};

package/dist/src/admin-commands.js

@@ -0,0 +1,140 @@
+import { createNoopSigner, getBase58Decoder, getBase64Decoder, getBase64Encoder, isSignerRole, isWritableRole, } from "@solana/kit";
+import { buildAcceptAdmin, buildProposeAdmin, buildUpdateConfig, buildInitConfig, buildLowerPause, buildRaisePause, buildUpdateEconomics, findConfigPda, feeBpsFor, kindBit, PAUSE_CREATE, PAUSE_FILL, } from "@intent-engine/core";
+import { clusterDomain, loadConfig } from "@intent-engine/client";
+import { redactUrl } from "./render.js";
+import { prepare } from "./agent/prepare.js";
+import { KIND_NAMES, KINDS, preparedView } from "./agent/shapes.js";
+import { NOT_SENT } from "./flows.js";
+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 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, url, runtime, by, build, summary, extra = {}) {
+    const cluster = { url: redactUrl(url), genesisHash: await transport.genesisHash() };
+    if ("keypair" in by) {
+        const signer = await runtime.loadSigner(by.keypair);
+        const instructions = await build(signer);
+        const described = { ...extra, cluster, 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,
+        cluster,
+        summary: summary(by.authority),
+        unsigned: {
+            ...view,
+            transaction_base58: getBase58Decoder().decode(getBase64Encoder().encode(view.transaction)),
+            instructions: instructions.map(instructionView),
+            next: AUTHORITY_NEXT,
+        },
+    };
+}
+export async function previewed(transport, instructions, signer, shown, yes) {
+    if (!yes) {
+        const simulated = await prepare(transport, instructions, signer.address);
+        return { ...shown, sent: false, units_consumed: simulated.unitsConsumed, next: NOT_SENT };
+    }
+    return { ...shown, sent: true, signature: await transport.send(instructions, signer) };
+}
+export async function adminCommand(command, runtime, transport) {
+    switch (command.name) {
+        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, command.url, 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 "raise-pause":
+            return administer(transport, command.url, 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, command.url, 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, command.url, 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, command.url, 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, command.url, runtime, command.by, async (pendingAdmin) => [await buildAcceptAdmin({ pendingAdmin })], (signer) => [`Makes ${signer} the admin in place of ${config.admin}`]);
+        }
+        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, command.url, 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}`,
+            ]);
+        }
+    }
+}
+//# sourceMappingURL=admin-commands.js.map

package/dist/src/admin-commands.js.map

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

package/dist/src/agent/actions.d.ts

@@ -13,6 +13,7 @@ export type AgentContext = {
     agent: AgentKey | undefined;
     claims: Claims;
     wallet?: WalletAccess;
+    url?: string;
 };
 type AgentKey = {
     signer: TransactionSigner;
@@ -25,6 +26,7 @@ type Action<I> = {
     description: string;
     effect: Effect;
     repeats?: true;
+    destructive?: false;
     input: Schema<I>;
     output: Schema<unknown>;
     run(ctx: AgentContext, input: I, call: Call): Promise<object>;

package/dist/src/agent/actions.js

@@ -38,7 +38,7 @@ export async function invoke(action, ctx, raw) {
         for (const undo of call.undo.reverse()) {
             undo();
         }
-        return { ok: false, problem: problemOf(error) };
+        return { ok: false, problem: problemOf(error, ctx.url ?? ctx.wallet?.url) };
     }
 }
 //# sourceMappingURL=actions.js.map

package/dist/src/agent/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/agent/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAkB,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAgB,SAAS,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAa,MAAM,EAAe,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AA4BxD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,MAAiB,EAAa,EAAE,CAAC,MAA8B,CAAC;AAE1F,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,MAAc,EAAE,KAAmB;QAC7C,KAAK,CAAC,GAAG,MAAM,wCAAwC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAID,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAiB,EAAE,GAAiB,EAAE,GAAY;IAC7E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,KAAc,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7G,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,YAAY,YAAY,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACvF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAgC,EAAE,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC;QACT,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAClD,CAAC;AACH,CAAC"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/agent/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAkB,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAgB,SAAS,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAa,MAAM,EAAe,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AA8BxD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,MAAiB,EAAa,EAAE,CAAC,MAA8B,CAAC;AAE1F,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,MAAc,EAAE,KAAmB;QAC7C,KAAK,CAAC,GAAG,MAAM,wCAAwC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAID,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAiB,EAAE,GAAiB,EAAE,GAAY;IAC7E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,KAAc,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7G,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,YAAY,YAAY,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACvF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAgC,EAAE,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC;QACT,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/src/agent/claims.js

@@ -3,20 +3,21 @@ export const PREPARED_TTL = 120n;
 export const MAX_PENDING_PER_OWNER = 16;
 export const claimsOf = () => ({ held: new Map(), busy: new Set() });
 export const callOf = () => ({ undo: [] });
-export function claimedBy(claims, owner, now) {
-    const held = claims.held.get(owner);
-    if (held === undefined) {
-        return new Set();
-    }
-    for (const [nonce, until] of held) {
-        if (until < now) {
-            held.delete(nonce);
+function prune(claims, now) {
+    for (const [owner, held] of claims.held) {
+        for (const [nonce, until] of held) {
+            if (until < now) {
+                held.delete(nonce);
+            }
+        }
+        if (held.size === 0) {
+            claims.held.delete(owner);
         }
     }
-    if (held.size === 0) {
-        claims.held.delete(owner);
-    }
-    return new Set(held.keys());
+}
+export function claimedBy(claims, owner, now) {
+    prune(claims, now);
+    return new Set(claims.held.get(owner)?.keys());
 }
 export function claim(claims, call, owner, nonce, until, now) {
     const pending = claimedBy(claims, owner, now);

package/dist/src/agent/claims.js.map

@@ -1 +1 @@
-{"version":3,"file":"claims.js","sourceRoot":"","sources":["../../../src/agent/claims.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAMxC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,MAAM,GAAG,GAAS,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAEjD,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAc,EAAE,GAAW;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAClC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,IAAU,EAAE,KAAc,EAAE,KAAa,EAAE,KAAa,EAAE,GAAW;IACzG,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,SAAS,KAAK,OAAO,KAAK,0HAA0H,CACrJ,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,IAAI,qBAAqB,EAAE,CAAC;QAC1C,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,GAAG,KAAK,gBAAgB,qBAAqB,kIAAkI,CAChL,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;IACjE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;QAClB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,GAAW;IAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,2GAA2G,CAC5G,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"claims.js","sourceRoot":"","sources":["../../../src/agent/claims.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAMxC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,MAAM,GAAG,GAAS,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAEjD,SAAS,KAAK,CAAC,MAAc,EAAE,GAAW;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAClC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAc,EAAE,GAAW;IACnE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,IAAU,EAAE,KAAc,EAAE,KAAa,EAAE,KAAa,EAAE,GAAW;IACzG,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,SAAS,KAAK,OAAO,KAAK,0HAA0H,CACrJ,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,IAAI,qBAAqB,EAAE,CAAC;QAC1C,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,GAAG,KAAK,gBAAgB,qBAAqB,kIAAkI,CAChL,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;IACjE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;QAClB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,GAAW;IAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,2GAA2G,CAC5G,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/agent/create.d.ts

@@ -1,4 +1,5 @@
 import { type IntentParams } from "@intent-engine/core";
+export declare const SPEC_URL_PLAIN = "is a plain http url, which a public cluster may not use; give an https url";
 export declare const WRAPPED = ", as wrapped SOL they unwrap themselves";
 export declare const MAX_EXPIRES_IN: number;
 export declare const MIN_EXPIRES_IN = 60;

package/dist/src/agent/create.js

@@ -1,6 +1,6 @@
 import { createNoopSigner } from "@solana/kit";
-import { buildCreateIntent, describeTerms, encodeParams, escrowAmount, findAssociatedTokenAddress, findConfigPda, findIntentPda, findUserStatePda, formatTime, LONG_LIVED_SECONDS, NATIVE_MINT, validate, settlementWarnings, WARN_LONG_LIVED, WARN_RECEIVER, } from "@intent-engine/core";
-import { chainTime, CLOCK_SYSVAR, initUserIfMissing, loadConfig, loadUser, mintOf, tokenAccountIfMissing, wrapIfShort, } from "@intent-engine/client";
+import { buildCreateIntent, describeTerms, encodeParams, escrowAmount, findAssociatedTokenAddress, findConfigPda, findIntentPda, findUserStatePda, formatTime, isMemoUrl, Kind, MEMO_URL_RULE, specMemo, LONG_LIVED_SECONDS, NATIVE_MINT, partnerBaseOf, partnerFeeLine, validate, settlementWarnings, WARN_LONG_LIVED, WARN_RECEIVER, } from "@intent-engine/core";
+import { chainTime, CLOCK_SYSVAR, initUserIfMissing, loadConfig, loadUser, memoInstruction, mintOf, PLAIN_HTTP_ON_PUBLIC, plainHttpOnPublic, tokenAccountIfMissing, wrapIfShort, } from "@intent-engine/client";
 import { define } from "./actions.js";
 import { tool } from "./names.js";
 import { claim, claimedBy, PREPARED_TTL } from "./claims.js";
@@ -10,6 +10,7 @@ import { InvalidInput } from "./schema.js";
 import { orderSchema, paramsOf, partnerSchema, preparedSchema, preparedView } from "./shapes.js";
 import { tokenNames } from "../tokens.js";
 import { account, amount, integer, list, object, optional, text, time } from "./schema.js";
+export const SPEC_URL_PLAIN = `${PLAIN_HTTP_ON_PUBLIC}; give an https url`;
 export const WRAPPED = ", as wrapped SOL they unwrap themselves";
 export const MAX_EXPIRES_IN = 365 * 24 * 60 * 60;
 export const MIN_EXPIRES_IN = 60;
@@ -56,6 +57,7 @@ export const prepareCreate = define({
     input: object({
         ...termsInput,
         pay_to: optional(account("the wallet that receives what the solver pays; default the owner")),
+        spec_url: optional(text(`where the acceptance spec of an attested order with spec_hash is published, ${MEMO_URL_RULE}; recorded in a memo the owner signs with the create, so workers find it`)),
     }),
     output: object({
         ...termsOutput,
@@ -70,6 +72,16 @@ export const prepareCreate = define({
         const now = await chainTime(transport);
         const expiresAt = expiryOf(input, now);
         const params = validate(paramsOf(input.order));
+        const specUrl = input.spec_url;
+        if (specUrl !== undefined && (params.kind !== Kind.AttestedResult || params.specHash.every((b) => b === 0))) {
+            throw new InvalidInput([{ path: "spec_url", message: "needs an attested order with spec_hash" }]);
+        }
+        if (specUrl !== undefined && !isMemoUrl(specUrl)) {
+            throw new InvalidInput([{ path: "spec_url", message: `must be ${MEMO_URL_RULE}` }]);
+        }
+        if (specUrl !== undefined && (await plainHttpOnPublic(transport, specUrl))) {
+            throw new InvalidInput([{ path: "spec_url", message: SPEC_URL_PLAIN }]);
+        }
         const { config } = await loadConfig(transport);
         const [inputToken, outputToken] = [await mintOf(transport, input.input_mint), await mintOf(transport, input.output_mint)];
         const user = await loadUser(transport, input.owner);
@@ -109,7 +121,8 @@ export const prepareCreate = define({
         });
         const register = await initUserIfMissing(user, input.owner);
         const wrap = await wrapIfShort(transport, input.owner, input.input_mint, inputToken.tokenProgram, escrowAmount(params));
-        const prepared = await prepare(transport, [...register, ...receiver.create, ...wrap.instructions, create], input.owner);
+        const published = specUrl === undefined ? [] : [memoInstruction(owner, specMemo(specUrl))];
+        const prepared = await prepare(transport, [...register, ...receiver.create, ...wrap.instructions, create, ...published], input.owner);
         return {
             intent,
             nonce,
@@ -118,8 +131,9 @@ export const prepareCreate = define({
             summary: [
                 ...describeTerms({ kind: params.kind, params: encodeParams(params), inputMint: input.input_mint, outputMint: input.output_mint }, { inputDecimals: inputToken.decimals, outputDecimals: outputToken.decimals, ...tokenNames(input.input_mint, input.output_mint) }),
                 `Expires: ${formatTime(expiresAt)}`,
+                ...(specUrl === undefined ? [] : [`Publishes: the acceptance spec's url ${specUrl}, in a memo the owner signs`]),
                 ...(elsewhere ? [`Pays to: ${recipient}, who receives what the solver pays${input.output_mint === NATIVE_MINT ? WRAPPED : ""}`] : []),
-                ...(input.partner === undefined ? [] : [`Partner fee: ${input.partner.bps} bps of the sold amount to ${input.partner.account}`]),
+                ...(input.partner === undefined ? [] : [partnerFeeLine(input.partner.bps, input.partner.account, partnerBaseOf(params))]),
                 ...setupLines({
                     registers: register.length > 0,
                     creates: receiver.create.length > 0 && !elsewhere ? [input.output_mint] : [],

package/dist/src/agent/create.js.map

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

package/dist/src/agent/mandate-agent.d.ts

@@ -0,0 +1,2 @@
+export declare const prepareAgentCreate: import("./actions.js").AnyAction;
+export declare const agentCreate: import("./actions.js").AnyAction;

package/dist/src/agent/mandate-agent.js

@@ -0,0 +1,136 @@
+import { createNoopSigner } from "@solana/kit";
+import { buildCreateIntentByAgent, describeTerms, encodeParams, escrowAmount, formatAmount, formatTime, validate, tokenOf, } from "@intent-engine/core";
+import { chainTime, loadConfig, mintOf, tokenAccountIfMissing } from "@intent-engine/client";
+import { define } from "./actions.js";
+import { createCost, release, rentFor, reserve, TOKEN_ACCOUNT_RENT_BYTES } from "./budget.js";
+import { expiryOf, MAX_EXPIRES_IN, MIN_EXPIRES_IN } from "./create.js";
+import { tool } from "./names.js";
+import { unusedIntent } from "./owner.js";
+import { prepare } from "./prepare.js";
+import { paying } from "./signed-relay.js";
+import { claim, PREPARED_TTL } from "./claims.js";
+import { AgentRefusal } from "./problems.js";
+import { orderSchema, paramsOf, preparedSchema, preparedView } from "./shapes.js";
+import { TOKEN_NAMES, tokenNames } from "../tokens.js";
+import { account, amount, integer, list, object, optional, text, time } from "./schema.js";
+import { agentNonce, explained, loadMandate } from "./mandate-state.js";
+const agentTerms = {
+    owner: account("the wallet whose mandate the agent uses"),
+    id: optional(amount("which of the owner's mandates for this agent; default 0")),
+    order: orderSchema,
+    expires_at: optional(time("unix seconds after which nobody can fill the intent")),
+    expires_in: optional(integer(MIN_EXPIRES_IN, MAX_EXPIRES_IN, "seconds from now until the intent expires")),
+    nonce: optional(amount("leave out to use the mandate's next free nonce; one you pass must have the top bit set")),
+};
+const agentOutput = {
+    intent: account(),
+    nonce: amount(),
+    expires_at: time(),
+    escrow: amount(),
+    agent_fee: amount("raw input units held with the escrow and paid to the agent only if this intent fills"),
+    budget_remaining: amount("raw input units the mandate still allows after this intent and its fee"),
+    summary: list(text(), 16),
+};
+async function agentIntent(transport, agent, input, claims, call) {
+    const id = input.id ?? 0n;
+    const { mandate } = await loadMandate(transport, input.owner, agent.address, id);
+    const now = await chainTime(transport);
+    const expiresAt = expiryOf(input, now);
+    const params = validate(paramsOf(input.order));
+    const { config } = await loadConfig(transport);
+    const inputToken = await mintOf(transport, mandate.inputMint);
+    const outputToken = await mintOf(transport, mandate.outputMint);
+    if (input.nonce !== undefined) {
+        await unusedIntent(transport, input.owner, input.nonce);
+        claim(claims, call, input.owner, input.nonce, now + PREPARED_TTL, now);
+    }
+    const nonce = input.nonce ?? (await agentNonce(transport, input.owner, mandate.serial, mandate.intents, { claims, call, now }));
+    const intent = await unusedIntent(transport, input.owner, nonce);
+    const feeAccount = mandate.agentFee === 0n
+        ? { create: [] }
+        : await tokenAccountIfMissing(transport, agent, agent.address, mandate.inputMint, inputToken.tokenProgram);
+    const create = await buildCreateIntentByAgent({
+        agent,
+        owner: input.owner,
+        mandateId: id,
+        treasury: config.feeRecipient,
+        maxCreateFee: config.createFee,
+        maxBounty: config.crankBounty,
+        nonce,
+        params,
+        expiresAt,
+        ...(mandate.partnerBps === 0 ? {} : { partner: { key: mandate.partner, bps: mandate.partnerBps } }),
+        inputMint: mandate.inputMint,
+        outputMint: mandate.outputMint,
+        inputTokenProgram: inputToken.tokenProgram,
+        outputTokenProgram: outputToken.tokenProgram,
+        ownerInput: mandate.inputAccount,
+        receiver: mandate.outputAccount,
+    });
+    const escrow = escrowAmount(params);
+    return {
+        mandate,
+        instructions: [...feeAccount.create, create],
+        cost: createCost(config) + (feeAccount.create.length > 0 ? rentFor(TOKEN_ACCOUNT_RENT_BYTES) : 0n),
+        now,
+        view: {
+            intent,
+            nonce,
+            expires_at: expiresAt,
+            escrow,
+            agent_fee: mandate.agentFee,
+            budget_remaining: mandate.total - mandate.spent - escrow - mandate.agentFee,
+            summary: [
+                ...describeTerms({ kind: params.kind, params: encodeParams(params), inputMint: mandate.inputMint, outputMint: mandate.outputMint }, { inputDecimals: inputToken.decimals, outputDecimals: outputToken.decimals, ...tokenNames(mandate.inputMint, mandate.outputMint) }),
+                `Expires: ${formatTime(expiresAt)}`,
+                ...(mandate.agentFee === 0n
+                    ? []
+                    : [
+                        `Agent fee: ${formatAmount(mandate.agentFee, inputToken.decimals)} of ${tokenOf(mandate.inputMint, TOKEN_NAMES[mandate.inputMint])}, held with the escrow and paid to the agent only if this intent fills; refunded to the owner if it is cancelled or expires`,
+                    ]),
+            ],
+        },
+    };
+}
+export const prepareAgentCreate = define({
+    name: tool("prepare_agent_create"),
+    title: "Prepare an intent under a mandate",
+    description: `Build the transaction an agent key signs to create an intent for an owner under the mandate the owner granted it. The agent pays the fee, rent and any create fee; the owner's tokens move from the allowance they gave the engine. The program refuses anything outside the mandate. Use ${tool("agent_create")} instead when this server holds the agent key.`,
+    effect: "prepare",
+    input: object({ agent: account("the agent key that signs and pays"), ...agentTerms }),
+    output: object({ ...agentOutput, prepared: preparedSchema }),
+    run: async ({ transport, claims }, input, call) => {
+        const built = await agentIntent(transport, createNoopSigner(input.agent), input, claims, call);
+        const prepared = await prepare(transport, built.instructions, input.agent).catch(explained(built.mandate));
+        return { ...built.view, prepared: preparedView(prepared) };
+    },
+});
+export const agentCreate = define({
+    name: tool("agent_create"),
+    title: "Create an intent under a mandate",
+    description: "Create an intent for an owner under the mandate the owner granted to this server's agent key, signing and paying with that key. Needs a server started with --agent. This server refuses owners outside its --agent-owners list and spending beyond its hourly lamport budget; the program refuses anything outside the mandate's limits. Each call creates a new intent.",
+    effect: "submit",
+    repeats: true,
+    input: object(agentTerms),
+    output: object({ ...agentOutput, signature: text() }),
+    run: async (ctx, input, call) => {
+        const key = ctx.agent;
+        if (key === undefined) {
+            throw new AgentRefusal("AgentNotConfigured", "this server holds no agent key; start it with --agent to act under mandates");
+        }
+        if (!key.owners.has(input.owner)) {
+            throw new AgentRefusal("OwnerNotServed", `this agent only acts for the owners it was started with; ${input.owner} is not one of them`);
+        }
+        const built = await agentIntent(ctx.transport, key.signer, input, ctx.claims, call);
+        const prepared = await prepare(ctx.transport, built.instructions, key.signer.address).catch(explained(built.mandate));
+        const spend = reserve(key.budget, built.cost + prepared.priorityLamports, built.now);
+        const paid = { any: false };
+        call.undo.push(() => {
+            if (!paid.any) {
+                release(key.budget, spend);
+            }
+        });
+        return { ...built.view, signature: await paying(paid, ctx.transport.send(prepared.instructions, key.signer)) };
+    },
+});
+//# sourceMappingURL=mandate-agent.js.map

package/dist/src/agent/mandate-agent.js.map

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

package/dist/src/agent/mandate-grant.d.ts

@@ -0,0 +1,2 @@
+export declare const prepareMandate: import("./actions.js").AnyAction;
+export declare const getMandate: import("./actions.js").AnyAction;