@openserv-labs/client 1.0.0

package/dist/agents-api.d.ts

@@ -0,0 +1,139 @@
+import type { PlatformClient } from "./client";
+import type { Agent, MarketplaceAgentsResponse } from "./types";
+/**
+ * API for managing agents on the OpenServ platform.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient({ apiKey: 'your-key' });
+ *
+ * // List your own agents
+ * const myAgents = await client.agents.list();
+ *
+ * // Search your own agents by name/description
+ * const myMatches = await client.agents.searchOwned({ query: 'data' });
+ *
+ * // List all public marketplace agents
+ * const marketplaceAgents = await client.agents.listMarketplace();
+ *
+ * // Search all marketplace agents (semantic search)
+ * const searchResults = await client.agents.listMarketplace({
+ *   search: 'data processing',
+ *   page: 1,
+ *   pageSize: 20
+ * });
+ *
+ * // Create an agent
+ * const agent = await client.agents.create({
+ *   name: 'My Agent',
+ *   capabilities_description: 'Handles data processing',
+ *   endpoint_url: 'https://my-agent.example.com'
+ * });
+ * ```
+ */
+export declare class AgentsAPI {
+    private client;
+    constructor(client: PlatformClient);
+    /**
+     * List all agents owned by the authenticated user.
+     * @returns Array of agents
+     */
+    list(): Promise<Agent[]>;
+    /**
+     * List all public agents from the marketplace.
+     * @param params - Optional parameters
+     * @param params.search - Search query to filter agents
+     * @param params.page - Page number (default: 1)
+     * @param params.pageSize - Number of items per page (default: 50)
+     * @param params.showPrivateAgents - Include private agents owned by the user (default: true)
+     * @returns Paginated marketplace agents response
+     */
+    listMarketplace(params?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+        showPrivateAgents?: boolean;
+    }): Promise<MarketplaceAgentsResponse>;
+    /**
+     * Get an agent by ID.
+     * @param params - Parameters object
+     * @param params.id - The agent ID
+     * @returns The agent
+     */
+    get(params: {
+        id: number | string;
+    }): Promise<Agent>;
+    /**
+     * Search for agents owned by the authenticated user.
+     * Searches both name and capabilities_description fields.
+     * For marketplace-wide search, use listMarketplace({ search }) instead.
+     * @param params - Parameters object
+     * @param params.query - Search query to match against agent names and descriptions
+     * @returns Array of matching agents owned by the user
+     */
+    searchOwned(params: {
+        query: string;
+    }): Promise<Agent[]>;
+    /**
+     * Create a new agent.
+     * @param params - Parameters object
+     * @param params.name - Unique name for the agent
+     * @param params.capabilities_description - Description of what the agent can do
+     * @param params.endpoint_url - URL where the agent is hosted
+     * @returns The created agent
+     */
+    create(params: {
+        name: string;
+        capabilities_description: string;
+        endpoint_url: string;
+    }): Promise<Agent>;
+    /**
+     * Get the API key for an agent.
+     * @param params - Parameters object
+     * @param params.id - The agent ID
+     * @returns The agent's API key
+     */
+    getApiKey(params: {
+        id: number | string;
+    }): Promise<string>;
+    /**
+     * Update an existing agent.
+     * @param params - Parameters object
+     * @param params.id - The agent ID to update
+     * @param params.endpoint_url - New endpoint URL (optional)
+     * @param params.name - New name (optional)
+     * @param params.capabilities_description - New description (optional)
+     * @returns The updated agent
+     */
+    update(params: {
+        id: number | string;
+        endpoint_url?: string;
+        name?: string;
+        capabilities_description?: string;
+    }): Promise<Agent>;
+    /**
+     * Delete an agent.
+     * @param params - Parameters object
+     * @param params.id - The agent ID to delete
+     */
+    delete(params: {
+        id: number | string;
+    }): Promise<void>;
+    /**
+     * Generate a new auth token for securing agent requests.
+     * Returns both the plaintext token (for the agent) and the hash (for the platform).
+     */
+    generateAuthToken(): Promise<{
+        authToken: string;
+        authTokenHash: string;
+    }>;
+    /**
+     * Save the auth token hash to the platform for a specific agent.
+     * The platform will use this to verify requests to the agent.
+     */
+    saveAuthToken(params: {
+        id: number | string;
+        authTokenHash: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=agents-api.d.ts.map

package/dist/agents-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-api.d.ts","sourceRoot":"","sources":["../src/agents-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,KAAK,EAKL,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAK9B;;;;;;;;OAQG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAetC;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAI1D;;;;;;;OAOG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAO9D;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,wBAAwB,EAAE,MAAM,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,KAAK,CAAC;IAWlB;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjE;;;;;;;;OAQG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,KAAK,CAAC;IAuClB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAOF;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlB"}

package/dist/agents-api.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsAPI = void 0;
+/**
+ * API for managing agents on the OpenServ platform.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient({ apiKey: 'your-key' });
+ *
+ * // List your own agents
+ * const myAgents = await client.agents.list();
+ *
+ * // Search your own agents by name/description
+ * const myMatches = await client.agents.searchOwned({ query: 'data' });
+ *
+ * // List all public marketplace agents
+ * const marketplaceAgents = await client.agents.listMarketplace();
+ *
+ * // Search all marketplace agents (semantic search)
+ * const searchResults = await client.agents.listMarketplace({
+ *   search: 'data processing',
+ *   page: 1,
+ *   pageSize: 20
+ * });
+ *
+ * // Create an agent
+ * const agent = await client.agents.create({
+ *   name: 'My Agent',
+ *   capabilities_description: 'Handles data processing',
+ *   endpoint_url: 'https://my-agent.example.com'
+ * });
+ * ```
+ */
+class AgentsAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List all agents owned by the authenticated user.
+     * @returns Array of agents
+     */
+    async list() {
+        const data = await this.client.get("/agents");
+        return data.items || data;
+    }
+    /**
+     * List all public agents from the marketplace.
+     * @param params - Optional parameters
+     * @param params.search - Search query to filter agents
+     * @param params.page - Page number (default: 1)
+     * @param params.pageSize - Number of items per page (default: 50)
+     * @param params.showPrivateAgents - Include private agents owned by the user (default: true)
+     * @returns Paginated marketplace agents response
+     */
+    async listMarketplace(params) {
+        return this.client.get("/marketplace/agents-classic", {
+            params: {
+                search: params?.search || "",
+                page: params?.page || 1,
+                pageSize: params?.pageSize || 50,
+                showPrivateAgents: params?.showPrivateAgents !== false ? "true" : "false",
+            },
+        });
+    }
+    /**
+     * Get an agent by ID.
+     * @param params - Parameters object
+     * @param params.id - The agent ID
+     * @returns The agent
+     */
+    async get(params) {
+        return this.client.get(`/agents/${params.id}`);
+    }
+    /**
+     * Search for agents owned by the authenticated user.
+     * Searches both name and capabilities_description fields.
+     * For marketplace-wide search, use listMarketplace({ search }) instead.
+     * @param params - Parameters object
+     * @param params.query - Search query to match against agent names and descriptions
+     * @returns Array of matching agents owned by the user
+     */
+    async searchOwned(params) {
+        const data = await this.client.get("/agents", {
+            params: { search: params.query },
+        });
+        return data.items || data;
+    }
+    /**
+     * Create a new agent.
+     * @param params - Parameters object
+     * @param params.name - Unique name for the agent
+     * @param params.capabilities_description - Description of what the agent can do
+     * @param params.endpoint_url - URL where the agent is hosted
+     * @returns The created agent
+     */
+    async create(params) {
+        const data = await this.client.post("/agents", {
+            name: params.name,
+            capabilities_description: params.capabilities_description,
+            endpoint_url: params.endpoint_url,
+            kind: "external",
+            is_built_by_agent_builder: false,
+        });
+        return this.get({ id: data.id });
+    }
+    /**
+     * Get the API key for an agent.
+     * @param params - Parameters object
+     * @param params.id - The agent ID
+     * @returns The agent's API key
+     */
+    async getApiKey(params) {
+        const data = await this.client.post(`/agents/${params.id}/api-key`, {});
+        return data.apiKey;
+    }
+    /**
+     * Update an existing agent.
+     * @param params - Parameters object
+     * @param params.id - The agent ID to update
+     * @param params.endpoint_url - New endpoint URL (optional)
+     * @param params.name - New name (optional)
+     * @param params.capabilities_description - New description (optional)
+     * @returns The updated agent
+     */
+    async update(params) {
+        const { id, endpoint_url, name, capabilities_description } = params;
+        // First get the current agent to preserve ALL required fields
+        const currentAgent = await this.get({ id });
+        // Build update payload - API uses PUT and requires ALL fields
+        // Note: scopes must be an object, not an array (API may return [] for empty scopes)
+        const scopes = currentAgent.scopes && !Array.isArray(currentAgent.scopes)
+            ? currentAgent.scopes
+            : {};
+        const updatePayload = {
+            name: name ?? currentAgent.name,
+            capabilities_description: capabilities_description ?? currentAgent.capabilities_description,
+            endpoint_url: endpoint_url ?? currentAgent.endpoint_url,
+            kind: "external",
+            is_built_by_agent_builder: false,
+            // Required fields that must be preserved
+            approval_status: currentAgent.approval_status || "in-development",
+            is_listed_on_marketplace: currentAgent.is_listed_on_marketplace ?? false,
+            is_trading_agent: currentAgent.is_trading_agent ?? false,
+            scopes,
+        };
+        // Note: endpoint_url is required for external agents. The GET single agent
+        // endpoint doesn't return it, so it must be provided in the update params.
+        if (updatePayload.kind === "external" && !updatePayload.endpoint_url) {
+            throw new Error("endpoint_url is required when updating an external agent");
+        }
+        await this.client.put(`/agents/${id}`, updatePayload);
+        return this.get({ id });
+    }
+    /**
+     * Delete an agent.
+     * @param params - Parameters object
+     * @param params.id - The agent ID to delete
+     */
+    async delete(params) {
+        // Use developer endpoint - admin-only endpoint requires elevated permissions
+        await this.client.delete(`/agents/${params.id}/developer`);
+    }
+    /**
+     * Generate a new auth token for securing agent requests.
+     * Returns both the plaintext token (for the agent) and the hash (for the platform).
+     */
+    async generateAuthToken() {
+        return this.client.post("/agents/generate-auth-token", {});
+    }
+    /**
+     * Save the auth token hash to the platform for a specific agent.
+     * The platform will use this to verify requests to the agent.
+     */
+    async saveAuthToken(params) {
+        await this.client.post(`/agents/${params.id}/auth-token`, {
+            authTokenHash: params.authTokenHash,
+        });
+    }
+}
+exports.AgentsAPI = AgentsAPI;

package/dist/client.d.ts

@@ -0,0 +1,107 @@
+import { type AxiosInstance, type AxiosRequestConfig } from "axios";
+import { AgentsAPI } from "./agents-api";
+import { IntegrationsAPI } from "./integrations-api";
+import { TriggersAPI } from "./triggers-api";
+import { TasksAPI } from "./tasks-api";
+import { WorkflowsAPI } from "./workflows-api";
+import { Web3API } from "./web3-api";
+import { PaymentsAPI } from "./payments-api";
+/**
+ * Client for interacting with the OpenServ Platform API.
+ *
+ * @example
+ * ```typescript
+ * // Using API key authentication
+ * const client = new PlatformClient({ apiKey: 'your-api-key' });
+ *
+ * // Using environment variable
+ * const client = new PlatformClient(); // Uses OPENSERV_USER_API_KEY
+ *
+ * // Using wallet authentication
+ * const client = new PlatformClient();
+ * await client.authenticate(process.env.WALLET_PRIVATE_KEY);
+ * ```
+ */
+export declare class PlatformClient {
+    private _apiClient;
+    /** API for managing agents */
+    readonly agents: AgentsAPI;
+    /** API for managing integration connections */
+    readonly integrations: IntegrationsAPI;
+    /** API for managing workflow triggers */
+    readonly triggers: TriggersAPI;
+    /** API for managing workflow tasks */
+    readonly tasks: TasksAPI;
+    /** API for managing workflows */
+    readonly workflows: WorkflowsAPI;
+    /** API for Web3 operations (USDC top-up) */
+    readonly web3: Web3API;
+    /** API for x402 payments to access paid workflows */
+    readonly payments: PaymentsAPI;
+    /**
+     * Get the raw axios client for advanced use cases.
+     * @returns The underlying axios instance
+     */
+    get rawClient(): AxiosInstance;
+    /**
+     * Make a GET request to the API.
+     * @param path - API endpoint path
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    get<T>(path: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Make a POST request to the API.
+     * @param path - API endpoint path
+     * @param data - Request body data
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    post<T>(path: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Make a PUT request to the API.
+     * @param path - API endpoint path
+     * @param data - Request body data
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    put<T>(path: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Make a DELETE request to the API.
+     * @param path - API endpoint path
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    delete<T>(path: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Creates a new PlatformClient instance.
+     *
+     * @param options - Configuration options
+     * @param options.apiKey - API key for authentication (defaults to OPENSERV_USER_API_KEY env var)
+     * @param options.baseUrl - Base URL for the API (defaults to https://api.openserv.ai)
+     */
+    constructor(options?: {
+        apiKey?: string;
+        baseUrl?: string;
+    });
+    /**
+     * Authenticate using an Ethereum wallet (SIWE - EIP-4361).
+     *
+     * This method performs Sign-In with Ethereum authentication:
+     * 1. Gets a nonce from the platform
+     * 2. Signs the SIWE message with the wallet
+     * 3. Verifies the signature and receives an API key
+     *
+     * @param privateKey - Wallet private key (defaults to WALLET_PRIVATE_KEY env var)
+     * @returns The API key received from authentication
+     *
+     * @example
+     * ```typescript
+     * const client = new PlatformClient();
+     * const apiKey = await client.authenticate(process.env.WALLET_PRIVATE_KEY);
+     * // Client is now authenticated and ready to use
+     * ```
+     */
+    authenticate(privateKey?: string): Promise<string>;
+}
+//# 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,OAAc,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK7C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAgB;IAElC,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B;;;OAGG;IACH,IAAI,SAAS,IAAI,aAAa,CAE7B;IAED;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnE;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAqB3D;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiEzD"}

package/dist/client.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const ethers_1 = require("ethers");
+const agents_api_1 = require("./agents-api");
+const integrations_api_1 = require("./integrations-api");
+const triggers_api_1 = require("./triggers-api");
+const tasks_api_1 = require("./tasks-api");
+const workflows_api_1 = require("./workflows-api");
+const web3_api_1 = require("./web3-api");
+const payments_api_1 = require("./payments-api");
+const PLATFORM_URL = process.env.OPENSERV_API_URL || "https://api.openserv.ai";
+/**
+ * Client for interacting with the OpenServ Platform API.
+ *
+ * @example
+ * ```typescript
+ * // Using API key authentication
+ * const client = new PlatformClient({ apiKey: 'your-api-key' });
+ *
+ * // Using environment variable
+ * const client = new PlatformClient(); // Uses OPENSERV_USER_API_KEY
+ *
+ * // Using wallet authentication
+ * const client = new PlatformClient();
+ * await client.authenticate(process.env.WALLET_PRIVATE_KEY);
+ * ```
+ */
+class PlatformClient {
+    _apiClient;
+    /** API for managing agents */
+    agents;
+    /** API for managing integration connections */
+    integrations;
+    /** API for managing workflow triggers */
+    triggers;
+    /** API for managing workflow tasks */
+    tasks;
+    /** API for managing workflows */
+    workflows;
+    /** API for Web3 operations (USDC top-up) */
+    web3;
+    /** API for x402 payments to access paid workflows */
+    payments;
+    /**
+     * Get the raw axios client for advanced use cases.
+     * @returns The underlying axios instance
+     */
+    get rawClient() {
+        return this._apiClient;
+    }
+    /**
+     * Make a GET request to the API.
+     * @param path - API endpoint path
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    async get(path, config) {
+        const response = await this._apiClient.get(path, config);
+        return response.data;
+    }
+    /**
+     * Make a POST request to the API.
+     * @param path - API endpoint path
+     * @param data - Request body data
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    async post(path, data, config) {
+        const response = await this._apiClient.post(path, data, config);
+        return response.data;
+    }
+    /**
+     * Make a PUT request to the API.
+     * @param path - API endpoint path
+     * @param data - Request body data
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    async put(path, data, config) {
+        const response = await this._apiClient.put(path, data, config);
+        return response.data;
+    }
+    /**
+     * Make a DELETE request to the API.
+     * @param path - API endpoint path
+     * @param config - Optional Axios request config
+     * @returns Response data
+     */
+    async delete(path, config) {
+        const response = await this._apiClient.delete(path, config);
+        return response.data;
+    }
+    /**
+     * Creates a new PlatformClient instance.
+     *
+     * @param options - Configuration options
+     * @param options.apiKey - API key for authentication (defaults to OPENSERV_USER_API_KEY env var)
+     * @param options.baseUrl - Base URL for the API (defaults to https://api.openserv.ai)
+     */
+    constructor(options) {
+        const apiKey = options?.apiKey || process.env.OPENSERV_USER_API_KEY;
+        const baseUrl = options?.baseUrl || PLATFORM_URL;
+        this._apiClient = axios_1.default.create({
+            baseURL: baseUrl,
+            headers: {
+                "Content-Type": "application/json",
+                ...(apiKey ? { "x-openserv-key": apiKey } : {}),
+            },
+        });
+        this.agents = new agents_api_1.AgentsAPI(this);
+        this.integrations = new integrations_api_1.IntegrationsAPI(this);
+        this.triggers = new triggers_api_1.TriggersAPI(this);
+        this.tasks = new tasks_api_1.TasksAPI(this);
+        this.workflows = new workflows_api_1.WorkflowsAPI(this);
+        this.web3 = new web3_api_1.Web3API(this);
+        this.payments = new payments_api_1.PaymentsAPI(this);
+    }
+    /**
+     * Authenticate using an Ethereum wallet (SIWE - EIP-4361).
+     *
+     * This method performs Sign-In with Ethereum authentication:
+     * 1. Gets a nonce from the platform
+     * 2. Signs the SIWE message with the wallet
+     * 3. Verifies the signature and receives an API key
+     *
+     * @param privateKey - Wallet private key (defaults to WALLET_PRIVATE_KEY env var)
+     * @returns The API key received from authentication
+     *
+     * @example
+     * ```typescript
+     * const client = new PlatformClient();
+     * const apiKey = await client.authenticate(process.env.WALLET_PRIVATE_KEY);
+     * // Client is now authenticated and ready to use
+     * ```
+     */
+    async authenticate(privateKey) {
+        const walletKey = privateKey || process.env.WALLET_PRIVATE_KEY;
+        if (!walletKey) {
+            // If no wallet key, assume API key auth is already set up
+            return "";
+        }
+        // Create wallet
+        const wallet = new ethers_1.ethers.Wallet(walletKey);
+        const walletAddress = wallet.address;
+        // Step 1: Get nonce from platform
+        const nonceResponse = await this._apiClient.post("/auth/wallet/nonce", {
+            walletAddress,
+        });
+        const { nonce, message: legacyMessage } = nonceResponse.data;
+        if (!nonce && !legacyMessage) {
+            throw new Error(`Nonce endpoint did not return nonce or message. Response: ${JSON.stringify(nonceResponse.data)}`);
+        }
+        // Construct SIWE-formatted message (EIP-4361)
+        const domain = "platform.openserv.ai";
+        const uri = "https://platform.openserv.ai";
+        const issuedAt = new Date().toISOString();
+        const message = legacyMessage ||
+            `${domain} wants you to sign in with your Ethereum account:
+${walletAddress}
+
+Sign in to OpenServ
+
+URI: ${uri}
+Version: 1
+Chain ID: 1
+Nonce: ${nonce}
+Issued At: ${issuedAt}`;
+        // Step 2: Sign the message
+        const signature = await wallet.signMessage(message);
+        // Step 3: Verify signature and get API key
+        const verifyResponse = await this._apiClient.post("/auth/wallet/verify", {
+            walletAddress,
+            signature,
+            message,
+        });
+        const apiKey = verifyResponse.data.apiKey;
+        // Update client with API key header
+        this._apiClient.defaults.headers.common["x-openserv-key"] = apiKey;
+        return apiKey;
+    }
+}
+exports.PlatformClient = PlatformClient;

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { PaginatedResponse, IdResponse, ApiKeyResponse, NonceResponse, VerifyResponse, Agent, Category, MarketplaceAgent, MarketplaceAgentsResponse, TriggerDefinition, TaskDefinition, EdgeDefinition, WorkflowConfig, Trigger, Task, Edge, WorkflowData, UsdcTopupConfig, UsdcVerifyRequest, UsdcVerifyResponse, UsdcTopupResult, X402PaymentRequest, X402PaymentResult, } from "./types";
+export type { InputSchemaProperty, InputSchema, WebhookTriggerConfig, X402TriggerConfig, CronTriggerConfig, ManualTriggerConfig, TriggerConfig, } from "./triggers-api";
+export { triggers, inputSchemaToJsonSchema, triggerConfigToProps, } from "./triggers-api";
+export { PlatformClient } from "./client";
+export { Workflow } from "./workflow";
+export { AgentsAPI } from "./agents-api";
+export { IntegrationsAPI } from "./integrations-api";
+export { TriggersAPI } from "./triggers-api";
+export { TasksAPI } from "./tasks-api";
+export { WorkflowsAPI } from "./workflows-api";
+export { Web3API } from "./web3-api";
+export { PaymentsAPI } from "./payments-api";
+export type { IntegrationConnection } from "./integrations-api";
+export type { ProvisionConfig, ProvisionResult, Logger } from "./provision";
+export { provision, isProvisioned, getProvisionedInfo, clearProvisionedState, setLogger, } from "./provision";
+//# 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":"AACA,YAAY,EAEV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EAEd,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,YAAY,EAEZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAEf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,EACL,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,SAAS,GACV,MAAM,aAAa,CAAC"}