n8n 2.42.2 → 2.43.0

package/dist/modules/agents/plans/agent-plan-tools.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentPlanTools = createAgentPlanTools;
+const tool_1 = require("@n8n/agents/tool");
+const node_crypto_1 = require("node:crypto");
+const zod_1 = require("zod");
+const agent_plan_repository_1 = require("../repositories/agent-plan.repository");
+const agent_plan_schema_1 = require("./agent-plan.schema");
+const itemId = zod_1.z.union([
+    zod_1.z.string().uuid().toLowerCase(),
+    zod_1.z
+        .string()
+        .regex(/^new:[A-Za-z0-9_-]+$/, 'Use a temporary ID such as new:research for new items.'),
+]);
+const itemFields = { id: itemId, dependsOn: zod_1.z.array(itemId) };
+const taskInput = agent_plan_schema_1.agentPlanTaskSchema
+    .omit({ startedAt: true, endedAt: true })
+    .extend({ ...itemFields, fallbackFor: itemId.optional() });
+const groupInput = agent_plan_schema_1.agentPlanGroupSchema
+    .omit({ startedAt: true, endedAt: true })
+    .extend({ ...itemFields, tasks: zod_1.z.array(taskInput) });
+const documentInput = agent_plan_schema_1.agentPlanDocumentSchema.extend({
+    items: zod_1.z.array(zod_1.z.discriminatedUnion('kind', [taskInput, groupInput])),
+});
+const writeInput = zod_1.z
+    .object({
+    planId: zod_1.z.string().uuid().toLowerCase(),
+    expectedRevision: zod_1.z.number().int().positive(),
+})
+    .strict();
+function prepareDocument(data, previous) {
+    const existing = new Map(previous?.items
+        .flatMap((item) => (item.kind === 'group' ? [item, ...item.tasks] : [item]))
+        .map((item) => [item.id, item]));
+    const aliases = new Map();
+    const items = data.items.flatMap((item) => item.kind === 'group' ? [item, ...item.tasks] : [item]);
+    for (const item of items) {
+        if (item.id.startsWith('new:')) {
+            if (aliases.has(item.id)) {
+                throw new agent_plan_schema_1.AgentPlanValidationError(`Duplicate temporary ID: ${item.id}`);
+            }
+            aliases.set(item.id, (0, node_crypto_1.randomUUID)());
+        }
+        else if (!existing.has(item.id)) {
+            throw new agent_plan_schema_1.AgentPlanValidationError(`Use a new: temporary ID for the new item: ${item.id}`);
+        }
+    }
+    const resolveId = (id) => {
+        if (!id.startsWith('new:'))
+            return id;
+        const resolved = aliases.get(id);
+        if (!resolved)
+            throw new agent_plan_schema_1.AgentPlanValidationError(`Unknown temporary ID: ${id}`);
+        return resolved;
+    };
+    const restoreItem = (item) => ({
+        ...item,
+        id: resolveId(item.id),
+        dependsOn: item.dependsOn.map(resolveId),
+        startedAt: existing.get(item.id)?.startedAt ?? null,
+        endedAt: existing.get(item.id)?.endedAt ?? null,
+    });
+    const restoreTask = (task) => ({
+        ...restoreItem(task),
+        kind: task.kind,
+        ...(task.fallbackFor !== undefined ? { fallbackFor: resolveId(task.fallbackFor) } : {}),
+    });
+    return {
+        ...data,
+        items: data.items.map((item) => item.kind === 'group'
+            ? { ...restoreItem(item), kind: item.kind, tasks: item.tasks.map(restoreTask) }
+            : restoreTask(item)),
+    };
+}
+function presentPlan(plan) {
+    if (!plan)
+        return null;
+    const startedAt = plan.data.items
+        .flatMap((item) => (item.kind === 'group' ? [item, ...item.tasks] : [item]))
+        .map((item) => item.startedAt)
+        .filter((timestamp) => timestamp !== null)
+        .sort()[0] ?? null;
+    const withoutTiming = (item) => {
+        const { startedAt, endedAt, ...visible } = item;
+        return visible;
+    };
+    return {
+        planId: plan.id,
+        revision: plan.revision,
+        closed: plan.closedAt !== null,
+        startedAt,
+        closedAt: plan.closedAt?.toISOString() ?? null,
+        document: {
+            ...plan.data,
+            items: plan.data.items.map((item) => item.kind === 'group'
+                ? { ...withoutTiming(item), tasks: item.tasks.map(withoutTiming) }
+                : withoutTiming(item)),
+        },
+        readiness: plan.readiness,
+    };
+}
+function scopedTool(name, description, schema, handler) {
+    return new tool_1.Tool(name)
+        .description(description)
+        .input(schema)
+        .handler(async (input, context) => {
+        const threadId = context.persistence?.threadId;
+        if (!threadId) {
+            return {
+                error: 'unavailable',
+                message: 'Plan tools need a persisted conversation thread.',
+            };
+        }
+        try {
+            return presentPlan(await handler(schema.parse(input), threadId, {}));
+        }
+        catch (error) {
+            if (error instanceof agent_plan_repository_1.AgentPlanWriteConflictError) {
+                return {
+                    error: 'conflict',
+                    message: 'The plan write conflicts with the stored state. Call read_plan before another write.',
+                };
+            }
+            if (error instanceof agent_plan_schema_1.AgentPlanValidationError || error instanceof zod_1.z.ZodError) {
+                return { error: 'invalid_plan', message: error.message };
+            }
+            throw error;
+        }
+    });
+}
+function createAgentPlanTools(service) {
+    return [
+        scopedTool('create_plan', 'Create the active plan for this conversation. Use unique new: names for new tasks and groups. ' +
+            'Use these names in dependency references. Set every task and group status to "pending", including work you will start immediately. ' +
+            'After creation succeeds, use update_plan with the returned permanent IDs and revision to start ready work.', zod_1.z.object({ document: documentInput }).strict(), async ({ document }, threadId, ctx) => await service.createActivePlan({
+            id: (0, node_crypto_1.randomUUID)(),
+            threadId,
+            formatVersion: agent_plan_schema_1.AGENT_PLAN_FORMAT_VERSION,
+            data: prepareDocument(document),
+        }, ctx))
+            .systemInstruction('Use planning for potentially long-running work, work with multiple steps, or work with complex dependencies. ' +
+            'For this work, create or update the plan before research, other task tool calls, or sub-agent delegation. ' +
+            'Discovery followed by a shortlist and parallel research requires a plan. A chat message describing the steps is not a plan. ' +
+            'If the user asks for quick work, keep the plan compact rather than skipping it. ' +
+            'Always save new tasks and groups with status "pending", in both create_plan and update_plan. ' +
+            'Do not create an item as "in_progress" or "done", even when work starts immediately or already finished. ' +
+            'After the write succeeds, use the returned permanent IDs and revision in a separate update_plan call to change statuses. ' +
+            'Only start or complete work after its prerequisites are Done. ' +
+            'If later tasks depend on research results, start with the known tasks and extend the plan after research. ' +
+            'Do not invent placeholder tasks for work whose scope or targets are not yet known. ' +
+            'Represent that stage as a Pending group with an empty tasks list and dependencies on the prerequisite work. ' +
+            'For example, add "Research finalists" without tasks named "Finalist 1", "Finalist 2", or "Finalist 3". ' +
+            'After accepting the shortlist results, add concrete tasks to that group before starting the research. ' +
+            'Do not add final communication-only tasks, such as "Presented findings to user", to the plan. ' +
+            'Include such a task only when it requires a sub-agent or a tool call beyond plan maintenance. ' +
+            'If the current plan content and revision are not in context, call read_plan before updating the plan. ' +
+            'For sub-agent work on a plan task, always use spawn_background_subagent, even for short or sequential tasks. ' +
+            'Do not use delegate_subagent for plan work. ' +
+            'This rule overrides the default foreground-delegation guidance for plan work. ' +
+            'If spawn_background_subagent is unavailable, explain the limitation instead of delegating plan work in the foreground. ' +
+            'Keep task and group statuses current. Accept results before marking work Done. ' +
+            'Before announcing plan changes or task progress to the user, always update the plan with that information. ' +
+            'Wait for the plan update to succeed before announcing the change. ' +
+            'Use presentation.label for a short, factual activity label in the plan card. ' +
+            'Name the current activity in a few words, such as "Checking vendor pricing", not a list of completed tasks. ' +
+            'Use presentation.detail for one brief progress note, limitation, or change of approach, not a results report. ' +
+            'Keep task and group titles short. Each title must explain the work without its description. ' +
+            'Avoid repeated words or phrases across task and group titles at the same nesting level when clarity permits. ' +
+            'Put shared context in the parent title instead of repeating it in every child title. ' +
+            'Keep each title distinct and clear. Do not replace repeated words with synonyms just for variety. ' +
+            'Update titles of pending or in-progress tasks to reflect the current activity. The card shows titles, not task descriptions. ' +
+            'For an in-progress task, use a simple action verb with a short note in parentheses, such as "Research pricing (3 vendors)". ' +
+            'When marking a task Done, use a past-tense title, such as "Researched pricing". ' +
+            'Save the completed title in the same update as the Done status. Final tasks cannot change. ' +
+            'Put constraints in descriptions and findings in resultSummary. ' +
+            'Keep this text current through update_plan. Presentation text does not set task or group statuses. ' +
+            'Before closing a plan, save a final presentation.detail summary of completed and unfinished work. ' +
+            'Underlying runs do not set plan statuses.')
+            .build(),
+        scopedTool('read_plan', 'Read the active plan and its current revision for this conversation. Returns null if there is no active plan.', zod_1.z.object({}).strict(), async (_input, threadId, ctx) => await service.findActivePlan(threadId, ctx)).build(),
+        scopedTool('update_plan', 'Replace the complete active plan at the expected revision. Keep permanent IDs for existing items. ' +
+            'Use new: names for new items and their references. Omit timestamps. ' +
+            'Dependencies connect siblings only. Prerequisites must be done before work starts or completes. ' +
+            'New tasks and groups must have status "pending". Change their statuses in a separate update after this write succeeds. ' +
+            'Final items cannot change. Only pending items can be removed. ' +
+            'fallbackFor references a failed or cancelled sibling task. Read the saved result for redirected dependencies.', writeInput.extend({ document: documentInput }), async ({ document, ...input }, threadId, ctx) => {
+            const current = await service.findPlan(threadId, input.planId, ctx);
+            if (!current || current.closedAt !== null || current.revision !== input.expectedRevision) {
+                throw new agent_plan_repository_1.AgentPlanWriteConflictError();
+            }
+            return await service.replacePlan({
+                ...input,
+                threadId,
+                formatVersion: agent_plan_schema_1.AGENT_PLAN_FORMAT_VERSION,
+                data: prepareDocument(document, current.data),
+            }, ctx);
+        }).build(),
+        scopedTool('close_plan', 'Close the active plan at the expected revision. Preserve its document and release the active-plan slot. ' +
+            'This does not cancel work or imply success.', writeInput, async (input, threadId, ctx) => await service.closePlan({ ...input, threadId }, ctx)).build(),
+    ];
+}
+//# sourceMappingURL=agent-plan-tools.js.map

