@openserv-labs/client 1.0.0

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLogger = exports.clearProvisionedState = exports.getProvisionedInfo = exports.isProvisioned = exports.provision = exports.PaymentsAPI = exports.Web3API = exports.WorkflowsAPI = exports.TasksAPI = exports.TriggersAPI = exports.IntegrationsAPI = exports.AgentsAPI = exports.Workflow = exports.PlatformClient = exports.triggerConfigToProps = exports.inputSchemaToJsonSchema = exports.triggers = void 0;
+// Trigger factory and helpers
+var triggers_api_1 = require("./triggers-api");
+Object.defineProperty(exports, "triggers", { enumerable: true, get: function () { return triggers_api_1.triggers; } });
+Object.defineProperty(exports, "inputSchemaToJsonSchema", { enumerable: true, get: function () { return triggers_api_1.inputSchemaToJsonSchema; } });
+Object.defineProperty(exports, "triggerConfigToProps", { enumerable: true, get: function () { return triggers_api_1.triggerConfigToProps; } });
+// Classes
+var client_1 = require("./client");
+Object.defineProperty(exports, "PlatformClient", { enumerable: true, get: function () { return client_1.PlatformClient; } });
+var workflow_1 = require("./workflow");
+Object.defineProperty(exports, "Workflow", { enumerable: true, get: function () { return workflow_1.Workflow; } });
+var agents_api_1 = require("./agents-api");
+Object.defineProperty(exports, "AgentsAPI", { enumerable: true, get: function () { return agents_api_1.AgentsAPI; } });
+var integrations_api_1 = require("./integrations-api");
+Object.defineProperty(exports, "IntegrationsAPI", { enumerable: true, get: function () { return integrations_api_1.IntegrationsAPI; } });
+var triggers_api_2 = require("./triggers-api");
+Object.defineProperty(exports, "TriggersAPI", { enumerable: true, get: function () { return triggers_api_2.TriggersAPI; } });
+var tasks_api_1 = require("./tasks-api");
+Object.defineProperty(exports, "TasksAPI", { enumerable: true, get: function () { return tasks_api_1.TasksAPI; } });
+var workflows_api_1 = require("./workflows-api");
+Object.defineProperty(exports, "WorkflowsAPI", { enumerable: true, get: function () { return workflows_api_1.WorkflowsAPI; } });
+var web3_api_1 = require("./web3-api");
+Object.defineProperty(exports, "Web3API", { enumerable: true, get: function () { return web3_api_1.Web3API; } });
+var payments_api_1 = require("./payments-api");
+Object.defineProperty(exports, "PaymentsAPI", { enumerable: true, get: function () { return payments_api_1.PaymentsAPI; } });
+// Provision functions
+var provision_1 = require("./provision");
+Object.defineProperty(exports, "provision", { enumerable: true, get: function () { return provision_1.provision; } });
+Object.defineProperty(exports, "isProvisioned", { enumerable: true, get: function () { return provision_1.isProvisioned; } });
+Object.defineProperty(exports, "getProvisionedInfo", { enumerable: true, get: function () { return provision_1.getProvisionedInfo; } });
+Object.defineProperty(exports, "clearProvisionedState", { enumerable: true, get: function () { return provision_1.clearProvisionedState; } });
+Object.defineProperty(exports, "setLogger", { enumerable: true, get: function () { return provision_1.setLogger; } });

package/dist/integrations-api.d.ts

@@ -0,0 +1,34 @@
+import type { PlatformClient } from "./client";
+export interface IntegrationConnection {
+    id: string;
+    name: string;
+    integrationId: string;
+    integrationName: string;
+    integrationDisplayName: string;
+    integrationDescription?: string | null;
+    integrationType: "nango" | "custom";
+    integrationLogo?: string | null;
+}
+export declare class IntegrationsAPI {
+    private client;
+    constructor(client: PlatformClient);
+    /**
+     * Get list of integration connections for the authenticated user
+     */
+    listConnections(): Promise<IntegrationConnection[]>;
+    /**
+     * Create an integration connection for a custom integration (like manual-trigger, webhook-trigger, etc.)
+     */
+    connect(params: {
+        identifier: string;
+        props?: Record<string, unknown>;
+    }): Promise<{
+        status: string;
+    }>;
+    /**
+     * Get the integration connection ID for a specific integration identifier.
+     * If no connection exists, creates one for custom integrations.
+     */
+    getOrCreateConnection(identifier: string): Promise<string>;
+}
+//# sourceMappingURL=integrations-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integrations-api.d.ts","sourceRoot":"","sources":["../src/integrations-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,eAAe,EAAE,OAAO,GAAG,QAAQ,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAIzD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ/B;;;OAGG;IACG,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBjE"}

