@aiconnect/agentjobs-mcp 1.0.8 → 1.1.0

package/build/cancel_job.js

@@ -1,71 +0,0 @@
-import { z } from "zod";
-import axios from 'axios';
-import { config } from './config.js';
-export default (server) => {
-    server.tool("cancel_job", "Cancels an agent job by its ID.", {
-        job_id: z.string({
-            description: "The ID of the job to cancel.",
-        }),
-        reason: z.string().optional().describe("Optional reason for cancellation."),
-    }, async (params) => {
-        const { job_id, reason } = params;
-        const apiUrl = config.AICONNECT_API_URL;
-        const apiKey = config.AICONNECT_API_KEY;
-        if (!apiUrl) {
-            return {
-                content: [{
-                        type: "text",
-                        text: "Error: API URL is not configured. Please set AICONNECT_API_URL environment variable."
-                    }]
-            };
-        }
-        if (!apiKey) {
-            return {
-                content: [{
-                        type: "text",
-                        text: "Error: API Key is not configured. Please set AICONNECT_API_KEY environment variable."
-                    }]
-            };
-        }
-        const endpoint = `${apiUrl}/services/agent-jobs/${job_id}`;
-        const headers = {
-            "Authorization": `Bearer ${apiKey}`,
-        };
-        let requestBody;
-        if (reason) {
-            headers["Content-Type"] = "application/json";
-            requestBody = { reason };
-        }
-        try {
-            const response = await axios.delete(endpoint, {
-                headers,
-                data: requestBody, // axios uses 'data' for DELETE request body
-            });
-            // Assuming the API returns a message field on success as per docs/agent-jobs-api.md:229
-            const responseMessage = response.data?.message || `Job with ID '${job_id}' successfully canceled.`;
-            return {
-                content: [{
-                        type: "text",
-                        text: responseMessage,
-                    }]
-            };
-        }
-        catch (error) {
-            let errorMessage = `Failed to cancel job ${job_id}.`;
-            if (axios.isAxiosError(error) && error.response) {
-                // Try to get a more specific error message from the API response
-                const apiError = error.response.data?.message || error.response.data?.error || JSON.stringify(error.response.data);
-                errorMessage = `API Error (${error.response.status}): ${apiError || error.message}`;
-            }
-            else if (error instanceof Error) {
-                errorMessage = `Error: ${error.message}`;
-            }
-            return {
-                content: [{
-                        type: "text",
-                        text: errorMessage,
-                    }]
-            };
-        }
-    });
-};

package/build/create_job.js

