@n8n/instance-ai 1.0.0

package/dist/tools/best-practices/techniques.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TechniqueDescription = exports.WorkflowTechnique = void 0;
+exports.WorkflowTechnique = {
+    SCHEDULING: 'scheduling',
+    CHATBOT: 'chatbot',
+    FORM_INPUT: 'form_input',
+    SCRAPING_AND_RESEARCH: 'scraping_and_research',
+    MONITORING: 'monitoring',
+    ENRICHMENT: 'enrichment',
+    TRIAGE: 'triage',
+    CONTENT_GENERATION: 'content_generation',
+    DOCUMENT_PROCESSING: 'document_processing',
+    DATA_EXTRACTION: 'data_extraction',
+    DATA_ANALYSIS: 'data_analysis',
+    DATA_TRANSFORMATION: 'data_transformation',
+    DATA_PERSISTENCE: 'data_persistence',
+    NOTIFICATION: 'notification',
+    KNOWLEDGE_BASE: 'knowledge_base',
+    HUMAN_IN_THE_LOOP: 'human_in_the_loop',
+};
+exports.TechniqueDescription = {
+    [exports.WorkflowTechnique.SCHEDULING]: 'Running an action at a specific time or interval',
+    [exports.WorkflowTechnique.CHATBOT]: 'Receiving chat messages and replying (built-in chat, Telegram, Slack, MS Teams, etc.)',
+    [exports.WorkflowTechnique.FORM_INPUT]: 'Gathering data from users via forms',
+    [exports.WorkflowTechnique.SCRAPING_AND_RESEARCH]: 'Methodically collecting information from websites or APIs to compile structured data',
+    [exports.WorkflowTechnique.MONITORING]: 'Repeatedly checking service/website status and taking action when conditions are met',
+    [exports.WorkflowTechnique.ENRICHMENT]: 'Adding extra details to existing data by merging information from other sources',
+    [exports.WorkflowTechnique.TRIAGE]: 'Classifying data for routing or prioritization',
+    [exports.WorkflowTechnique.CONTENT_GENERATION]: 'Creating text, images, audio, video, etc.',
+    [exports.WorkflowTechnique.DOCUMENT_PROCESSING]: 'Taking action on content within files (PDFs, Word docs, images)',
+    [exports.WorkflowTechnique.DATA_EXTRACTION]: 'Pulling specific information from structured or unstructured inputs',
+    [exports.WorkflowTechnique.DATA_ANALYSIS]: 'Examining data to find patterns, trends, anomalies, or insights',
+    [exports.WorkflowTechnique.DATA_TRANSFORMATION]: 'Cleaning, formatting, or restructuring data (including summarization)',
+    [exports.WorkflowTechnique.DATA_PERSISTENCE]: 'Storing, updating, or retrieving records from persistent storage (Google Sheets, Airtable, built-in Data Tables)',
+    [exports.WorkflowTechnique.NOTIFICATION]: 'Sending alerts or updates via email, chat, SMS when events occur',
+    [exports.WorkflowTechnique.KNOWLEDGE_BASE]: 'Building or using a centralized information collection (usually vector database for LLM use)',
+    [exports.WorkflowTechnique.HUMAN_IN_THE_LOOP]: 'Pausing for human decision/input before resuming',
+};
+//# sourceMappingURL=techniques.js.map

