@rnsk/toolkits 0.0.11 → 0.0.12

package/dist/toolkits/zoho/tools/update-related-records.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { zohoFetch } from './utils.js';
+export const ZohoUpdateRelatedRecords = tool({
+    description: 'Associates or updates relationships between records across different modules in Zoho CRM. This action creates or modifies relationships between a parent record and related records. Common use cases: - Associate Leads/Contacts with Campaigns (with member status) - Link Products to Deals/Quotes/Accoun',
+    inputSchema: z.object({
+        zohoToken: z.string().describe('Zoho OAuth access token (Zoho-oauthtoken).'),
+        data: z.array(z.record(z.any())).describe('A list of related records to associate with the parent record. Each dictionary must include: 1) \'id\' (string, mandatory): The unique ID of the related record to associate. 2) Optional fields to upda'),
+        record_id: z.string().describe('The unique identifier (ID) of the parent record to which related records will be associated. This is the numeric ID from Zoho CRM (e.g., \'5725767000000649013\').'),
+        module_api_name: z.string().describe('The API name of the parent module where the record resides. Common modules: \'Leads\', \'Contacts\', \'Accounts\', \'Deals\', \'Products\', \'Quotes\'. Use the exact module API name (PascalCase, e.g.,'),
+        related_list_api_name: z.string().describe('The API name of the related list/module to update relationships with. Common examples: \'Campaigns\' (for Lead-Campaign relations), \'Products\' (for Deal-Product relations), \'Contacts\' (for Account'),
+    }),
+    execute: async (params) => {
+        const { zohoToken, ...rest } = params;
+        if (!zohoToken)
+            return { error: 'Zoho token is required. Connect Zoho CRM first.' };
+        try {
+            const p = rest;
+            const path = `/${p.module_api_name}/${p.record_id}/${p.related_list_api_name}`;
+            // For bulk updates, Zoho expects {data: [...]}
+            const body = p.data ? { data: p.data, trigger: p.trigger } : { data: [p] };
+            const res = await zohoFetch(path, { zohoToken, method: 'PUT', body });
+            if (!res.ok)
+                return { error: 'Failed to update', details: res.data };
+            return res.data;
+        }
+        catch (e) {
+            return { error: 'Error in ZohoUpdateRelatedRecords', message: e instanceof Error ? e.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=update-related-records.js.map

package/dist/toolkits/zoho/tools/update-zoho-record.d.ts

@@ -0,0 +1,10 @@
+export declare const ZohoUpdateZohoRecord: import("ai").Tool<{
+    data: Record<string, any>[];
+    zohoToken: string;
+    module_api_name: string;
+    trigger?: string[] | undefined;
+    lar_id?: string | undefined;
+    skip_feature_execution?: Record<string, any>[] | undefined;
+    apply_feature_execution?: Record<string, any>[] | undefined;
+}, any>;
+//# sourceMappingURL=update-zoho-record.d.ts.map

package/dist/toolkits/zoho/tools/update-zoho-record.js

@@ -0,0 +1,35 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { zohoFetch } from './utils.js';
+export const ZohoUpdateZohoRecord = tool({
+    description: 'Updates existing records in a specified module in Zoho CRM. Supports updating up to 100 records per API call. Use field API names (not display names) for all field updates. The \'id\' field is mandatory for each record.',
+    inputSchema: z.object({
+        zohoToken: z.string().describe('Zoho OAuth access token (Zoho-oauthtoken).'),
+        data: z.array(z.record(z.any())).describe('A list of dictionaries representing the records to be updated. Each record MUST include the \'id\' field with the record ID to update. Update up to 100 records per API call. Use field API names as key'),
+        lar_id: z.string().optional().describe('Assignment rule ID to trigger during record update (for applicable modules like Leads). Use the Get Assignment Rules API to obtain the lar_id.'),
+        trigger: z.array(z.string()).optional().describe('List of automation triggers to execute during update. Valid values: [\'workflow\', \'approval\', \'blueprint\', \'pathfinder\', \'orchestration\']. Pass empty array [] to skip all automation. If not s'),
+        module_api_name: z.string().describe('The API name of the module to update records in. Standard modules use PascalCase (e.g., \'Leads\', \'Contacts\', \'Accounts\', \'Deals\', \'Tasks\', \'Campaigns\'). Custom modules must use their exact'),
+        skip_feature_execution: z.array(z.record(z.any())).optional().describe('Features to skip during the update. Example: [{\'name\': \'cadences\'}] to skip cadence execution'),
+        apply_feature_execution: z.array(z.record(z.any())).optional().describe('Features to execute during the update. Example: [{\'name\': \'layout_rules\'}] or [{\'name\': \'criteria_validation_rule\'}]'),
+    }),
+    execute: async (params) => {
+        const { zohoToken, ...rest } = params;
+        if (!zohoToken)
+            return { error: 'Zoho token is required. Connect Zoho CRM first.' };
+        try {
+            const { moduleApiName, data, trigger, larId } = rest;
+            const body = { data };
+            if (trigger)
+                body.trigger = trigger;
+            const res = await zohoFetch(`/${moduleApiName}`, { zohoToken, method: 'PUT', body });
+            if (!res.ok)
+                return { error: 'Failed to update record', details: res.data };
+            return res.data;
+        }
+        catch (e) {
+            return { error: 'Error in ZohoUpdateZohoRecord', message: e instanceof Error ? e.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=update-zoho-record.js.map

package/dist/toolkits/zoho/tools/upload-attachment.d.ts

@@ -0,0 +1,9 @@
+export declare const ZohoUploadAttachment: import("ai").Tool<{
+    zohoToken: string;
+    record_id: string;
+    module_api_name: string;
+    title?: string | undefined;
+    attachmentUrl?: string | undefined;
+    file?: Record<string, any> | undefined;
+}, any>;
+//# sourceMappingURL=upload-attachment.d.ts.map

package/dist/toolkits/zoho/tools/upload-attachment.js

@@ -0,0 +1,34 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { zohoFetch } from './utils.js';
+export const ZohoUploadAttachment = tool({
+    description: 'Tool to upload a file as an Attachment to a specific Zoho CRM record. Use when you need to store files (PDFs, documents, images) in a record\'s Attachments section.',
+    inputSchema: z.object({
+        zohoToken: z.string().describe('Zoho OAuth access token (Zoho-oauthtoken).'),
+        file: z.record(z.any()).optional().describe('File to upload as an attachment.'),
+        title: z.string().optional().describe('Deprecated. This field is ignored because remote URL attachments are not supported.'),
+        record_id: z.string().describe('The unique ID of the record to attach the file or URL to.'),
+        attachmentUrl: z.string().optional().describe('Deprecated. Remote URL attachments are not supported because Zoho fetches the URL server-side.'),
+        module_api_name: z.string().describe('The API name of the module containing the record. Examples: \'Leads\', \'Contacts\', \'Accounts\', \'Deals\', etc.'),
+    }),
+    execute: async (params) => {
+        const { zohoToken, ...rest } = params;
+        if (!zohoToken)
+            return { error: 'Zoho token is required. Connect Zoho CRM first.' };
+        try {
+            const { moduleApiName, recordId, file } = rest;
+            if (!file?.s3key)
+                return { error: 'File s3key is required for upload' };
+            // For Zoho, file upload is multipart; here we proxy via simple JSON for now
+            const res = await zohoFetch(`/${moduleApiName}/${recordId}/Attachments`, { zohoToken, method: 'POST', body: { file } });
+            if (!res.ok)
+                return { error: 'Failed to upload attachment', details: res.data };
+            return res.data;
+        }
+        catch (e) {
+            return { error: 'Error in ZohoUploadAttachment', message: e instanceof Error ? e.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=upload-attachment.js.map

package/dist/toolkits/zoho/tools/utils.d.ts

@@ -0,0 +1,24 @@
+export declare const ZOHO_API_BASE = "https://www.zohoapis.com/crm/v8";
+export declare function getZohoBase(apiDomain?: string): string;
+export declare function zohoFetch(path: string, { zohoToken, method, query, body, apiDomain, }: {
+    zohoToken: string;
+    method?: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    apiDomain?: string;
+}): Promise<{
+    ok: false;
+    status: number;
+    data: any;
+    error: any;
+} | {
+    ok: true;
+    status: number;
+    data: any;
+    error?: undefined;
+}>;
+export declare function handleZohoError(data: any): {
+    error: string;
+    details?: any;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/toolkits/zoho/tools/utils.js

@@ -0,0 +1,49 @@
+// @ts-nocheck
+export const ZOHO_API_BASE = 'https://www.zohoapis.com/crm/v8';
+export function getZohoBase(apiDomain) {
+    if (!apiDomain)
+        return ZOHO_API_BASE;
+    // allow passing full domain like https://www.zohoapis.eu or just www.zohoapis.eu
+    if (apiDomain.startsWith('http'))
+        return `${apiDomain.replace(/\/$/, '')}/crm/v8`;
+    return `https://${apiDomain.replace(/\/$/, '')}/crm/v8`;
+}
+export async function zohoFetch(path, { zohoToken, method = 'GET', query, body, apiDomain, }) {
+    const base = getZohoBase(apiDomain);
+    const url = new URL(`${base}${path}`);
+    if (query) {
+        Object.entries(query).forEach(([k, v]) => {
+            if (v !== undefined && v !== null && v !== '')
+                url.searchParams.set(k, String(v));
+        });
+    }
+    const headers = {
+        Authorization: `Zoho-oauthtoken ${zohoToken}`,
+        'Content-Type': 'application/json',
+    };
+    const res = await fetch(url.toString(), {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const text = await res.text();
+    let data;
+    try {
+        data = text ? JSON.parse(text) : {};
+    }
+    catch {
+        data = { raw: text };
+    }
+    if (!res.ok) {
+        return { ok: false, status: res.status, data, error: data };
+    }
+    return { ok: true, status: res.status, data };
+}
+export function handleZohoError(data) {
+    if (data?.data?.[0]?.message)
+        return { error: data.data[0].message, details: data };
+    if (data?.message)
+        return { error: data.message, details: data };
+    return { error: 'Zoho API error', details: data };
+}
+//# sourceMappingURL=utils.js.map

package/dist/toolkits/zoho/tools/validate-credential.d.ts

@@ -0,0 +1,4 @@
+export declare const ZohoValidateCredential: import("ai").Tool<{
+    zohoToken: string;
+}, any>;
+//# sourceMappingURL=validate-credential.d.ts.map

package/dist/toolkits/zoho/tools/validate-credential.js

@@ -0,0 +1,27 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { zohoFetch } from './utils.js';
+export const ZohoValidateCredential = tool({
+    description: 'Validates Zoho CRM credentials by retrieving current user information. Returns user details if credentials are valid. Use this action when you need to verify that API credentials are working correctly before performing other operations. This is a read-only operation that confirms authentication with',
+    inputSchema: z.object({
+        zohoToken: z.string().describe('Zoho OAuth access token (Zoho-oauthtoken).'),
+    }),
+    execute: async (params) => {
+        const { zohoToken, ...rest } = params;
+        if (!zohoToken)
+            return { error: 'Zoho token is required. Connect Zoho CRM first.' };
+        try {
+            const p = rest;
+            const path = `/users?type=CurrentUser`;
+            const res = await zohoFetch(path, { zohoToken, method: 'GET', query: p });
+            if (!res.ok)
+                return { error: 'Failed', details: res.data };
+            return res.data;
+        }
+        catch (e) {
+            return { error: 'Error in ZohoValidateCredential', message: e instanceof Error ? e.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=validate-credential.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnsk/toolkits",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "Runstack toolkit registry — manifest-driven tool definitions for AI agents",
   "type": "module",
   "main": "./dist/index.js",