@mantle-agent/cli 0.0.0-stage → 0.1.0

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,IAAI,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAoB,MAAM,YAAY,CAAC;AAErD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,EAC7E,KAAK,EAAE,KAAc,EAAE,EAAE;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,GAAwD,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBACtG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACzF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChF,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;iBACrH,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAgB;IAC/C,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/proof.d.ts

@@ -0,0 +1,2 @@
+/** What the agent key signs to prove possession when exchanging a claim. Must match the API's claimProofMessage. */
+export declare const claimProof: (claimId: string) => string;

package/dist/proof.js

@@ -0,0 +1,3 @@
+/** What the agent key signs to prove possession when exchanging a claim. Must match the API's claimProofMessage. */
+export const claimProof = (claimId) => `mantle-agent-claim:${claimId}`;
+//# sourceMappingURL=proof.js.map

package/dist/proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof.js","sourceRoot":"","sources":["../src/proof.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,sBAAsB,OAAO,EAAE,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,24 @@
+import type { AgentClient } from "@mantle-agent/client";
+import type { Store } from "./store.js";
+/**
+ * One scheduled run (PRD RUN-02/03): take the lease, run the host's agent command with the lease in its
+ * environment, kill it when the lease expires, report back. No lease → nothing runs (missed slots are skipped,
+ * never caught up).
+ */
+export declare function runScheduled(client: AgentClient, params: {
+    host: string;
+    command: string[];
+    emit: (event: object) => void;
+}): Promise<number>;
+/**
+ * Prints a cron entry (does not install it). Cron fires every few minutes; the server decides when a run is due,
+ * so the owner can change the interval or pause from the confirmation page without touching the machine.
+ */
+export declare function schedule(store: Store, params: {
+    host: string;
+    cli: string;
+}): {
+    cron: string;
+    promptFile: string;
+    note: string;
+};

package/dist/run.js