package/dist/modules/agents/plans/agent-plan-tools.js.map

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

package/dist/modules/agents/plans/agent-plan.schema.d.ts

@@ -0,0 +1,352 @@
+import { UserError } from 'n8n-workflow';
+import { z } from 'zod';
+export declare const AGENT_PLAN_FORMAT_VERSION = 1;
+export declare class AgentPlanValidationError extends UserError {
+}
+export declare const agentPlanTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<["pending", "in_progress", "done", "failed", "cancelled"]>;
+    dependsOn: z.ZodArray<z.ZodString, "many">;
+    resultSummary: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    endedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodLiteral<"task">;
+    fallbackFor: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    description: string;
+    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+    dependsOn: string[];
+    resultSummary?: string | undefined;
+    startedAt: string | null;
+    endedAt: string | null;
+    kind: "task";
+    fallbackFor?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    description: string;
+    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+    dependsOn: string[];
+    resultSummary?: string | undefined;
+    startedAt?: string | null | undefined;
+    endedAt?: string | null | undefined;
+    kind: "task";
+    fallbackFor?: string | undefined;
+}>;
+export declare const agentPlanGroupSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<["pending", "in_progress", "done", "failed", "cancelled"]>;
+    dependsOn: z.ZodArray<z.ZodString, "many">;
+    resultSummary: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    endedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodLiteral<"group">;
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "done", "failed", "cancelled"]>;
+        dependsOn: z.ZodArray<z.ZodString, "many">;
+        resultSummary: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        endedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodLiteral<"task">;
+        fallbackFor: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt: string | null;
+        endedAt: string | null;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    description: string;
+    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+    dependsOn: string[];
+    resultSummary?: string | undefined;
+    startedAt: string | null;
+    endedAt: string | null;
+    kind: "group";
+    tasks: {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt: string | null;
+        endedAt: string | null;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    }[];
+}, {
+    id: string;
+    title: string;
+    description: string;
+    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+    dependsOn: string[];
+    resultSummary?: string | undefined;
+    startedAt?: string | null | undefined;
+    endedAt?: string | null | undefined;
+    kind: "group";
+    tasks: {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    }[];
+}>;
+export declare const agentPlanDocumentSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodString;
+    presentation: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        detail?: string | undefined;
+    }, {
+        label: string;
+        detail?: string | undefined;
+    }>>;
+    items: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "done", "failed", "cancelled"]>;
+        dependsOn: z.ZodArray<z.ZodString, "many">;
+        resultSummary: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        endedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodLiteral<"task">;
+        fallbackFor: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt: string | null;
+        endedAt: string | null;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "done", "failed", "cancelled"]>;
+        dependsOn: z.ZodArray<z.ZodString, "many">;
+        resultSummary: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        endedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodLiteral<"group">;
+        tasks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            status: z.ZodEnum<["pending", "in_progress", "done", "failed", "cancelled"]>;
+            dependsOn: z.ZodArray<z.ZodString, "many">;
+            resultSummary: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            endedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodLiteral<"task">;
+            fallbackFor: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            description: string;
+            status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+            dependsOn: string[];
+            resultSummary?: string | undefined;
+            startedAt: string | null;
+            endedAt: string | null;
+            kind: "task";
+            fallbackFor?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            description: string;
+            status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+            dependsOn: string[];
+            resultSummary?: string | undefined;
+            startedAt?: string | null | undefined;
+            endedAt?: string | null | undefined;
+            kind: "task";
+            fallbackFor?: string | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt: string | null;
+        endedAt: string | null;
+        kind: "group";
+        tasks: {
+            id: string;
+            title: string;
+            description: string;
+            status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+            dependsOn: string[];
+            resultSummary?: string | undefined;
+            startedAt: string | null;
+            endedAt: string | null;
+            kind: "task";
+            fallbackFor?: string | undefined;
+        }[];
+    }, {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        kind: "group";
+        tasks: {
+            id: string;
+            title: string;
+            description: string;
+            status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+            dependsOn: string[];
+            resultSummary?: string | undefined;
+            startedAt?: string | null | undefined;
+            endedAt?: string | null | undefined;
+            kind: "task";
+            fallbackFor?: string | undefined;
+        }[];
+    }>]>, "many">;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    description: string;
+    presentation?: {
+        label: string;
+        detail?: string | undefined;
+    } | undefined;
+    items: ({
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt: string | null;
+        endedAt: string | null;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    } | {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt: string | null;
+        endedAt: string | null;
+        kind: "group";
+        tasks: {
+            id: string;
+            title: string;
+            description: string;
+            status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+            dependsOn: string[];
+            resultSummary?: string | undefined;
+            startedAt: string | null;
+            endedAt: string | null;
+            kind: "task";
+            fallbackFor?: string | undefined;
+        }[];
+    })[];
+}, {
+    title: string;
+    description: string;
+    presentation?: {
+        label: string;
+        detail?: string | undefined;
+    } | undefined;
+    items: ({
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        kind: "task";
+        fallbackFor?: string | undefined;
+    } | {
+        id: string;
+        title: string;
+        description: string;
+        status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+        dependsOn: string[];
+        resultSummary?: string | undefined;
+        startedAt?: string | null | undefined;
+        endedAt?: string | null | undefined;
+        kind: "group";
+        tasks: {
+            id: string;
+            title: string;
+            description: string;
+            status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+            dependsOn: string[];
+            resultSummary?: string | undefined;
+            startedAt?: string | null | undefined;
+            endedAt?: string | null | undefined;
+            kind: "task";
+            fallbackFor?: string | undefined;
+        }[];
+    })[];
+}>;
+export type AgentPlanDocument = z.infer<typeof agentPlanDocumentSchema>;
+export type AgentPlanTask = z.infer<typeof agentPlanTaskSchema>;
+export type AgentPlanGroup = z.infer<typeof agentPlanGroupSchema>;
+export type AgentPlanItem = AgentPlanDocument['items'][number];
+export type AgentPlanStatus = AgentPlanItem['status'];
+export declare function parseAgentPlan(data: unknown, formatVersion: number): AgentPlanDocument;