package/dist/tools/best-practices/techniques.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"techniques.js","sourceRoot":"","sources":["../../../src/tools/best-practices/techniques.ts"],"names":[],"mappings":";;;AAGa,QAAA,iBAAiB,GAAG;IAEhC,UAAU,EAAE,YAAY;IAExB,OAAO,EAAE,SAAS;IAElB,UAAU,EAAE,YAAY;IAExB,qBAAqB,EAAE,uBAAuB;IAE9C,UAAU,EAAE,YAAY;IAExB,UAAU,EAAE,YAAY;IAExB,MAAM,EAAE,QAAQ;IAEhB,kBAAkB,EAAE,oBAAoB;IAExC,mBAAmB,EAAE,qBAAqB;IAE1C,eAAe,EAAE,iBAAiB;IAElC,aAAa,EAAE,eAAe;IAE9B,mBAAmB,EAAE,qBAAqB;IAE1C,gBAAgB,EAAE,kBAAkB;IAEpC,YAAY,EAAE,cAAc;IAE5B,cAAc,EAAE,gBAAgB;IAEhC,iBAAiB,EAAE,mBAAmB;CAC7B,CAAC;AAOE,QAAA,oBAAoB,GAA0C;IAC1E,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAAE,kDAAkD;IAClF,CAAC,yBAAiB,CAAC,OAAO,CAAC,EAC1B,uFAAuF;IACxF,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAAE,qCAAqC;IACrE,CAAC,yBAAiB,CAAC,qBAAqB,CAAC,EACxC,sFAAsF;IACvF,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAC7B,sFAAsF;IACvF,CAAC,yBAAiB,CAAC,UAAU,CAAC,EAC7B,iFAAiF;IAClF,CAAC,yBAAiB,CAAC,MAAM,CAAC,EAAE,gDAAgD;IAC5E,CAAC,yBAAiB,CAAC,kBAAkB,CAAC,EAAE,2CAA2C;IACnF,CAAC,yBAAiB,CAAC,mBAAmB,CAAC,EACtC,iEAAiE;IAClE,CAAC,yBAAiB,CAAC,eAAe,CAAC,EAClC,qEAAqE;IACtE,CAAC,yBAAiB,CAAC,aAAa,CAAC,EAChC,iEAAiE;IAClE,CAAC,yBAAiB,CAAC,mBAAmB,CAAC,EACtC,uEAAuE;IACxE,CAAC,yBAAiB,CAAC,gBAAgB,CAAC,EACnC,kHAAkH;IACnH,CAAC,yBAAiB,CAAC,YAAY,CAAC,EAC/B,kEAAkE;IACnE,CAAC,yBAAiB,CAAC,cAAc,CAAC,EACjC,8FAA8F;IAC/F,CAAC,yBAAiB,CAAC,iBAAiB,CAAC,EAAE,kDAAkD;CACzF,CAAC"}

package/dist/tools/credentials/delete-credential.tool.d.ts

@@ -0,0 +1,21 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createDeleteCredentialTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    credentialId: string;
+    credentialName?: string | undefined;
+}, {
+    success: boolean;
+    denied?: boolean | undefined;
+    reason?: string | undefined;
+}, {
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, import("@mastra/core/tools").ToolExecutionContext<{
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, unknown>, "delete-credential", unknown>;

package/dist/tools/credentials/delete-credential.tool.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeleteCredentialTool = createDeleteCredentialTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+function createDeleteCredentialTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'delete-credential',
+        description: 'Permanently delete a credential by ID. Irreversible.',
+        inputSchema: zod_1.z.object({
+            credentialId: zod_1.z.string().describe('ID of the credential to delete'),
+            credentialName: zod_1.z
+                .string()
+                .optional()
+                .describe('Name of the credential (for confirmation message)'),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            denied: zod_1.z.boolean().optional(),
+            reason: zod_1.z.string().optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: api_types_1.instanceAiConfirmationSeveritySchema,
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+        }),
+        execute: async (input, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.deleteCredential !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: `Delete credential "${input.credentialName ?? input.credentialId}"? This cannot be undone.`,
+                    severity: 'destructive',
+                });
+                return { success: false };
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return { success: false, denied: true, reason: 'User denied the action' };
+            }
+            await context.credentialService.delete(input.credentialId);
+            return { success: true };
+        },
+    });
+}
+//# sourceMappingURL=delete-credential.tool.js.map

