@openserv-labs/client 1.0.0

package/dist/tasks-api.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TasksAPI = void 0;
+/**
+ * API for managing tasks within workflows.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient({ apiKey: 'your-key' });
+ *
+ * // Create a task
+ * const task = await client.tasks.create({
+ *   workflowId: 123,
+ *   agentId: 456,
+ *   description: 'Process the data',
+ *   body: 'Additional details'
+ * });
+ *
+ * // Create a task with dependencies
+ * const task2 = await client.tasks.create({
+ *   workflowId: 123,
+ *   agentId: 456,
+ *   description: 'Follow-up task',
+ *   dependencies: [task.id]
+ * });
+ * ```
+ */
+class TasksAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new task in a workflow.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID to create the task in
+     * @param params.agentId - The agent ID to assign the task to
+     * @param params.description - Short description of the task
+     * @param params.body - Detailed task body (defaults to description)
+     * @param params.input - Input data for the task
+     * @param params.dependencies - Array of task IDs this task depends on
+     * @returns The created task
+     */
+    async create(params) {
+        const { workflowId, agentId, description, body, input, dependencies } = params;
+        const data = await this.client.post(`/workspaces/${workflowId}/task`, {
+            assignee: typeof agentId === "string" ? parseInt(agentId) : agentId,
+            description: description,
+            body: body || description,
+            input: input || "",
+            outputOptions: {
+                default: {
+                    name: "Task Output",
+                    type: "text",
+                    instructions: "Complete the task and provide output",
+                },
+            },
+            dependencies: dependencies || [],
+        });
+        return this.get({ workflowId, id: data.id });
+    }
+    /**
+     * Get a task by ID.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The task ID
+     * @returns The task
+     */
+    async get(params) {
+        return this.client.get(`/workspaces/${params.workflowId}/tasks/${params.id}`);
+    }
+    /**
+     * List all tasks in a workflow.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @returns Array of tasks
+     */
+    async list(params) {
+        return this.client.get(`/workspaces/${params.workflowId}/tasks`);
+    }
+    /**
+     * Update an existing task.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The task ID to update
+     * @param params.description - New description (optional)
+     * @param params.body - New body (optional)
+     * @param params.input - New input (optional)
+     * @param params.status - New status (optional)
+     * @param params.assigneeAgentId - New assignee agent ID (optional)
+     * @param params.dependencies - New dependencies (optional)
+     * @returns The updated task
+     */
+    async update(params) {
+        const { workflowId, id, ...data } = params;
+        await this.client.put(`/workspaces/${workflowId}/tasks/${id}`, data);
+        // PUT returns success message for user auth, fetch the updated task
+        return this.get({ workflowId, id });
+    }
+    /**
+     * Delete a task.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The task ID to delete
+     */
+    async delete(params) {
+        await this.client.delete(`/workspaces/${params.workflowId}/tasks/${params.id}`);
+    }
+}
+exports.TasksAPI = TasksAPI;

package/dist/triggers-api.d.ts

