devchain-cli 0.23.2 → 0.23.4

package/dist/server/modules/mcp/dtos/mcp.dto.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import type { SyncResult } from '../../skills/services/skill-sync.types';
 export declare const PROJECT_ID_PREFIX_PATTERN: RegExp;
 export declare const CreateRecordParamsSchema: z.ZodObject<{
     epicId: z.ZodString;
@@ -87,120 +88,6 @@ export declare const RemoveTagsParamsSchema: z.ZodObject<{
     id: string;
 }>;
 export type RemoveTagsParams = z.infer<typeof RemoveTagsParamsSchema>;
-export declare const ListDocumentsParamsSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    q: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    offset: z.ZodOptional<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    sessionId: string;
-    tags?: string[] | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-    q?: string | undefined;
-}, {
-    sessionId: string;
-    tags?: string[] | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-    q?: string | undefined;
-}>;
-export type ListDocumentsParams = z.infer<typeof ListDocumentsParamsSchema>;
-export declare const GetDocumentParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    projectId: z.ZodOptional<z.ZodString>;
-    slug: z.ZodOptional<z.ZodString>;
-    includeLinks: z.ZodOptional<z.ZodEnum<["none", "meta", "inline"]>>;
-    maxDepth: z.ZodOptional<z.ZodNumber>;
-    maxBytes: z.ZodOptional<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    id?: string | undefined;
-    projectId?: string | undefined;
-    slug?: string | undefined;
-    maxBytes?: number | undefined;
-    includeLinks?: "none" | "meta" | "inline" | undefined;
-    maxDepth?: number | undefined;
-}, {
-    id?: string | undefined;
-    projectId?: string | undefined;
-    slug?: string | undefined;
-    maxBytes?: number | undefined;
-    includeLinks?: "none" | "meta" | "inline" | undefined;
-    maxDepth?: number | undefined;
-}>, {
-    id?: string | undefined;
-    projectId?: string | undefined;
-    slug?: string | undefined;
-    maxBytes?: number | undefined;
-    includeLinks?: "none" | "meta" | "inline" | undefined;
-    maxDepth?: number | undefined;
-}, {
-    id?: string | undefined;
-    projectId?: string | undefined;
-    slug?: string | undefined;
-    maxBytes?: number | undefined;
-    includeLinks?: "none" | "meta" | "inline" | undefined;
-    maxDepth?: number | undefined;
-}>, {
-    id?: string | undefined;
-    projectId?: string | undefined;
-    slug?: string | undefined;
-    maxBytes?: number | undefined;
-    includeLinks?: "none" | "meta" | "inline" | undefined;
-    maxDepth?: number | undefined;
-}, {
-    id?: string | undefined;
-    projectId?: string | undefined;
-    slug?: string | undefined;
-    maxBytes?: number | undefined;
-    includeLinks?: "none" | "meta" | "inline" | undefined;
-    maxDepth?: number | undefined;
-}>;
-export type GetDocumentParams = z.infer<typeof GetDocumentParamsSchema>;
-export declare const CreateDocumentParamsSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    title: z.ZodString;
-    contentMd: z.ZodString;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strict", z.ZodTypeAny, {
-    title: string;
-    sessionId: string;
-    contentMd: string;
-    tags?: string[] | undefined;
-}, {
-    title: string;
-    sessionId: string;
-    contentMd: string;
-    tags?: string[] | undefined;
-}>;
-export type CreateDocumentParams = z.infer<typeof CreateDocumentParamsSchema>;
-export declare const UpdateDocumentParamsSchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodOptional<z.ZodString>;
-    slug: z.ZodOptional<z.ZodString>;
-    contentMd: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    archived: z.ZodOptional<z.ZodBoolean>;
-    version: z.ZodOptional<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    id: string;
-    tags?: string[] | undefined;
-    title?: string | undefined;
-    version?: number | undefined;
-    slug?: string | undefined;
-    archived?: boolean | undefined;
-    contentMd?: string | undefined;
-}, {
-    id: string;
-    tags?: string[] | undefined;
-    title?: string | undefined;
-    version?: number | undefined;
-    slug?: string | undefined;
-    archived?: boolean | undefined;
-    contentMd?: string | undefined;
-}>;
-export type UpdateDocumentParams = z.infer<typeof UpdateDocumentParamsSchema>;
 export declare const ListPromptsParamsSchema: z.ZodObject<{
     sessionId: z.ZodString;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -257,18 +144,21 @@ export declare const ListEpicsParamsSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     q: z.ZodOptional<z.ZodString>;
+    includeDescription: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     sessionId: string;
     limit?: number | undefined;
     offset?: number | undefined;
     statusName?: string | undefined;
     q?: string | undefined;
+    includeDescription?: boolean | undefined;
 }, {
     sessionId: string;
     limit?: number | undefined;
     offset?: number | undefined;
     statusName?: string | undefined;
     q?: string | undefined;
+    includeDescription?: boolean | undefined;
 }>;
 export type ListEpicsParams = z.infer<typeof ListEpicsParamsSchema>;
 export declare const ListAssignedEpicsTasksParamsSchema: z.ZodObject<{
@@ -288,7 +178,7 @@ export declare const ListAssignedEpicsTasksParamsSchema: z.ZodObject<{
     offset?: number | undefined;
 }>;
 export type ListAssignedEpicsTasksParams = z.infer<typeof ListAssignedEpicsTasksParamsSchema>;
-export declare const CreateEpicParamsSchema: z.ZodObject<{
+export declare const CreateEpicParamsSchema: z.ZodEffects<z.ZodObject<{
     sessionId: z.ZodString;
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -307,11 +197,59 @@ export declare const CreateEpicParamsSchema: z.ZodObject<{
         relatedEpicId: string;
         relation: "related" | "blocks" | "blocked_by";
     }>>;
+    relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        relatedEpicId: z.ZodString;
+        relation: z.ZodEnum<["related", "blocks", "blocked_by"]>;
+    }, "strict", z.ZodTypeAny, {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    }, {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     title: string;
     sessionId: string;
     tags?: string[] | undefined;
     description?: string | undefined;
+    relations?: {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    }[] | undefined;
+    agentName?: string | undefined;
+    parentId?: string | undefined;
+    statusName?: string | undefined;
+    skillsRequired?: string[] | undefined;
+    relation?: {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    } | undefined;
+}, {
+    title: string;
+    sessionId: string;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    relations?: {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    }[] | undefined;
+    agentName?: string | undefined;
+    parentId?: string | undefined;
+    statusName?: string | undefined;
+    skillsRequired?: string[] | undefined;
+    relation?: {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    } | undefined;
+}>, {
+    title: string;
+    sessionId: string;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    relations?: {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    }[] | undefined;
     agentName?: string | undefined;
     parentId?: string | undefined;
     statusName?: string | undefined;
@@ -325,6 +263,10 @@ export declare const CreateEpicParamsSchema: z.ZodObject<{
     sessionId: string;
     tags?: string[] | undefined;
     description?: string | undefined;
+    relations?: {
+        relatedEpicId: string;
+        relation: "related" | "blocks" | "blocked_by";
+    }[] | undefined;
     agentName?: string | undefined;
     parentId?: string | undefined;
     statusName?: string | undefined;
@@ -338,12 +280,15 @@ export type CreateEpicParams = z.infer<typeof CreateEpicParamsSchema>;
 export declare const GetEpicByIdParamsSchema: z.ZodObject<{
     sessionId: z.ZodString;
     id: z.ZodString;
+    includeParentDescription: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     id: string;
     sessionId: string;
+    includeParentDescription?: boolean | undefined;
 }, {
     id: string;
     sessionId: string;
+    includeParentDescription?: boolean | undefined;
 }>;
 export type GetEpicByIdParams = z.infer<typeof GetEpicByIdParamsSchema>;
 export declare const EpicRelationsListParamsSchema: z.ZodObject<{
@@ -428,12 +373,34 @@ export declare const AddEpicCommentParamsSchema: z.ZodObject<{
     sessionId: string;
 }>;
 export type AddEpicCommentParams = z.infer<typeof AddEpicCommentParamsSchema>;
-export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+export declare const EpicDescriptionEditInputSchema: z.ZodObject<{
+    find: z.ZodString;
+    replace: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    find: string;
+    replace: string;
+}, {
+    find: string;
+    replace: string;
+}>;
+export type EpicDescriptionEditInput = z.infer<typeof EpicDescriptionEditInputSchema>;
+export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
     sessionId: z.ZodString;
     id: z.ZodString;
     version: z.ZodNumber;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
+    descriptionEdits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        find: z.ZodString;
+        replace: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        find: string;
+        replace: string;
+    }, {
+        find: string;
+        replace: string;
+    }>, "many">>;
+    appendDescription: z.ZodOptional<z.ZodString>;
     statusName: z.ZodOptional<z.ZodString>;
     assignment: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         agentName: z.ZodString;
@@ -467,6 +434,53 @@ export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObje
     parentId?: string | undefined;
     statusName?: string | undefined;
     skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
+    assignment?: {
+        agentName: string;
+    } | {
+        clear: true;
+    } | undefined;
+    clearParent?: boolean | undefined;
+    setTags?: string[] | undefined;
+    addTags?: string[] | undefined;
+    removeTags?: string[] | undefined;
+}, {
+    id: string;
+    version: number;
+    sessionId: string;
+    description?: string | undefined;
+    title?: string | undefined;
+    parentId?: string | undefined;
+    statusName?: string | undefined;
+    skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
+    assignment?: unknown;
+    clearParent?: boolean | undefined;
+    setTags?: string[] | undefined;
+    addTags?: string[] | undefined;
+    removeTags?: string[] | undefined;
+}>, {
+    id: string;
+    version: number;
+    sessionId: string;
+    description?: string | undefined;
+    title?: string | undefined;
+    parentId?: string | undefined;
+    statusName?: string | undefined;
+    skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
     assignment?: {
         agentName: string;
     } | {
@@ -485,6 +499,11 @@ export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObje
     parentId?: string | undefined;
     statusName?: string | undefined;
     skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
     assignment?: unknown;
     clearParent?: boolean | undefined;
     setTags?: string[] | undefined;
@@ -499,6 +518,11 @@ export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObje
     parentId?: string | undefined;
     statusName?: string | undefined;
     skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
     assignment?: {
         agentName: string;
     } | {
@@ -517,6 +541,11 @@ export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObje
     parentId?: string | undefined;
     statusName?: string | undefined;
     skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
     assignment?: unknown;
     clearParent?: boolean | undefined;
     setTags?: string[] | undefined;
@@ -531,6 +560,11 @@ export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObje
     parentId?: string | undefined;
     statusName?: string | undefined;
     skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
     assignment?: {
         agentName: string;
     } | {
@@ -549,6 +583,11 @@ export declare const UpdateEpicParamsSchema: z.ZodEffects<z.ZodEffects<z.ZodObje
     parentId?: string | undefined;
     statusName?: string | undefined;
     skillsRequired?: string[] | undefined;
+    descriptionEdits?: {
+        find: string;
+        replace: string;
+    }[] | undefined;
+    appendDescription?: string | undefined;
     assignment?: unknown;
     clearParent?: boolean | undefined;
     setTags?: string[] | undefined;
@@ -607,22 +646,28 @@ export type GetPromptParams = z.infer<typeof GetPromptParamsSchema>;
 export declare const listSkillsSchema: z.ZodObject<{
     sessionId: z.ZodString;
     q: z.ZodOptional<z.ZodString>;
+    includeDisabled: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     sessionId: string;
     q?: string | undefined;
+    includeDisabled?: boolean | undefined;
 }, {
     sessionId: string;
     q?: string | undefined;
+    includeDisabled?: boolean | undefined;
 }>;
 export declare const ListSkillsParamsSchema: z.ZodObject<{
     sessionId: z.ZodString;
     q: z.ZodOptional<z.ZodString>;
+    includeDisabled: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     sessionId: string;
     q?: string | undefined;
+    includeDisabled?: boolean | undefined;
 }, {
     sessionId: string;
     q?: string | undefined;
+    includeDisabled?: boolean | undefined;
 }>;
 export type ListSkillsParams = z.infer<typeof listSkillsSchema>;
 export declare const getSkillSchema: z.ZodObject<{
@@ -646,6 +691,108 @@ export declare const GetSkillParamsSchema: z.ZodObject<{
     slug: string;
 }>;
 export type GetSkillParams = z.infer<typeof getSkillSchema>;
+export declare const skillsUsageStatsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    from?: string | undefined;
+    to?: string | undefined;
+}, {
+    sessionId: string;
+    from?: string | undefined;
+    to?: string | undefined;
+}>;
+export declare const SkillsUsageStatsParamsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    from?: string | undefined;
+    to?: string | undefined;
+}, {
+    sessionId: string;
+    from?: string | undefined;
+    to?: string | undefined;
+}>;
+export type SkillsUsageStatsParams = z.infer<typeof skillsUsageStatsSchema>;
+export declare const skillsSetEnabledSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    slugs: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">;
+    enabled: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    enabled: boolean;
+    slugs: string[];
+}, {
+    sessionId: string;
+    enabled: boolean;
+    slugs: string[];
+}>;
+export declare const SkillsSetEnabledParamsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    slugs: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">;
+    enabled: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    enabled: boolean;
+    slugs: string[];
+}, {
+    sessionId: string;
+    enabled: boolean;
+    slugs: string[];
+}>;
+export type SkillsSetEnabledParams = z.infer<typeof skillsSetEnabledSchema>;
+export declare const skillsSetSourceEnabledSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    sourceName: z.ZodString;
+    enabled: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    enabled: boolean;
+    sourceName: string;
+}, {
+    sessionId: string;
+    enabled: boolean;
+    sourceName: string;
+}>;
+export declare const SkillsSetSourceEnabledParamsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    sourceName: z.ZodString;
+    enabled: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    enabled: boolean;
+    sourceName: string;
+}, {
+    sessionId: string;
+    enabled: boolean;
+    sourceName: string;
+}>;
+export type SkillsSetSourceEnabledParams = z.infer<typeof skillsSetSourceEnabledSchema>;
+export declare const skillsSyncSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    sourceName: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    sourceName?: string | undefined;
+}, {
+    sessionId: string;
+    sourceName?: string | undefined;
+}>;
+export declare const SkillsSyncParamsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    sourceName: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    sourceName?: string | undefined;
+}, {
+    sessionId: string;
+    sourceName?: string | undefined;
+}>;
+export type SkillsSyncParams = z.infer<typeof skillsSyncSchema>;
 export declare const McpToolCallSchema: z.ZodObject<{
     tool: z.ZodString;
     params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -713,52 +860,6 @@ export interface RemoveTagsResponse {
     id: string;
     version: number;
 }
-export interface DocumentSummary {
-    id: string;
-    projectId: string | null;
-    title: string;
-    slug: string;
-    tags: string[];
-    archived: boolean;
-    version: number;
-    updatedAt: string;
-}
-export interface DocumentDetail extends DocumentSummary {
-    contentMd: string;
-    createdAt: string;
-}
-export interface DocumentLinkMeta {
-    slug: string;
-    title?: string;
-    id?: string;
-    projectId?: string | null;
-    exists: boolean;
-}
-export interface DocumentInlineResolution {
-    contentMd: string;
-    depthUsed: number;
-    bytes: number;
-    truncated: boolean;
-}
-export interface ListDocumentsResponse {
-    documents: DocumentSummary[];
-    total: number;
-    limit: number;
-    offset: number;
-}
-export interface GetDocumentResponse {
-    document: DocumentDetail;
-    links: DocumentLinkMeta[];
-    resolved?: DocumentInlineResolution;
-}
-export interface CreateDocumentResponse {
-    id: string;
-    version: number;
-}
-export interface UpdateDocumentResponse {
-    id: string;
-    version: number;
-}
 export interface PromptSummary {
     id: string;
     projectId: string | null;
@@ -769,7 +870,7 @@ export interface PromptSummary {
     createdAt: string;
     updatedAt: string;
 }
-export interface PromptDetail extends PromptSummary {
+export interface PromptDetail extends Omit<PromptSummary, 'contentPreview'> {
     content: string;
 }
 export interface ListPromptsResponse {
@@ -782,6 +883,10 @@ export interface GetPromptResponse {
 export interface SkillListItem {
     slug: string;
     description: string;
+    disabled?: boolean;
+    skillDisabled?: boolean;
+    sourceProjectEnabled?: boolean;
+    sourceGloballyEnabled?: boolean;
 }
 export interface ListSkillsResponse {
     skills: SkillListItem[];
@@ -800,6 +905,42 @@ export interface GetSkillResponse {
     status: 'available' | 'outdated' | 'sync_error';
     frontmatter: Record<string, unknown> | null;
 }
+export interface SkillsUsageStatsSummaryDto {
+    totalEvents: number;
+    distinctSkills: number;
+    firstEventAt: string | null;
+    lastEventAt: string | null;
+}
+export interface SkillUsageStatItem {
+    slug: string;
+    name: string | null;
+    displayName: string | null;
+    usageCount: number;
+    firstAccessedAt: string | null;
+    lastAccessedAt: string | null;
+}
+export interface SkillEpicReferenceItem {
+    slug: string;
+    total: number;
+    byStatus: Record<string, number>;
+}
+export interface SkillsUsageStatsResponse {
+    summary: SkillsUsageStatsSummaryDto;
+    complete: true;
+    skills: SkillUsageStatItem[];
+    epicReferences: SkillEpicReferenceItem[];
+}
+export interface SkillsSetEnabledResponse {
+    updatedCount: number;
+    unchanged: string[];
+    notFound: string[];
+}
+export interface SkillsSetSourceEnabledResponse {
+    name: string;
+    projectId: string;
+    projectEnabled: boolean;
+}
+export type SkillsSyncResponse = SyncResult;
 export interface AgentSummary {
     id: string;
     name: string;
@@ -818,11 +959,6 @@ export interface InstructionsResolved {
     contentMd: string;
     bytes: number;
     truncated: boolean;
-    docs: {
-        id: string;
-        slug: string;
-        title: string;
-    }[];
     prompts: {
         id: string;
         title: string;
@@ -885,13 +1021,23 @@ export interface EpicSummary {
     skillsRequired?: string[];
     subEpics?: EpicChildSummary[];
 }
+export type EpicListItem = Omit<EpicSummary, 'description'> & {
+    description?: string | null;
+    descriptionPreview?: string | null;
+    descriptionLength?: number;
+};
 export interface ListEpicsResponse {
+    epics: EpicListItem[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface ListAssignedEpicsTasksResponse {
     epics: EpicSummary[];
     total: number;
     limit: number;
     offset: number;
 }
-export type ListAssignedEpicsTasksResponse = ListEpicsResponse;
 export interface EpicChildSummary {
     id: string;
     title: string;
@@ -900,7 +1046,8 @@ export interface EpicChildSummary {
 export interface EpicParentSummary {
     id: string;
     title: string;
-    description: string | null;
+    description?: string | null;
+    status?: string;
     agentName?: string | null;
 }
 export interface EpicCommentSummary {
@@ -930,6 +1077,14 @@ export interface UpdateEpicResponse {
     id: string;
     version: number;
     hint?: string;
+    descriptionEdits?: Array<{
+        index: number;
+        context: string;
+    }>;
+    appended?: {
+        context: string;
+    };
+    descriptionLength?: number;
 }
 export interface DeleteEpicResponse {
     id: string;