package/dist/tools/credentials/delete-credential.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-credential.tool.js","sourceRoot":"","sources":["../../../src/tools/credentials/delete-credential.tool.ts"],"names":[],"mappings":";;AAOA,gEAkDC;AAzDD,8CAAgD;AAChD,8CAAsE;AACtE,mCAAgC;AAChC,6BAAwB;AAIxB,SAAgB,0BAA0B,CAAC,OAA0B;IACpE,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,mBAAmB;QACvB,WAAW,EAAE,sDAAsD;QACnE,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACnE,cAAc,EAAE,OAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;SAC/D,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;YACpB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC;QACF,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC;YACvB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,gDAAoC;SAC9C,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE;SACrB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC;YAEjD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,gBAAgB,KAAK,cAAc,CAAC;YAG/E,IAAI,aAAa,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,CAAC,EAAE,CAAC;gBACxE,MAAM,OAAO,EAAE,CAAC;oBACf,SAAS,EAAE,IAAA,eAAM,GAAE;oBACnB,OAAO,EAAE,sBAAsB,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,YAAY,2BAA2B;oBACpG,QAAQ,EAAE,aAAsB;iBAChC,CAAC,CAAC;gBAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC3B,CAAC;YAGD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;gBAC7E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;YAC3E,CAAC;YAGD,MAAM,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/credentials/get-credential.tool.d.ts

@@ -0,0 +1,4 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createGetCredentialTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    credentialId: string;
+}, import("../../types").CredentialDetail, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "get-credential", unknown>;

package/dist/tools/credentials/get-credential.tool.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetCredentialTool = createGetCredentialTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+function createGetCredentialTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'get-credential',
+        description: 'Get credential metadata (name, type, node access). Never returns decrypted secrets.',
+        inputSchema: zod_1.z.object({
+            credentialId: zod_1.z.string().describe('ID of the credential'),
+        }),
+        outputSchema: zod_1.z.object({
+            id: zod_1.z.string(),
+            name: zod_1.z.string(),
+            type: zod_1.z.string(),
+            createdAt: zod_1.z.string(),
+            updatedAt: zod_1.z.string(),
+            nodesWithAccess: zod_1.z.array(zod_1.z.object({ nodeType: zod_1.z.string() })).optional(),
+        }),
+        execute: async (inputData) => {
+            return await context.credentialService.get(inputData.credentialId);
+        },
+    });
+}
+//# sourceMappingURL=get-credential.tool.js.map

package/dist/tools/credentials/get-credential.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-credential.tool.js","sourceRoot":"","sources":["../../../src/tools/credentials/get-credential.tool.ts"],"names":[],"mappings":";;AAKA,0DAoBC;AAzBD,8CAAgD;AAChD,6BAAwB;AAIxB,SAAgB,uBAAuB,CAAC,OAA0B;IACjE,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,gBAAgB;QACpB,WAAW,EACV,qFAAqF;QACtF,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;SACzD,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;YACrB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;YACrB,eAAe,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;SACvE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAC5B,OAAO,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACpE,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/credentials/list-credentials.tool.d.ts

@@ -0,0 +1,6 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createListCredentialsTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    type?: string | undefined;
+}, {
+    credentials: import("../../types").CredentialSummary[];
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "list-credentials", unknown>;

package/dist/tools/credentials/list-credentials.tool.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createListCredentialsTool = createListCredentialsTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+function createListCredentialsTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'list-credentials',
+        description: 'List credentials accessible to the current user. Never exposes secret data.',
+        inputSchema: zod_1.z.object({
+            type: zod_1.z.string().optional().describe('Filter by credential type (e.g. "notionApi")'),
+        }),
+        outputSchema: zod_1.z.object({
+            credentials: zod_1.z.array(zod_1.z.object({
+                id: zod_1.z.string(),
+                name: zod_1.z.string(),
+                type: zod_1.z.string(),
+                createdAt: zod_1.z.string(),
+                updatedAt: zod_1.z.string(),
+            })),
+        }),
+        execute: async (inputData) => {
+            const credentials = await context.credentialService.list({
+                type: inputData.type,
+            });
+            return { credentials };
+        },
+    });
+}
+//# sourceMappingURL=list-credentials.tool.js.map

