@yagr/agent 0.1.0

package/dist/tools/delete-workspace-file.js

@@ -0,0 +1,31 @@
+import fs from 'node:fs';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { fileExists, relativeWorkspacePath, resolveWorkspacePath } from './workspace-utils.js';
+export function createDeleteWorkspaceFileTool(_observer) {
+    return tool({
+        description: 'Delete a workspace file that is obsolete, orphaned, or superseded by a canonical copy. Use only when you can attribute the artifact to the current run or prove it is redundant.',
+        parameters: z.object({
+            path: z.string().min(1).describe('Workspace-relative file path.'),
+            allowMissing: z.boolean().default(true).describe('Whether missing files should be treated as a non-fatal result.'),
+        }),
+        execute: async ({ path: inputPath, allowMissing }) => {
+            const targetPath = resolveWorkspacePath(inputPath);
+            if (!fileExists(targetPath)) {
+                return {
+                    ok: allowMissing,
+                    path: relativeWorkspacePath(targetPath),
+                    deleted: false,
+                    error: allowMissing ? undefined : `File does not exist: ${inputPath}`,
+                };
+            }
+            fs.rmSync(targetPath, { force: true });
+            return {
+                ok: true,
+                path: relativeWorkspacePath(targetPath),
+                deleted: true,
+            };
+        },
+    });
+}
+//# sourceMappingURL=delete-workspace-file.js.map