@@ -0,0 +1,94 @@
+import { spawn } from "node:child_process";
+import { existsSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * One scheduled run (PRD RUN-02/03): take the lease, run the host's agent command with the lease in its
+ * environment, kill it when the lease expires, report back. No lease → nothing runs (missed slots are skipped,
+ * never caught up).
+ */
+export async function runScheduled(client, params) {
+    const lease = await client.runtime.lease(params.host);
+    if (!lease.granted) {
+        params.emit({ event: "skipped", reason: lease.reason, nextRunAt: lease.nextRunAt });
+        return 0;
+    }
+    // The host received these commands; their effect (pause/resume/run-now) already happened server-side.
+    for (const c of lease.commands)
+        await client.runtime.ack(c.commandId);
+    params.emit({ event: "run", leaseId: lease.leaseId, expiresAt: lease.expiresAt, budget: lease.budget });
+    const [cmd, ...args] = params.command;
+    if (!cmd)
+        throw new Error("missing host command after --");
+    const child = spawn(cmd, args, {
+        stdio: ["ignore", "pipe", "inherit"],
+        env: {
+            ...process.env,
+            MANTLE_AGENT_LEASE: lease.leaseId,
+            MANTLE_AGENT_RUN_EXPIRES: lease.expiresAt,
+            MANTLE_AGENT_RUN_BUDGET: JSON.stringify(lease.budget),
+        },
+    });
+    let output = "";
+    child.stdout.on("data", (d) => {
+        output += d.toString();
+        process.stderr.write(d); // keep our own stdout machine-readable
+    });
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        child.kill("SIGTERM");
+        setTimeout(() => child.kill("SIGKILL"), 5_000).unref();
+    }, Math.max(0, new Date(lease.expiresAt).getTime() - Date.now()));
+    const code = await new Promise((resolve) => {
+        child.on("error", () => resolve(127));
+        child.on("close", (c) => resolve(c ?? 1));
+    });
+    clearTimeout(timer);
+    const llmCostUsd = costFrom(output);
+    const summary = `exit ${code}${timedOut ? " (lease expired)" : ""}`;
+    await client.runtime.complete(lease.leaseId, { summary, ...(llmCostUsd !== undefined ? { llmCostUsd } : {}) });
+    params.emit({ event: "completed", leaseId: lease.leaseId, exitCode: code, timedOut, ...(llmCostUsd !== undefined ? { llmCostUsd } : {}) });
+    return code;
+}
+/** Hosts that report spend in their JSON output (e.g. `claude -p --output-format json` → total_cost_usd). */
+function costFrom(output) {
+    for (const line of output.trim().split("\n").reverse()) {
+        try {
+            const v = JSON.parse(line);
+            if (typeof v.total_cost_usd === "number")
+                return v.total_cost_usd;
+        }
+        catch {
+            // not JSON
+        }
+    }
+    return undefined;
+}
+const HOST_COMMANDS = {
+    "claude-code": (p) => `claude -p "$(cat ${p})" --output-format json --allowedTools "mcp__mantle-agent__*"`,
+    codex: (p) => `codex exec "$(cat ${p})"`,
+};
+const DEFAULT_PROMPT = `You are running a scheduled session for the owner's Mantle Agent Account.
+Follow the mantle-agent skill. Start with the \`status\` and \`runtime_status\` tools, decide whether a trade is
+warranted under the owner's instructions below, trade within the remaining budget, and finish. If anything looks
+wrong, call \`pause\` and explain why.
+
+Owner instructions:
+- (edit this file to describe your strategy)
+`;
+/**
+ * Prints a cron entry (does not install it). Cron fires every few minutes; the server decides when a run is due,
+ * so the owner can change the interval or pause from the confirmation page without touching the machine.
+ */
+export function schedule(store, params) {
+    const promptFile = join(store.dir, "run-prompt.md");
+    if (!existsSync(promptFile))
+        writeFileSync(promptFile, DEFAULT_PROMPT);
+    const hostCmd = HOST_COMMANDS[params.host]?.(promptFile) ?? "<your agent command, e.g. hermes run ...>";
+    return {
+        cron: `*/5 * * * * ${params.cli} run --host ${params.host} -- ${hostCmd} >> ${join(store.dir, "runs.log")} 2>&1`,
+        promptFile,
+        note: "Add this line with `crontab -e` (or the host's native scheduler). Edit the prompt file to set the strategy.",
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/skill.d.ts

@@ -0,0 +1,13 @@
+export declare const SKILL_FILE: URL;
+/**
+ * `mantle-agent install-skill`: copies the skill into a host's skills directory. Without `host`/`dir` it installs
+ * for every known host whose config directory exists. Hosts without a skills directory (Grok Bot, …) read
+ * `mantle-agent guide` instead.
+ */
+export declare function installSkill(params: {
+    host?: string;
+    dir?: string;
+}): {
+    installed: string[];
+    skipped: string[];
+};

package/dist/skill.js

@@ -0,0 +1,42 @@
+import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const SKILL_FILE = new URL("../skill/mantle-agent/SKILL.md", import.meta.url);
+/** Hosts that load skills from a directory of `<name>/SKILL.md` folders. */
+const HOSTS = {
+    "claude-code": join(homedir(), ".claude", "skills"),
+    codex: join(homedir(), ".codex", "skills"),
+};
+/**
+ * `mantle-agent install-skill`: copies the skill into a host's skills directory. Without `host`/`dir` it installs
+ * for every known host whose config directory exists. Hosts without a skills directory (Grok Bot, …) read
+ * `mantle-agent guide` instead.
+ */
+export function installSkill(params) {
+    let targets;
+    if (params.dir)
+        targets = [["custom", params.dir]];
+    else if (params.host) {
+        const dir = HOSTS[params.host];
+        if (!dir)
+            throw new Error(`unknown host ${params.host}; use one of ${Object.keys(HOSTS).join(", ")} or --dir <skills dir>`);
+        targets = [[params.host, dir]];
+    }
+    else
+        targets = Object.entries(HOSTS);
+    const installed = [];
+    const skipped = [];
+    for (const [host, dir] of targets) {
+        // Only auto-install where the host is actually present (its config dir exists).
+        if (!params.dir && !params.host && !existsSync(join(dir, ".."))) {
+            skipped.push(host);
+            continue;
+        }
+        const target = join(dir, "mantle-agent");
+        mkdirSync(target, { recursive: true });
+        copyFileSync(SKILL_FILE, join(target, "SKILL.md"));
+        installed.push(join(target, "SKILL.md"));
+    }
+    return { installed, skipped };
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAErF,4EAA4E;AAC5E,MAAM,KAAK,GAA2B;IACpC,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC;IACnD,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC3C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuC;IAClE,IAAI,OAA2B,CAAC;IAChC,IAAI,MAAM,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;SAC9C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC5H,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;;QAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,gFAAgF;QAChF,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACzC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QACnD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,45 @@
+import type { Claim } from "@mantle-agent/client";
+export type CredentialKind = "trading" | "social" | "runtime";
+export type Credentials = Record<CredentialKind, {
+    token: string;
+    expiresAt: string;
+}>;
+export type Config = {
+    apiUrl: string;
+    agentId?: string;
+    name?: string;
+    host?: string;
+};
+/** A claim started with `connect --no-wait` that the owner has not approved yet. */
+export type PendingClaim = Claim & {
+    apiUrl: string;
+    name: string;
+    host: string;
+    proposalKey?: string | null;
+};
+/**
+ * Local state under MANTLE_AGENT_HOME (default ~/.mantle-agent): config, the agent's Ed25519 key and the API
+ * credentials. Secrets are written 0600 and never printed.
+ */
+export declare class Store {
+    readonly dir: string;
+    constructor(dir?: string);
+    private path;
+    private write;
+    private read;
+    config(): Config | null;
+    saveConfig(config: Config): void;
+    credentials(): Credentials | null;
+    saveCredentials(credentials: Credentials): void;
+    pendingClaim(): PendingClaim | null;
+    savePendingClaim(claim: PendingClaim | null): void;
+    /** The agent identity key; created on first use. Its public half is what the owner sees as a fingerprint. */
+    agentKey(): AgentKey;
+}
+export type AgentKey = {
+    publicKey: string;
+    fingerprint: string;
+    sign(message: string): string;
+};
+/** Same algorithm as the server; computed locally so the user compares against something the server did not send. */
+export declare function fingerprintOf(publicKeyHex: string): string;

package/dist/store.js

@@ -0,0 +1,64 @@
+import { createHash, createPrivateKey, createPublicKey, generateKeyPairSync, sign } from "node:crypto";
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Local state under MANTLE_AGENT_HOME (default ~/.mantle-agent): config, the agent's Ed25519 key and the API
+ * credentials. Secrets are written 0600 and never printed.
+ */
+export class Store {
+    dir;
+    constructor(dir = process.env.MANTLE_AGENT_HOME ?? join(homedir(), ".mantle-agent")) {
+        this.dir = dir;
+    }
+    path(name) {
+        return join(this.dir, name);
+    }
+    write(name, content, secret) {
+        mkdirSync(this.dir, { recursive: true, mode: 0o700 });
+        writeFileSync(this.path(name), content, { mode: secret ? 0o600 : 0o644 });
+        if (secret)
+            chmodSync(this.path(name), 0o600);
+    }
+    read(name) {
+        return existsSync(this.path(name)) ? JSON.parse(readFileSync(this.path(name), "utf8")) : null;
+    }
+    config() {
+        return this.read("config.json");
+    }
+    saveConfig(config) {
+        this.write("config.json", JSON.stringify(config, null, 2), false);
+    }
+    credentials() {
+        return this.read("credentials.json");
+    }
+    saveCredentials(credentials) {
+        this.write("credentials.json", JSON.stringify(credentials, null, 2), true);
+    }
+    pendingClaim() {
+        return this.read("pending-claim.json");
+    }
+    savePendingClaim(claim) {
+        if (claim)
+            this.write("pending-claim.json", JSON.stringify(claim, null, 2), false);
+        else
+            rmSync(this.path("pending-claim.json"), { force: true });
+    }
+    /** The agent identity key; created on first use. Its public half is what the owner sees as a fingerprint. */
+    agentKey() {
+        const file = this.path("agent-key.pem");
+        if (!existsSync(file)) {
+            const { privateKey } = generateKeyPairSync("ed25519");
+            this.write("agent-key.pem", privateKey.export({ format: "pem", type: "pkcs8" }).toString(), true);
+        }
+        const privateKey = createPrivateKey(readFileSync(file));
+        const publicKey = createPublicKey(privateKey).export({ format: "der", type: "spki" }).subarray(12).toString("hex");
+        return { publicKey, fingerprint: fingerprintOf(publicKey), sign: (message) => sign(null, Buffer.from(message), privateKey).toString("hex") };
+    }
+}
+/** Same algorithm as the server; computed locally so the user compares against something the server did not send. */
+export function fingerprintOf(publicKeyHex) {
+    const digest = createHash("sha256").update(Buffer.from(publicKeyHex, "hex")).digest("hex").slice(0, 16);
+    return digest.match(/.{4}/g).join("-");
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { type AgentClient, type SessionLimits } from "@mantle-agent/client";
+export type ToolContext = {
+    /** The SDK client; its `leaseId` (from MANTLE_AGENT_LEASE under `mantle-agent run`) charges trades to the run. */
+    client: AgentClient;
+};
+/** One capability, exposed identically as a CLI command and an MCP tool (PRD RUN-01). */
+export type Tool<S extends z.ZodRawShape = z.ZodRawShape> = {
+    name: string;
+    title: string;
+    description: string;
+    input: S;
+    run(ctx: ToolContext, input: z.infer<z.ZodObject<S>>): Promise<unknown>;
+};
+export declare const statusTool: Tool<{}>;
+export declare const quoteTool: Tool<{
+    side: z.ZodEnum<{
+        buy: "buy";
+        sell: "sell";
+    }>;
+    token: z.ZodString;
+    amount: z.ZodString;
+    unit: z.ZodOptional<z.ZodEnum<{
+        ether: "ether";
+        wei: "wei";
+    }>>;
+}>;
+export declare const tradeTool: Tool<{
+    side: z.ZodEnum<{
+        buy: "buy";
+        sell: "sell";
+    }>;
+    token: z.ZodString;
+    amount: z.ZodString;
+    unit: z.ZodOptional<z.ZodEnum<{
+        ether: "ether";
+        wei: "wei";
+    }>>;
+    requestId: z.ZodOptional<z.ZodString>;
+    wait: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const tradeStatusTool: Tool<{
+    intentId: z.ZodString;
+}>;
+export declare const stopTool: Tool<{}>;
+export declare const runtimeStatusTool: Tool<{}>;
+export declare const pauseTool: Tool<{}>;
+export declare const limitsInput: {
+    perTrade: z.ZodOptional<z.ZodString>;
+    period: z.ZodOptional<z.ZodString>;
+    periodHours: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodString>;
+    days: z.ZodOptional<z.ZodNumber>;
+    slippagePercent: z.ZodOptional<z.ZodNumber>;
+};
+export declare function limitsFrom(i: {
+    perTrade?: string;
+    period?: string;
+    periodHours?: number;
+    total?: string;
+    days?: number;
+    slippagePercent?: number;
+}): SessionLimits;
+export declare const requestAuthorizeTool: Tool<{
+    perTrade: z.ZodOptional<z.ZodString>;
+    period: z.ZodOptional<z.ZodString>;
+    periodHours: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodString>;
+    days: z.ZodOptional<z.ZodNumber>;
+    slippagePercent: z.ZodOptional<z.ZodNumber>;
+}>;
+export declare const requestRenewTool: Tool<{
+    days: z.ZodNumber;
+}>;
+export declare const requestRevokeTool: Tool<{}>;
+export declare const requestWithdrawTool: Tool<{
+    asset: z.ZodUnion<readonly [z.ZodLiteral<"MNT">, z.ZodString]>;
+    amount: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodString]>;
+    to: z.ZodString;
+}>;
+export declare const requestAutoRunTool: Tool<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    everyHours: z.ZodOptional<z.ZodNumber>;
+    maxTradesPerRun: z.ZodOptional<z.ZodNumber>;
+    maxTradesPerDay: z.ZodOptional<z.ZodNumber>;
+    maxSpendPerDay: z.ZodOptional<z.ZodString>;
+    maxLlmUsdPerDay: z.ZodOptional<z.ZodNumber>;
+}>;
+export declare const requestResumeTool: Tool<{}>;
+export declare const requestStatusTool: Tool<{
+    requestId: z.ZodOptional<z.ZodString>;
+}>;
+export declare const tools: readonly [Tool<{}>, Tool<{
+    side: z.ZodEnum<{
+        buy: "buy";
+        sell: "sell";
+    }>;
+    token: z.ZodString;
+    amount: z.ZodString;
+    unit: z.ZodOptional<z.ZodEnum<{
+        ether: "ether";
+        wei: "wei";
+    }>>;
+}>, Tool<{
+    side: z.ZodEnum<{
+        buy: "buy";
+        sell: "sell";
+    }>;
+    token: z.ZodString;
+    amount: z.ZodString;
+    unit: z.ZodOptional<z.ZodEnum<{
+        ether: "ether";
+        wei: "wei";
+    }>>;
+    requestId: z.ZodOptional<z.ZodString>;
+    wait: z.ZodOptional<z.ZodBoolean>;
+}>, Tool<{
+    intentId: z.ZodString;
+}>, Tool<{}>, Tool<{}>, Tool<{}>, Tool<{
+    perTrade: z.ZodOptional<z.ZodString>;
+    period: z.ZodOptional<z.ZodString>;
+    periodHours: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodString>;
+    days: z.ZodOptional<z.ZodNumber>;
+    slippagePercent: z.ZodOptional<z.ZodNumber>;
+}>, Tool<{
+    days: z.ZodNumber;
+}>, Tool<{}>, Tool<{
+    asset: z.ZodUnion<readonly [z.ZodLiteral<"MNT">, z.ZodString]>;
+    amount: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodString]>;
+    to: z.ZodString;
+}>, Tool<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    everyHours: z.ZodOptional<z.ZodNumber>;
+    maxTradesPerRun: z.ZodOptional<z.ZodNumber>;
+    maxTradesPerDay: z.ZodOptional<z.ZodNumber>;
+    maxSpendPerDay: z.ZodOptional<z.ZodString>;
+    maxLlmUsdPerDay: z.ZodOptional<z.ZodNumber>;
+}>, Tool<{}>, Tool<{
+    requestId: z.ZodOptional<z.ZodString>;
+}>];