package/dist/tools/credentials/list-credentials.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-credentials.tool.js","sourceRoot":"","sources":["../../../src/tools/credentials/list-credentials.tool.ts"],"names":[],"mappings":";;AAKA,8DAyBC;AA9BD,8CAAgD;AAChD,6BAAwB;AAIxB,SAAgB,yBAAyB,CAAC,OAA0B;IACnE,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,kBAAkB;QACtB,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;SACpF,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,OAAC,CAAC,KAAK,CACnB,OAAC,CAAC,MAAM,CAAC;gBACR,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;gBACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;gBACrB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;aACrB,CAAC,CACF;SACD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAC5B,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBACxD,IAAI,EAAE,SAAS,CAAC,IAAI;aACpB,CAAC,CAAC;YACH,OAAO,EAAE,WAAW,EAAE,CAAC;QACxB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/credentials/search-credential-types.tool.d.ts

@@ -0,0 +1,6 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createSearchCredentialTypesTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    query: string;
+}, {
+    results: import("../../types").CredentialTypeSearchResult[];
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "search-credential-types", unknown>;

package/dist/tools/credentials/search-credential-types.tool.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchCredentialTypesTool = createSearchCredentialTypesTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const GENERIC_AUTH_TYPES = new Set([
+    'httpHeaderAuth',
+    'httpBearerAuth',
+    'httpQueryAuth',
+    'httpBasicAuth',
+    'httpCustomAuth',
+    'httpDigestAuth',
+    'oAuth1Api',
+    'oAuth2Api',
+]);
+function createSearchCredentialTypesTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'search-credential-types',
+        description: 'Search available credential types by keyword (e.g. "linear", "github", "slack"). ' +
+            'Returns matching credential types that can be used with nodes. ' +
+            'Use this BEFORE resorting to genericCredentialType with HTTP Request — ' +
+            'a dedicated credential type almost always exists for popular services.',
+        inputSchema: zod_1.z.object({
+            query: zod_1.z
+                .string()
+                .describe('Search keyword — typically the service name (e.g. "linear", "notion", "slack")'),
+        }),
+        outputSchema: zod_1.z.object({
+            results: zod_1.z.array(zod_1.z.object({
+                type: zod_1.z.string().describe('Credential type name (e.g. "linearApi")'),
+                displayName: zod_1.z.string().describe('Human-readable name (e.g. "Linear API")'),
+            })),
+        }),
+        execute: async (input) => {
+            if (!context.credentialService.searchCredentialTypes) {
+                return { results: [] };
+            }
+            const allResults = await context.credentialService.searchCredentialTypes(input.query);
+            const results = allResults.filter((r) => !GENERIC_AUTH_TYPES.has(r.type));
+            return { results };
+        },
+    });
+}
+//# sourceMappingURL=search-credential-types.tool.js.map

package/dist/tools/credentials/search-credential-types.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-credential-types.tool.js","sourceRoot":"","sources":["../../../src/tools/credentials/search-credential-types.tool.ts"],"names":[],"mappings":";;AAiBA,0EAkCC;AAnDD,8CAAgD;AAChD,6BAAwB;AAKxB,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IAClC,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,WAAW;IACX,WAAW;CACX,CAAC,CAAC;AAEH,SAAgB,+BAA+B,CAAC,OAA0B;IACzE,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,yBAAyB;QAC7B,WAAW,EACV,mFAAmF;YACnF,iEAAiE;YACjE,yEAAyE;YACzE,wEAAwE;QACzE,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,KAAK,EAAE,OAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CAAC,gFAAgF,CAAC;SAC5F,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,OAAO,EAAE,OAAC,CAAC,KAAK,CACf,OAAC,CAAC,MAAM,CAAC;gBACR,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;gBACpE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;aAC3E,CAAC,CACF;SACD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,CAAC;gBACtD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACxB,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAGtF,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAE1E,OAAO,EAAE,OAAO,EAAE,CAAC;QACpB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/credentials/setup-credentials.tool.d.ts

