@openserv-labs/client 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,219 @@
+export interface Agent {
+    id: number;
+    name: string;
+    capabilities_description: string;
+    endpoint_url: string;
+    approval_status: string;
+    is_listed_on_marketplace: boolean;
+    is_trading_agent: boolean;
+    scopes: Record<string, unknown> | string[];
+}
+export interface Category {
+    id: number;
+    name: string;
+    description?: string | null;
+}
+export interface MarketplaceAgent {
+    id: number;
+    name: string;
+    capabilities_description: string;
+    avatar_url?: string | null;
+    author_name: string;
+    approval_status: "approved" | "rejected" | "pending" | "in-development";
+    scopes: Record<string, unknown>;
+    isOwner?: boolean | null;
+    categories: Category[];
+    kind: "openserv" | "external";
+    isBuiltByAgentBuilder: boolean;
+    is_trading_agent: boolean;
+}
+export interface MarketplaceAgentsResponse {
+    items: MarketplaceAgent[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    hasPrivateAgents: boolean;
+}
+export interface PaginatedResponse<T> {
+    items: T[];
+}
+export interface IdResponse {
+    id: number;
+}
+export interface ApiKeyResponse {
+    apiKey: string;
+}
+export interface AuthTokenResponse {
+    authToken: string;
+    authTokenHash: string;
+}
+export interface NonceResponse {
+    nonce: string;
+    message?: string;
+}
+export interface VerifyResponse {
+    success: boolean;
+    apiKey: string;
+}
+export interface TriggerDefinition {
+    id?: string;
+    name: string;
+    type?: "x402" | "webhook" | "cron" | "manual";
+    integrationConnectionId?: string;
+    props?: Record<string, unknown>;
+}
+export interface TaskDefinition {
+    id?: number;
+    name: string;
+    agentId: number | string;
+    description: string;
+    body?: string;
+    input?: string;
+    dependencies?: string[];
+}
+export interface EdgeDefinition {
+    from: string;
+    to: string;
+}
+export interface WorkflowConfig {
+    name: string;
+    goal?: string;
+    agentIds: (number | string)[];
+    triggers?: TriggerDefinition[];
+    tasks?: TaskDefinition[];
+    edges?: EdgeDefinition[];
+}
+export interface Trigger {
+    id: string;
+    name: string;
+    description?: string;
+    integrationConnectionId: string;
+    props: Record<string, unknown>;
+    url?: string;
+    webhookUrl?: string;
+    token?: string;
+    isActive?: boolean;
+    state?: string;
+}
+export interface Task {
+    id: number;
+    name?: string;
+    description: string;
+    assigneeAgentId: number;
+    body?: string;
+    status: string;
+    dependencies: Array<{
+        dependency_task_id: number;
+    } | number>;
+}
+export interface Edge {
+    from: {
+        type: string;
+        id: string | number;
+    };
+    to: {
+        type: string;
+        id: string | number;
+    };
+}
+export interface WorkflowData {
+    id: number;
+    name: string;
+    goal: string;
+    status: string;
+    triggers: Trigger[];
+    tasks: Task[];
+    edges: Edge[];
+    agents: Agent[];
+}
+/**
+ * Configuration for USDC top-up payments.
+ * Returned by the platform to enable wallet-based credit purchases.
+ */
+export interface UsdcTopupConfig {
+    /** Address that receives USDC payments */
+    receiverAddress: string;
+    /** USDC token contract address on the target chain */
+    usdcContractAddress: string;
+    /** Chain ID (e.g., 8453 for Base) */
+    chainId: number;
+    /** Human-readable network name (e.g., "base") */
+    network: string;
+    /** Conversion rate: USDC to credits (1 USDC = 1 USD = 100_000_000 credits) */
+    rateUsdcToCredits: number;
+}
+/**
+ * Request to verify a USDC top-up transaction.
+ */
+export interface UsdcVerifyRequest {
+    /** The transaction hash of the USDC transfer */
+    txHash: string;
+    /**
+     * For non-wallet users: the address that sent the USDC.
+     * Required when the user is authenticated via email/Google rather than wallet.
+     */
+    payerAddress?: string;
+    /**
+     * For non-wallet users: signature proving ownership of the sending wallet.
+     * The signature should be over the message: "Verify USDC top-up: {txHash}"
+     */
+    signature?: string;
+}
+/**
+ * Response from verifying a USDC top-up transaction.
+ */
+export interface UsdcVerifyResponse {
+    /** Whether the verification was successful */
+    success: boolean;
+    /** Number of credits added to the user's wallet */
+    creditsAdded: number;
+    /** Original USDC amount as a string (with decimals) */
+    usdcAmount: string;
+}
+/**
+ * Result from the high-level topUp method.
+ */
+export interface UsdcTopupResult {
+    /** Whether the top-up was successful */
+    success: boolean;
+    /** The transaction hash of the USDC transfer */
+    txHash: string;
+    /** Number of credits added to the user's wallet */
+    creditsAdded: number;
+    /** USDC amount transferred (with decimals) */
+    usdcAmount: string;
+    /** Network where the transaction was sent */
+    network: string;
+    /** Chain ID of the network */
+    chainId: number;
+}
+/**
+ * Request parameters for paying and executing an x402 workflow.
+ */
+export interface X402PaymentRequest {
+    /** The x402 trigger URL to pay for (webhookUrl from discoverServices or trigger.webhookUrl) */
+    triggerUrl: string;
+    /** Wallet private key for payment (or uses WALLET_PRIVATE_KEY env var) */
+    privateKey?: string;
+    /** Input data to pass to the workflow */
+    input?: Record<string, unknown>;
+}
+/**
+ * Result from paying and executing an x402 workflow.
+ */
+export interface X402PaymentResult {
+    /** Whether the payment and execution were successful */
+    success: boolean;
+    /** The payment transaction hash (may be empty - x402 handles internally) */
+    txHash: string;
+    /** The price paid in USD (may be empty - x402 handles internally) */
+    price: string;
+    /** The workflow response data */
+    response: unknown;
+    /** Network where the payment was made */
+    network: string;
+    /** Chain ID of the network */
+    chainId: number;
+}
+//# 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,5 @@
+"use strict";
+// ============================================================================
+// API Response Types (raw platform responses)
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/web3-api.d.ts

@@ -0,0 +1,117 @@
+import type { PlatformClient } from "./client";
+import type { UsdcTopupConfig, UsdcTopupResult, UsdcVerifyRequest, UsdcVerifyResponse } from "./types";
+/**
+ * API for Web3 operations including USDC top-up for credits.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient();
+ *
+ * // Simple one-liner to top up with USDC - auto-authenticates with wallet
+ * const result = await client.web3.topUp({
+ *   privateKey: process.env.WALLET_PRIVATE_KEY,
+ *   amountUsd: 10 // $10 worth of USDC
+ * });
+ * console.log(`Added ${result.creditsAdded} credits`);
+ *
+ * // Or use the lower-level methods for more control
+ * const config = await client.web3.getUsdcTopupConfig();
+ * // ... send USDC manually ...
+ * const verifyResult = await client.web3.verifyUsdcTransaction({ txHash: '0x...' });
+ * ```
+ */
+export declare class Web3API {
+    private client;
+    constructor(client: PlatformClient);
+    /**
+     * Get the configuration for USDC top-up payments.
+     *
+     * Returns the receiver address, USDC contract address, chain ID, and conversion rate
+     * needed to send a USDC payment for credit top-up.
+     *
+     * @returns USDC top-up configuration
+     *
+     * @example
+     * ```typescript
+     * const config = await client.web3.getUsdcTopupConfig();
+     * // config.receiverAddress - Address to send USDC to
+     * // config.usdcContractAddress - USDC token contract
+     * // config.chainId - Target chain (e.g., 8453 for Base)
+     * // config.network - Network name (e.g., "base")
+     * // config.rateUsdcToCredits - 1 USDC = 100_000_000 credits
+     * ```
+     */
+    getUsdcTopupConfig(): Promise<UsdcTopupConfig>;
+    /**
+     * Verify a USDC transaction and add credits to the user's wallet.
+     *
+     * After sending USDC to the receiver address, call this method with the
+     * transaction hash to verify the payment and receive credits.
+     *
+     * For wallet-authenticated users, the sender address is verified automatically.
+     * For email/Google-authenticated users, you must provide a signature proving
+     * ownership of the sending wallet.
+     *
+     * @param params - Verification parameters
+     * @param params.txHash - The transaction hash of the USDC transfer
+     * @param params.payerAddress - (Optional) For non-wallet users: the address that sent the USDC
+     * @param params.signature - (Optional) For non-wallet users: signature over "Verify USDC top-up: {txHash}"
+     * @returns Verification result with credits added
+     *
+     * @example
+     * ```typescript
+     * // For wallet-authenticated users
+     * const result = await client.web3.verifyUsdcTransaction({
+     *   txHash: '0xabc123...'
+     * });
+     *
+     * // For email/Google-authenticated users
+     * const message = `Verify USDC top-up: ${txHash}`;
+     * const signature = await wallet.signMessage(message);
+     * const result = await client.web3.verifyUsdcTransaction({
+     *   txHash: '0xabc123...',
+     *   payerAddress: '0xYourWallet...',
+     *   signature
+     * });
+     *
+     * console.log(`Added ${result.creditsAdded} credits (${result.usdcAmount} USDC)`);
+     * ```
+     */
+    verifyUsdcTransaction(params: UsdcVerifyRequest): Promise<UsdcVerifyResponse>;
+    /**
+     * Top up credits by sending USDC from your wallet.
+     *
+     * This is a high-level method that handles the entire flow:
+     * 1. Auto-authenticates with wallet if no API key is set
+     * 2. Fetches the USDC top-up configuration
+     * 3. Sends USDC from your wallet to the receiver
+     * 4. Waits for transaction confirmation
+     * 5. Signs a verification message
+     * 6. Verifies the transaction and adds credits
+     *
+     * @param params - Top-up parameters
+     * @param params.privateKey - Wallet private key (or uses WALLET_PRIVATE_KEY env var)
+     * @param params.amountUsd - Amount in USD to top up (e.g., 10 for $10)
+     * @param params.rpcUrl - (Optional) Custom RPC URL for the chain
+     * @returns Top-up result with credits added and transaction details
+     *
+     * @example
+     * ```typescript
+     * // Top up $10 worth of credits - only wallet key needed!
+     * const result = await client.web3.topUp({
+     *   privateKey: process.env.WALLET_PRIVATE_KEY,
+     *   amountUsd: 10
+     * });
+     *
+     * console.log(`Transaction: ${result.txHash}`);
+     * console.log(`Added ${result.creditsAdded} credits`);
+     * console.log(`USDC spent: ${result.usdcAmount}`);
+     * ```
+     */
+    topUp(params: {
+        privateKey?: string;
+        amountUsd: number;
+        rpcUrl?: string;
+    }): Promise<UsdcTopupResult>;
+}
+//# sourceMappingURL=web3-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web3-api.d.ts","sourceRoot":"","sources":["../src/web3-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAajB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;;;;;;;;;;;;;;;OAiBG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,qBAAqB,CACzB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAO9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,KAAK,CAAC,MAAM,EAAE;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,eAAe,CAAC;CAyF7B"}

package/dist/web3-api.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Web3API = void 0;
+const ethers_1 = require("ethers");
+// ERC20 Transfer ABI (minimal)
+const ERC20_ABI = [
+    "function transfer(address to, uint256 amount) returns (bool)",
+    "function balanceOf(address owner) view returns (uint256)",
+];
+// Known RPC URLs for supported chains
+const CHAIN_RPC_URLS = {
+    8453: "https://mainnet.base.org", // Base mainnet
+};
+/**
+ * API for Web3 operations including USDC top-up for credits.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient();
+ *
+ * // Simple one-liner to top up with USDC - auto-authenticates with wallet
+ * const result = await client.web3.topUp({
+ *   privateKey: process.env.WALLET_PRIVATE_KEY,
+ *   amountUsd: 10 // $10 worth of USDC
+ * });
+ * console.log(`Added ${result.creditsAdded} credits`);
+ *
+ * // Or use the lower-level methods for more control
+ * const config = await client.web3.getUsdcTopupConfig();
+ * // ... send USDC manually ...
+ * const verifyResult = await client.web3.verifyUsdcTransaction({ txHash: '0x...' });
+ * ```
+ */
+class Web3API {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get the configuration for USDC top-up payments.
+     *
+     * Returns the receiver address, USDC contract address, chain ID, and conversion rate
+     * needed to send a USDC payment for credit top-up.
+     *
+     * @returns USDC top-up configuration
+     *
+     * @example
+     * ```typescript
+     * const config = await client.web3.getUsdcTopupConfig();
+     * // config.receiverAddress - Address to send USDC to
+     * // config.usdcContractAddress - USDC token contract
+     * // config.chainId - Target chain (e.g., 8453 for Base)
+     * // config.network - Network name (e.g., "base")
+     * // config.rateUsdcToCredits - 1 USDC = 100_000_000 credits
+     * ```
+     */
+    async getUsdcTopupConfig() {
+        return this.client.get("/config/topup/usdc");
+    }
+    /**
+     * Verify a USDC transaction and add credits to the user's wallet.
+     *
+     * After sending USDC to the receiver address, call this method with the
+     * transaction hash to verify the payment and receive credits.
+     *
+     * For wallet-authenticated users, the sender address is verified automatically.
+     * For email/Google-authenticated users, you must provide a signature proving
+     * ownership of the sending wallet.
+     *
+     * @param params - Verification parameters
+     * @param params.txHash - The transaction hash of the USDC transfer
+     * @param params.payerAddress - (Optional) For non-wallet users: the address that sent the USDC
+     * @param params.signature - (Optional) For non-wallet users: signature over "Verify USDC top-up: {txHash}"
+     * @returns Verification result with credits added
+     *
+     * @example
+     * ```typescript
+     * // For wallet-authenticated users
+     * const result = await client.web3.verifyUsdcTransaction({
+     *   txHash: '0xabc123...'
+     * });
+     *
+     * // For email/Google-authenticated users
+     * const message = `Verify USDC top-up: ${txHash}`;
+     * const signature = await wallet.signMessage(message);
+     * const result = await client.web3.verifyUsdcTransaction({
+     *   txHash: '0xabc123...',
+     *   payerAddress: '0xYourWallet...',
+     *   signature
+     * });
+     *
+     * console.log(`Added ${result.creditsAdded} credits (${result.usdcAmount} USDC)`);
+     * ```
+     */
+    async verifyUsdcTransaction(params) {
+        return this.client.post("/web3/transactions/usdc/verify", params);
+    }
+    /**
+     * Top up credits by sending USDC from your wallet.
+     *
+     * This is a high-level method that handles the entire flow:
+     * 1. Auto-authenticates with wallet if no API key is set
+     * 2. Fetches the USDC top-up configuration
+     * 3. Sends USDC from your wallet to the receiver
+     * 4. Waits for transaction confirmation
+     * 5. Signs a verification message
+     * 6. Verifies the transaction and adds credits
+     *
+     * @param params - Top-up parameters
+     * @param params.privateKey - Wallet private key (or uses WALLET_PRIVATE_KEY env var)
+     * @param params.amountUsd - Amount in USD to top up (e.g., 10 for $10)
+     * @param params.rpcUrl - (Optional) Custom RPC URL for the chain
+     * @returns Top-up result with credits added and transaction details
+     *
+     * @example
+     * ```typescript
+     * // Top up $10 worth of credits - only wallet key needed!
+     * const result = await client.web3.topUp({
+     *   privateKey: process.env.WALLET_PRIVATE_KEY,
+     *   amountUsd: 10
+     * });
+     *
+     * console.log(`Transaction: ${result.txHash}`);
+     * console.log(`Added ${result.creditsAdded} credits`);
+     * console.log(`USDC spent: ${result.usdcAmount}`);
+     * ```
+     */
+    async topUp(params) {
+        const privateKey = params.privateKey || process.env.WALLET_PRIVATE_KEY;
+        if (!privateKey) {
+            throw new Error("Private key is required. Provide it as a parameter or set WALLET_PRIVATE_KEY env var.");
+        }
+        if (params.amountUsd <= 0) {
+            throw new Error("Amount must be greater than 0");
+        }
+        // Step 0: Auto-authenticate with wallet if no API key is set
+        if (!this.client.rawClient.defaults.headers.common["x-openserv-key"]) {
+            await this.client.authenticate(privateKey);
+        }
+        // Step 1: Get USDC top-up configuration
+        const config = await this.getUsdcTopupConfig();
+        // Get RPC URL for the chain
+        const rpcUrl = params.rpcUrl ||
+            CHAIN_RPC_URLS[config.chainId] ||
+            `https://rpc.ankr.com/${config.network}`;
+        // Step 2: Create wallet and connect to the chain
+        const provider = new ethers_1.ethers.JsonRpcProvider(rpcUrl);
+        const wallet = new ethers_1.ethers.Wallet(privateKey, provider);
+        // Step 3: Check USDC balance
+        const usdcContract = new ethers_1.ethers.Contract(config.usdcContractAddress, ERC20_ABI, wallet);
+        // USDC has 6 decimals
+        const amountInSmallestUnit = ethers_1.ethers.parseUnits(params.amountUsd.toString(), 6);
+        const balance = await usdcContract.getFunction("balanceOf")(wallet.address);
+        if (balance < amountInSmallestUnit) {
+            const balanceFormatted = ethers_1.ethers.formatUnits(balance, 6);
+            throw new Error(`Insufficient USDC balance. Have: ${balanceFormatted} USDC, need: ${params.amountUsd} USDC`);
+        }
+        // Step 4: Send USDC transfer
+        const tx = await usdcContract.getFunction("transfer")(config.receiverAddress, amountInSmallestUnit);
+        // Step 5: Wait for confirmation
+        const receipt = await tx.wait();
+        if (!receipt || receipt.status !== 1) {
+            throw new Error("Transaction failed or was reverted");
+        }
+        const txHash = receipt.hash;
+        // Step 6: Sign verification message
+        const verificationMessage = `Verify USDC top-up: ${txHash}`;
+        const signature = await wallet.signMessage(verificationMessage);
+        // Step 7: Verify transaction and add credits
+        const verifyResult = await this.verifyUsdcTransaction({
+            txHash,
+            payerAddress: wallet.address,
+            signature,
+        });
+        return {
+            success: verifyResult.success,
+            txHash,
+            creditsAdded: verifyResult.creditsAdded,
+            usdcAmount: verifyResult.usdcAmount,
+            network: config.network,
+            chainId: config.chainId,
+        };
+    }
+}
+exports.Web3API = Web3API;

package/dist/workflow.d.ts

@@ -0,0 +1,27 @@
+import type { PlatformClient } from "./client";
+import type { TriggerDefinition, TaskDefinition, EdgeDefinition, WorkflowData, Trigger, Task, Edge, Agent } from "./types";
+export declare class Workflow {
+    readonly id: number;
+    readonly name: string;
+    readonly goal: string;
+    status: string;
+    triggers: Trigger[];
+    tasks: Task[];
+    edges: Edge[];
+    agents: Agent[];
+    private client;
+    constructor(data: WorkflowData, client: PlatformClient);
+    /**
+     * Sync the workflow with a new configuration (declarative update)
+     */
+    sync(config: {
+        triggers?: TriggerDefinition[];
+        tasks?: TaskDefinition[];
+        edges?: EdgeDefinition[];
+    }): Promise<void>;
+    /**
+     * Set the workflow to running state
+     */
+    setRunning(): Promise<void>;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,KAAK,EACN,MAAM,SAAS,CAAC;AAEjB,qBAAa,QAAQ;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc;IAYtD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE;QACjB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC/B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}

package/dist/workflow.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Workflow = void 0;
+class Workflow {
+    id;
+    name;
+    goal;
+    status;
+    triggers;
+    tasks;
+    edges;
+    agents;
+    client;
+    constructor(data, client) {
+        this.id = data.id;
+        this.name = data.name;
+        this.goal = data.goal;
+        this.status = data.status;
+        this.triggers = data.triggers;
+        this.tasks = data.tasks;
+        this.edges = data.edges;
+        this.agents = data.agents;
+        this.client = client;
+    }
+    /**
+     * Sync the workflow with a new configuration (declarative update)
+     */
+    async sync(config) {
+        await this.client.workflows.sync({
+            id: this.id,
+            triggers: config.triggers,
+            tasks: config.tasks,
+            edges: config.edges,
+        });
+        // Refresh local state
+        const updated = await this.client.workflows.get({ id: this.id });
+        this.triggers = updated.triggers;
+        this.tasks = updated.tasks;
+        this.edges = updated.edges;
+        this.status = updated.status;
+    }
+    /**
+     * Set the workflow to running state
+     */
+    async setRunning() {
+        await this.client.workflows.setRunning({ id: this.id });
+        this.status = "running";
+    }
+}
+exports.Workflow = Workflow;