stelagent 0.0.3 → 0.0.5

package/dist/index.mjs

@@ -201,7 +201,7 @@ function formatError(e) {
 	if (e instanceof Error) return e.message;
 	return String(e);
 }
-async function runApp(command, fn, format = "json") {
+async function runApp(command, fn, format = "json", options) {
 	const start = Date.now();
 	try {
 		const result = await fn();
@@ -210,6 +210,7 @@ async function runApp(command, fn, format = "json") {
 			ok: true,
 			durationMs: Date.now() - start
 		});
+		if (!options?.silent) printResult(Result.ok(result), format);
 		return result;
 	} catch (e) {
 		writeAuditEntry({
@@ -323,7 +324,7 @@ z.enum(["asc", "desc"]).default("desc");
 z.coerce.number().int().min(6e4);
 //#endregion
 //#region src/commands/wallet-login.ts
-function formatZodError$11(e) {
+function formatZodError$12(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const walletLogin = defineCommand({
@@ -354,7 +355,7 @@ const walletLogin = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$11(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$12(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -533,7 +534,7 @@ const walletAddress = defineCommand({
 });
 //#endregion
 //#region src/services/stellar.ts
-const HORIZON_URLS$1 = {
+const HORIZON_URLS$2 = {
 	testnet: process.env.STELAGENT_HORIZON_TESTNET_URL ?? "https://horizon-testnet.stellar.org",
 	pubnet: process.env.STELAGENT_HORIZON_PUBNET_URL ?? "https://horizon-mainnet.stellar.org"
 };
@@ -573,7 +574,7 @@ async function getBalances(publicKey, network) {
 	return Result.tryPromise({
 		try: async () => {
 			const { Horizon } = await import("@stellar/stellar-sdk");
-			return (await new Horizon.Server(HORIZON_URLS$1[network]).loadAccount(publicKey)).balances.map((b) => ({
+			return (await new Horizon.Server(HORIZON_URLS$2[network]).loadAccount(publicKey)).balances.map((b) => ({
 				assetType: b.asset_type,
 				assetCode: b.asset_type === "native" ? "XLM" : "asset_code" in b && typeof b.asset_code === "string" ? b.asset_code : "",
 				balance: b.balance
@@ -586,7 +587,7 @@ async function transferXlm(sourceSecret, destination, amount, network) {
 	return Result.tryPromise({
 		try: async () => {
 			const { Keypair, Asset, Operation, TransactionBuilder, Horizon } = await import("@stellar/stellar-sdk");
-			const server = new Horizon.Server(HORIZON_URLS$1[network]);
+			const server = new Horizon.Server(HORIZON_URLS$2[network]);
 			const sourceKp = Keypair.fromSecret(sourceSecret);
 			let sourceAccount;
 			try {
@@ -623,7 +624,7 @@ async function sendPayment(sourceSecret, destination, amount, assetStr, network,
 	return Result.tryPromise({
 		try: async () => {
 			const { Keypair, Operation, TransactionBuilder, Horizon, Memo } = await import("@stellar/stellar-sdk");
-			const server = new Horizon.Server(HORIZON_URLS$1[network]);
+			const server = new Horizon.Server(HORIZON_URLS$2[network]);
 			const sourceKp = Keypair.fromSecret(sourceSecret);
 			let sourceAccount;
 			try {
@@ -685,7 +686,7 @@ const walletBalance = defineCommand({
 });
 //#endregion
 //#region src/commands/wallet-transfer.ts
-function formatZodError$10(e) {
+function formatZodError$11(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 //#endregion
@@ -732,7 +733,7 @@ const walletCommand = defineCommand({
 					catch: (e) => e
 				});
 				if (Result.isError(validation)) {
-					const msg = validation.error instanceof z.ZodError ? formatZodError$10(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+					const msg = validation.error instanceof z.ZodError ? formatZodError$11(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 					printResult(Result.err(msg), format);
 					return;
 				}
@@ -842,7 +843,7 @@ async function pay(url) {
 }
 //#endregion
 //#region src/commands/pay.ts
-function formatZodError$9(e) {
+function formatZodError$10(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const payCommand = defineCommand({
@@ -866,7 +867,7 @@ const payCommand = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$9(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$10(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -879,12 +880,12 @@ const payCommand = defineCommand({
 });
 //#endregion
 //#region src/services/horizon.ts
-const HORIZON_URLS = {
+const HORIZON_URLS$1 = {
 	testnet: process.env.STELAGENT_HORIZON_TESTNET_URL ?? "https://horizon-testnet.stellar.org",
 	pubnet: process.env.STELAGENT_HORIZON_PUBNET_URL ?? "https://horizon-mainnet.stellar.org"
 };
 function horizonServer(network) {
-	return new Horizon.Server(HORIZON_URLS[network]);
+	return new Horizon.Server(HORIZON_URLS$1[network]);
 }
 function classifyHorizonError(e, address) {
 	const message = e instanceof Error ? e.message : String(e);
@@ -1113,7 +1114,7 @@ function streamEffects(publicKey, network, opts, onMessage, onError) {
 }
 //#endregion
 //#region src/commands/account-details.ts
-function formatZodError$8(e) {
+function formatZodError$9(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const accountDetails = defineCommand({
@@ -1144,7 +1145,7 @@ const accountDetails = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$8(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$9(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -1157,7 +1158,7 @@ const accountDetails = defineCommand({
 });
 //#endregion
 //#region src/commands/account-transactions.ts
-function formatZodError$7(e) {
+function formatZodError$8(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const accountTransactions = defineCommand({
@@ -1205,7 +1206,7 @@ const accountTransactions = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$7(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$8(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -1226,7 +1227,7 @@ const accountTransactions = defineCommand({
 });
 //#endregion
 //#region src/commands/account-payments.ts
-function formatZodError$6(e) {
+function formatZodError$7(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const accountPayments = defineCommand({
@@ -1274,7 +1275,7 @@ const accountPayments = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$6(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$7(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -1295,7 +1296,7 @@ const accountPayments = defineCommand({
 });
 //#endregion
 //#region src/commands/account-effects.ts
-function formatZodError$5(e) {
+function formatZodError$6(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 //#endregion
@@ -1348,7 +1349,7 @@ const accountCommand = defineCommand({
 					catch: (e) => e
 				});
 				if (Result.isError(validation)) {
-					const msg = validation.error instanceof z.ZodError ? formatZodError$5(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+					const msg = validation.error instanceof z.ZodError ? formatZodError$6(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 					printResult(Result.err(msg), format);
 					return;
 				}
@@ -1370,7 +1371,7 @@ const accountCommand = defineCommand({
 });
 //#endregion
 //#region src/commands/assets-search.ts
-function formatZodError$4(e) {
+function formatZodError$5(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 //#endregion
@@ -1419,7 +1420,7 @@ const assetsCommand = defineCommand({
 					catch: (e) => e
 				});
 				if (Result.isError(validation)) {
-					const msg = validation.error instanceof z.ZodError ? formatZodError$4(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+					const msg = validation.error instanceof z.ZodError ? formatZodError$5(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 					printResult(Result.err(msg), format);
 					return;
 				}
@@ -1506,7 +1507,7 @@ const assetsCommand = defineCommand({
 });
 //#endregion
 //#region src/commands/send.ts
-function formatZodError$3(e) {
+function formatZodError$4(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const sendCommand = defineCommand({
@@ -1561,7 +1562,7 @@ const sendCommand = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$3(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$4(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -1609,7 +1610,7 @@ const feeCommand = defineCommand({
 });
 //#endregion
 //#region src/commands/monitor-transactions.ts
-function formatZodError$2(e) {
+function formatZodError$3(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const monitorTransactions = defineCommand({
@@ -1646,7 +1647,7 @@ const monitorTransactions = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$2(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$3(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -1666,7 +1667,7 @@ const monitorTransactions = defineCommand({
 						error: `Stream error: ${message}`
 					}));
 				});
-			}, format);
+			}, format, { silent: true });
 		} catch (e) {
 			const message = e instanceof Error ? e.message : String(e);
 			printResult(Result.err(`Failed to stream transactions: ${message}`), "json");
@@ -1686,7 +1687,7 @@ const monitorTransactions = defineCommand({
 });
 //#endregion
 //#region src/commands/monitor-payments.ts
-function formatZodError$1(e) {
+function formatZodError$2(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 const monitorPayments = defineCommand({
@@ -1723,7 +1724,7 @@ const monitorPayments = defineCommand({
 			catch: (e) => e
 		});
 		if (Result.isError(validation)) {
-			const msg = validation.error instanceof z.ZodError ? formatZodError$1(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+			const msg = validation.error instanceof z.ZodError ? formatZodError$2(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 			printResult(Result.err(msg), format);
 			return;
 		}
@@ -1743,7 +1744,7 @@ const monitorPayments = defineCommand({
 						error: `Stream error: ${message}`
 					}));
 				});
-			}, format);
+			}, format, { silent: true });
 		} catch (e) {
 			const message = e instanceof Error ? e.message : String(e);
 			printResult(Result.err(`Failed to stream payments: ${message}`), "json");
@@ -1763,7 +1764,7 @@ const monitorPayments = defineCommand({
 });
 //#endregion
 //#region src/commands/monitor-effects.ts
-function formatZodError(e) {
+function formatZodError$1(e) {
 	return e.issues.map((issue) => issue.message).join(", ");
 }
 //#endregion
@@ -1810,7 +1811,7 @@ const monitorCommand = defineCommand({
 					catch: (e) => e
 				});
 				if (Result.isError(validation)) {
-					const msg = validation.error instanceof z.ZodError ? formatZodError(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+					const msg = validation.error instanceof z.ZodError ? formatZodError$1(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
 					printResult(Result.err(msg), format);
 					return;
 				}
@@ -1830,7 +1831,7 @@ const monitorCommand = defineCommand({
 								error: `Stream error: ${message}`
 							}));
 						});
-					}, format);
+					}, format, { silent: true });
 				} catch (e) {
 					const message = e instanceof Error ? e.message : String(e);
 					printResult(Result.err(`Failed to stream effects: ${message}`), "json");
@@ -2173,6 +2174,126 @@ function registerAssetTools(server) {
 	});
 }
 //#endregion
+//#region src/services/preflight.ts
+const HORIZON_URLS = {
+	testnet: process.env.STELAGENT_HORIZON_TESTNET_URL ?? "https://horizon-testnet.stellar.org",
+	pubnet: process.env.STELAGENT_HORIZON_PUBNET_URL ?? "https://horizon-mainnet.stellar.org"
+};
+const BASE_RESERVE = "1";
+const LINE_RESERVE = "0.5";
+async function preflightSend(destination, amount, assetStr, network) {
+	const walletResult = await fetchWallet();
+	if (Result.isError(walletResult)) return Result.err(walletResult.error);
+	const wallet = walletResult.value;
+	const sender = wallet.publicKey;
+	const server = new Horizon.Server(HORIZON_URLS[network]);
+	let senderAccount;
+	let senderFunded = true;
+	let destinationFunded = true;
+	let destinationFundingRequired = false;
+	const warnings = [];
+	try {
+		senderAccount = await server.loadAccount(sender);
+	} catch {
+		senderFunded = false;
+		const msg = wallet.network === "testnet" ? `Sender account ${sender.slice(0, 8)}... is not funded. Use wallet login to auto-fund on testnet.` : `Sender account ${sender.slice(0, 8)}... is not funded. Send at least 1 XLM to activate it.`;
+		return Result.ok({
+			canProceed: false,
+			sender,
+			destination,
+			amount,
+			asset: assetStr === "native" ? "XLM" : assetStr,
+			network,
+			senderFunded,
+			destinationFunded: true,
+			destinationFundingRequired: false,
+			balances: [],
+			estimatedFee: "0",
+			baseReserve: BASE_RESERVE,
+			warnings: [msg]
+		});
+	}
+	let feeStatsResult;
+	try {
+		const stats = await server.feeStats();
+		feeStatsResult = {
+			feeCharged: { mode: stats.fee_charged.mode },
+			maxFee: { mode: stats.max_fee.mode }
+		};
+	} catch {
+		feeStatsResult = {
+			feeCharged: { mode: "100" },
+			maxFee: { mode: "100" }
+		};
+	}
+	const estimatedFee = feeStatsResult.feeCharged.mode;
+	const balances = [];
+	let sufficientOverall = true;
+	for (const b of senderAccount.balances) {
+		const code = b.asset_type === "native" ? "XLM" : "asset_code" in b ? String(b.asset_code) : "";
+		const available = Number(b.balance);
+		if (b.asset_type === "native") {
+			const subentryCount = senderAccount.subentry_count;
+			const effectiveAvailable = available - (Number(BASE_RESERVE) + Number(LINE_RESERVE) * subentryCount);
+			const needed = Number(amount) + Number(estimatedFee) / 1e7;
+			const sufficient = effectiveAvailable >= needed;
+			if (!sufficient) sufficientOverall = false;
+			balances.push({
+				asset: "XLM",
+				available: effectiveAvailable.toFixed(7),
+				needed: needed.toFixed(7),
+				sufficient
+			});
+		} else if (assetStr !== "native" && code === assetStr.split(":")[0] || assetStr === code) {
+			const needed = Number(amount);
+			const sufficient = available >= needed;
+			if (!sufficient) sufficientOverall = false;
+			balances.push({
+				asset: code,
+				available: available.toFixed(7),
+				needed: needed.toFixed(7),
+				sufficient
+			});
+		}
+	}
+	try {
+		await server.loadAccount(destination);
+	} catch {
+		destinationFunded = false;
+		destinationFundingRequired = true;
+		if (assetStr === "native") warnings.push(`Destination ${destination.slice(0, 8)}... is not funded. The transaction will create the account if amount >= 1 XLM.`);
+		else {
+			warnings.push(`Destination ${destination.slice(0, 8)}... is not funded. Cannot send custom assets to an unfunded account. The destination must first receive XLM.`);
+			sufficientOverall = false;
+		}
+	}
+	if (assetStr === "native") {
+		const totalNeeded = Number(amount) + Number(estimatedFee) / 1e7;
+		const xlmBalance = senderAccount.balances.find((b) => b.asset_type === "native");
+		if (xlmBalance) {
+			const subentryCount = senderAccount.subentry_count;
+			const minReserve = Number(BASE_RESERVE) + Number(LINE_RESERVE) * subentryCount;
+			if (Number(xlmBalance.balance) - totalNeeded - minReserve < 0) warnings.push(`After sending ${amount} XLM + fees, remaining balance would fall below minimum reserve (${minReserve} XLM).`);
+		}
+	}
+	const canProceed = senderFunded && sufficientOverall;
+	return Result.ok({
+		canProceed,
+		sender,
+		destination,
+		amount,
+		asset: assetStr === "native" ? "XLM" : assetStr,
+		network,
+		senderFunded,
+		destinationFunded,
+		destinationFundingRequired,
+		balances,
+		estimatedFee,
+		baseReserve: BASE_RESERVE,
+		warnings
+	});
+}
+//#endregion
 //#region src/mcp/payment-tools.ts
 function ok(data) {
 	return { content: [{
@@ -2230,6 +2351,25 @@ function registerPaymentTools(server) {
 		if (Result.isError(result)) return err(formatPaymentError(result.error));
 		return ok(result.value);
 	});
+	server.registerTool("preflight_check", {
+		description: "Validate a payment before sending. Checks if the sender has sufficient balance, estimates fees, and verifies the destination account. Returns whether the transaction can proceed, along with detailed balance info and warnings.",
+		inputSchema: {
+			destination: z.string().describe("Destination public key (G...)"),
+			amount: z.string().describe("Amount to validate (up to 7 decimal places)"),
+			asset: z.string().default("native").describe("Asset: 'native' for XLM, or 'CODE:ISSUER' for custom assets"),
+			network: z.enum(["testnet", "pubnet"]).default("testnet").describe("Stellar network")
+		}
+	}, async ({ destination, amount, asset, network }) => {
+		const destValidation = stellarPublicKey.safeParse(destination);
+		if (!destValidation.success) return err(`Invalid destination: ${destValidation.error.issues.map((i) => i.message).join(", ")}`);
+		const amountValidation = amountSchema.safeParse(amount);
+		if (!amountValidation.success) return err(`Invalid amount: ${amountValidation.error.issues.map((i) => i.message).join(", ")}`);
+		const assetValidation = assetSchema.safeParse(asset);
+		if (!assetValidation.success) return err(`Invalid asset: ${assetValidation.error.issues.map((i) => i.message).join(", ")}`);
+		const result = await preflightSend(destination, amount, asset, network === "pubnet" ? "pubnet" : "testnet");
+		if (Result.isError(result)) return err(formatWalletError(result.error));
+		return ok(result.value);
+	});
 }
 //#endregion
 //#region src/mcp/mod.ts
@@ -2252,6 +2392,29 @@ async function startMcpServer() {
 	await server.connect(transport);
 }
 //#endregion
+//#region src/commands/mcp.ts
+const mcpCommand = defineCommand({
+	meta: {
+		name: "mcp",
+		description: "Start the MCP server on stdio"
+	},
+	args: {},
+	async run() {
+		try {
+			await startMcpServer();
+		} catch (e) {
+			const message = e instanceof Error ? e.message : String(e);
+			console.error(`Failed to start MCP server: ${message}`);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+//#region src/commands/preflight.ts
+function formatZodError(e) {
+	return e.issues.map((issue) => issue.message).join(", ");
+}
+//#endregion
 //#region src/index.ts
 runMain(defineCommand({
 	meta: {
@@ -2267,20 +2430,61 @@ runMain(defineCommand({
 		send: sendCommand,
 		fee: feeCommand,
 		monitor: monitorCommand,
-		mcp: defineCommand({
+		mcp: mcpCommand,
+		preflight: defineCommand({
 			meta: {
-				name: "mcp",
-				description: "Start the MCP server on stdio"
+				name: "preflight",
+				description: "Validate a payment before sending: check balances, fees, and destination"
 			},
-			args: {},
-			async run() {
-				try {
-					await startMcpServer();
-				} catch (e) {
-					const message = e instanceof Error ? e.message : String(e);
-					console.error(`Failed to start MCP server: ${message}`);
-					process.exit(1);
+			args: {
+				destination: {
+					type: "positional",
+					description: "Destination public key (G...)",
+					required: true
+				},
+				amount: {
+					type: "string",
+					alias: ["a"],
+					description: "Amount to validate",
+					required: true
+				},
+				asset: {
+					type: "string",
+					alias: ["s"],
+					description: "Asset: 'native' (default) or 'CODE:ISSUER'",
+					default: "native"
+				},
+				network: networkArg,
+				format: formatArg
+			},
+			async run({ args }) {
+				const networkResult = parseNetwork$4(String(args.network ?? "testnet"));
+				const format = parseFormat(String(args.format ?? "json"));
+				if (Result.isError(networkResult)) {
+					printResult(Result.err(networkResult.error._tag), "json");
+					return;
+				}
+				const destination = String(args.destination ?? "");
+				const amount = String(args.amount ?? "");
+				const asset = String(args.asset ?? "native");
+				const validation = Result.try({
+					try: () => {
+						stellarPublicKey.parse(destination);
+						amountSchema.parse(amount);
+						assetSchema.parse(asset);
+					},
+					catch: (e) => e
+				});
+				if (Result.isError(validation)) {
+					const msg = validation.error instanceof z.ZodError ? formatZodError(validation.error) : validation.error instanceof Error ? validation.error.message : String(validation.error);
+					printResult(Result.err(msg), format);
+					return;
 				}
+				await runCommand(async () => {
+					const result = await preflightSend(destination, amount, asset, networkResult.value);
+					if (Result.isError(result)) return Result.err(formatWalletError(result.error));
+					return Result.ok(result.value);
+				}, format);
 			}
 		})
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stelagent",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Modular, agent-first CLI for Stellar — wallet, payments, markets, and DeFi",
   "license": "MIT",
   "bin": {