package/dist/integrations-api.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationsAPI = void 0;
+class IntegrationsAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get list of integration connections for the authenticated user
+     */
+    async listConnections() {
+        return this.client.get("/integration/connections");
+    }
+    /**
+     * Create an integration connection for a custom integration (like manual-trigger, webhook-trigger, etc.)
+     */
+    async connect(params) {
+        return this.client.post("/integration/connection", {
+            type: "custom",
+            identifier: params.identifier,
+            props: params.props || {},
+        });
+    }
+    /**
+     * Get the integration connection ID for a specific integration identifier.
+     * If no connection exists, creates one for custom integrations.
+     */
+    async getOrCreateConnection(identifier) {
+        const connections = await this.listConnections();
+        const existing = connections.find((c) => c.integrationName === identifier);
+        if (existing) {
+            return existing.id;
+        }
+        // Create a new connection for custom integrations
+        await this.connect({ identifier });
+        // Fetch again to get the new connection ID
+        const updatedConnections = await this.listConnections();
+        const newConnection = updatedConnections.find((c) => c.integrationName === identifier);
+        if (!newConnection) {
+            throw new Error(`Failed to create integration connection for ${identifier}`);
+        }
+        return newConnection.id;
+    }
+}
+exports.IntegrationsAPI = IntegrationsAPI;

package/dist/payments-api.d.ts

@@ -0,0 +1,126 @@
+import type { PlatformClient } from "./client";
+import type { X402PaymentRequest, X402PaymentResult } from "./types";
+/**
+ * API for making x402 payments to access paid workflows.
+ *
+ * The x402 protocol allows workflows to be monetized - users pay to trigger them.
+ * This API provides methods to pay for and execute x402-protected workflows programmatically.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient();
+ *
+ * // Pay and execute an x402 workflow in one call - only wallet key needed!
+ * const result = await client.payments.payWorkflow({
+ *   triggerUrl: 'https://api.openserv.ai/webhooks/x402/trigger/...',
+ *   input: { query: 'Hello world' }
+ * });
+ *
+ * console.log(result.response); // Workflow response
+ * ```
+ */
+export declare class PaymentsAPI {
+    private client;
+    constructor(client: PlatformClient);
+    /**
+     * Pay for and execute an x402-protected workflow.
+     *
+     * This method handles the entire x402 payment flow automatically:
+     * 1. Creates a payment-enabled fetch wrapper using your wallet
+     * 2. Makes a request to the trigger URL
+     * 3. Automatically handles the 402 Payment Required response
+     * 4. Signs and submits the payment
+     * 5. Retries the request with payment proof
+     * 6. Returns the workflow response
+     *
+     * @param params - Payment parameters
+     * @param params.triggerUrl - The x402 trigger URL (webhookUrl from x402-services API or trigger.webhookUrl)
+     * @param params.privateKey - Wallet private key for payment (or uses WALLET_PRIVATE_KEY env var)
+     * @param params.input - Input data to pass to the workflow
+     * @returns Payment result with workflow response
+     *
+     * @example
+     * ```typescript
+     * // Using environment variable for private key
+     * const result = await client.payments.payWorkflow({
+     *   triggerUrl: 'https://api.openserv.ai/webhooks/x402/trigger/abc123',
+     *   input: { prompt: 'Generate a summary' }
+     * });
+     *
+     * console.log(result.response); // Workflow execution result
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Explicitly providing private key
+     * const result = await client.payments.payWorkflow({
+     *   triggerUrl: workflow.triggers[0].webhookUrl,
+     *   privateKey: '0x...',
+     *   input: { query: 'What is the weather?' }
+     * });
+     * ```
+     */
+    payWorkflow(params: X402PaymentRequest): Promise<X402PaymentResult>;
+    /**
+     * Discover available x402 services from the platform.
+     *
+     * Lists all public x402-enabled workflows that can be paid for and executed.
+     * Each service includes pricing, input schema, and the webhook URL to call.
+     *
+     * @returns Array of available x402 services
+     *
+     * @example
+     * ```typescript
+     * const services = await client.payments.discoverServices();
+     *
+     * for (const service of services) {
+     *   console.log(`${service.name}: $${service.x402Pricing}`);
+     *   console.log(`URL: ${service.webhookUrl}`);
+     * }
+     * ```
+     */
+    discoverServices(): Promise<Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        x402Pricing: string;
+        webhookUrl: string;
+        workspaceName: string;
+        ownerDisplayName: string;
+    }>>;
+    /**
+     * Get preflight information for an x402 trigger.
+     *
+     * Returns pricing, input schema, and wallet information for a trigger
+     * before making a payment. Useful for displaying payment UI.
+     *
+     * @param params - Parameters object
+     * @param params.token - The trigger token (from the webhook URL path)
+     * @returns Trigger preflight information including pricing and schema
+     *
+     * @example
+     * ```typescript
+     * // Extract token from webhook URL: .../trigger/{token}
+     * const preflight = await client.payments.getTriggerPreflight({
+     *   token: 'abc123def456'
+     * });
+     *
+     * console.log(`Price: ${preflight.x402Pricing}`);
+     * console.log(`Pay to: ${preflight.x402WalletAddress}`);
+     * ```
+     */
+    getTriggerPreflight(params: {
+        token: string;
+    }): Promise<{
+        triggerId: string;
+        triggerName: string;
+        triggerDescription: string | null;
+        jsonSchema: Record<string, unknown>;
+        uiSchema: Record<string, unknown>;
+        x402Enabled: boolean;
+        x402Pricing: string;
+        x402WalletAddress: string;
+        erc8004AgentId: string | null;
+    }>;
+}
+//# sourceMappingURL=payments-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payments-api.d.ts","sourceRoot":"","sources":["../src/payments-api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACG,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+CzE;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,IAAI,OAAO,CAC/B,KAAK,CAAC;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC,CACH;IAmBD;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5D,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;CAeH"}