@@ -1,151 +0,0 @@
-import { z } from 'zod';
-import axios from 'axios';
-import { config } from './config.js';
-// Schema for the target_channel object
-const targetChannelSchema = z
-    .object({
-    org_id: z.string().optional().describe('Organization ID for the target channel. If not provided, uses the default organization.'),
-    platform: z
-        .enum(['whatsapp', 'slack', 'web'])
-        .describe('Platform of the target channel.'),
-    type: z.string().describe('Type of the target channel (e.g., channel).'),
-    code: z.string().describe('Code/identifier for the target channel.'),
-    data: z
-        .record(z.any())
-        .optional()
-        .describe('Additional platform-specific data for the channel.')
-})
-    .describe('Defines the target channel for the job.');
-// Schema for the config object
-const configSchema = z
-    .object({
-    max_follow_ups: z
-        .number()
-        .int()
-        .optional()
-        .describe('Maximum number of follow-ups allowed.'),
-    max_task_retries: z
-        .number()
-        .int()
-        .optional()
-        .describe('Maximum number of retries for a task.'),
-    task_retry_interval: z
-        .number()
-        .int()
-        .optional()
-        .describe('Interval in minutes between task retries.'),
-    start_prompt: z.string().describe('The initial prompt to start the job.'),
-    max_time_to_complete: z
-        .number()
-        .int()
-        .optional()
-        .describe('Maximum time in minutes for the job to complete.'),
-    profile_id: z.string().describe('Profile ID to be used for the job.')
-})
-    .describe('Configuration settings for the job.');
-export default (server) => {
-    server.tool('create_job', 'Creates a new agent job.', {
-        target_channel: targetChannelSchema,
-        job_type_id: z.string().describe('The ID of the job type.'),
-        config: configSchema.optional(),
-        params: z
-            .record(z.any())
-            .optional()
-            .describe('Arbitrary parameters for the job.'),
-        scheduled_at: z
-            .string()
-            .datetime({ message: 'Invalid datetime string. Must be ISO 8601' })
-            .optional()
-            .describe('Optional ISO 8601 date string for scheduling the job.'),
-        delay: z
-            .number()
-            .int()
-            .nonnegative()
-            .optional()
-            .describe('Optional maximum random delay in minutes to add to the scheduled time (query parameter).')
-    }, async (toolParams) => {
-        const apiUrl = config.AICONNECT_API_URL;
-        const apiKey = config.AICONNECT_API_KEY;
-        const defaultOrgId = config.DEFAULT_ORG_ID;
-        if (!apiUrl) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Error: API URL is not configured. Please set AICONNECT_API_URL environment variable.'
-                    }
-                ]
-            };
-        }
-        if (!apiKey) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Error: API Key is not configured. Please set AICONNECT_API_KEY environment variable.'
-                    }
-                ]
-            };
-        }
-        // Use default org_id if not provided
-        if (!toolParams.target_channel.org_id && defaultOrgId) {
-            toolParams.target_channel.org_id = defaultOrgId;
-        }
-        else if (!toolParams.target_channel.org_id && !defaultOrgId) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Error: Organization ID is required. Please provide org_id or set DEFAULT_ORG_ID environment variable.'
-                    }
-                ]
-            };
-        }
-        const endpoint = `${apiUrl}/services/agent-jobs`;
-        const headers = {
-            Authorization: `Bearer ${apiKey}`,
-            'Content-Type': 'application/json'
-        };
-        // Separate delay as it's a query parameter
-        const { delay, ...bodyPayload } = toolParams;
-        const queryParams = {};
-        if (delay !== undefined) {
-            queryParams.delay = delay;
-        }
-        try {
-            const response = await axios.post(endpoint, bodyPayload, {
-                headers,
-                params: queryParams
-            });
-            // API returns job details under 'data' key
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(response.data, null, 2)
-                    }
-                ]
-            };
-        }
-        catch (error) {
-            let errorMessage = `Failed to create job.`;
-            if (axios.isAxiosError(error) && error.response) {
-                const apiError = error.response.data?.message ||
-                    error.response.data?.error ||
-                    JSON.stringify(error.response.data);
-                errorMessage = `API Error (${error.response.status}): ${apiError || error.message}`;
-            }
-            else if (error instanceof Error) {
-                errorMessage = `Error: ${error.message}`;
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: errorMessage
-                    }
-                ]
-            };
-        }
-    });
-};

package/build/get_job.js

@@ -1,62 +0,0 @@
-import { z } from "zod";
-import axios from 'axios';
-import { config } from './config.js';
-export default (server) => {
-    server.tool("get_job", "Retrieves an agent job by its ID.", {
-        job_id: z.string({
-            description: "The ID of the job to retrieve.",
-        }),
-    }, async (params) => {
-        const { job_id } = params;
-        const apiUrl = config.AICONNECT_API_URL;
-        const apiKey = config.AICONNECT_API_KEY;
-        if (!apiUrl) {
-            return {
-                content: [{
-                        type: "text",
-                        text: "Error: API URL is not configured. Please set AICONNECT_API_URL environment variable."
-                    }]
-            };
-        }
-        if (!apiKey) {
-            return {
-                content: [{
-                        type: "text",
-                        text: "Error: API Key is not configured. Please set AICONNECT_API_KEY environment variable."
-                    }]
-            };
-        }
-        const endpoint = `${apiUrl}/services/agent-jobs/${job_id}`;
-        const headers = {
-            "Authorization": `Bearer ${apiKey}`,
-        };
-        try {
-            const response = await axios.get(endpoint, {
-                headers,
-            });
-            // Return the data part of the response, stringified as JSON text
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify(response.data?.data || response.data, null, 2),
-                    }]
-            };
-        }
-        catch (error) {
-            let errorMessage = `Failed to retrieve job ${job_id}.`;
-            if (axios.isAxiosError(error) && error.response) {
-                const apiError = error.response.data?.message || error.response.data?.error || JSON.stringify(error.response.data);
-                errorMessage = `API Error (${error.response.status}): ${apiError || error.message}`;
-            }
-            else if (error instanceof Error) {
-                errorMessage = `Error: ${error.message}`;
-            }
-            return {
-                content: [{
-                        type: "text",
-                        text: errorMessage,
-                    }]
-            };
-        }
-    });
-};