package/dist/modules/agents/plans/agent-plan.schema.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentPlanDocumentSchema = exports.agentPlanGroupSchema = exports.agentPlanTaskSchema = exports.AgentPlanValidationError = exports.AGENT_PLAN_FORMAT_VERSION = void 0;
+exports.parseAgentPlan = parseAgentPlan;
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = require("zod");
+exports.AGENT_PLAN_FORMAT_VERSION = 1;
+class AgentPlanValidationError extends n8n_workflow_1.UserError {
+}
+exports.AgentPlanValidationError = AgentPlanValidationError;
+const idSchema = zod_1.z.string().uuid().toLowerCase();
+const itemFields = {
+    id: idSchema,
+    title: zod_1.z.string().min(1),
+    description: zod_1.z.string(),
+    status: zod_1.z.enum(['pending', 'in_progress', 'done', 'failed', 'cancelled']),
+    dependsOn: zod_1.z.array(idSchema),
+    resultSummary: zod_1.z.string().optional(),
+    startedAt: zod_1.z.string().datetime().nullable().default(null),
+    endedAt: zod_1.z.string().datetime().nullable().default(null),
+};
+exports.agentPlanTaskSchema = zod_1.z
+    .object({ ...itemFields, kind: zod_1.z.literal('task'), fallbackFor: idSchema.optional() })
+    .strict();
+exports.agentPlanGroupSchema = zod_1.z
+    .object({ ...itemFields, kind: zod_1.z.literal('group'), tasks: zod_1.z.array(exports.agentPlanTaskSchema) })
+    .strict();
+exports.agentPlanDocumentSchema = zod_1.z
+    .object({
+    title: zod_1.z.string().min(1),
+    description: zod_1.z.string(),
+    presentation: zod_1.z
+        .object({
+        label: zod_1.z.string().trim().min(1),
+        detail: zod_1.z.string().trim().min(1).optional(),
+    })
+        .strict()
+        .optional(),
+    items: zod_1.z.array(zod_1.z.discriminatedUnion('kind', [exports.agentPlanTaskSchema, exports.agentPlanGroupSchema])),
+})
+    .strict();
+function parseAgentPlan(data, formatVersion) {
+    if (formatVersion !== exports.AGENT_PLAN_FORMAT_VERSION) {
+        throw new AgentPlanValidationError(`Unsupported plan format version: ${formatVersion}`);
+    }
+    const result = exports.agentPlanDocumentSchema.safeParse(data);
+    if (!result.success) {
+        throw new AgentPlanValidationError(result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('\n'));
+    }
+    return result.data;
+}
+//# sourceMappingURL=agent-plan.schema.js.map

package/dist/modules/agents/plans/agent-plan.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-plan.schema.js","sourceRoot":"","sources":["../../../../src/modules/agents/plans/agent-plan.schema.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents/plans/agent-plan.validation.d.ts

@@ -0,0 +1,10 @@
+import { type AgentPlanDocument } from './agent-plan.schema';
+export type AgentPlanReadiness = {
+    ready: string[];
+    blocked: Array<{
+        id: string;
+        blockedBy: string[];
+    }>;
+};
+export declare function getAgentPlanReadiness(document: AgentPlanDocument): AgentPlanReadiness;
+export declare function prepareAgentPlan(data: unknown, formatVersion: number, previous: AgentPlanDocument | null, now: Date): AgentPlanDocument;