package/dist/payments-api.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentsAPI = void 0;
+const accounts_1 = require("viem/accounts");
+const x402_fetch_1 = require("x402-fetch");
+/**
+ * API for making x402 payments to access paid workflows.
+ *
+ * The x402 protocol allows workflows to be monetized - users pay to trigger them.
+ * This API provides methods to pay for and execute x402-protected workflows programmatically.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient();
+ *
+ * // Pay and execute an x402 workflow in one call - only wallet key needed!
+ * const result = await client.payments.payWorkflow({
+ *   triggerUrl: 'https://api.openserv.ai/webhooks/x402/trigger/...',
+ *   input: { query: 'Hello world' }
+ * });
+ *
+ * console.log(result.response); // Workflow response
+ * ```
+ */
+class PaymentsAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Pay for and execute an x402-protected workflow.
+     *
+     * This method handles the entire x402 payment flow automatically:
+     * 1. Creates a payment-enabled fetch wrapper using your wallet
+     * 2. Makes a request to the trigger URL
+     * 3. Automatically handles the 402 Payment Required response
+     * 4. Signs and submits the payment
+     * 5. Retries the request with payment proof
+     * 6. Returns the workflow response
+     *
+     * @param params - Payment parameters
+     * @param params.triggerUrl - The x402 trigger URL (webhookUrl from x402-services API or trigger.webhookUrl)
+     * @param params.privateKey - Wallet private key for payment (or uses WALLET_PRIVATE_KEY env var)
+     * @param params.input - Input data to pass to the workflow
+     * @returns Payment result with workflow response
+     *
+     * @example
+     * ```typescript
+     * // Using environment variable for private key
+     * const result = await client.payments.payWorkflow({
+     *   triggerUrl: 'https://api.openserv.ai/webhooks/x402/trigger/abc123',
+     *   input: { prompt: 'Generate a summary' }
+     * });
+     *
+     * console.log(result.response); // Workflow execution result
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Explicitly providing private key
+     * const result = await client.payments.payWorkflow({
+     *   triggerUrl: workflow.triggers[0].webhookUrl,
+     *   privateKey: '0x...',
+     *   input: { query: 'What is the weather?' }
+     * });
+     * ```
+     */
+    async payWorkflow(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.");
+        }
+        // Create account from private key (for getting address)
+        const account = (0, accounts_1.privateKeyToAccount)(privateKey);
+        // Create signer for x402 payments on Base network
+        const signer = await (0, x402_fetch_1.createSigner)("base", privateKey);
+        // Wrap fetch with x402 payment handling
+        const x402Fetch = (0, x402_fetch_1.wrapFetchWithPayment)(fetch, signer);
+        // Make the request - x402Fetch automatically handles 402 responses
+        const response = await x402Fetch(params.triggerUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                buyerAddress: account.address,
+                payload: params.input || {},
+            }),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            throw new Error(`Workflow execution failed: ${response.status} ${JSON.stringify(errorData)}`);
+        }
+        const responseData = await response.json();
+        return {
+            success: true,
+            txHash: "", // x402 handles this internally, tx hash not exposed
+            price: "", // Price is handled by x402 protocol
+            response: responseData,
+            network: "base",
+            chainId: 8453,
+        };
+    }
+    /**
+     * Discover available x402 services from the platform.
+     *
+     * Lists all public x402-enabled workflows that can be paid for and executed.
+     * Each service includes pricing, input schema, and the webhook URL to call.
+     *
+     * @returns Array of available x402 services
+     *
+     * @example
+     * ```typescript
+     * const services = await client.payments.discoverServices();
+     *
+     * for (const service of services) {
+     *   console.log(`${service.name}: $${service.x402Pricing}`);
+     *   console.log(`URL: ${service.webhookUrl}`);
+     * }
+     * ```
+     */
+    async discoverServices() {
+        const response = await this.client.get("/x402-services");
+        return response.services;
+    }
+    /**
+     * Get preflight information for an x402 trigger.
+     *
+     * Returns pricing, input schema, and wallet information for a trigger
+     * before making a payment. Useful for displaying payment UI.
+     *
+     * @param params - Parameters object
+     * @param params.token - The trigger token (from the webhook URL path)
+     * @returns Trigger preflight information including pricing and schema
+     *
+     * @example
+     * ```typescript
+     * // Extract token from webhook URL: .../trigger/{token}
+     * const preflight = await client.payments.getTriggerPreflight({
+     *   token: 'abc123def456'
+     * });
+     *
+     * console.log(`Price: ${preflight.x402Pricing}`);
+     * console.log(`Pay to: ${preflight.x402WalletAddress}`);
+     * ```
+     */
+    async getTriggerPreflight(params) {
+        // This endpoint is public and doesn't require authentication
+        const response = await fetch(`https://api.openserv.ai/webhooks/trigger/${params.token}`);
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            throw new Error(`Failed to get trigger preflight: ${response.status} ${JSON.stringify(errorData)}`);
+        }
+        return response.json();
+    }
+}
+exports.PaymentsAPI = PaymentsAPI;