@@ -0,0 +1,73 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createSetupCredentialsTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    credentials: {
+        credentialType: string;
+        reason?: string | undefined;
+        suggestedName?: string | undefined;
+    }[];
+    projectId?: string | undefined;
+    credentialFlow?: {
+        stage: "generic" | "finalize";
+    } | undefined;
+}, {
+    success: boolean;
+    deferred?: boolean | undefined;
+    reason?: string | undefined;
+    credentials?: Record<string, string> | undefined;
+    credentialType?: string | undefined;
+    needsBrowserSetup?: boolean | undefined;
+    docsUrl?: string | undefined;
+    requiredFields?: {
+        type: string;
+        name: string;
+        required: boolean;
+        displayName: string;
+        description?: string | undefined;
+    }[] | undefined;
+}, {
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+    credentialRequests: {
+        reason: string;
+        credentialType: string;
+        existingCredentials: {
+            name: string;
+            id: string;
+        }[];
+        suggestedName?: string | undefined;
+    }[];
+    projectId?: string | undefined;
+    credentialFlow?: {
+        stage: "generic" | "finalize";
+    } | undefined;
+}, {
+    approved: boolean;
+    credentials?: Record<string, string> | undefined;
+    autoSetup?: {
+        credentialType: string;
+    } | undefined;
+}, import("@mastra/core/tools").ToolExecutionContext<{
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+    credentialRequests: {
+        reason: string;
+        credentialType: string;
+        existingCredentials: {
+            name: string;
+            id: string;
+        }[];
+        suggestedName?: string | undefined;
+    }[];
+    projectId?: string | undefined;
+    credentialFlow?: {
+        stage: "generic" | "finalize";
+    } | undefined;
+}, {
+    approved: boolean;
+    credentials?: Record<string, string> | undefined;
+    autoSetup?: {
+        credentialType: string;
+    } | undefined;
+}, unknown>, "setup-credentials", unknown>;