package/build/list_jobs.js

@@ -1,88 +0,0 @@
-import { z } from "zod";
-import axios from 'axios';
-import { config } from './config.js';
-// Define the schema for job status based on docs/agent-jobs-api.md:246-251
-const jobStatusSchema = z.enum([
-    "waiting",
-    "scheduled",
-    "running",
-    "completed",
-    "failed",
-    "canceled"
-]);
-export default (server) => {
-    server.tool("list_jobs", "Retrieves a list of agent jobs, with optional filters and pagination.", {
-        org_id: z.string().optional().describe("Filter by organization ID. If not provided, uses the default organization."),
-        status: jobStatusSchema.optional().describe("Filter by job status."),
-        scheduled_at: z.string().datetime().optional().describe("Filter by exact scheduled time (ISO 8601)."),
-        scheduled_at_gte: z.string().datetime().optional().describe("Filter by scheduled time greater than or equal to (ISO 8601)."),
-        scheduled_at_lte: z.string().datetime().optional().describe("Filter by scheduled time less than or equal to (ISO 8601)."),
-        created_at_gte: z.string().datetime().optional().describe("Filter by creation time greater than or equal to (ISO 8601)."),
-        created_at_lte: z.string().datetime().optional().describe("Filter by creation time less than or equal to (ISO 8601)."),
-        job_type_id: z.string().optional().describe("Filter by job type ID."),
-        channel_code: z.string().optional().describe("Filter by channel code."),
-        limit: z.number().int().positive().optional().describe("Maximum number of jobs to return."),
-        offset: z.number().int().nonnegative().optional().describe("Number of jobs to skip (for pagination)."),
-        sort: z.string().optional().describe("Sorting field and direction (e.g., created_at:desc)."),
-    }, async (params) => {
-        const apiUrl = config.AICONNECT_API_URL;
-        const apiKey = config.AICONNECT_API_KEY;
-        if (!apiUrl) {
-            return {
-                content: [{
-                        type: "text",
-                        text: "Error: API URL is not configured. Please set AICONNECT_API_URL environment variable."
-                    }]
-            };
-        }
-        if (!apiKey) {
-            return {
-                content: [{
-                        type: "text",
-                        text: "Error: API Key is not configured. Please set AICONNECT_API_KEY environment variable."
-                    }]
-            };
-        }
-        const endpoint = `${apiUrl}/services/agent-jobs`;
-        const headers = {
-            "Authorization": `Bearer ${apiKey}`,
-        };
-        // Build query parameters object from provided params
-        const queryParams = {};
-        for (const [key, value] of Object.entries(params)) {
-            if (value !== undefined) {
-                queryParams[key] = value;
-            }
-        }
-        try {
-            const response = await axios.get(endpoint, {
-                headers,
-                params: queryParams, // Axios uses 'params' for query parameters in GET requests
-            });
-            // Return the data part of the response, stringified as JSON text
-            // API docs show jobs under 'data' key, and meta for pagination
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify(response.data, null, 2),
-                    }]
-            };
-        }
-        catch (error) {
-            let errorMessage = `Failed to list jobs.`;
-            if (axios.isAxiosError(error) && error.response) {
-                const apiError = error.response.data?.message || error.response.data?.error || JSON.stringify(error.response.data);
-                errorMessage = `API Error (${error.response.status}): ${apiError || error.message}`;
-            }
-            else if (error instanceof Error) {
-                errorMessage = `Error: ${error.message}`;
-            }
-            return {
-                content: [{
-                        type: "text",
-                        text: errorMessage,
-                    }]
-            };
-        }
-    });
-};