package/dist/tools/delete-workspace-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-workspace-file.js","sourceRoot":"","sources":["../../src/tools/delete-workspace-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE/F,MAAM,UAAU,6BAA6B,CAAC,SAAiC;IAC7E,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,kLAAkL;QAC/L,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACjE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC;SACnH,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE;YACnD,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAEnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5B,OAAO;oBACL,EAAE,EAAE,YAAY;oBAChB,IAAI,EAAE,qBAAqB,CAAC,UAAU,CAAC;oBACvC,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,wBAAwB,SAAS,EAAE;iBACtE,CAAC;YACJ,CAAC;YAED,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAEvC,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,qBAAqB,CAAC,UAAU,CAAC;gBACvC,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/deploy.d.ts

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import type { Engine } from '../engine/engine.js';
+export declare function createDeployWorkflowTool(engine: Engine): import("ai").Tool<z.ZodObject<{
+    workflow: z.ZodObject<{
+        engine: z.ZodEnum<["n8n", "yagr-engine"]>;
+        name: z.ZodString;
+        sourceType: z.ZodEnum<["n8n-json", "yagr-python"]>;
+        definition: z.ZodUnknown;
+        credentialRequirements: z.ZodArray<z.ZodObject<{
+            nodeName: z.ZodString;
+            credentialType: z.ZodString;
+            displayName: z.ZodString;
+            required: z.ZodBoolean;
+            status: z.ZodEnum<["missing", "linked", "unknown"]>;
+            helpUrl: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: "linked" | "missing" | "unknown";
+            credentialType: string;
+            displayName: string;
+            nodeName: string;
+            required: boolean;
+            helpUrl?: string | undefined;
+        }, {
+            status: "linked" | "missing" | "unknown";
+            credentialType: string;
+            displayName: string;
+            nodeName: string;
+            required: boolean;
+            helpUrl?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        engine: "n8n" | "yagr-engine";
+        name: string;
+        sourceType: "n8n-json" | "yagr-python";
+        credentialRequirements: {
+            status: "linked" | "missing" | "unknown";
+            credentialType: string;
+            displayName: string;
+            nodeName: string;
+            required: boolean;
+            helpUrl?: string | undefined;
+        }[];
+        definition?: unknown;
+    }, {
+        engine: "n8n" | "yagr-engine";
+        name: string;
+        sourceType: "n8n-json" | "yagr-python";
+        credentialRequirements: {
+            status: "linked" | "missing" | "unknown";
+            credentialType: string;
+            displayName: string;
+            nodeName: string;
+            required: boolean;
+            helpUrl?: string | undefined;
+        }[];
+        definition?: unknown;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    workflow: {
+        engine: "n8n" | "yagr-engine";
+        name: string;
+        sourceType: "n8n-json" | "yagr-python";
+        credentialRequirements: {
+            status: "linked" | "missing" | "unknown";
+            credentialType: string;
+            displayName: string;
+            nodeName: string;
+            required: boolean;
+            helpUrl?: string | undefined;
+        }[];
+        definition?: unknown;
+    };
+}, {
+    workflow: {
+        engine: "n8n" | "yagr-engine";
+        name: string;
+        sourceType: "n8n-json" | "yagr-python";
+        credentialRequirements: {
+            status: "linked" | "missing" | "unknown";
+            credentialType: string;
+            displayName: string;
+            nodeName: string;
+            required: boolean;
+            helpUrl?: string | undefined;
+        }[];
+        definition?: unknown;
+    };
+}>, {
+    deployed: import("../types.js").DeployedWorkflow;
+}> & {
+    execute: (args: {
+        workflow: {
+            engine: "n8n" | "yagr-engine";
+            name: string;
+            sourceType: "n8n-json" | "yagr-python";
+            credentialRequirements: {
+                status: "linked" | "missing" | "unknown";
+                credentialType: string;
+                displayName: string;
+                nodeName: string;
+                required: boolean;
+                helpUrl?: string | undefined;
+            }[];
+            definition?: unknown;
+        };
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+        deployed: import("../types.js").DeployedWorkflow;
+    }>;
+};
+//# sourceMappingURL=deploy.d.ts.map

package/dist/tools/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/tools/deploy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBtD"}

package/dist/tools/deploy.js

@@ -0,0 +1,28 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+export function createDeployWorkflowTool(engine) {
+    return tool({
+        description: 'Deploy a validated workflow to the active engine.',
+        parameters: z.object({
+            workflow: z.object({
+                engine: z.enum(['n8n', 'yagr-engine']),
+                name: z.string(),
+                sourceType: z.enum(['n8n-json', 'yagr-python']),
+                definition: z.unknown(),
+                credentialRequirements: z.array(z.object({
+                    nodeName: z.string(),
+                    credentialType: z.string(),
+                    displayName: z.string(),
+                    required: z.boolean(),
+                    status: z.enum(['missing', 'linked', 'unknown']),
+                    helpUrl: z.string().optional(),
+                })),
+            }),
+        }),
+        execute: async ({ workflow }) => {
+            const deployed = await engine.deploy(workflow);
+            return { deployed };
+        },
+    });
+}
+//# sourceMappingURL=deploy.js.map

package/dist/tools/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/tools/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,mDAAmD;QAChE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;gBACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;gBACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAChB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;gBAC/C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;gBACvB,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;oBACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;oBACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;oBAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;oBACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;oBACrB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;oBAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC/B,CAAC,CAAC;aACJ,CAAC;SACH,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAA6B,CAAC,CAAC;YACpE,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/generate-workflow.d.ts

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import type { Engine } from '../engine/engine.js';
+export declare function createGenerateWorkflowTool(engine: Engine): import("ai").Tool<z.ZodObject<{
+    name: z.ZodString;
+    nodes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        typeVersion: z.ZodOptional<z.ZodNumber>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        parameters: Record<string, unknown>;
+        credentials?: Record<string, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }> | undefined;
+        typeVersion?: number | undefined;
+        position?: [number, number] | undefined;
+    }, {
+        type: string;
+        name: string;
+        parameters: Record<string, unknown>;
+        credentials?: Record<string, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }> | undefined;
+        typeVersion?: number | undefined;
+        position?: [number, number] | undefined;
+    }>, "many">;
+    connections: z.ZodUnion<[z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }, {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }>, "many">, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodArray<z.ZodArray<z.ZodObject<{
+        node: z.ZodString;
+        type: z.ZodString;
+        index: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        node: string;
+        index?: number | undefined;
+    }, {
+        type: string;
+        node: string;
+        index?: number | undefined;
+    }>, "many">, "many">>>, z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }, {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }>, "many">>]>;
+    active: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        type: string;
+        name: string;
+        parameters: Record<string, unknown>;
+        credentials?: Record<string, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }> | undefined;
+        typeVersion?: number | undefined;
+        position?: [number, number] | undefined;
+    }[];
+    connections: {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }[] | Record<string, Record<string, {
+        type: string;
+        node: string;
+        index?: number | undefined;
+    }[][]>> | Record<string, {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }[]>;
+    name: string;
+    active?: boolean | undefined;
+}, {
+    nodes: {
+        type: string;
+        name: string;
+        parameters: Record<string, unknown>;
+        credentials?: Record<string, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }> | undefined;
+        typeVersion?: number | undefined;
+        position?: [number, number] | undefined;
+    }[];
+    connections: {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }[] | Record<string, Record<string, {
+        type: string;
+        node: string;
+        index?: number | undefined;
+    }[][]>> | Record<string, {
+        from: string;
+        to: string;
+        type?: string | undefined;
+        index?: number | undefined;
+    }[]>;
+    name: string;
+    active?: boolean | undefined;
+}>, {
+    workflow: import("../types.js").GeneratedWorkflow;
+}> & {
+    execute: (args: {
+        nodes: {
+            type: string;
+            name: string;
+            parameters: Record<string, unknown>;
+            credentials?: Record<string, {
+                name?: string | undefined;
+                id?: string | undefined;
+            }> | undefined;
+            typeVersion?: number | undefined;
+            position?: [number, number] | undefined;
+        }[];
+        connections: {
+            from: string;
+            to: string;
+            type?: string | undefined;
+            index?: number | undefined;
+        }[] | Record<string, Record<string, {
+            type: string;
+            node: string;
+            index?: number | undefined;
+        }[][]>> | Record<string, {
+            from: string;
+            to: string;
+            type?: string | undefined;
+            index?: number | undefined;
+        }[]>;
+        name: string;
+        active?: boolean | undefined;
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+        workflow: import("../types.js").GeneratedWorkflow;
+    }>;
+};
+//# sourceMappingURL=generate-workflow.d.ts.map

package/dist/tools/generate-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-workflow.d.ts","sourceRoot":"","sources":["../../src/tools/generate-workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA+ClD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcxD"}

package/dist/tools/generate-workflow.js

@@ -0,0 +1,46 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+const workflowNodeSchema = z.object({
+    name: z.string().min(1),
+    type: z.string().min(1),
+    parameters: z.record(z.unknown()),
+    typeVersion: z.number().optional(),
+    position: z.tuple([z.number(), z.number()]).optional(),
+    credentials: z.record(z.object({
+        id: z.string().optional(),
+        name: z.string().optional(),
+    })).optional(),
+});
+const arrayConnectionsSchema = z.array(z.object({
+    from: z.string().min(1),
+    to: z.string().min(1),
+    type: z.string().optional(),
+    index: z.number().optional(),
+}));
+const n8nConnectionsSchema = z.record(z.string(), z.record(z.string(), z.array(z.array(z.object({
+    node: z.string().min(1),
+    type: z.string().min(1),
+    index: z.number().optional(),
+})))));
+const groupedEdgeConnectionsSchema = z.record(z.string(), z.array(z.object({
+    from: z.string().min(1),
+    to: z.string().min(1),
+    type: z.string().optional(),
+    index: z.number().optional(),
+})));
+export function createGenerateWorkflowTool(engine) {
+    return tool({
+        description: 'Generate a workflow definition from a structured specification.',
+        parameters: z.object({
+            name: z.string().min(1),
+            nodes: z.array(workflowNodeSchema).min(1),
+            connections: z.union([arrayConnectionsSchema, n8nConnectionsSchema, groupedEdgeConnectionsSchema]),
+            active: z.boolean().optional(),
+        }),
+        execute: async (spec) => {
+            const workflow = await engine.generateWorkflow(spec);
+            return { workflow };
+        },
+    });
+}
+//# sourceMappingURL=generate-workflow.js.map

package/dist/tools/generate-workflow.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,20 @@
+export { buildTools } from './build-tools.js';
+export { createDeleteWorkspaceFileTool } from './delete-workspace-file.js';
+export { createListDirectoryTool } from './list-directory.js';
+export { createN8nAcTool } from './n8nac.js';
+export { createMoveWorkspaceFileTool } from './move-workspace-file.js';
+export { createReadWorkspaceFileTool } from './read-workspace-file.js';
+export { createReplaceInWorkspaceFileTool } from './replace-in-workspace-file.js';
+export { createReportProgressTool } from './report-progress.js';
+export { createRequestRequiredActionTool } from './request-required-action.js';
+export { createSearchWorkspaceTool } from './search-workspace.js';
+export { createWriteWorkspaceFileTool } from './write-workspace-file.js';
+export { createDeployWorkflowTool } from './deploy.js';
+export { createGenerateWorkflowTool } from './generate-workflow.js';
+export { createListWorkflowsTool } from './list-workflows.js';
+export { createManageWorkflowTool } from './manage-workflow.js';
+export { createNodeInfoTool } from './node-info.js';
+export { createSearchNodesTool } from './search-nodes.js';
+export { createSearchTemplatesTool } from './search-templates.js';
+export { createValidateWorkflowTool } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,20 @@
+export { buildTools } from './build-tools.js';
+export { createDeleteWorkspaceFileTool } from './delete-workspace-file.js';
+export { createListDirectoryTool } from './list-directory.js';
+export { createN8nAcTool } from './n8nac.js';
+export { createMoveWorkspaceFileTool } from './move-workspace-file.js';
+export { createReadWorkspaceFileTool } from './read-workspace-file.js';
+export { createReplaceInWorkspaceFileTool } from './replace-in-workspace-file.js';
+export { createReportProgressTool } from './report-progress.js';
+export { createRequestRequiredActionTool } from './request-required-action.js';
+export { createSearchWorkspaceTool } from './search-workspace.js';
+export { createWriteWorkspaceFileTool } from './write-workspace-file.js';
+export { createDeployWorkflowTool } from './deploy.js';
+export { createGenerateWorkflowTool } from './generate-workflow.js';
+export { createListWorkflowsTool } from './list-workflows.js';
+export { createManageWorkflowTool } from './manage-workflow.js';
+export { createNodeInfoTool } from './node-info.js';
+export { createSearchNodesTool } from './search-nodes.js';
+export { createSearchTemplatesTool } from './search-templates.js';
+export { createValidateWorkflowTool } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/list-directory.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import type { ToolExecutionObserver } from './observer.js';
+export declare function createListDirectoryTool(_observer?: ToolExecutionObserver): import("ai").Tool<z.ZodObject<{
+    path: z.ZodDefault<z.ZodString>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    recursive: boolean;
+    maxDepth: number;
+}, {
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+    maxDepth?: number | undefined;
+}>, {
+    ok: boolean;
+    path: string;
+    error: string;
+    entries?: undefined;
+} | {
+    ok: boolean;
+    path: string;
+    entries: {
+        path: string;
+        type: "file" | "directory";
+    }[];
+    error?: undefined;
+}> & {
+    execute: (args: {
+        path: string;
+        recursive: boolean;
+        maxDepth: number;
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+        ok: boolean;
+        path: string;
+        error: string;
+        entries?: undefined;
+    } | {
+        ok: boolean;
+        path: string;
+        entries: {
+            path: string;
+            type: "file" | "directory";
+        }[];
+        error?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-directory.d.ts.map

package/dist/tools/list-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory.d.ts","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AA2B3D,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;cAxBmC,MAAM;cAAQ,MAAM,GAAG,WAAW;;;;;;;;;;;;;;;;;kBAAlC,MAAM;kBAAQ,MAAM,GAAG,WAAW;;;;EA4D7I"}

package/dist/tools/list-directory.js

@@ -0,0 +1,61 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { relativeWorkspacePath, resolveWorkspacePath, shouldIgnorePath } from './workspace-utils.js';
+function collectEntries(targetPath, recursive, maxDepth, depth = 0) {
+    const entries = fs.readdirSync(targetPath, { withFileTypes: true })
+        .sort((left, right) => left.name.localeCompare(right.name));
+    const results = [];
+    for (const entry of entries) {
+        const absolutePath = path.join(targetPath, entry.name);
+        if (shouldIgnorePath(absolutePath)) {
+            continue;
+        }
+        results.push({
+            path: relativeWorkspacePath(absolutePath),
+            type: entry.isDirectory() ? 'directory' : 'file',
+        });
+        if (recursive && entry.isDirectory() && depth < maxDepth) {
+            results.push(...collectEntries(absolutePath, true, maxDepth, depth + 1));
+        }
+    }
+    return results;
+}
+export function createListDirectoryTool(_observer) {
+    return tool({
+        description: 'List files and directories in the active workspace. Use this to discover workflow folders before editing files.',
+        parameters: z.object({
+            path: z.string().default('.').describe('Workspace-relative directory path to inspect.'),
+            recursive: z.boolean().default(false).describe('Whether to walk subdirectories.'),
+            maxDepth: z.number().int().min(0).max(6).default(2).describe('Maximum recursion depth when recursive is true.'),
+        }),
+        execute: async ({ path: inputPath, recursive, maxDepth }) => {
+            const targetPath = resolveWorkspacePath(inputPath);
+            let stats;
+            try {
+                stats = fs.statSync(targetPath);
+            }
+            catch (error) {
+                return {
+                    ok: false,
+                    path: inputPath,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+            if (!stats.isDirectory()) {
+                return {
+                    ok: false,
+                    path: relativeWorkspacePath(targetPath),
+                    error: `Path is not a directory: ${inputPath}`,
+                };
+            }
+            return {
+                ok: true,
+                path: relativeWorkspacePath(targetPath),
+                entries: collectEntries(targetPath, recursive, maxDepth),
+            };
+        },
+    });
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/tools/list-directory.js.map

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

package/dist/tools/list-workflows.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { Engine } from '../engine/engine.js';
+export declare function createListWorkflowsTool(engine: Engine): import("ai").Tool<z.ZodObject<{
+    includeInactive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    includeInactive: boolean;
+}, {
+    includeInactive?: boolean | undefined;
+}>, {
+    workflows: import("../types.js").DeployedWorkflow[];
+}> & {
+    execute: (args: {
+        includeInactive: boolean;
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+        workflows: import("../types.js").DeployedWorkflow[];
+    }>;
+};
+//# sourceMappingURL=list-workflows.d.ts.map

package/dist/tools/list-workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-workflows.d.ts","sourceRoot":"","sources":["../../src/tools/list-workflows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;EAarD"}

package/dist/tools/list-workflows.js

@@ -0,0 +1,17 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+export function createListWorkflowsTool(engine) {
+    return tool({
+        description: 'List workflows deployed in the active engine instance.',
+        parameters: z.object({
+            includeInactive: z.boolean().optional().default(true),
+        }),
+        execute: async ({ includeInactive }) => {
+            const workflows = await engine.listWorkflows();
+            return {
+                workflows: includeInactive ? workflows : workflows.filter((workflow) => workflow.active),
+            };
+        },
+    });
+}
+//# sourceMappingURL=list-workflows.js.map

package/dist/tools/list-workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-workflows.js","sourceRoot":"","sources":["../../src/tools/list-workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,wDAAwD;QACrE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;SACtD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;YACrC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;YAC/C,OAAO;gBACL,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;aACzF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}