agentlaunch-sdk 0.1.0

package/dist/agents.js

@@ -0,0 +1,106 @@
+/**
+ * @agent-launch/sdk — Agent operations
+ *
+ * SDK-005: Authentication and Agentverse agent management.
+ *
+ * These endpoints let an agent:
+ *   - Exchange an Agentverse API key for a platform JWT (POST /agents/auth)
+ *   - List its own Agentverse agents (GET /agents/my-agents)
+ *   - Import agent metadata by API key (POST /agents/import-agentverse)
+ */
+import { AgentLaunchClient } from './client.js';
+// ---------------------------------------------------------------------------
+// Module-level default client (lazy, env-based)
+// ---------------------------------------------------------------------------
+function defaultClient(apiKey) {
+    return new AgentLaunchClient({
+        apiKey: apiKey ?? process.env['AGENTVERSE_API_KEY'] ?? process.env['AGENT_LAUNCH_API_KEY'],
+        baseUrl: process.env['AGENT_LAUNCH_BASE_URL'],
+    });
+}
+// ---------------------------------------------------------------------------
+// authenticate
+// ---------------------------------------------------------------------------
+/**
+ * Exchange an Agentverse API key for a platform JWT.
+ *
+ * The JWT can be used as a `Bearer` token on any endpoint that requires
+ * platform authentication (same access level as an X-API-Key header).
+ *
+ * Rate limit: 10 requests per 60 seconds.
+ *
+ * @param apiKey  Agentverse API key (av-…)
+ * @param client  Optional pre-configured client instance
+ *
+ * @example
+ * ```ts
+ * const { data } = await authenticate('av-xxxxxxxxxxxxxxxx');
+ * // data.token — JWT string
+ * // data.expires_in — seconds until expiry
+ * ```
+ */
+export async function authenticate(apiKey, client) {
+    // authenticate uses a body field, not a header — use a temporary client
+    // that does NOT need an API key header (the key goes in the body).
+    const c = client ?? new AgentLaunchClient({
+        baseUrl: process.env['AGENT_LAUNCH_BASE_URL'],
+        // No apiKey — the key is passed in the request body for this endpoint
+    });
+    // The auth endpoint accepts the key in the body and does not require
+    // an X-API-Key header, so we call post directly with no guard.
+    // We build a one-off request to avoid the "apiKey required" guard.
+    return c.post('/api/agents/auth', { api_key: apiKey });
+}
+// ---------------------------------------------------------------------------
+// getMyAgents
+// ---------------------------------------------------------------------------
+/**
+ * List the Agentverse agents owned by the caller's API key.
+ *
+ * Requires X-API-Key authentication.
+ *
+ * Rate limit: 30 requests per 60 seconds.
+ *
+ * @example
+ * ```ts
+ * const { data } = await getMyAgents();
+ * console.log(data.agents.map(a => a.address));
+ * ```
+ */
+export async function getMyAgents(client) {
+    const c = client ?? defaultClient();
+    return c.get('/api/agents/my-agents');
+}
+// ---------------------------------------------------------------------------
+// importFromAgentverse
+// ---------------------------------------------------------------------------
+/**
+ * Fetch all agents belonging to the supplied Agentverse API key.
+ *
+ * No platform authentication is required — the caller provides their own
+ * Agentverse key in the request body.  Results are cached on the server
+ * for 5 minutes.
+ *
+ * Useful for building integrations that need to enumerate an account's
+ * agents without a pre-existing platform session.
+ *
+ * Rate limit: 5 requests per 60 seconds.
+ *
+ * @param agentverseApiKey  Agentverse API key to import agents from
+ * @param client            Optional pre-configured client instance
+ *
+ * @example
+ * ```ts
+ * const { agents, count } = await importFromAgentverse('av-xxxxxxxxxxxxxxxx');
+ * ```
+ */
+export async function importFromAgentverse(agentverseApiKey, client) {
+    // This endpoint does not require platform auth — use a client without key
+    const c = client ?? new AgentLaunchClient({
+        baseUrl: process.env['AGENT_LAUNCH_BASE_URL'],
+    });
+    return c.post('/api/agents/import-agentverse', {
+        agentverseApiKey,
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOhD,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAS,aAAa,CAAC,MAAe;IACpC,OAAO,IAAI,iBAAiB,CAAC;QAC3B,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAC1F,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,MAA0B;IAE1B,wEAAwE;IACxE,mEAAmE;IACnE,MAAM,CAAC,GAAG,MAAM,IAAI,IAAI,iBAAiB,CAAC;QACxC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC7C,sEAAsE;KACvE,CAAC,CAAC;IAEH,qEAAqE;IACrE,+DAA+D;IAC/D,mEAAmE;IACnE,OAAQ,CAEN,CAAC,IAAI,CAAoB,kBAAkB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA0B;IAE1B,MAAM,CAAC,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IACpC,OAAO,CAAC,CAAC,GAAG,CAAmB,uBAAuB,CAAC,CAAC;AAC1D,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,gBAAwB,EACxB,MAA0B;IAE1B,0EAA0E;IAC1E,MAAM,CAAC,GAAG,MAAM,IAAI,IAAI,iBAAiB,CAAC;QACxC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;KAC9C,CAAC,CAAC;IAEH,OAAQ,CAEN,CAAC,IAAI,CAA2B,+BAA+B,EAAE;QACjE,gBAAgB;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @agent-launch/sdk — HTTP client
+ *
+ * SDK-001: Core fetch wrapper that injects auth headers and provides typed
+ * request helpers used by all other SDK modules.
+ *
+ * SDK-007: Exponential backoff retry on HTTP 429 (rate limit) responses.
+ * Retries up to `maxRetries` times (default: 3) with delays of 1s, 2s, 4s, …
+ *
+ * No external runtime dependencies — uses the global fetch() available in
+ * Node.js ≥ 18, Deno, and modern browsers.
+ */
+import { AgentLaunchConfig } from './types.js';
+/**
+ * AgentLaunchClient
+ *
+ * The central HTTP client for the AgentLaunch SDK.  Instantiate once and
+ * pass to the token, market, handoff, and agent helpers — or use the
+ * named module functions which create a default client from environment
+ * variables automatically.
+ *
+ * Automatically retries requests that receive HTTP 429 (Too Many Requests)
+ * using exponential backoff: 1s → 2s → 4s → … up to `maxRetries` attempts.
+ *
+ * @example
+ * ```ts
+ * import { AgentLaunchClient } from '@agent-launch/sdk';
+ *
+ * const client = new AgentLaunchClient({
+ *   apiKey: process.env.AGENTVERSE_API_KEY,
+ *   maxRetries: 3, // default
+ * });
+ * ```
+ */
+export declare class AgentLaunchClient {
+    /** Resolved base URL (no trailing slash, no /api suffix). */
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly maxRetries;
+    constructor(config?: AgentLaunchConfig);
+    /** Build the full API URL for a given path. */
+    private url;
+    /** Shared headers injected on every request. */
+    private headers;
+    /**
+     * Execute a fetch call with exponential backoff retry on HTTP 429.
+     *
+     * @param fetchFn  Factory that returns a Promise<Response> for each attempt
+     * @param label    Human-readable label for error messages (e.g. "GET /api/...")
+     */
+    private fetchWithRetry;
+    /**
+     * Perform a typed GET request.
+     *
+     * @param path   API path, e.g. `/api/agents/tokens`
+     * @param params Optional query-string parameters (undefined values omitted)
+     */
+    get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    /**
+     * Perform a typed POST request.  Always requires authentication.
+     *
+     * @param path API path, e.g. `/api/agents/tokenize`
+     * @param body Request body (serialised to JSON)
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AA0BjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,iBAAiB;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,GAAE,iBAAsB;IAU1C,+CAA+C;IAC/C,OAAO,CAAC,GAAG;IAKX,gDAAgD;IAChD,OAAO,CAAC,OAAO;IAuBf;;;;;OAKG;YACW,cAAc;IAiC5B;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC;IAqCb;;;;;OAKG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAyBvD"}

package/dist/client.js

@@ -0,0 +1,174 @@
+/**
+ * @agent-launch/sdk — HTTP client
+ *
+ * SDK-001: Core fetch wrapper that injects auth headers and provides typed
+ * request helpers used by all other SDK modules.
+ *
+ * SDK-007: Exponential backoff retry on HTTP 429 (rate limit) responses.
+ * Retries up to `maxRetries` times (default: 3) with delays of 1s, 2s, 4s, …
+ *
+ * No external runtime dependencies — uses the global fetch() available in
+ * Node.js ≥ 18, Deno, and modern browsers.
+ */
+import { AgentLaunchError } from './types.js';
+const DEFAULT_BASE_URL = 'https://agent-launch.ai';
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Parses the response body and extracts a human-readable error message
+ * from the server's JSON error payload (if present).
+ */
+async function extractErrorMessage(response) {
+    try {
+        const body = (await response.json());
+        return body.message ?? body.error ?? undefined;
+    }
+    catch {
+        // Body is not JSON — ignore
+        return undefined;
+    }
+}
+/**
+ * Sleep for `ms` milliseconds. Used between retry attempts.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * AgentLaunchClient
+ *
+ * The central HTTP client for the AgentLaunch SDK.  Instantiate once and
+ * pass to the token, market, handoff, and agent helpers — or use the
+ * named module functions which create a default client from environment
+ * variables automatically.
+ *
+ * Automatically retries requests that receive HTTP 429 (Too Many Requests)
+ * using exponential backoff: 1s → 2s → 4s → … up to `maxRetries` attempts.
+ *
+ * @example
+ * ```ts
+ * import { AgentLaunchClient } from '@agent-launch/sdk';
+ *
+ * const client = new AgentLaunchClient({
+ *   apiKey: process.env.AGENTVERSE_API_KEY,
+ *   maxRetries: 3, // default
+ * });
+ * ```
+ */
+export class AgentLaunchClient {
+    constructor(config = {}) {
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    /** Build the full API URL for a given path. */
+    url(path) {
+        // Paths passed internally are already prefixed with /api/...
+        return `${this.baseUrl}${path}`;
+    }
+    /** Shared headers injected on every request. */
+    headers(requireAuth) {
+        const h = {
+            'Content-Type': 'application/json',
+        };
+        if (requireAuth) {
+            if (!this.apiKey) {
+                throw new AgentLaunchError('An API key is required for this operation. ' +
+                    'Pass apiKey to AgentLaunchClient or set AGENTVERSE_API_KEY in your environment.', 0);
+            }
+            h['X-API-Key'] = this.apiKey;
+        }
+        else if (this.apiKey) {
+            // Attach the key on public endpoints too when present — harmless and
+            // enables higher rate limits on some endpoints.
+            h['X-API-Key'] = this.apiKey;
+        }
+        return h;
+    }
+    /**
+     * Execute a fetch call with exponential backoff retry on HTTP 429.
+     *
+     * @param fetchFn  Factory that returns a Promise<Response> for each attempt
+     * @param label    Human-readable label for error messages (e.g. "GET /api/...")
+     */
+    async fetchWithRetry(fetchFn, label) {
+        let attempt = 0;
+        while (true) {
+            const response = await fetchFn();
+            if (response.status !== 429 || attempt >= this.maxRetries) {
+                return response;
+            }
+            // Exponential backoff: 1000ms, 2000ms, 4000ms, …
+            const delayMs = 1000 * Math.pow(2, attempt);
+            attempt++;
+            // Respect Retry-After header if the server sends one
+            const retryAfter = response.headers.get('Retry-After');
+            const waitMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : delayMs;
+            await sleep(waitMs);
+            // The 429 response body must be consumed to avoid memory leaks in some
+            // runtimes; do so after the sleep so we don't block unnecessarily.
+            try {
+                await response.text();
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Public request methods
+    // -------------------------------------------------------------------------
+    /**
+     * Perform a typed GET request.
+     *
+     * @param path   API path, e.g. `/api/agents/tokens`
+     * @param params Optional query-string parameters (undefined values omitted)
+     */
+    async get(path, params) {
+        let fullPath = path;
+        if (params) {
+            const qs = new URLSearchParams();
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    qs.set(key, String(value));
+                }
+            }
+            const queryString = qs.toString();
+            if (queryString) {
+                fullPath = `${path}?${queryString}`;
+            }
+        }
+        const response = await this.fetchWithRetry(() => fetch(this.url(fullPath), {
+            method: 'GET',
+            headers: this.headers(false),
+        }), `GET ${fullPath}`);
+        if (!response.ok) {
+            const serverMessage = await extractErrorMessage(response);
+            throw new AgentLaunchError(`GET ${fullPath} failed: ${response.status} ${response.statusText}` +
+                (serverMessage ? ` — ${serverMessage}` : ''), response.status, serverMessage);
+        }
+        return response.json();
+    }
+    /**
+     * Perform a typed POST request.  Always requires authentication.
+     *
+     * @param path API path, e.g. `/api/agents/tokenize`
+     * @param body Request body (serialised to JSON)
+     */
+    async post(path, body) {
+        // Build headers first — throws synchronously if apiKey is missing
+        const headers = this.headers(true);
+        const response = await this.fetchWithRetry(() => fetch(this.url(path), {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        }), `POST ${path}`);
+        if (!response.ok) {
+            const serverMessage = await extractErrorMessage(response);
+            throw new AgentLaunchError(`POST ${path} failed: ${response.status} ${response.statusText}` +
+                (serverMessage ? ` — ${serverMessage}` : ''), response.status, serverMessage);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/handoff.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @agent-launch/sdk — Handoff link generation
+ *
+ * SDK-004: Helpers for generating deploy and trade handoff URLs.
+ *
+ * The agent-human handoff protocol:
+ *   1. Agent calls POST /api/agents/tokenize → receives token_id
+ *   2. Agent generates a deploy link from token_id → sends to human
+ *   3. Human opens link, connects wallet, signs 2 transactions
+ *   4. Token is live on the bonding curve
+ *
+ * Agents never hold private keys or sign blockchain transactions directly.
+ * All on-chain actions are delegated to humans via handoff links.
+ */
+import type { TradeLinkOptions } from './types.js';
+/**
+ * Generate a deploy handoff link for a pending token.
+ *
+ * The returned URL opens the deployment page where a human can connect
+ * their wallet and complete the on-chain deployment with two transactions:
+ *   1. Approve 120 FET to the deployer contract
+ *   2. Call deploy() on the deployer contract
+ *
+ * @param tokenId  The `token_id` returned by POST /api/agents/tokenize
+ * @param baseUrl  Override the platform base URL (defaults to agent-launch.ai)
+ *
+ * @example
+ * ```ts
+ * const link = generateDeployLink(42);
+ * // https://agent-launch.ai/deploy/42
+ *
+ * const devLink = generateDeployLink(42, 'https://fetch.ants-at-work.com');
+ * // https://fetch.ants-at-work.com/deploy/42
+ * ```
+ */
+export declare function generateDeployLink(tokenId: number, baseUrl?: string): string;
+/**
+ * Generate a trade handoff link for a deployed token.
+ *
+ * Agents use this to send pre-filled trade URLs to users.  The user opens
+ * the link, connects their wallet, reviews the pre-filled amount, and
+ * clicks Buy or Sell.
+ *
+ * @param address Token contract address
+ * @param opts    Optional action ('buy' | 'sell') and pre-fill amount
+ * @param baseUrl Override the platform base URL
+ *
+ * @example
+ * ```ts
+ * // Simple buy link
+ * generateTradeLink('0xAbCd...');
+ * // https://agent-launch.ai/trade/0xAbCd...
+ *
+ * // Pre-filled buy with amount
+ * generateTradeLink('0xAbCd...', { action: 'buy', amount: 100 });
+ * // https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+ *
+ * // Sell link
+ * generateTradeLink('0xAbCd...', { action: 'sell', amount: 500 });
+ * // https://agent-launch.ai/trade/0xAbCd...?action=sell&amount=500
+ * ```
+ */
+export declare function generateTradeLink(address: string, opts?: TradeLinkOptions, baseUrl?: string): string;
+/**
+ * Generate a buy link with a pre-filled FET amount.
+ *
+ * @example
+ * ```ts
+ * const link = generateBuyLink('0xAbCd...', 100);
+ * // https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+ * ```
+ */
+export declare function generateBuyLink(address: string, amount?: number | string, baseUrl?: string): string;
+/**
+ * Generate a sell link with a pre-filled token amount.
+ *
+ * @example
+ * ```ts
+ * const link = generateSellLink('0xAbCd...', 500);
+ * // https://agent-launch.ai/trade/0xAbCd...?action=sell&amount=500
+ * ```
+ */
+export declare function generateSellLink(address: string, amount?: number | string, baseUrl?: string): string;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,YAAY,CAAC;AAchE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,gBAAqB,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAeR;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAER"}

package/dist/handoff.js

@@ -0,0 +1,119 @@
+/**
+ * @agent-launch/sdk — Handoff link generation
+ *
+ * SDK-004: Helpers for generating deploy and trade handoff URLs.
+ *
+ * The agent-human handoff protocol:
+ *   1. Agent calls POST /api/agents/tokenize → receives token_id
+ *   2. Agent generates a deploy link from token_id → sends to human
+ *   3. Human opens link, connects wallet, signs 2 transactions
+ *   4. Token is live on the bonding curve
+ *
+ * Agents never hold private keys or sign blockchain transactions directly.
+ * All on-chain actions are delegated to humans via handoff links.
+ */
+/** Resolve the platform base URL from the optional override or environment. */
+function resolveBaseUrl(baseUrl) {
+    return ((baseUrl ?? process.env['AGENT_LAUNCH_BASE_URL'])?.replace(/\/$/, '') ??
+        'https://agent-launch.ai');
+}
+// ---------------------------------------------------------------------------
+// generateDeployLink
+// ---------------------------------------------------------------------------
+/**
+ * Generate a deploy handoff link for a pending token.
+ *
+ * The returned URL opens the deployment page where a human can connect
+ * their wallet and complete the on-chain deployment with two transactions:
+ *   1. Approve 120 FET to the deployer contract
+ *   2. Call deploy() on the deployer contract
+ *
+ * @param tokenId  The `token_id` returned by POST /api/agents/tokenize
+ * @param baseUrl  Override the platform base URL (defaults to agent-launch.ai)
+ *
+ * @example
+ * ```ts
+ * const link = generateDeployLink(42);
+ * // https://agent-launch.ai/deploy/42
+ *
+ * const devLink = generateDeployLink(42, 'https://fetch.ants-at-work.com');
+ * // https://fetch.ants-at-work.com/deploy/42
+ * ```
+ */
+export function generateDeployLink(tokenId, baseUrl) {
+    if (!Number.isInteger(tokenId) || tokenId <= 0) {
+        throw new Error(`generateDeployLink: tokenId must be a positive integer, got ${tokenId}`);
+    }
+    return `${resolveBaseUrl(baseUrl)}/deploy/${tokenId}`;
+}
+// ---------------------------------------------------------------------------
+// generateTradeLink
+// ---------------------------------------------------------------------------
+/**
+ * Generate a trade handoff link for a deployed token.
+ *
+ * Agents use this to send pre-filled trade URLs to users.  The user opens
+ * the link, connects their wallet, reviews the pre-filled amount, and
+ * clicks Buy or Sell.
+ *
+ * @param address Token contract address
+ * @param opts    Optional action ('buy' | 'sell') and pre-fill amount
+ * @param baseUrl Override the platform base URL
+ *
+ * @example
+ * ```ts
+ * // Simple buy link
+ * generateTradeLink('0xAbCd...');
+ * // https://agent-launch.ai/trade/0xAbCd...
+ *
+ * // Pre-filled buy with amount
+ * generateTradeLink('0xAbCd...', { action: 'buy', amount: 100 });
+ * // https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+ *
+ * // Sell link
+ * generateTradeLink('0xAbCd...', { action: 'sell', amount: 500 });
+ * // https://agent-launch.ai/trade/0xAbCd...?action=sell&amount=500
+ * ```
+ */
+export function generateTradeLink(address, opts = {}, baseUrl) {
+    const base = resolveBaseUrl(baseUrl);
+    const params = new URLSearchParams();
+    if (opts.action) {
+        params.set('action', opts.action);
+    }
+    if (opts.amount !== undefined && opts.amount !== null) {
+        params.set('amount', String(opts.amount));
+    }
+    const qs = params.toString();
+    return qs
+        ? `${base}/trade/${address}?${qs}`
+        : `${base}/trade/${address}`;
+}
+// ---------------------------------------------------------------------------
+// Convenience re-exports for common patterns
+// ---------------------------------------------------------------------------
+/**
+ * Generate a buy link with a pre-filled FET amount.
+ *
+ * @example
+ * ```ts
+ * const link = generateBuyLink('0xAbCd...', 100);
+ * // https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+ * ```
+ */
+export function generateBuyLink(address, amount, baseUrl) {
+    return generateTradeLink(address, { action: 'buy', amount }, baseUrl);
+}
+/**
+ * Generate a sell link with a pre-filled token amount.
+ *
+ * @example
+ * ```ts
+ * const link = generateSellLink('0xAbCd...', 500);
+ * // https://agent-launch.ai/trade/0xAbCd...?action=sell&amount=500
+ * ```
+ */
+export function generateSellLink(address, amount, baseUrl) {
+    return generateTradeLink(address, { action: 'sell', amount }, baseUrl);
+}
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,+EAA+E;AAC/E,SAAS,cAAc,CAAC,OAAgB;IACtC,OAAO,CACL,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACrE,yBAAyB,CAC1B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,OAAgB;IAClE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,+DAA+D,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,OAAO,EAAE,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,OAAyB,EAAE,EAC3B,OAAgB;IAEhB,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,OAAO,EAAE;QACP,CAAC,CAAC,GAAG,IAAI,UAAU,OAAO,IAAI,EAAE,EAAE;QAClC,CAAC,CAAC,GAAG,IAAI,UAAU,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,MAAwB,EACxB,OAAgB;IAEhB,OAAO,iBAAiB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAoB,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,MAAwB,EACxB,OAAgB;IAEhB,OAAO,iBAAiB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAqB,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,3 @@
+'use strict';
+const m = require('./index.js');
+module.exports = m;

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @agent-launch/sdk
+ *
+ * TypeScript SDK for the AgentLaunch platform (agent-launch.ai).
+ *
+ * Enables AI agents and developers to:
+ *   - Create token records and receive human handoff links
+ *   - Query token prices, market data, and holder information
+ *   - Generate pre-filled deploy and trade URLs for human users
+ *   - Authenticate with Agentverse API keys
+ *   - List and import Agentverse agents
+ *
+ * Quick start:
+ * ```ts
+ * import { tokenize, generateDeployLink } from '@agent-launch/sdk';
+ *
+ * const { data } = await tokenize({
+ *   agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj...',
+ *   name: 'My Agent Token',
+ *   chainId: 97,
+ * });
+ *
+ * const link = generateDeployLink(data.token_id);
+ * // Share this link with a human → they connect wallet → token is live
+ * ```
+ *
+ * Authentication:
+ *   Set AGENTVERSE_API_KEY in your environment, or pass `apiKey` directly
+ *   to AgentLaunchClient.
+ *
+ * Platform fee:
+ *   A 2% fee applies to every buy and sell transaction.
+ *   This fee goes 100% to the protocol treasury (REVENUE_ACCOUNT).
+ *   There is no creator fee.
+ */
+export { AgentLaunch } from './agentlaunch.js';
+export type { TokensNamespace, MarketNamespace, HandoffNamespace, AgentsNamespace, } from './agentlaunch.js';
+export { AgentLaunchClient } from './client.js';
+export type { AgentLaunchConfig, TokenizeParams, TokenizeResponse, Token, TokenListParams, TokenListResponse, Holder, HolderListResponse, SingleHolderResponse, TradeAction, TradeLinkOptions, AgentAuthResponse, AgentverseAgent, MyAgentsResponse, ImportAgentverseResponse, } from './types.js';
+export { AgentLaunchError } from './types.js';
+export { tokenize, getToken, listTokens } from './tokens.js';
+export { getTokenPrice, getTokenHolders, generateTradeLink as generateTradeLinkWithAction, generateTradeLinkFromOptions, } from './market.js';
+export { generateDeployLink, generateTradeLink, generateBuyLink, generateSellLink, } from './handoff.js';
+export { authenticate, getMyAgents, importFromAgentverse } from './agents.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,MAAM,EACN,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,IAAI,2BAA2B,EAChD,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}