package/dist/tools/credentials/setup-credentials.tool.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSetupCredentialsTool = createSetupCredentialsTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+function createSetupCredentialsTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'setup-credentials',
+        description: 'Open the n8n credential setup UI for the user to select existing credentials or ' +
+            'create new ones directly in their browser. Use this ONLY when the user explicitly ' +
+            'asks to set up/add/create a credential outside of a workflow context. ' +
+            'Do NOT use this after building a workflow — use setup-workflow instead, which ' +
+            'handles per-node credential assignment along with parameter and trigger setup. ' +
+            'The user handles secrets through the UI — you never see sensitive data. ' +
+            'Returns a mapping of credential type to selected credential ID. ' +
+            'When the result contains needsBrowserSetup=true, delegate to a browser agent ' +
+            'with the provided docsUrl and credentialType.',
+        inputSchema: zod_1.z.object({
+            credentials: zod_1.z
+                .array(zod_1.z.object({
+                credentialType: zod_1.z
+                    .string()
+                    .describe('n8n credential type name (e.g. "slackApi", "gmailOAuth2Api")'),
+                reason: zod_1.z.string().optional().describe('Why this credential is needed (shown to user)'),
+                suggestedName: zod_1.z
+                    .string()
+                    .optional()
+                    .describe('Suggested display name for the credential (e.g. "Linear API key"). Pre-fills the name field when creating a new credential.'),
+            }))
+                .describe('List of credentials to set up'),
+            projectId: zod_1.z
+                .string()
+                .optional()
+                .describe('Project ID to scope credential creation to. Defaults to personal project.'),
+            credentialFlow: zod_1.z
+                .object({
+                stage: zod_1.z.enum(['generic', 'finalize']),
+            })
+                .optional()
+                .describe('Credential flow stage. "finalize" renders post-verification picker with "Apply credentials" / "Later" buttons.'),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            deferred: zod_1.z.boolean().optional(),
+            credentials: zod_1.z.record(zod_1.z.string()).optional(),
+            reason: zod_1.z.string().optional(),
+            needsBrowserSetup: zod_1.z.boolean().optional(),
+            credentialType: zod_1.z.string().optional(),
+            docsUrl: zod_1.z.string().optional(),
+            requiredFields: zod_1.z
+                .array(zod_1.z.object({
+                name: zod_1.z.string(),
+                displayName: zod_1.z.string(),
+                type: zod_1.z.string(),
+                required: zod_1.z.boolean(),
+                description: zod_1.z.string().optional(),
+            }))
+                .optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: api_types_1.instanceAiConfirmationSeveritySchema,
+            credentialRequests: zod_1.z.array(zod_1.z.object({
+                credentialType: zod_1.z.string(),
+                reason: zod_1.z.string(),
+                existingCredentials: zod_1.z.array(zod_1.z.object({ id: zod_1.z.string(), name: zod_1.z.string() })),
+                suggestedName: zod_1.z.string().optional(),
+            })),
+            projectId: zod_1.z.string().optional(),
+            credentialFlow: zod_1.z.object({ stage: zod_1.z.enum(['generic', 'finalize']) }).optional(),
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+            credentials: zod_1.z.record(zod_1.z.string()).optional(),
+            autoSetup: zod_1.z.object({ credentialType: zod_1.z.string() }).optional(),
+        }),
+        execute: async (input, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const isFinalize = input.credentialFlow?.stage === 'finalize';
+            if (resumeData === undefined || resumeData === null) {
+                const credentialRequests = await Promise.all(input.credentials.map(async (req) => {
+                    const existing = await context.credentialService.list({ type: req.credentialType });
+                    return {
+                        credentialType: req.credentialType,
+                        reason: req.reason ?? `Required for ${req.credentialType}`,
+                        existingCredentials: existing.map((c) => ({ id: c.id, name: c.name })),
+                        ...(req.suggestedName ? { suggestedName: req.suggestedName } : {}),
+                    };
+                }));
+                const typeNames = input.credentials.map((c) => c.credentialType).join(', ');
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: isFinalize
+                        ? `Your workflow is verified. Add credentials to make it production-ready: ${typeNames}`
+                        : input.credentials.length === 1
+                            ? `Select or create a ${typeNames} credential`
+                            : `Select or create credentials: ${typeNames}`,
+                    severity: 'info',
+                    credentialRequests,
+                    ...(input.projectId ? { projectId: input.projectId } : {}),
+                    ...(input.credentialFlow ? { credentialFlow: input.credentialFlow } : {}),
+                });
+                return { success: false };
+            }
+            if (!resumeData.approved) {
+                return {
+                    success: true,
+                    deferred: true,
+                    reason: 'User skipped credential setup for now. Continue without credentials and let the user set them up later.',
+                };
+            }
+            if (resumeData.autoSetup) {
+                const { credentialType } = resumeData.autoSetup;
+                const docsUrl = (await context.credentialService.getDocumentationUrl?.(credentialType)) ?? undefined;
+                const requiredFields = (await context.credentialService.getCredentialFields?.(credentialType)) ?? undefined;
+                return {
+                    success: false,
+                    needsBrowserSetup: true,
+                    credentialType,
+                    docsUrl,
+                    requiredFields,
+                };
+            }
+            return {
+                success: true,
+                credentials: resumeData.credentials,
+            };
+        },
+    });
+}
+//# sourceMappingURL=setup-credentials.tool.js.map

package/dist/tools/credentials/setup-credentials.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-credentials.tool.js","sourceRoot":"","sources":["../../../src/tools/credentials/setup-credentials.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/credentials/test-credential.tool.d.ts

