devchain-cli 0.12.3 → 0.13.0

package/dist/server/modules/mcp/services/handlers/epic-tools.js

@@ -1,249 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleListAgents = handleListAgents;
-exports.handleGetAgentByName = handleGetAgentByName;
-exports.handleListStatuses = handleListStatuses;
 exports.handleListEpics = handleListEpics;
 exports.handleListAssignedEpicsTasks = handleListAssignedEpicsTasks;
 exports.handleCreateEpic = handleCreateEpic;
 exports.handleGetEpicById = handleGetEpicById;
 exports.handleAddEpicComment = handleAddEpicComment;
 exports.handleUpdateEpic = handleUpdateEpic;
+exports.handleDeleteEpic = handleDeleteEpic;
 const logger_1 = require("../../../../common/logging/logger");
 const error_types_1 = require("../../../../common/errors/error-types");
-const agent_recipient_context_1 = require("../../../../common/template/agent-recipient-context");
-const mcp_dto_1 = require("../../dtos/mcp.dto");
 const dto_mappers_1 = require("../mappers/dto-mappers");
+const service_unavailable_error_1 = require("../../../../common/errors/service-unavailable.error");
 const resolve_epic_id_1 = require("../utils/resolve-epic-id");
+const session_context_helpers_1 = require("../utils/session-context-helpers");
+const agent_name_resolver_1 = require("../utils/agent-name-resolver");
+const require_project_1 = require("../utils/require-project");
 const logger = (0, logger_1.createLogger)('McpService');
