@balchemyai/agent-sdk 0.1.0

package/dist/streaming/sse-event-stream.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * SseEventStream — lightweight SSE consumer.
+ *
+ * Parses the text/event-stream protocol and emits typed events via
+ * an async iterator or a callback-based subscribe API.
+ *
+ * Usage (async iterator):
+ *   const stream = new SseEventStream(endpoint, apiKey);
+ *   for await (const event of stream) {
+ *     handleEvent(event);
+ *   }
+ *
+ * Usage (callback):
+ *   const unsub = stream.subscribe((event) => { ... }, onError);
+ *   // later:
+ *   unsub();
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseEventStream = void 0;
+const agent_sdk_error_1 = require("../errors/agent-sdk-error");
+class SseEventStream {
+    endpoint;
+    apiKey;
+    reconnectDelayMs;
+    maxReconnectDelayMs;
+    maxReconnects;
+    jitterFactor;
+    fetchFn;
+    closed = false;
+    reconnectCount = 0;
+    lastEventId;
+    constructor(endpoint, apiKey, options) {
+        this.endpoint = endpoint;
+        this.apiKey = apiKey;
+        this.reconnectDelayMs = options?.reconnectDelayMs ?? 2000;
+        this.maxReconnectDelayMs = options?.maxReconnectDelayMs ?? 30_000;
+        this.maxReconnects = options?.maxReconnects ?? 0; // 0 = unlimited
+        this.jitterFactor = options?.jitterFactor ?? 0.25;
+        this.fetchFn = options?.fetchFn ?? fetch;
+    }
+    close() {
+        this.closed = true;
+    }
+    /**
+     * Subscribe with a callback. Returns an unsubscribe function.
+     */
+    subscribe(onEvent, onError) {
+        let active = true;
+        const run = async () => {
+            try {
+                for await (const event of this) {
+                    if (!active)
+                        break;
+                    onEvent(event);
+                }
+            }
+            catch (err) {
+                if (active) {
+                    onError?.(err);
+                }
+            }
+        };
+        void run();
+        return () => {
+            active = false;
+            this.close();
+        };
+    }
+    [Symbol.asyncIterator]() {
+        return this.createIterator();
+    }
+    createIterator() {
+        const queue = [];
+        const resolvers = [];
+        let done = false;
+        let error = null;
+        const push = (event) => {
+            if (resolvers.length > 0) {
+                const resolve = resolvers.shift();
+                resolve({ value: event, done: false });
+            }
+            else {
+                queue.push(event);
+            }
+        };
+        const finish = (err) => {
+            done = true;
+            error = err ?? null;
+            for (const resolve of resolvers) {
+                if (err) {
+                    resolve({ value: undefined, done: true });
+                }
+                else {
+                    resolve({ value: undefined, done: true });
+                }
+            }
+            resolvers.length = 0;
+        };
+        // Start consuming in background
+        void this.consume(push, finish);
+        return {
+            next() {
+                if (queue.length > 0) {
+                    return Promise.resolve({ value: queue.shift(), done: false });
+                }
+                if (done) {
+                    if (error) {
+                        return Promise.reject(error);
+                    }
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => {
+                    resolvers.push(resolve);
+                });
+            },
+            return() {
+                finish();
+                return Promise.resolve({ value: undefined, done: true });
+            },
+        };
+    }
+    async consume(push, finish) {
+        while (!this.closed) {
+            try {
+                await this.readStream(push);
+                // Clean close from server
+                if (this.reconnectDelayMs === 0)
+                    break;
+                if (this.maxReconnects > 0 && this.reconnectCount >= this.maxReconnects)
+                    break;
+            }
+            catch (err) {
+                if (this.closed)
+                    break;
+                if (this.reconnectDelayMs === 0)
+                    break;
+                if (this.maxReconnects > 0 && this.reconnectCount >= this.maxReconnects) {
+                    finish(err);
+                    return;
+                }
+            }
+            if (this.closed)
+                break;
+            if (this.reconnectDelayMs === 0)
+                break;
+            this.reconnectCount++;
+            // Exponential backoff with jitter, capped at maxReconnectDelayMs
+            const baseDelay = Math.min(this.reconnectDelayMs * Math.pow(2, Math.min(this.reconnectCount - 1, 10)), this.maxReconnectDelayMs);
+            const jitter = baseDelay * this.jitterFactor * (Math.random() * 2 - 1);
+            const delay = Math.max(0, baseDelay + jitter);
+            await this.sleep(delay);
+        }
+        finish();
+    }
+    async readStream(push) {
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "text/event-stream",
+            "Cache-Control": "no-cache",
+        };
+        if (this.lastEventId) {
+            headers["Last-Event-ID"] = this.lastEventId;
+        }
+        const response = await this.fetchFn(this.endpoint, {
+            method: "GET",
+            headers,
+        });
+        if (!response.ok) {
+            throw new agent_sdk_error_1.AgentSdkError({
+                code: response.status === 401 || response.status === 403
+                    ? "provider_auth_error"
+                    : "execution_error",
+                status: response.status,
+                message: `SSE stream error: HTTP ${response.status}`,
+            });
+        }
+        if (!response.body) {
+            throw new agent_sdk_error_1.AgentSdkError({
+                code: "invalid_response",
+                message: "SSE response has no body",
+            });
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        // Current event fields
+        let eventType = "message";
+        let dataLines = [];
+        let eventId;
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done || this.closed)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const rawLine of lines) {
+                    const line = rawLine.replace(/\r$/, "");
+                    if (line === "") {
+                        // Dispatch event
+                        if (dataLines.length > 0) {
+                            const rawData = dataLines.join("\n");
+                            let parsedData = rawData;
+                            try {
+                                parsedData = JSON.parse(rawData);
+                            }
+                            catch {
+                                // keep as string
+                            }
+                            push({ event: eventType, data: parsedData, id: eventId });
+                        }
+                        // Reset
+                        eventType = "message";
+                        dataLines = [];
+                        eventId = undefined;
+                        continue;
+                    }
+                    if (line.startsWith(":")) {
+                        // Comment — ignore
+                        continue;
+                    }
+                    const colonIdx = line.indexOf(":");
+                    let field;
+                    let fieldValue;
+                    if (colonIdx === -1) {
+                        field = line;
+                        fieldValue = "";
+                    }
+                    else {
+                        field = line.slice(0, colonIdx);
+                        fieldValue = line.slice(colonIdx + 1).replace(/^ /, "");
+                    }
+                    switch (field) {
+                        case "event":
+                            eventType = fieldValue;
+                            break;
+                        case "data":
+                            dataLines.push(fieldValue);
+                            break;
+                        case "id":
+                            eventId = fieldValue;
+                            this.lastEventId = fieldValue;
+                            break;
+                        case "retry": {
+                            // Server-sent reconnect hint — ignore for now
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => globalThis.setTimeout(resolve, ms));
+    }
+}
+exports.SseEventStream = SseEventStream;
+//# sourceMappingURL=sse-event-stream.js.map