@@ -0,0 +1,7 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createTestCredentialTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    credentialId: string;
+}, {
+    success: boolean;
+    message?: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "test-credential", unknown>;

package/dist/tools/credentials/test-credential.tool.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestCredentialTool = createTestCredentialTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+function createTestCredentialTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'test-credential',
+        description: 'Test whether a credential is valid and can connect to its service.',
+        inputSchema: zod_1.z.object({
+            credentialId: zod_1.z.string().describe('ID of the credential to test'),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            message: zod_1.z.string().optional(),
+        }),
+        execute: async (inputData) => {
+            try {
+                return await context.credentialService.test(inputData.credentialId);
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    message: error instanceof Error ? error.message : 'Credential test failed',
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=test-credential.tool.js.map

package/dist/tools/credentials/test-credential.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-credential.tool.js","sourceRoot":"","sources":["../../../src/tools/credentials/test-credential.tool.ts"],"names":[],"mappings":";;AAKA,4DAsBC;AA3BD,8CAAgD;AAChD,6BAAwB;AAIxB,SAAgB,wBAAwB,CAAC,OAA0B;IAClE,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,iBAAiB;QACrB,WAAW,EAAE,oEAAoE;QACjF,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SACjE,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;YACpB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACJ,OAAO,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YACrE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;iBAC1E,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/data-tables/add-data-table-column.tool.d.ts

@@ -0,0 +1,27 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createAddDataTableColumnTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    type: "string" | "number" | "boolean" | "date";
+    name: string;
+    dataTableId: string;
+}, {
+    denied?: boolean | undefined;
+    reason?: string | undefined;
+    column?: {
+        type: string;
+        name: string;
+        id: string;
+        index: number;
+    } | undefined;
+}, {
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, import("@mastra/core/tools").ToolExecutionContext<{
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, unknown>, "add-data-table-column", unknown>;

package/dist/tools/data-tables/add-data-table-column.tool.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAddDataTableColumnTool = createAddDataTableColumnTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+const columnTypeSchema = zod_1.z.enum(['string', 'number', 'boolean', 'date']);
+function createAddDataTableColumnTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'add-data-table-column',
+        description: 'Add a new column to an existing data table.',
+        inputSchema: zod_1.z.object({
+            dataTableId: zod_1.z.string().describe('ID of the data table'),
+            name: zod_1.z.string().describe('Column name (alphanumeric + underscores)'),
+            type: columnTypeSchema.describe('Column data type'),
+        }),
+        outputSchema: zod_1.z.object({
+            column: zod_1.z
+                .object({
+                id: zod_1.z.string(),
+                name: zod_1.z.string(),
+                type: zod_1.z.string(),
+                index: zod_1.z.number(),
+            })
+                .optional(),
+            denied: zod_1.z.boolean().optional(),
+            reason: zod_1.z.string().optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: api_types_1.instanceAiConfirmationSeveritySchema,
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+        }),
+        execute: async (input, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.mutateDataTableSchema !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: `Add column "${input.name}" (${input.type}) to data table "${input.dataTableId}"?`,
+                    severity: 'warning',
+                });
+                return {};
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return { denied: true, reason: 'User denied the action' };
+            }
+            const column = await context.dataTableService.addColumn(input.dataTableId, {
+                name: input.name,
+                type: input.type,
+            });
+            return { column };
+        },
+    });
+}
+//# sourceMappingURL=add-data-table-column.tool.js.map

package/dist/tools/data-tables/add-data-table-column.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-data-table-column.tool.js","sourceRoot":"","sources":["../../../src/tools/data-tables/add-data-table-column.tool.ts"],"names":[],"mappings":";;AASA,oEAyDC;AAlED,8CAAgD;AAChD,8CAAsE;AACtE,mCAAgC;AAChC,6BAAwB;AAIxB,MAAM,gBAAgB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzE,SAAgB,4BAA4B,CAAC,OAA0B;IACtE,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,uBAAuB;QAC3B,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACxD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YACrE,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SACnD,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,MAAM,EAAE,OAAC;iBACP,MAAM,CAAC;gBACP,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;gBACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;aACjB,CAAC;iBACD,QAAQ,EAAE;YACZ,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC;QACF,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC;YACvB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,gDAAoC;SAC9C,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE;SACrB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC;YAEjD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,qBAAqB,KAAK,cAAc,CAAC;YAGpF,IAAI,aAAa,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,CAAC,EAAE,CAAC;gBACxE,MAAM,OAAO,EAAE,CAAC;oBACf,SAAS,EAAE,IAAA,eAAM,GAAE;oBACnB,OAAO,EAAE,eAAe,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,oBAAoB,KAAK,CAAC,WAAW,IAAI;oBAC3F,QAAQ,EAAE,SAAkB;iBAC5B,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC;YACX,CAAC;YAGD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;gBAC7E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;YAC3D,CAAC;YAGD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE;gBAC1E,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,CAAC;QACnB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}