-function getActorFromContext(ctx) {
-    if (ctx.type === 'agent') {
-        return ctx.agent;
-    }
-    if (ctx.type === 'guest') {
-        return {
-            id: ctx.guest.id,
-            name: ctx.guest.name,
-            projectId: ctx.guest.projectId,
-        };
-    }
-    return null;
-}
-function missingSessionResolver() {
-    return {
-        success: false,
-        error: {
-            code: 'SERVICE_UNAVAILABLE',
-            message: 'Session resolution requires full app context (not available in standalone MCP mode)',
-        },
-    };
-}
-async function resolveSessionContext(ctx, sessionId) {
-    if (!ctx.resolveSessionContext) {
-        return missingSessionResolver();
-    }
-    return ctx.resolveSessionContext(sessionId);
-}
-async function handleListAgents(ctx, params) {
-    const validated = mcp_dto_1.ListAgentsParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
-    if (!sessionCtxResult.success)
-        return sessionCtxResult;
-    const { project } = sessionCtxResult.data;
-    if (!project) {
-        return {
-            success: false,
-            error: {
-                code: 'PROJECT_NOT_FOUND',
-                message: 'No project associated with this session',
-            },
-        };
-    }
-    const limit = validated.limit ?? 100;
-    const offset = validated.offset ?? 0;
-    const normalizedQuery = validated.q?.toLowerCase();
-    const MAX_COMBINED_FETCH = 1000;
-    const [agentsResult, guests] = await Promise.all([
-        ctx.storage.listAgents(project.id, { limit: MAX_COMBINED_FETCH, offset: 0 }),
-        ctx.storage.listGuests(project.id),
-    ]);
-    const [agentPresence, tmuxSessions] = await Promise.all([
-        ctx.sessionsService
-            ? ctx.sessionsService.getAgentPresence(project.id)
-            : Promise.resolve(new Map()),
-        ctx.tmuxService ? ctx.tmuxService.listAllSessionNames() : Promise.resolve(new Set()),
-    ]);
-    const agentItems = agentsResult.items.map((agent) => ({
-        id: agent.id,
-        name: agent.name,
-        profileId: agent.profileId,
-        description: agent.description,
-        type: 'agent',
-        online: agentPresence.get(agent.id)?.online ?? false,
-    }));
-    const guestItems = guests.map((guest) => ({
-        id: guest.id,
-        name: guest.name,
-        profileId: null,
-        description: guest.description,
-        type: 'guest',
-        online: tmuxSessions.has(guest.tmuxSessionId),
-    }));
-    let allItems = [...agentItems, ...guestItems].sort((a, b) => {
-        const nameCompare = a.name.localeCompare(b.name);
-        if (nameCompare !== 0)
-            return nameCompare;
-        return a.type === 'agent' ? -1 : 1;
-    });
-    if (normalizedQuery) {
-        allItems = allItems.filter((item) => item.name.toLowerCase().includes(normalizedQuery));
-    }
-    const total = allItems.length;
-    const paginatedItems = allItems.slice(offset, offset + limit);
-    const response = {
-        agents: paginatedItems,
-        total,
-        limit,
-        offset,
-    };
-    return { success: true, data: response };
-}
-async function handleGetAgentByName(ctx, params) {
-    const validated = mcp_dto_1.GetAgentByNameParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
-    if (!sessionCtxResult.success)
-        return sessionCtxResult;
-    const { project } = sessionCtxResult.data;
-    if (!project) {
-        return {
-            success: false,
-            error: {
-                code: 'PROJECT_NOT_FOUND',
-                message: 'No project associated with this session',
-            },
-        };
-    }
-    const normalizedName = validated.name.trim().toLowerCase();
-    const agentsList = await ctx.storage.listAgents(project.id, { limit: 1000, offset: 0 });
-    const candidate = agentsList.items.find((agent) => agent.name.toLowerCase() === normalizedName);
-    if (!candidate) {
-        return {
-            success: false,
-            error: {
-                code: 'AGENT_NOT_FOUND',
-                message: `Agent "${validated.name}" not found in project`,
-                data: {
-                    availableNames: agentsList.items.map((agent) => agent.name),
-                },
-            },
-        };
-    }
-    let agentWithProfile;
-    try {
-        agentWithProfile = await ctx.storage.getAgentByName(project.id, candidate.name);
-    }
-    catch (error) {
-        if (error instanceof error_types_1.NotFoundError) {
-            return {
-                success: false,
-                error: {
-                    code: 'AGENT_NOT_FOUND',
-                    message: `Agent "${validated.name}" not found in project`,
-                    data: {
-                        availableNames: agentsList.items.map((agent) => agent.name),
-                    },
-                },
-            };
-        }
-        logger.warn({ projectId: project.id, name: candidate.name, error }, 'Agent lookup failed after matching by name');
-        throw error;
-    }
-    if (!ctx.instructionsResolver) {
-        return {
-            success: false,
-            error: {
-                code: 'SERVICE_UNAVAILABLE',
-                message: 'Instructions resolver requires full app context (not available in standalone MCP mode)',
-            },
-        };
-    }
-    const profile = agentWithProfile.profile;
-    const sessionContext = sessionCtxResult.data;
-    const callerAgentId = sessionContext.type === 'agent' ? sessionContext.agent?.id : undefined;
-    const teamCtx = callerAgentId && ctx.teamsService
-        ? await (0, agent_recipient_context_1.loadAgentRecipientContext)(ctx.teamsService, callerAgentId)
-        : { team_name: '', team_names: '', is_team_lead: false };
-    const renderVars = {
-        agent_name: sessionContext.type === 'agent' ? (sessionContext.agent?.name ?? '') : '',
-        project_name: project.name,
-        ...teamCtx,
-    };
-    const resolvedInstructions = profile
-        ? await ctx.instructionsResolver.resolve(project.id, profile.instructions ?? null, {
-            maxBytes: ctx.defaultInlineMaxBytes ?? 64 * 1024,
-            render: {
-                vars: renderVars,
-                legacyVariables: Object.keys(renderVars),
-            },
-        })
-        : null;
-    const response = {
-        agent: {
-            id: agentWithProfile.id,
-            name: agentWithProfile.name,
-            profileId: agentWithProfile.profileId,
-            description: agentWithProfile.description,
-            profile: profile
-                ? {
-                    id: profile.id,
-                    name: profile.name,
-                    instructions: profile.instructions ?? null,
-                    instructionsResolved: resolvedInstructions ?? undefined,
-                }
-                : undefined,
-        },
-    };
-    return { success: true, data: response };
-}
-async function handleListStatuses(ctx, params) {
-    const validated = mcp_dto_1.ListStatusesParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
-    if (!sessionCtxResult.success)
-        return sessionCtxResult;
-    const { project } = sessionCtxResult.data;
-    if (!project) {
-        return {
-            success: false,
-            error: {
-                code: 'PROJECT_NOT_FOUND',
-                message: 'No project associated with this session',
-            },
-        };
-    }
-    const result = await ctx.storage.listStatuses(project.id, {
-        limit: 1000,
-        offset: 0,
-    });
-    const response = {
-        statuses: result.items.map((status) => (0, dto_mappers_1.mapStatusSummary)(status)),
-    };
-    return { success: true, data: response };
-}
 async function handleListEpics(ctx, params) {
-    const validated = mcp_dto_1.ListEpicsParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
-    if (!sessionCtxResult.success)
-        return sessionCtxResult;
-    const { project } = sessionCtxResult.data;
-    if (!project) {
-        return {
-            success: false,
-            error: {
-                code: 'PROJECT_NOT_FOUND',
-                message: 'No project associated with this session',
-            },
-        };
-    }
+    const validated = params;
+    const sessionCtxResult = await (0, session_context_helpers_1.resolveSessionContext)(ctx, validated.sessionId);
+    const projectResult = (0, require_project_1.requireProject)(sessionCtxResult);
+    if (!('project' in projectResult))
+        return projectResult;
+    const { project } = projectResult;
     let statusId;
     if (validated.statusName) {
         const status = await ctx.storage.findStatusByName(project.id, validated.statusName);
@@ -281,16 +60,7 @@ async function handleListEpics(ctx, params) {
         if (epic.agentId)
             agentIds.add(epic.agentId);
     }
-    const agentNameById = new Map();
-    for (const agentId of agentIds) {
-        try {
-            const agent = await ctx.storage.getAgent(agentId);
-            agentNameById.set(agentId, agent.name);
-        }
-        catch (error) {
-            logger.warn({ agentId }, 'Failed to resolve agent name');
-        }
-    }
+    const agentNameById = await (0, agent_name_resolver_1.resolveAgentNames)(ctx.storage, agentIds);
     const parentIds = result.items.map((epic) => epic.id);
     const subEpicsMap = await ctx.storage.listSubEpicsForParents(project.id, parentIds, {
         excludeMcpHidden: true,
@@ -323,20 +93,12 @@ async function handleListEpics(ctx, params) {
     return { success: true, data: response };
 }
 async function handleListAssignedEpicsTasks(ctx, params) {
-    const validated = mcp_dto_1.ListAssignedEpicsTasksParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
-    if (!sessionCtxResult.success)
-        return sessionCtxResult;
-    const { project } = sessionCtxResult.data;
-    if (!project) {
-        return {
-            success: false,
-            error: {
-                code: 'PROJECT_NOT_FOUND',
-                message: 'No project associated with this session',
-            },
-        };
-    }
+    const validated = params;
+    const sessionCtxResult = await (0, session_context_helpers_1.resolveSessionContext)(ctx, validated.sessionId);
+    const projectResult = (0, require_project_1.requireProject)(sessionCtxResult);
+    if (!('project' in projectResult))
+        return projectResult;
+    const { project } = projectResult;
     const limit = validated.limit ?? 100;
     const offset = validated.offset ?? 0;
     try {
@@ -358,16 +120,7 @@ async function handleListAssignedEpicsTasks(ctx, params) {
             if (epic.agentId)
                 agentIds.add(epic.agentId);
         }
-        const agentNameById = new Map();
-        for (const agentId of agentIds) {
-            try {
-                const agent = await ctx.storage.getAgent(agentId);
-                agentNameById.set(agentId, agent.name);
-            }
-            catch (error) {
-                logger.warn({ agentId }, 'Failed to resolve agent name');
-            }
-        }
+        const agentNameById = await (0, agent_name_resolver_1.resolveAgentNames)(ctx.storage, agentIds);
         const epicsWithStatus = result.items.map((epic) => {
             const summary = (0, dto_mappers_1.mapEpicSummary)(epic, agentNameById);
             const status = statusById.get(epic.statusId);
@@ -408,29 +161,12 @@ async function handleListAssignedEpicsTasks(ctx, params) {
     }
 }
 async function handleCreateEpic(ctx, params) {
-    if (!ctx.epicsService) {
-        return {
-            success: false,
-            error: {
-                code: 'SERVICE_UNAVAILABLE',
-                message: 'Epic creation requires full app context (not available in standalone MCP mode)',
-            },
-        };
-    }
-    const validated = mcp_dto_1.CreateEpicParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
-    if (!sessionCtxResult.success)
-        return sessionCtxResult;
-    const { project } = sessionCtxResult.data;
-    if (!project) {
-        return {
-            success: false,
-            error: {
-                code: 'PROJECT_NOT_FOUND',
-                message: 'No project associated with this session',
-            },
-        };
-    }
+    const validated = params;
+    const sessionCtxResult = await (0, session_context_helpers_1.resolveSessionContext)(ctx, validated.sessionId);
+    const projectResult = (0, require_project_1.requireProject)(sessionCtxResult);
+    if (!('project' in projectResult))
+        return projectResult;
+    const { project } = projectResult;
     let statusId;
     if (validated.statusName) {
         const status = await ctx.storage.findStatusByName(project.id, validated.statusName);
@@ -469,23 +205,22 @@ async function handleCreateEpic(ctx, params) {
             parentId: validated.parentId ?? null,
             skillsRequired: validated.skillsRequired ?? null,
         }, context);
-        let agentNameById;
-        if (epic.agentId) {
-            agentNameById = new Map();
-            try {
-                const agent = await ctx.storage.getAgent(epic.agentId);
-                agentNameById.set(epic.agentId, agent.name);
-            }
-            catch (error) {
-                logger.warn({ agentId: epic.agentId }, 'Failed to resolve agent name');
-            }
-        }
+        const agentNameById = await (0, agent_name_resolver_1.resolveAgentNames)(ctx.storage, epic.agentId ? new Set([epic.agentId]) : new Set());
         const response = {
-            epic: (0, dto_mappers_1.mapEpicSummary)(epic, agentNameById),
+            epic: (0, dto_mappers_1.mapEpicSummary)(epic, agentNameById.size > 0 ? agentNameById : undefined),
         };
         return { success: true, data: response };
     }
     catch (error) {
+        if (error instanceof service_unavailable_error_1.ServiceUnavailableError) {
+            return {
+                success: false,
+                error: {
+                    code: 'SERVICE_UNAVAILABLE',
+                    message: 'Epic creation requires full app context (not available in standalone MCP mode)',
+                },
+            };
+        }
         if (error instanceof error_types_1.NotFoundError) {
             return {
                 success: false,
@@ -509,20 +244,12 @@ async function handleCreateEpic(ctx, params) {
     }
 }
 async function handleGetEpicById(ctx, params) {
-    const validated = mcp_dto_1.GetEpicByIdParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
-    if (!sessionCtxResult.success)
-        return sessionCtxResult;
-    const { project } = sessionCtxResult.data;
-    if (!project) {
-        return {
-            success: false,
-            error: {
-                code: 'PROJECT_NOT_FOUND',
-                message: 'No project associated with this session',
-            },
-        };
-    }
+    const validated = params;
+    const sessionCtxResult = await (0, session_context_helpers_1.resolveSessionContext)(ctx, validated.sessionId);
+    const projectResult = (0, require_project_1.requireProject)(sessionCtxResult);
+    if (!('project' in projectResult))
+        return projectResult;
+    const { project } = projectResult;
     const resolved = await (0, resolve_epic_id_1.resolveEpicId)(ctx.storage, project.id, validated.id);
     if (!resolved.success)
         return resolved;
@@ -590,16 +317,7 @@ async function handleGetEpicById(ctx, params) {
     }
     if (parentEpic?.agentId)
         agentIds.add(parentEpic.agentId);
-    const agentNameById = new Map();
-    for (const agentId of agentIds) {
-        try {
-            const agent = await ctx.storage.getAgent(agentId);
-            agentNameById.set(agentId, agent.name);
-        }
-        catch (error) {
-            logger.warn({ agentId }, 'Failed to resolve agent name');
-        }
-    }
+    const agentNameById = await (0, agent_name_resolver_1.resolveAgentNames)(ctx.storage, agentIds);
     let parentSummary;
     if (parentEpic) {
         parentSummary = (0, dto_mappers_1.mapEpicParent)(parentEpic, agentNameById);
@@ -630,12 +348,12 @@ async function handleGetEpicById(ctx, params) {
     return { success: true, data: response };
 }
 async function handleAddEpicComment(ctx, params) {
-    const validated = mcp_dto_1.AddEpicCommentParamsSchema.parse(params);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
+    const validated = params;
+    const sessionCtxResult = await (0, session_context_helpers_1.resolveSessionContext)(ctx, validated.sessionId);
     if (!sessionCtxResult.success)
         return sessionCtxResult;
     const sessionCtx = sessionCtxResult.data;
-    const authorActor = getActorFromContext(sessionCtx);
+    const authorActor = (0, session_context_helpers_1.getActorFromContext)(sessionCtx);
     if (!authorActor) {
         return {
             success: false,
@@ -659,11 +377,23 @@ async function handleAddEpicComment(ctx, params) {
     if (!resolved.success)
         return resolved;
     const epicId = resolved.data.epicId;
-    let epic;
     try {
-        epic = await ctx.storage.getEpic(epicId);
+        const comment = await ctx.epicsService.addEpicComment(epicId, project.id, validated.content, authorActor.id, sessionCtx.type);
+        const response = {
+            comment: (0, dto_mappers_1.mapEpicComment)(comment),
+        };
+        return { success: true, data: response };
     }
     catch (error) {
+        if (error instanceof service_unavailable_error_1.ServiceUnavailableError) {
+            return {
+                success: false,
+                error: {
+                    code: 'SERVICE_UNAVAILABLE',
+                    message: 'Epic comment creation requires full app context (not available in standalone MCP mode)',
+                },
+            };
+        }
         if (error instanceof error_types_1.NotFoundError) {
             return {
                 success: false,
@@ -673,50 +403,22 @@ async function handleAddEpicComment(ctx, params) {
                 },
             };
         }
+        if (error instanceof error_types_1.ValidationError) {
+            return {
+                success: false,
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: error.message,
+                    data: error.details,
+                },
+            };
+        }
         throw error;
     }
-    if (epic.projectId !== project.id) {
-        return {
-            success: false,
-            error: {
-                code: 'EPIC_NOT_FOUND',
-                message: `Epic ${epicId} does not belong to the resolved project.`,
-            },
-        };
-    }
-    const comment = await ctx.storage.createEpicComment({
-        epicId,
-        authorName: authorActor.name,
-        content: validated.content,
-    });
-    const response = {
-        comment: (0, dto_mappers_1.mapEpicComment)(comment),
-    };
-    return { success: true, data: response };
 }
 async function handleUpdateEpic(ctx, params) {
-    if (!ctx.epicsService) {
-        return {
-            success: false,
-            error: {
-                code: 'SERVICE_UNAVAILABLE',
-                message: 'Epic updates require full app context (not available in standalone MCP mode)',
-            },
-        };
-    }
-    let preprocessedParams = params;
-    if (params && typeof params === 'object' && 'assignment' in params) {
-        const p = params;
-        if (typeof p.assignment === 'string') {
-            try {
-                preprocessedParams = { ...p, assignment: JSON.parse(p.assignment) };
-            }
-            catch {
-            }
-        }
-    }
-    const validated = mcp_dto_1.UpdateEpicParamsSchema.parse(preprocessedParams);
-    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
+    const validated = params;
+    const sessionCtxResult = await (0, session_context_helpers_1.resolveSessionContext)(ctx, validated.sessionId);
     if (!sessionCtxResult.success)
         return sessionCtxResult;
     const sessionCtx = sessionCtxResult.data;
@@ -857,15 +559,6 @@ async function handleUpdateEpic(ctx, params) {
                 },
             };
         }
-        if (parentEpic.parentId !== null) {
-            return {
-                success: false,
-                error: {
-                    code: 'HIERARCHY_CONFLICT',
-                    message: 'Only one level of epic hierarchy is allowed. The specified parent already has a parent.',
-                },
-            };
-        }
         updateData.parentId = validated.parentId;
     }
     if (validated.setTags !== undefined) {
@@ -882,6 +575,7 @@ async function handleUpdateEpic(ctx, params) {
         updateData.tags = Array.from(currentTags);
     }
     let updatedEpic;
+    let outcome;
     try {
         const actor = sessionCtx.type === 'agent'
             ? { type: 'agent', id: sessionCtx.agent.id }
@@ -889,9 +583,20 @@ async function handleUpdateEpic(ctx, params) {
                 ? { type: 'guest', id: sessionCtx.guest.id }
                 : null;
         const context = { actor };
-        updatedEpic = await ctx.epicsService.updateEpic(epicId, updateData, validated.version, context);
+        const result = await ctx.epicsService.updateEpicWithOutcome(epicId, updateData, validated.version, context);
+        updatedEpic = result.epic;
+        outcome = result.outcome;
     }
     catch (error) {
+        if (error instanceof service_unavailable_error_1.ServiceUnavailableError) {
+            return {
+                success: false,
+                error: {
+                    code: 'SERVICE_UNAVAILABLE',
+                    message: 'Epic updates require full app context (not available in standalone MCP mode)',
+                },
+            };
+        }
         if (error instanceof Error && error.message.includes('was modified by another operation')) {
             const currentEpic = await ctx.storage.getEpic(epicId);
             return {
@@ -905,31 +610,115 @@ async function handleUpdateEpic(ctx, params) {
                 },
             };
         }
-        throw error;
-    }
-    let agentNameById;
-    if (updatedEpic.agentId) {
-        agentNameById = new Map();
-        try {
-            const agent = await ctx.storage.getAgent(updatedEpic.agentId);
-            agentNameById.set(updatedEpic.agentId, agent.name);
-        }
-        catch (error) {
-            logger.warn({ agentId: updatedEpic.agentId }, 'Failed to resolve agent name');
+        if (error instanceof error_types_1.ValidationError) {
+            return {
+                success: false,
+                error: {
+                    code: 'HIERARCHY_CONFLICT',
+                    message: error.message,
+                },
+            };
         }
+        throw error;
     }
+    const agentNameById = await (0, agent_name_resolver_1.resolveAgentNames)(ctx.storage, updatedEpic.agentId ? new Set([updatedEpic.agentId]) : new Set());
     const response = {
-        epic: (0, dto_mappers_1.mapEpicSummary)(updatedEpic, agentNameById),
+        epic: (0, dto_mappers_1.mapEpicSummary)(updatedEpic, agentNameById.size > 0 ? agentNameById : undefined),
     };
-    const statusChanged = updateData.statusId !== undefined && updateData.statusId !== epic.statusId;
     if (sessionCtx.type === 'agent' &&
         sessionCtx.agent?.id &&
-        statusChanged &&
+        outcome.statusChanged &&
         validated.assignment === undefined &&
-        updatedEpic.agentId === sessionCtx.agent.id) {
-        const hintAgentName = agentNameById?.get(updatedEpic.agentId) ?? sessionCtx.agent.name;
-        response.hint = `CHECK REQUIRED: Epic moved to a new status while still assigned to ${hintAgentName}. Answer this before continuing — is this a handoff to another agent? If YES, call devchain_update_epic with assignment: { agentName: "Target Agent" } now. If NO, the current assignee remains and you may proceed. Do not skip this check.`;
+        outcome.agentUnchanged &&
+        outcome.previousAssigneeAgent?.id === sessionCtx.agent.id) {
+        response.hint = `CHECK REQUIRED: Epic moved to a new status while still assigned to ${outcome.previousAssigneeAgent.name}. Answer this before continuing — is this a handoff to another agent? If YES, call devchain_update_epic with assignment: { agentName: "Target Agent" } now. If NO, the current assignee remains and you may proceed. Do not skip this check.`;
+    }
+    return { success: true, data: response };
+}
+async function handleDeleteEpic(ctx, params) {
+    const validated = params;
+    const sessionCtxResult = await (0, session_context_helpers_1.resolveSessionContext)(ctx, validated.sessionId);
+    if (!sessionCtxResult.success)
+        return sessionCtxResult;
+    const sessionCtx = sessionCtxResult.data;
+    const { project } = sessionCtx;
+    if (!project) {
+        return {
+            success: false,
+            error: {
+                code: 'PROJECT_NOT_FOUND',
+                message: 'No project associated with this session',
+            },
+        };
+    }
+    const resolved = await (0, resolve_epic_id_1.resolveEpicId)(ctx.storage, project.id, validated.id);
+    if (!resolved.success)
+        return resolved;
+    const epicId = resolved.data.epicId;
+    let epic;
+    try {
+        epic = await ctx.storage.getEpic(epicId);
     }
+    catch (error) {
+        if (error instanceof error_types_1.NotFoundError) {
+            return {
+                success: false,
+                error: {
+                    code: 'EPIC_NOT_FOUND',
+                    message: `Epic ${epicId} was not found.`,
+                },
+            };
+        }
+        throw error;
+    }
+    if (epic.projectId !== project.id) {
+        return {
+            success: false,
+            error: {
+                code: 'EPIC_NOT_FOUND',
+                message: `Epic ${epicId} does not belong to the resolved project.`,
+            },
+        };
+    }
+    try {
+        const actor = sessionCtx.type === 'agent'
+            ? { type: 'agent', id: sessionCtx.agent.id }
+            : sessionCtx.type === 'guest'
+                ? { type: 'guest', id: sessionCtx.guest.id }
+                : null;
+        const context = { actor };
+        await ctx.epicsService.deleteEpic(epicId, context);
+    }
+    catch (error) {
+        if (error instanceof service_unavailable_error_1.ServiceUnavailableError) {
+            return {
+                success: false,
+                error: {
+                    code: 'SERVICE_UNAVAILABLE',
+                    message: 'Epic deletion requires full app context (not available in standalone MCP mode)',
+                },
+            };
+        }
+        if (error instanceof error_types_1.NotFoundError) {
+            return {
+                success: false,
+                error: {
+                    code: 'EPIC_NOT_FOUND',
+                    message: `Epic ${epicId} was not found.`,
+                },
+            };
+        }
+        throw error;
+    }
+    const response = {
+        deletedEpic: {
+            id: epic.id,
+            title: epic.title,
+            projectId: epic.projectId,
+            parentId: epic.parentId ?? null,
+            version: epic.version,
+        },
+    };
     return { success: true, data: response };
 }
 //# sourceMappingURL=epic-tools.js.map