package/dist/provision.d.ts

@@ -0,0 +1,194 @@
+import { type TriggerConfig } from "./triggers-api";
+/**
+ * Configuration for provisioning an agent and workflow.
+ *
+ * @example
+ * ```typescript
+ * const config: ProvisionConfig = {
+ *   agent: {
+ *     name: 'my-agent',
+ *     description: 'Handles API requests'
+ *   },
+ *   workflow: {
+ *     name: 'api-workflow',
+ *     trigger: triggers.webhook({ waitForCompletion: true }),
+ *     task: {
+ *       description: 'Process incoming requests',
+ *       body: 'Handle the webhook payload'
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export interface ProvisionConfig {
+    /** Agent configuration */
+    agent: {
+        /** Unique name for the agent */
+        name: string;
+        /** Description of the agent's capabilities */
+        description: string;
+        /**
+         * URL where the agent is hosted.
+         * Optional - when using @openserv-labs/sdk v2.0.0+, the endpoint is automatically
+         * set to https://agents-proxy.openserv.ai when run(agent) is called.
+         * Only provide this if your agent runs with a different publicly accessible URL.
+         */
+        endpointUrl?: string;
+    };
+    /** Workflow configuration */
+    workflow: {
+        /** Name for the workflow */
+        name: string;
+        /** Trigger configuration (use triggers factory) */
+        trigger: TriggerConfig;
+        /** Optional task configuration */
+        task?: {
+            /** Task description */
+            description?: string;
+            /** Detailed task body */
+            body?: string;
+        };
+    };
+}
+/**
+ * Result from provisioning an agent and workflow.
+ */
+export interface ProvisionResult {
+    /** The created agent's ID */
+    agentId: number;
+    /** API key for the agent */
+    apiKey: string;
+    /** Auth token for securing agent requests (if generated) */
+    authToken?: string;
+    /** The created workflow's ID */
+    workflowId: number;
+    /** The created trigger's ID */
+    triggerId: string;
+    /** Token for the trigger (used in URLs) */
+    triggerToken: string;
+    /** Paywall URL for x402 triggers */
+    paywallUrl?: string;
+    /** API endpoint URL for webhook triggers */
+    apiEndpoint?: string;
+}
+/**
+ * Logger interface for provision operations.
+ * Implement this to customize logging behavior.
+ */
+export interface Logger {
+    /** Log informational messages */
+    info: (...args: unknown[]) => void;
+    /** Log warning messages */
+    warn: (...args: unknown[]) => void;
+    /** Log error messages */
+    error: (...args: unknown[]) => void;
+}
+/**
+ * Set a custom logger for provision operations.
+ *
+ * @param customLogger - Logger implementation to use
+ *
+ * @example
+ * ```typescript
+ * setLogger({
+ *   info: (...args) => myLogger.info(...args),
+ *   warn: (...args) => myLogger.warn(...args),
+ *   error: (...args) => myLogger.error(...args)
+ * });
+ * ```
+ */
+export declare function setLogger(customLogger: Logger): void;
+/**
+ * Provision an agent and workflow on the OpenServ platform.
+ * This function handles:
+ * - Wallet creation/retrieval
+ * - Platform authentication (with session persistence)
+ * - Agent registration/update
+ * - Workflow creation/update
+ * - State persistence to .openserv.json
+ *
+ * @param config - Provisioning configuration
+ * @returns Provision result with IDs and URLs
+ *
+ * @example
+ * ```ts
+ * import { provision, triggers } from '@openserv-labs/client';
+ *
+ * const result = await provision({
+ *   agent: {
+ *     name: 'my-agent',
+ *     description: 'My autonomous agent',
+ *     // endpointUrl is optional - SDK v2.0.0+ auto-updates to agents-proxy when run(agent) is called
+ *   },
+ *   workflow: {
+ *     name: 'default',
+ *     trigger: triggers.webhook(),
+ *     task: {
+ *       description: 'Process incoming requests',
+ *     },
+ *   },
+ * });
+ *
+ * console.log('Agent ID:', result.agentId);
+ * console.log('API Endpoint:', result.apiEndpoint);
+ * ```
+ */
+export declare function provision(config: ProvisionConfig): Promise<ProvisionResult>;
+/**
+ * Check if an agent and workflow are already provisioned.
+ *
+ * This checks the local `.openserv.json` state file.
+ *
+ * @param agentName - Name of the agent to check
+ * @param workflowName - Name of the workflow (defaults to "default")
+ * @returns True if both agent and workflow are provisioned
+ *
+ * @example
+ * ```typescript
+ * if (isProvisioned('my-agent', 'api-workflow')) {
+ *   console.log('Already provisioned!');
+ * } else {
+ *   await provision(config);
+ * }
+ * ```
+ */
+export declare function isProvisioned(agentName: string, workflowName?: string): boolean;
+/**
+ * Get provisioned workflow info from the local state file.
+ *
+ * @param agentName - Name of the agent
+ * @param workflowName - Name of the workflow (defaults to "default")
+ * @returns Object with agent and workflow details, or null if not provisioned
+ *
+ * @example
+ * ```typescript
+ * const info = getProvisionedInfo('my-agent', 'api-workflow');
+ * if (info) {
+ *   console.log('Agent ID:', info.agentId);
+ *   console.log('Workflow ID:', info.workflowId);
+ * }
+ * ```
+ */
+export declare function getProvisionedInfo(agentName: string, workflowName?: string): {
+    agentId?: number;
+    apiKey?: string;
+    authToken?: string;
+    workflowId?: number;
+    triggerId?: string;
+    triggerToken?: string;
+} | null;
+/**
+ * Clear all provisioned state.
+ *
+ * This deletes the `.openserv.json` file. Useful for testing or resetting.
+ * Note: This does not delete resources from the platform, only the local state file.
+ *
+ * @example
+ * ```typescript
+ * clearProvisionedState();
+ * // Now provision will create new resources
+ * await provision(config);
+ * ```
+ */
+export declare function clearProvisionedState(): void;
+//# sourceMappingURL=provision.d.ts.map

package/dist/provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,gBAAgB,CAAC;AAM1E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,KAAK,EAAE;QACL,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,8CAA8C;QAC9C,WAAW,EAAE,MAAM,CAAC;QACpB;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,6BAA6B;IAC7B,QAAQ,EAAE;QACR,4BAA4B;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,mDAAmD;QACnD,OAAO,EAAE,aAAa,CAAC;QACvB,kCAAkC;QAClC,IAAI,CAAC,EAAE;YACL,uBAAuB;YACvB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,yBAAyB;YACzB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2BD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,iCAAiC;IACjC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,yBAAyB;IACzB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAEpD;AA2bD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CAkC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAMT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB;IACD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAmBP;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAU5C"}