feat: extract core fns from cli to use-agently-sdk (#65)

* feat: initial use-agently-sdk

* update use-agently cli to use sdk

* fix a2a + balance in sdk

* fix client and config

* fix mcp

* fix test timeout

* resolve comments

* use tsdown for sdk bundler

* resolve comments + duplicate testing

* fix typing

* fix types + tests

* inject clientFetch to all commands

* fix for npm publish

Author: kevzzsk

bun.lock

@@ -24,6 +24,7 @@
   },
   "devDependencies": {
     "@types/bun": "^1.3.9",
+    "@types/node": "^25.4.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "prettier": "^3.8.1",

package.json

@@ -3,6 +3,9 @@
   "version": "0.0.0",
   "private": true,
   "type": "module",
+  "exports": {
+    "./test": "./test.ts"
+  },
   "scripts": {
     "dev": "aixyz dev",
     "test": "bun test"

packages/localhost-aixyz/package.json

@@ -0,0 +1 @@
+build

packages/use-agently-sdk/.gitignore

@@ -0,0 +1,82 @@
+# @use-agently/sdk
+
+Core SDK for the [Agently](https://use-agently.com) platform — wallet management, A2A (Agent-to-Agent) protocol, MCP (Model Context Protocol), and x402 payments.
+
+## Install
+
+```bash
+npm install @use-agently/sdk
+```
+
+or
+
+```bash
+bun install @use-agently/sdk
+```
+
+## A2A (Agent-to-Agent)
+
+```ts
+import { getA2ACard } from "@use-agently/sdk";
+
+// Fetch an agent's A2A card
+const card = await getA2ACard("https://use-agently.com/echo-agent/");
+```
+
+```ts
+import { sendA2AMessage } from "@use-agently/sdk";
+
+// Send a message (dry-run by default — no payment)
+const result = await sendA2AMessage("https://use-agently.com/echo-agent/", "Hello!");
+console.log(result.text);
+```
+
+## MCP (Model Context Protocol)
+
+```ts
+import { listMcpTools } from "@use-agently/sdk";
+
+// List tools on an MCP server
+const tools = await listMcpTools("https://use-agently.com/echo-agent/");
+```
+
+```ts
+import { callMcpTool } from "@use-agently/sdk";
+
+// Call an MCP tool
+const output = await callMcpTool("https://use-agently.com/echo-agent/", "echo", { message: "hi" });
+```
+
+## Wallet & Payments
+
+```ts
+import { generateEvmPrivateKeyConfig, loadWallet } from "@use-agently/sdk";
+
+const config = generateEvmPrivateKeyConfig();
+const wallet = loadWallet(config);
+console.log(wallet.address);
+
+// Send a message with real payment
+const result = await sendA2AMessage("https://use-agently.com/echo-agent/", "Hello!", {
+  transaction: PayTransaction(wallet),
+});
+```
+
+## Marketplace Discovery
+
+```ts
+import { fetchAgents, searchAgents } from "@use-agently/sdk";
+
+const agents = await fetchAgents();
+const a2aAgents = await searchAgents({ query: "echo", protocols: ["a2a"] });
+```
+
+```ts
+import { resolveErc8004Agent } from "@use-agently/sdk";
+
+const agent = await resolveErc8004Agent("eip155:8453/erc-8004:0x1234/1");
+```
+
+## License
+
+MIT

packages/use-agently-sdk/README.md

@@ -0,0 +1,52 @@
+{
+  "name": "@use-agently/sdk",
+  "version": "0.0.0",
+  "description": "Core SDK for the Agently platform — wallet management, A2A, MCP, x402 payments",
+  "homepage": "https://github.com/AgentlyHQ/use-agently/tree/main/packages/use-agently-sdk",
+  "bugs": {
+    "url": "https://github.com/AgentlyHQ/use-agently/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentlyHQ/use-agently.git",
+    "directory": "packages/use-agently-sdk"
+  },
+  "license": "MIT",
+  "author": "AgentlyHQ",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./build/index.js"
+    }
+  },
+  "files": [
+    "build",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf build",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.10",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@x402/evm": "^2.5.0",
+    "@x402/fetch": "^2.5.0",
+    "@x402/mcp": "^2.5.0",
+    "viem": "^2.46.3",
+    "zod": "^4"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "localhost-aixyz": "^0",
+    "testcontainers": "^11",
+    "tsdown": "^0.21.1",
+    "x402-fl": "^0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}