@untools/devflow 0.2.11 → 0.2.13

package/dist/copilot/client.js

@@ -0,0 +1,226 @@
+// Copilot SDK client - Real SDK Integration
+// Uses @github/copilot-sdk for agent control
+// Reference: https://github.com/github/copilot-sdk
+import { CopilotClient as RealCopilotClient, } from "@github/copilot-sdk";
+/**
+ * CopilotClient - Wrapper for GitHub Copilot SDK
+ *
+ * This uses the real @github/copilot-sdk package installed from npm.
+ *
+ * Requirements:
+ * - GitHub Copilot CLI installed and authenticated (copilot --version)
+ * - @github/copilot-sdk package installed (npm install @github/copilot-sdk)
+ */
+export class CopilotClient {
+    constructor() {
+        this.model = "gpt-4";
+        this.eventListeners = [];
+        // Initialize the real SDK client
+        // Ensure we have authentication
+        const token = process.env.GITHUB_TOKEN || process.env.GITHUB_COPILOT_TOKEN;
+        if (!token) {
+            console.warn("⚠️ [CopilotClient] No GITHUB_TOKEN or GITHUB_COPILOT_TOKEN found in environment!");
+            console.warn("   The Copilot SDK may fail to authenticate.");
+        }
+        this.client = new RealCopilotClient({
+            // The SDK uses GITHUB_TOKEN or GH_TOKEN from env by default, but we can pass explicit auth or env.
+            // Based on demo, passing env explicitly with multiple token vars helps robustness.
+            env: {
+                ...process.env,
+                GITHUB_TOKEN: token, // Ensure it's set if we found it
+                GH_TOKEN: token,
+                COPILOT_GITHUB_TOKEN: token,
+            },
+        });
+    }
+    async createSession(options) {
+        const self = this;
+        const model = options.model || this.model;
+        console.log(`[CopilotClient] 🚀 Creating session with model: ${model}`);
+        console.log(`[CopilotClient] Streaming: ${options.streaming !== false}`);
+        if (options.tools?.length) {
+            console.log(`[CopilotClient] Tools: ${options.tools.map((t) => t.name || "unknown").join(", ")}`);
+        }
+        // Re-initialize client if a specific token is provided (e.g. from user credentials)
+        if (options.githubToken) {
+            console.log("[CopilotClient] 🔄 Re-initializing SDK with provided user token");
+            this.client = new RealCopilotClient({
+                env: {
+                    ...process.env,
+                    GITHUB_TOKEN: options.githubToken,
+                    GH_TOKEN: options.githubToken,
+                    COPILOT_GITHUB_TOKEN: options.githubToken,
+                },
+            });
+        }
+        try {
+            // Ensure client is started
+            // The SDK's start() is usually idempotent or we can check state if needed,
+            // but simplistic approach: just call it.
+            console.log("[CopilotClient] Starting SDK client...");
+            await this.client.start();
+            console.log("[CopilotClient] Verifying authentication...");
+            const authStatus = await this.client.getAuthStatus();
+            console.log(`[CopilotClient] Auth Status: ${JSON.stringify(authStatus)}`);
+            const statusAny = authStatus;
+            if (statusAny.status === "NotAuthenticated" ||
+                statusAny.status === "error" ||
+                statusAny.isAuthenticated === false) {
+                throw new Error(`Copilot Authentication Failed: ${authStatus.statusMessage || "Unknown reason"}`);
+            }
+            // Create real SDK session
+            const realSession = await this.client.createSession({
+                model,
+                streaming: options.streaming !== false,
+                tools: options.tools, // Pass undefined if not provided, allowing SDK defaults
+            });
+            // Wrap the real session to normalize event types
+            return {
+                async sendAndWait(request) {
+                    let output = "";
+                    realSession.on((event) => {
+                        // console.log(
+                        //   `[CopilotClient] Raw Event: ${event.type}`,
+                        //   JSON.stringify(event.data || {}, null, 2),
+                        // );
+                        // Wrapper to map internal types to our exported types
+                        let mappedEvent = null;
+                        switch (event.type) {
+                            case "assistant.message_delta":
+                                mappedEvent = {
+                                    type: "assistant.message_delta",
+                                    data: {
+                                        deltaContent: event.data?.deltaContent,
+                                        messageId: event.data?.messageId,
+                                    },
+                                };
+                                output += event.data?.deltaContent || "";
+                                break;
+                            case "assistant.turn_start":
+                                mappedEvent = {
+                                    type: "assistant.turn_start",
+                                    data: { turnId: event.data?.turnId },
+                                };
+                                break;
+                            case "assistant.turn_end":
+                                mappedEvent = {
+                                    type: "assistant.turn_end",
+                                    data: { turnId: event.data?.turnId },
+                                };
+                                break;
+                            case "session.usage_info":
+                                mappedEvent = {
+                                    type: "session.usage_info",
+                                    data: event.data,
+                                };
+                                break;
+                            case "session.idle":
+                                mappedEvent = { type: "session.idle" };
+                                break;
+                            case "tool.start":
+                            case "tool_start": // Fallback for older SDK versions
+                            case "tool.execution_start":
+                                mappedEvent = {
+                                    type: "tool.execution_start",
+                                    data: {
+                                        toolName: event.data?.toolName,
+                                        toolCallId: event.data?.toolCallId,
+                                        arguments: event.data?.arguments,
+                                    },
+                                };
+                                break;
+                            case "tool.end":
+                            case "tool_end":
+                            case "tool.execution_complete":
+                                mappedEvent = {
+                                    type: "tool.execution_complete",
+                                    data: {
+                                        toolCallId: event.data?.toolCallId,
+                                        result: event.data?.result,
+                                        success: event.data?.success,
+                                    },
+                                };
+                                break;
+                            case "error":
+                            case "session.error":
+                                mappedEvent = {
+                                    type: "error",
+                                    data: { message: event.data?.message || "Unknown error" },
+                                };
+                                break;
+                        }
+                        if (mappedEvent) {
+                            self.eventListeners.forEach((listener) => listener(mappedEvent));
+                        }
+                    });
+                    console.log(`[CopilotClient] Sending Prompt: ${request.prompt.substring(0, 50)}...`);
+                    try {
+                        // Increase timeout to 10 minutes for complex workflows
+                        // The SDK's default 60s is too short for comprehensive tasks
+                        const response = await realSession.sendAndWait(request, 600000); // 10 min timeout
+                        console.log(`[CopilotClient] Final Response:`, JSON.stringify(response, null, 2));
+                        return response;
+                    }
+                    catch (err) {
+                        // Check if it's a timeout error
+                        const isTimeout = err instanceof Error &&
+                            err.message.includes("Timeout after") &&
+                            err.message.includes("waiting for session.idle");
+                        if (isTimeout) {
+                            console.warn(`[CopilotClient] Session timed out after 10 minutes, but workflow may still` +
+                                ` be running. The session will continue in the background.`);
+                            // Don't throw - allow the workflow to continue and send completion when done
+                            // The `send_progress_update` tool will handle final status
+                            return {
+                                output,
+                                warning: "Workflow timed out but may still complete",
+                            };
+                        }
+                        console.error(`[CopilotClient] sendAndWait failed:`, err);
+                        throw err;
+                    }
+                },
+                on(callback) {
+                    self.eventListeners.push(callback);
+                },
+            };
+        }
+        catch (error) {
+            console.error("[CopilotClient] Failed to create session:", error);
+            throw error;
+        }
+    }
+    async stop() {
+        console.log("[CopilotClient] Stopping session...");
+        // Real SDK cleanup if needed
+    }
+}
+let copilotInstance = null;
+export function getCopilotClient() {
+    if (!copilotInstance) {
+        copilotInstance = new CopilotClient();
+    }
+    return copilotInstance;
+}
+/**
+ * Tool Definition Helper
+ * Creates Copilot SDK-compatible tool definitions
+ *
+ * Example:
+ * const gitTool = defineTool("git_ops", {
+ *   description: "Execute git operations",
+ *   parameters: {
+ *     type: "object",
+ *     properties: { ... },
+ *     required: [...]
+ *   },
+ *   handler: async (args) => ({ ... })
+ * });
+ */
+export function defineTool(name, definition) {
+    return {
+        name,
+        ...definition,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/copilot/client.js.map

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

package/dist/copilot/flows/base.d.ts

@@ -0,0 +1,47 @@
+import { CopilotClient, Session } from "../client.js";
+import DevflowClient from "../../devflow/client.js";
+export interface WorkflowContext {
+    taskId: string;
+    intent: string;
+    repo: string;
+    localPath?: string;
+    branch?: string;
+    naturalLanguage: string;
+    context?: Record<string, any>;
+    source: {
+        channel: "telegram" | "slack" | "cli";
+        chatId: string;
+        messageId: string;
+    };
+    credentials?: {
+        github?: string;
+    };
+    sessionId?: string;
+    localGitHubToken?: string;
+}
+export interface WorkflowResult {
+    success: boolean;
+    output?: string;
+    prUrl?: string;
+    summary?: string;
+    error?: string;
+}
+export declare class WorkflowExecutor {
+    protected devflowClient: DevflowClient;
+    protected copilot: CopilotClient;
+    protected devflowConfig: {
+        url: string;
+        secret: string;
+    };
+    private progressUpdateCount;
+    private readonly ESTIMATED_MAX_UPDATES;
+    private readonly MAX_AUTO_PROGRESS;
+    constructor(devflowUrl: string, devflowSecret: string);
+    protected sendProgress(taskId: string, step: string, progress: number, details?: string): Promise<void>;
+    protected sendCompletion(taskId: string, result: WorkflowResult): Promise<void>;
+    protected buildSystemPrompt(intent: string, context: WorkflowContext): string;
+    protected setupSession(context: WorkflowContext): Promise<Session>;
+    protected executeWorkflow(prompt: string, context: WorkflowContext): Promise<WorkflowResult>;
+    execute(context: WorkflowContext): Promise<WorkflowResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/copilot/flows/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/copilot/flows/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AAEpE,OAAO,aAAa,MAAM,yBAAyB,CAAC;AAGpD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,MAAM,EAAE;QACN,OAAO,EAAE,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;QACtC,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAgB;IAC3B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC;IACjC,SAAS,CAAC,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAGzD,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAM;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;gBAE9B,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;cAMrC,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;cAkBA,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;IA4BhB,SAAS,CAAC,iBAAiB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,MAAM;cA0BO,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;cA2ExD,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC;IA4IpB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAGjE"}

package/dist/copilot/flows/base.js

@@ -0,0 +1,235 @@
+// Workflow executor base and orchestration logic
+import { CopilotClient } from "../client.js";
+import DevflowClient from "../../devflow/client.js";
+import { getAllTools } from "../tools/index.js";
+export class WorkflowExecutor {
+    constructor(devflowUrl, devflowSecret) {
+        // Auto-incrementing progress tracking
+        this.progressUpdateCount = 0;
+        this.ESTIMATED_MAX_UPDATES = 30; // Rough estimate of updates per workflow
+        this.MAX_AUTO_PROGRESS = 0.95; // Cap at 95%, leave 5% for completion
+        this.devflowConfig = { url: devflowUrl, secret: devflowSecret };
+        this.devflowClient = new DevflowClient(devflowUrl, devflowSecret);
+        this.copilot = new CopilotClient(); // Will be replaced with actual SDK when available
+    }
+    async sendProgress(taskId, step, progress, details) {
+        // Auto-increment progress instead of using Copilot's arbitrary values
+        this.progressUpdateCount++;
+        const autoProgress = Math.min(this.MAX_AUTO_PROGRESS, this.progressUpdateCount / this.ESTIMATED_MAX_UPDATES);
+        await this.devflowClient.sendProgressUpdate({
+            taskId,
+            status: "in_progress",
+            step,
+            progress: autoProgress, // Use calculated progress instead of Copilot's value
+            details,
+            timestamp: Date.now(),
+        });
+    }
+    async sendCompletion(taskId, result) {
+        console.log(`[WorkflowExecutor] Sending completion for ${taskId}, success: ${result.success}`);
+        try {
+            if (result.success) {
+                await this.devflowClient.notifyCompletion(taskId, {
+                    summary: result.summary || "Workflow completed successfully",
+                    prUrl: result.prUrl,
+                    output: result.output,
+                });
+                console.log(`[WorkflowExecutor] Completion notification sent for ${taskId}`);
+            }
+            else {
+                await this.devflowClient.notifyError(taskId, result.error || "Workflow failed");
+                console.log(`[WorkflowExecutor] Error notification sent for ${taskId}`);
+            }
+        }
+        catch (error) {
+            console.error(`[WorkflowExecutor] Failed to send completion notification: ${error}`);
+        }
+    }
+    buildSystemPrompt(intent, context) {
+        return `You are Devflow, an AI DevOps agent integrated with GitHub Copilot.
+
+Your task: ${intent}
+Repository: ${context.repo}
+Branch: ${context.branch || "main"}
+Request: ${context.naturalLanguage}
+Task ID: ${context.taskId}
+
+You have access to these tools:
+- git_operations: Clone, branch, commit, push repositories
+- run_tests: Run test suites and capture results
+- read_file, write_file, list_files: File operations
+- open_pull_request: Create and manage pull requests
+- send_progress_update: Send progress updates to the user
+
+IMPORTANT:
+1. Always send progress updates at key milestones
+2. Use read_file to examine code before making changes
+3. Verify changes with run_tests before pushing
+4. Create pull requests with clear descriptions
+5. Report all errors clearly with context
+
+Begin by understanding the repository structure.`;
+    }
+    async setupSession(context) {
+        try {
+            // Check for existing session
+            if (context.sessionId) {
+                const { SessionRegistry } = await import("../session-registry.js");
+                const existingSession = SessionRegistry.get(context.sessionId);
+                if (existingSession) {
+                    return existingSession;
+                }
+            }
+            // Determine GitHub token source (Priority: local > platform > env)
+            let userGitHubToken;
+            // 1. Check local config token (most secure, recommended)
+            if (context.localGitHubToken) {
+                userGitHubToken = context.localGitHubToken;
+                console.log("[Workflow] Using local GitHub token from config");
+            }
+            // 2. Try platform-provided encrypted credentials (legacy/SaaS mode)
+            else if (context.credentials?.github) {
+                try {
+                    const { decryptCredentials } = await import("../../credentials.js");
+                    const decrypted = decryptCredentials(context.credentials);
+                    userGitHubToken = decrypted.github;
+                    console.log("[Workflow] Using decrypted user credentials (managed SaaS)");
+                }
+                catch (error) {
+                    console.warn("[Workflow] Failed to decrypt credentials, falling back to env var:", error instanceof Error ? error.message : error);
+                }
+            }
+            // 3. Fall back to environment variable
+            else {
+                console.log("[Workflow] No local token or platform credentials. Using GITHUB_TOKEN from environment (if set)");
+            }
+            const session = await this.copilot.createSession({
+                model: process.env.COPILOT_MODEL || "gpt-3.5-turbo",
+                streaming: true,
+                tools: getAllTools({
+                    githubToken: userGitHubToken,
+                    localPath: context.localPath,
+                    devflowUrl: this.devflowConfig.url,
+                    devflowSecret: this.devflowConfig.secret,
+                }),
+                githubToken: userGitHubToken,
+                mcpServers: process.env.COPILOT_ENABLE_MCP === "true"
+                    ? {
+                        github: {
+                            type: "http",
+                            url: "https://api.github.com/mcp/",
+                        },
+                    }
+                    : undefined,
+            });
+            // Register new session if ID provided
+            if (context.sessionId) {
+                const { SessionRegistry } = await import("../session-registry.js");
+                SessionRegistry.register(context.sessionId, session);
+            }
+            return session;
+        }
+        catch (error) {
+            throw new Error(`Failed to create Copilot session: ${error}`);
+        }
+    }
+    async executeWorkflow(prompt, context) {
+        try {
+            // Reset progress counter for this workflow
+            this.progressUpdateCount = 0;
+            const session = await this.setupSession(context);
+            this.devflowClient.sendLog(context.taskId, "info", `Starting workflow execution for task: ${context.intent}`);
+            this.devflowClient.sendLog(context.taskId, "info", `Context: Repo=${context.repo}, Branch=${context.branch || "default"}, LocalPath=${context.localPath || "N/A"}`);
+            let output = "";
+            let hasError = false;
+            let errorMessage = "";
+            // Listen for session events
+            let pendingDeltaBuffer = "";
+            let lastProgressUpdate = 0;
+            const PROGRESS_THROTTLE_MS = 2000; // Throttle text updates to every 2s
+            session.on((event) => {
+                // console.log(`[${context.taskId}] Event:`, event.type); // Debug logging
+                if (event.type === "tool.execution_start" ||
+                    event.type === "tool.start") {
+                    const toolName = event.data?.toolName || "unknown";
+                    console.log(`[${context.taskId}] Tool Start: ${toolName}`);
+                    // Flush any pending text before announcing tool start
+                    if (pendingDeltaBuffer.trim().length > 0) {
+                        this.sendProgress(context.taskId, pendingDeltaBuffer, // Send the accumulated text as the "step" description/output
+                        0.3).catch(console.error);
+                        pendingDeltaBuffer = "";
+                    }
+                    this.sendProgress(context.taskId, `Executing: ${toolName}`, 0.3).catch(console.error);
+                }
+                if (event.type === "tool.execution_complete" ||
+                    event.type === "tool.end") {
+                    const result = event.data?.result;
+                    console.log(`[${context.taskId}] Tool Result:`, JSON.stringify(result).substring(0, 100) + "...");
+                    // We don't send a separate update for tool end to avoid noise, unless it failed
+                }
+                if (event.type === "assistant.message_delta") {
+                    const chunk = event.data?.deltaContent || "";
+                    output += chunk;
+                    pendingDeltaBuffer += chunk;
+                    // Periodically flush buffer to keep user engaged if response is long
+                    const now = Date.now();
+                    if (now - lastProgressUpdate > PROGRESS_THROTTLE_MS &&
+                        pendingDeltaBuffer.length > 20) {
+                        // Send what we have so far
+                        // Note: In a real streaming architecture, we'd append.
+                        // Here we are updating the "step" which might overwrite previous "step" text in UI
+                        // depending on how frontend handles it.
+                        // For "smart batching" in a chat context, we mainly want to avoid network spam.
+                        this.sendProgress(context.taskId, pendingDeltaBuffer, // Update current "step" with latest text chunk
+                        0.4).catch(console.error);
+                        lastProgressUpdate = now;
+                        // We keep buffer growing? Or reset?
+                        // If we reset, the UI might see "..." -> "Hello" -> "World".
+                        // If the UI replaces the text, we should probably send the *accumulated* buffer for this turn if possible,
+                        // or just send the delta if the UI appends.
+                        // Assuming the UI replaces "step" description:
+                        // Let's NOT reset buffer here if we want to show full message building up in the "step" field.
+                        // But pendingDeltaBuffer is meant to be "whats new".
+                        // Let's assume the UI shows a log or chat bubble.
+                        // To be safe, we just throttle.
+                        // Actually, flushing effectively clears the "pending" state for the *next* update.
+                        pendingDeltaBuffer = "";
+                    }
+                }
+                if (event.type === "session.usage_info") {
+                    console.log(`[${context.taskId}] Token Usage: ${event.data?.currentTokens}/${event.data?.tokenLimit}`);
+                }
+                if (event.type === "error") {
+                    hasError = true;
+                    errorMessage = event.data?.message || "Unknown error";
+                    console.error(`[${context.taskId}] Error:`, errorMessage);
+                }
+            });
+            // Send the workflow prompt
+            await session.sendAndWait({ prompt });
+            if (hasError) {
+                return {
+                    success: false,
+                    error: errorMessage,
+                    output,
+                };
+            }
+            return {
+                success: true,
+                output,
+                summary: "Workflow completed successfully",
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                error: errorMsg,
+            };
+        }
+    }
+    async execute(context) {
+        throw new Error("execute() must be implemented by subclasses");
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/copilot/flows/base.js.map

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

package/dist/copilot/flows/explain.d.ts

@@ -0,0 +1,5 @@
+import { WorkflowExecutor, WorkflowContext, WorkflowResult } from "./base.js";
+export declare class ExplainWorkflow extends WorkflowExecutor {
+    execute(context: WorkflowContext): Promise<WorkflowResult>;
+}
+//# sourceMappingURL=explain.d.ts.map

package/dist/copilot/flows/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/copilot/flows/explain.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE9E,qBAAa,eAAgB,SAAQ,gBAAgB;IAC7C,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAuFjE"}

package/dist/copilot/flows/explain.js

@@ -0,0 +1,76 @@
+// Code Explanation Workflow
+// Explains code, architecture, or specific features
+import { WorkflowExecutor } from "./base.js";
+export class ExplainWorkflow extends WorkflowExecutor {
+    async execute(context) {
+        try {
+            await this.sendProgress(context.taskId, "Starting code explanation workflow", 0.05);
+            const systemPrompt = `You are Devflow, an expert code explanation assistant.
+
+Your task: Provide clear, comprehensive explanations of code, architecture, or features.
+Repository: ${context.repo}
+Request: ${context.naturalLanguage}
+
+You have access to these tools:
+- git_operations: Clone repositories
+- read_file: Read source code files
+- list_files: List files in the repository
+- send_progress_update: Send updates to the user
+
+IMPORTANT:
+1. Clone the repository first
+2. Examine the relevant code files
+3. Provide clear, well-structured explanations
+4. Include code examples where helpful
+5. Explain design patterns and architectural decisions
+6. Mention dependencies and how they're used
+7. Send progress updates as you explore
+`;
+            const userPrompt = `
+Please explain the following:
+
+${context.naturalLanguage}
+
+${context.context?.files ? `Focus on these files:\n${context.context.files}` : ""}
+${context.context?.focusArea ? `Focus area: ${context.context.focusArea}` : ""}
+
+Follow these steps:
+1. Clone the repository
+2. List the directory structure to understand the layout
+3. Identify the relevant files for this explanation
+4. Read and analyze the code
+5. Provide a comprehensive explanation that includes:
+   - What the code does
+   - How it works
+   - Key components and their relationships
+   - Important design decisions
+   - Dependencies and external integrations
+   - Examples of usage
+6. Send a progress update with the complete explanation
+
+Format your explanation clearly with:
+- Headings for different sections
+- Code snippets for important parts
+- Clear descriptions of flow and logic
+- Diagrams or ASCII art if helpful (use markdown code blocks)
+`;
+            const result = await this.executeWorkflow(`${systemPrompt}\n\n${userPrompt}`, context);
+            if (result.success) {
+                await this.sendProgress(context.taskId, "Explanation complete", 1.0, "Code explanation has been prepared and sent");
+            }
+            return result;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            await this.sendCompletion(context.taskId, {
+                success: false,
+                error: errorMsg,
+            });
+            return {
+                success: false,
+                error: errorMsg,
+            };
+        }
+    }
+}
+//# sourceMappingURL=explain.js.map

package/dist/copilot/flows/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/copilot/flows/explain.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,oDAAoD;AACpD,OAAO,EAAE,gBAAgB,EAAmC,MAAM,WAAW,CAAC;AAE9E,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD,KAAK,CAAC,OAAO,CAAC,OAAwB;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CACrB,OAAO,CAAC,MAAM,EACd,oCAAoC,EACpC,IAAI,CACL,CAAC;YAEF,MAAM,YAAY,GAAG;;;cAGb,OAAO,CAAC,IAAI;WACf,OAAO,CAAC,eAAe;;;;;;;;;;;;;;;;CAgBjC,CAAC;YAEI,MAAM,UAAU,GAAG;;;EAGvB,OAAO,CAAC,eAAe;;EAEvB,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,0BAA0B,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;EAC/E,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,eAAe,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;CAqB7E,CAAC;YAEI,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CACvC,GAAG,YAAY,OAAO,UAAU,EAAE,EAClC,OAAO,CACR,CAAC;YAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,IAAI,CAAC,YAAY,CACrB,OAAO,CAAC,MAAM,EACd,sBAAsB,EACtB,GAAG,EACH,6CAA6C,CAC9C,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxE,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE;gBACxC,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,QAAQ;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/copilot/flows/feature.d.ts

@@ -0,0 +1,5 @@
+import { WorkflowExecutor, WorkflowContext, WorkflowResult } from "./base.js";
+export declare class FeatureWorkflow extends WorkflowExecutor {
+    execute(context: WorkflowContext): Promise<WorkflowResult>;
+}
+//# sourceMappingURL=feature.d.ts.map

package/dist/copilot/flows/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../src/copilot/flows/feature.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE9E,qBAAa,eAAgB,SAAQ,gBAAgB;IAC7C,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAgGjE"}