@@ -0,0 +1,254 @@
+import type { PlatformClient } from "./client";
+import type { Trigger } from "./types";
+/**
+ * Defines a single property in an input schema.
+ */
+export interface InputSchemaProperty {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    title?: string;
+    description?: string;
+    enum?: string[];
+    default?: unknown;
+}
+/**
+ * Schema defining input fields for a trigger.
+ */
+export interface InputSchema {
+    [key: string]: InputSchemaProperty;
+}
+/**
+ * Configuration for a webhook trigger.
+ */
+export interface WebhookTriggerConfig {
+    type: "webhook";
+    /** Input schema for webhook payload validation */
+    input?: InputSchema;
+    /** Whether to wait for workflow completion before responding */
+    waitForCompletion?: boolean;
+    /** Timeout in seconds (default: 180) */
+    timeout?: number;
+}
+/**
+ * Configuration for an x402 (paid) trigger.
+ */
+export interface X402TriggerConfig {
+    type: "x402";
+    /** Price in USD (e.g., "0.01") */
+    price: string;
+    /** Input schema for request validation */
+    input?: InputSchema;
+    /** Timeout in seconds (default: 180) */
+    timeout?: number;
+    /** Wallet address to receive payments */
+    walletAddress?: string;
+}
+/**
+ * Configuration for a cron (scheduled) trigger.
+ */
+export interface CronTriggerConfig {
+    type: "cron";
+    /** Cron expression (e.g., "0 9 * * *" for daily at 9 AM) */
+    schedule: string;
+    /** Timezone (default: "UTC") */
+    timezone?: string;
+}
+/**
+ * Configuration for a manual trigger.
+ */
+export interface ManualTriggerConfig {
+    type: "manual";
+}
+/**
+ * Union type for all trigger configurations.
+ */
+export type TriggerConfig = WebhookTriggerConfig | X402TriggerConfig | CronTriggerConfig | ManualTriggerConfig;
+/**
+ * Factory functions for creating type-safe trigger configurations.
+ *
+ * @example
+ * ```typescript
+ * import { triggers, triggerConfigToProps } from '@openserv-labs/client';
+ *
+ * // Create a webhook trigger config
+ * const webhookConfig = triggers.webhook({
+ *   input: { query: { type: 'string' } },
+ *   waitForCompletion: true
+ * });
+ *
+ * // Convert to API props
+ * const props = triggerConfigToProps(webhookConfig);
+ * ```
+ */
+export declare const triggers: {
+    /**
+     * Create a webhook trigger configuration.
+     * @param opts - Options for the webhook trigger
+     * @returns Webhook trigger configuration
+     */
+    webhook: (opts?: {
+        input?: InputSchema;
+        waitForCompletion?: boolean;
+        timeout?: number;
+    }) => WebhookTriggerConfig;
+    /**
+     * Create an x402 (paid) trigger configuration.
+     * @param opts - Options for the x402 trigger
+     * @param opts.price - Price in USD (e.g., "0.01")
+     * @returns x402 trigger configuration
+     */
+    x402: (opts: {
+        price: string;
+        input?: InputSchema;
+        timeout?: number;
+        walletAddress?: string;
+    }) => X402TriggerConfig;
+    /**
+     * Create a cron (scheduled) trigger configuration.
+     * @param opts - Options for the cron trigger
+     * @param opts.schedule - Cron expression
+     * @param opts.timezone - Timezone (default: "UTC")
+     * @returns Cron trigger configuration
+     */
+    cron: (opts: {
+        schedule: string;
+        timezone?: string;
+    }) => CronTriggerConfig;
+    /**
+     * Create a manual trigger configuration.
+     * @returns Manual trigger configuration
+     */
+    manual: () => ManualTriggerConfig;
+};
+/**
+ * Convert an InputSchema to JSON Schema format.
+ * @param input - The input schema to convert
+ * @returns JSON Schema compliant object
+ */
+export declare function inputSchemaToJsonSchema(input: InputSchema): Record<string, unknown>;
+/**
+ * Convert a trigger configuration to API props format.
+ * @param config - The trigger configuration
+ * @returns Props object for the trigger API
+ *
+ * @example
+ * ```typescript
+ * const config = triggers.x402({ price: '0.01' });
+ * const props = triggerConfigToProps(config);
+ * // props = { x402Pricing: '0.01', timeout: 180 }
+ * ```
+ */
+export declare function triggerConfigToProps(config: TriggerConfig): Record<string, unknown>;
+/**
+ * API for managing workflow triggers.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient({ apiKey: 'your-key' });
+ *
+ * // Get integration connection ID
+ * const connId = await client.integrations.getOrCreateConnection('webhook-trigger');
+ *
+ * // Create a trigger
+ * const trigger = await client.triggers.create({
+ *   workflowId: 123,
+ *   name: 'My Webhook',
+ *   integrationConnectionId: connId,
+ *   props: { waitForCompletion: true }
+ * });
+ *
+ * // Activate the trigger
+ * await client.triggers.activate({ workflowId: 123, id: trigger.id });
+ * ```
+ */
+export declare class TriggersAPI {
+    private client;
+    constructor(client: PlatformClient);
+    /**
+     * Create a new trigger in a workflow.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.name - Name for the trigger
+     * @param params.integrationConnectionId - Integration connection ID (e.g., from getOrCreateConnection)
+     * @param params.props - Trigger properties (use triggerConfigToProps helper)
+     * @param params.trigger_name - Optional specific trigger name
+     * @returns The created trigger
+     */
+    create(params: {
+        workflowId: number | string;
+        name: string;
+        integrationConnectionId: string;
+        props?: Record<string, unknown>;
+        trigger_name?: string;
+    }): Promise<Trigger>;
+    /**
+     * Get a trigger by ID.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID
+     * @returns The trigger
+     */
+    get(params: {
+        workflowId: number | string;
+        id: string;
+    }): Promise<Trigger>;
+    /**
+     * List all triggers in a workflow.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @returns Array of triggers
+     */
+    list(params: {
+        workflowId: number | string;
+    }): Promise<Trigger[]>;
+    /**
+     * Update an existing trigger.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to update
+     * @param params.props - New properties (optional)
+     * @param params.name - New name (optional)
+     * @param params.description - New description (optional)
+     * @returns The updated trigger
+     */
+    update(params: {
+        workflowId: number | string;
+        id: string;
+        props?: Record<string, unknown>;
+        name?: string;
+        description?: string;
+    }): Promise<Trigger>;
+    /**
+     * Delete a trigger.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to delete
+     */
+    delete(params: {
+        workflowId: number | string;
+        id: string;
+    }): Promise<void>;
+    /**
+     * Activate a trigger so it can receive events.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to activate
+     */
+    activate(params: {
+        workflowId: number | string;
+        id: string;
+    }): Promise<void>;
+    /**
+     * Fire a trigger manually (for testing or manual invocation).
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to fire
+     * @param params.input - Optional input data as JSON string
+     * @returns Response from the trigger
+     */
+    fire(params: {
+        workflowId: number | string;
+        id: string;
+        input?: string;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=triggers-api.d.ts.map

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

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

package/dist/triggers-api.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggersAPI = exports.triggers = void 0;
+exports.inputSchemaToJsonSchema = inputSchemaToJsonSchema;
+exports.triggerConfigToProps = triggerConfigToProps;
+// ============================================================================
+// Trigger Factory Functions
+// ============================================================================
+/**
+ * Factory functions for creating type-safe trigger configurations.
+ *
+ * @example
+ * ```typescript
+ * import { triggers, triggerConfigToProps } from '@openserv-labs/client';
+ *
+ * // Create a webhook trigger config
+ * const webhookConfig = triggers.webhook({
+ *   input: { query: { type: 'string' } },
+ *   waitForCompletion: true
+ * });
+ *
+ * // Convert to API props
+ * const props = triggerConfigToProps(webhookConfig);
+ * ```
+ */
+exports.triggers = {
+    /**
+     * Create a webhook trigger configuration.
+     * @param opts - Options for the webhook trigger
+     * @returns Webhook trigger configuration
+     */
+    webhook: (opts) => ({
+        type: "webhook",
+        ...opts,
+    }),
+    /**
+     * Create an x402 (paid) trigger configuration.
+     * @param opts - Options for the x402 trigger
+     * @param opts.price - Price in USD (e.g., "0.01")
+     * @returns x402 trigger configuration
+     */
+    x402: (opts) => ({
+        type: "x402",
+        ...opts,
+    }),
+    /**
+     * Create a cron (scheduled) trigger configuration.
+     * @param opts - Options for the cron trigger
+     * @param opts.schedule - Cron expression
+     * @param opts.timezone - Timezone (default: "UTC")
+     * @returns Cron trigger configuration
+     */
+    cron: (opts) => ({
+        type: "cron",
+        ...opts,
+    }),
+    /**
+     * Create a manual trigger configuration.
+     * @returns Manual trigger configuration
+     */
+    manual: () => ({
+        type: "manual",
+    }),
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Convert an InputSchema to JSON Schema format.
+ * @param input - The input schema to convert
+ * @returns JSON Schema compliant object
+ */
+function inputSchemaToJsonSchema(input) {
+    const properties = {};
+    const required = [];
+    for (const [key, prop] of Object.entries(input)) {
+        properties[key] = {
+            type: prop.type,
+            ...(prop.title && { title: prop.title }),
+            ...(prop.description && { description: prop.description }),
+            ...(prop.enum && { enum: prop.enum }),
+            ...(prop.default !== undefined && { default: prop.default }),
+        };
+        if (prop.default === undefined) {
+            required.push(key);
+        }
+    }
+    return {
+        $schema: "http://json-schema.org/draft-07/schema#",
+        type: "object",
+        properties,
+        required,
+    };
+}
+/**
+ * Convert a trigger configuration to API props format.
+ * @param config - The trigger configuration
+ * @returns Props object for the trigger API
+ *
+ * @example
+ * ```typescript
+ * const config = triggers.x402({ price: '0.01' });
+ * const props = triggerConfigToProps(config);
+ * // props = { x402Pricing: '0.01', timeout: 180 }
+ * ```
+ */
+function triggerConfigToProps(config) {
+    switch (config.type) {
+        case "webhook":
+            return {
+                waitForCompletion: config.waitForCompletion ?? false,
+                timeout: config.timeout ?? 180,
+                ...(config.input && {
+                    inputSchema: inputSchemaToJsonSchema(config.input),
+                }),
+            };
+        case "x402":
+            return {
+                x402Pricing: config.price,
+                timeout: config.timeout ?? 180,
+                ...(config.walletAddress && {
+                    x402WalletAddress: config.walletAddress,
+                }),
+                ...(config.input && {
+                    inputSchema: inputSchemaToJsonSchema(config.input),
+                }),
+            };
+        case "cron":
+            return {
+                schedule: config.schedule,
+                timezone: config.timezone || "UTC",
+            };
+        case "manual":
+            return {};
+        default:
+            return {};
+    }
+}
+/**
+ * API for managing workflow triggers.
+ *
+ * @example
+ * ```typescript
+ * const client = new PlatformClient({ apiKey: 'your-key' });
+ *
+ * // Get integration connection ID
+ * const connId = await client.integrations.getOrCreateConnection('webhook-trigger');
+ *
+ * // Create a trigger
+ * const trigger = await client.triggers.create({
+ *   workflowId: 123,
+ *   name: 'My Webhook',
+ *   integrationConnectionId: connId,
+ *   props: { waitForCompletion: true }
+ * });
+ *
+ * // Activate the trigger
+ * await client.triggers.activate({ workflowId: 123, id: trigger.id });
+ * ```
+ */
+class TriggersAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new trigger in a workflow.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.name - Name for the trigger
+     * @param params.integrationConnectionId - Integration connection ID (e.g., from getOrCreateConnection)
+     * @param params.props - Trigger properties (use triggerConfigToProps helper)
+     * @param params.trigger_name - Optional specific trigger name
+     * @returns The created trigger
+     */
+    async create(params) {
+        const { workflowId, name, integrationConnectionId, props, trigger_name } = params;
+        const data = await this.client.post(`/workspaces/${workflowId}/trigger`, {
+            name,
+            // If trigger_name not specified, server will use the integration's default
+            ...(trigger_name && { trigger_name }),
+            integrationConnectionId,
+            props: props || {},
+            attributes: {},
+        });
+        if (!data.id) {
+            throw new Error(`Trigger creation returned no ID. Response: ${JSON.stringify(data)}`);
+        }
+        const triggerId = data.id;
+        // The create response may include a token; capture it if present
+        const createToken = data.token;
+        // The single trigger GET endpoint doesn't include token,
+        // so fetch from list (workspace response) which includes it
+        const triggersList = await this.list({ workflowId });
+        const triggerFromList = triggersList.find((t) => t.id === triggerId);
+        if (triggerFromList) {
+            return triggerFromList;
+        }
+        // Fallback to get endpoint if not found in list (shouldn't happen)
+        const triggerDetails = await this.get({ workflowId, id: triggerId });
+        return {
+            ...triggerDetails,
+            id: triggerId,
+            token: createToken,
+        };
+    }
+    /**
+     * Get a trigger by ID.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID
+     * @returns The trigger
+     */
+    async get(params) {
+        const data = await this.client.get(`/workspaces/${params.workflowId}/triggers/${params.id}`);
+        // The single trigger GET endpoint doesn't return the ID in the response,
+        // so we include it from the request parameters
+        return {
+            ...data,
+            id: params.id,
+        };
+    }
+    /**
+     * List all triggers in a workflow.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @returns Array of triggers
+     */
+    async list(params) {
+        // The list endpoint returns available integrations, not actual trigger instances
+        // To get actual triggers, we need to fetch from the workspace get endpoint
+        const workspace = await this.client.get(`/workspaces/${params.workflowId}`);
+        // The workspace response includes triggers with the full structure
+        const triggers = workspace.triggers || [];
+        // Map to Trigger type - token is in attributes.uiState.token
+        return triggers.map((t) => ({
+            id: t.id,
+            name: t.name,
+            description: t.description || undefined,
+            integrationConnectionId: t.integrationConnection?.id || "",
+            props: t.props,
+            token: t.attributes?.uiState?.token,
+            isActive: t.is_active,
+            state: t.state,
+        }));
+    }
+    /**
+     * Update an existing trigger.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to update
+     * @param params.props - New properties (optional)
+     * @param params.name - New name (optional)
+     * @param params.description - New description (optional)
+     * @returns The updated trigger
+     */
+    async update(params) {
+        const { workflowId, id, props, name, description } = params;
+        // First get the current trigger to preserve required fields
+        const currentTrigger = await this.get({ workflowId, id });
+        return this.client.put(`/workspaces/${workflowId}/triggers/${id}`, {
+            name: name ?? currentTrigger.name,
+            description: description ?? currentTrigger.description ?? currentTrigger.name,
+            integrationConnectionId: currentTrigger.integrationConnectionId,
+            props: props ?? currentTrigger.props,
+        });
+    }
+    /**
+     * Delete a trigger.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to delete
+     */
+    async delete(params) {
+        await this.client.delete(`/workspaces/${params.workflowId}/triggers/${params.id}`);
+    }
+    /**
+     * Activate a trigger so it can receive events.
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to activate
+     */
+    async activate(params) {
+        const currentTrigger = await this.get({
+            workflowId: params.workflowId,
+            id: params.id,
+        });
+        await this.client.put(`/workspaces/${params.workflowId}/triggers/${params.id}`, {
+            name: currentTrigger.name,
+            integrationConnectionId: currentTrigger.integrationConnectionId,
+            props: currentTrigger.props,
+            is_active: true,
+        });
+    }
+    /**
+     * Fire a trigger manually (for testing or manual invocation).
+     * @param params - Parameters object
+     * @param params.workflowId - The workflow ID
+     * @param params.id - The trigger ID to fire
+     * @param params.input - Optional input data as JSON string
+     * @returns Response from the trigger
+     */
+    async fire(params) {
+        return this.client.put(`/workspaces/${params.workflowId}/triggers/${params.id}/trigger`, {
+            input: params.input || "",
+        });
+    }
+}
+exports.TriggersAPI = TriggersAPI;