package/dist/streaming/sse-event-stream.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,151 @@
+export type AgentOnboardingMode = "siwe" | "walletless" | "legacy";
+export type AgentScope = "read" | "trade" | "manage";
+export type ProvisionedBot = {
+    botId: string;
+    publicId: string;
+    name: string;
+};
+export type ProvisionedMcp = {
+    endpoint: string;
+    apiKey?: string;
+    keyPrefix?: string;
+    keyId?: string;
+};
+export type ProvisionedBaseWallet = {
+    chainId: number;
+    custodialWallet?: {
+        address: string;
+        walletId?: string;
+        chainId?: number;
+    };
+};
+export type IdentityAccess = {
+    token: string;
+    tokenType: "Bearer";
+    expiresIn: number;
+    expiresAt: string;
+    kid: string;
+    issuer: string;
+    /** Scope granted at onboarding. "manage" is never issued at onboarding time. */
+    scope: "read" | "trade";
+};
+export type OnboardingResponse = {
+    /**
+     * Legacy flag from canonical API envelopes.
+     * SDK unwraps `{ success, data }`, so this is typically undefined.
+     */
+    success?: boolean;
+    bot: ProvisionedBot;
+    mcp: ProvisionedMcp;
+    base: ProvisionedBaseWallet;
+    onboardingInstructions?: string;
+    onboarding?: {
+        mode: AgentOnboardingMode;
+        chainId: number;
+        registryVerified: boolean;
+        identityProvider?: string;
+    };
+    identityAccess?: IdentityAccess;
+};
+export type SiweNonceResponse = {
+    message: string;
+    nonce?: string;
+    issuedAt?: string;
+    expiresAt?: string;
+};
+export type OnboardWithSiweInput = {
+    message: string;
+    signature: string;
+    agentId: string;
+    /** Optional existing bot binding target (owned bot id). */
+    botId?: string;
+    /** Requested MCP key scope. Defaults to "trade" if omitted. */
+    scope?: "read" | "trade";
+};
+export type OnboardWithIdentityInput = {
+    provider: string;
+    identityToken: string;
+    agentId: string;
+    /** Optional existing bot binding target (owned bot id). */
+    botId?: string;
+    chainId?: number;
+    /** Requested MCP key scope. Defaults to "trade" if omitted. */
+    scope?: "read" | "trade";
+};
+export type RequestSiweNonceInput = {
+    address: string;
+    chainId: number;
+    domain: string;
+    uri: string;
+    statement?: string;
+};
+export type RevokeIdentityTokenInput = {
+    jti: string;
+    ttlSeconds?: number;
+};
+export type IdentityTokenRevokeStatusInput = {
+    jti: string;
+};
+export type IdentityTokenRevokeResponse = {
+    revoked: boolean;
+    jti: string;
+};
+export type McpTool = {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+};
+export type McpListToolsResponse = {
+    tools: McpTool[];
+};
+export type McpTextContent = {
+    type: "text";
+    text: string;
+};
+export type McpCallToolResponse = {
+    content: McpTextContent[];
+    isError?: boolean;
+};
+/** Structured response from agent mode LLM calls */
+export type AgentResponse = {
+    answer: string;
+    confidence: number;
+    sources?: string[];
+    tool_calls?: Array<{
+        tool_name: string;
+        result: unknown;
+        success: boolean;
+    }>;
+    follow_up_suggestions?: string[];
+};
+/** x-balchemy extension fields present in MCP tools/list entries */
+export type McpToolExtensions = {
+    'x-balchemy-category'?: string;
+    'x-balchemy-data-contract'?: string;
+    'x-balchemy-requires-scope'?: string;
+    'x-balchemy-rate-limit'?: string;
+};
+/** Extended MCP tool with balchemy metadata from the tools/list response */
+export type McpToolWithMetadata = McpTool & {
+    extensions?: McpToolExtensions;
+};
+export type AgentSdkConfig = {
+    /**
+     * Base URL for the Balchemy API, including the `/api` path segment.
+     *
+     * The SDK appends endpoint paths (e.g. `/public/erc8004/onboarding/identity`)
+     * directly to this value, so it must NOT have a trailing slash.
+     *
+     * @example
+     * // Local development
+     * apiBaseUrl: "http://localhost:3000/api"
+     *
+     * @example
+     * // Production
+     * apiBaseUrl: "https://api.balchemy.ai/api"
+     */
+    apiBaseUrl: string;
+    timeoutMs?: number;
+    fetchFn?: typeof fetch;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/retry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Retry utility with exponential backoff + jitter.
+ *
+ * Retries only on transient errors (network_error, execution_error ≥500,
+ * rate_limit_error with Retry-After support).
+ *
+ * Usage:
+ *   const result = await withRetry(() => fetch(...), { maxAttempts: 3 });
+ */
+export type RetryOptions = {
+    /** Maximum number of total attempts (including the first). Default: 3 */
+    maxAttempts?: number;
+    /** Base delay in ms for exponential backoff. Default: 200 */
+    baseDelayMs?: number;
+    /** Maximum delay cap in ms. Default: 5000 */
+    maxDelayMs?: number;
+    /** Whether to add random jitter (±25%). Default: true */
+    jitter?: boolean;
+    /** Override the sleep function — useful in tests. */
+    sleepFn?: (ms: number) => Promise<void>;
+    /** Optional retry predicate for endpoint/error-aware policies. */
+    shouldRetry?: (error: unknown, context: RetryDecisionContext) => boolean;
+};
+export type RetryDecisionContext = {
+    attempt: number;
+    maxAttempts: number;
+};
+export declare function defaultShouldRetry(error: unknown): boolean;
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,MAAM,YAAY,GAAG;IACzB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,kEAAkE;IAClE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAQF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM1D;AAwBD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAsDZ"}

package/dist/utils/retry.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Retry utility with exponential backoff + jitter.
+ *
+ * Retries only on transient errors (network_error, execution_error ≥500,
+ * rate_limit_error with Retry-After support).
+ *
+ * Usage:
+ *   const result = await withRetry(() => fetch(...), { maxAttempts: 3 });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultShouldRetry = defaultShouldRetry;
+exports.withRetry = withRetry;
+const agent_sdk_error_1 = require("../errors/agent-sdk-error");
+const RETRYABLE_CODES = new Set([
+    "network_error",
+    "execution_error",
+    "rate_limit_error",
+]);
+function defaultShouldRetry(error) {
+    if (error instanceof agent_sdk_error_1.AgentSdkError) {
+        return RETRYABLE_CODES.has(error.code);
+    }
+    // Plain Error (e.g. AbortError on timeout) — always retry
+    return error instanceof Error;
+}
+function computeDelay(attempt, baseDelayMs, maxDelayMs, jitter) {
+    // Exponential: base * 2^attempt  (attempt 0-indexed)
+    const exponential = Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
+    if (!jitter) {
+        return exponential;
+    }
+    // ±25% uniform jitter
+    const spread = exponential * 0.25;
+    return Math.round(exponential - spread + Math.random() * spread * 2);
+}
+const defaultSleep = (ms) => new Promise((resolve) => {
+    // globalThis.setTimeout is available in both Node.js and browser environments
+    globalThis.setTimeout(resolve, ms);
+});
+async function withRetry(fn, options) {
+    const maxAttempts = options?.maxAttempts ?? 3;
+    const baseDelayMs = options?.baseDelayMs ?? 200;
+    const maxDelayMs = options?.maxDelayMs ?? 5000;
+    const jitter = options?.jitter ?? true;
+    const sleepFn = options?.sleepFn ?? defaultSleep;
+    const shouldRetry = options?.shouldRetry ??
+        ((error) => defaultShouldRetry(error));
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            const isLastAttempt = attempt === maxAttempts - 1;
+            if (isLastAttempt ||
+                !shouldRetry(error, {
+                    attempt,
+                    maxAttempts,
+                })) {
+                throw error;
+            }
+            // If rate-limited with a Retry-After hint, respect it (capped)
+            let delayMs = computeDelay(attempt, baseDelayMs, maxDelayMs, jitter);
+            if (error instanceof agent_sdk_error_1.AgentSdkError &&
+                error.code === "rate_limit_error" &&
+                typeof error.details === "object" &&
+                error.details !== null) {
+                const details = error.details;
+                const retryAfterSec = typeof details["retry-after"] === "number"
+                    ? details["retry-after"]
+                    : typeof details["retryAfter"] === "number"
+                        ? details["retryAfter"]
+                        : null;
+                if (retryAfterSec !== null) {
+                    delayMs = Math.min(retryAfterSec * 1000, maxDelayMs);
+                }
+            }
+            await sleepFn(delayMs);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@balchemyai/agent-sdk",
+  "version": "0.1.0",
+  "license": "MIT",
+  "private": false,
+  "description": "Balchemy external AI agent onboarding + MCP SDK — ERC-8004 onboarding, Solana/EVM trading, 100 tools via MCP",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "docs"
+  ],
+  "keywords": [
+    "balchemy",
+    "mcp",
+    "model-context-protocol",
+    "ai-agent",
+    "erc8004",
+    "solana",
+    "evm",
+    "base",
+    "crypto",
+    "trading",
+    "onboarding",
+    "defi",
+    "wallet",
+    "typescript"
+  ],
+  "homepage": "https://balchemy.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/balchemy/balchemy-agent",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/balchemy/balchemy-agent/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "jest",
+    "test:cov": "jest --coverage",
+    "prepublishOnly": "pnpm run typecheck && pnpm run build"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "22.17.2",
+    "jest": "^30.0.0",
+    "ts-jest": "^29.3.4",
+    "typescript": "5.8.3"
+  }
+}