@plusplusoneplusplus/coc 1.0.0

package/dist/server/executors/base-executor.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Base Executor
+ *
+ * Abstract base class that owns the shared streaming/cancellation plumbing
+ * used by all execution modes. Concrete executors (e.g. CLITaskExecutor)
+ * extend this class and add execution-mode-specific logic on top.
+ *
+ * Responsibilities:
+ * - Streaming lifecycle: chunk accumulation, throttled flush, timeline buffering
+ * - Cancellation token management (cancelledTasks set)
+ * - Tool-event capture (building the onToolEvent handler)
+ * - Output file management (writing streamed output to disk)
+ *
+ * No execution-mode logic (chat, plan, autopilot, workflows, scripts) lives here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseExecutor = void 0;
+const forge_1 = require("@plusplusoneplusplus/forge");
+const output_file_manager_1 = require("../output-file-manager");
+// ============================================================================
+// BaseExecutor
+// ============================================================================
+class BaseExecutor {
+    constructor(store, dataDir) {
+        /** Set of task IDs that have been cancelled. */
+        this.cancelledTasks = new Set();
+        /** Consolidated per-process session state. */
+        this.sessions = new Map();
+        this.store = store;
+        this.dataDir = dataDir;
+    }
+    // ========================================================================
+    // Session lifecycle
+    // ========================================================================
+    /** Get or create the session state for a process. */
+    getOrCreateSession(processId) {
+        let session = this.sessions.get(processId);
+        if (!session) {
+            session = {
+                outputBuffer: '',
+                timelineBuffer: [],
+                throttleState: { chunksSinceLastFlush: 0, lastFlushTime: 0 },
+                pendingSuggestions: undefined,
+            };
+            this.sessions.set(processId, session);
+        }
+        return session;
+    }
+    /** Delete all session state for a process in one atomic operation. */
+    cleanupSession(processId) {
+        this.sessions.delete(processId);
+    }
+    // ========================================================================
+    // Streaming / throttling
+    // ========================================================================
+    /** Append a timeline item to the in-memory buffer for a process. */
+    appendTimelineItem(processId, item) {
+        const session = this.getOrCreateSession(processId);
+        const last = session.timelineBuffer.length > 0
+            ? session.timelineBuffer[session.timelineBuffer.length - 1]
+            : undefined;
+        // Merge consecutive content items to avoid word-per-line rendering
+        if (last && last.type === 'content' && item.type === 'content') {
+            last.content = (last.content ?? '') + (item.content ?? '');
+        }
+        else {
+            session.timelineBuffer.push(item);
+        }
+    }
+    /**
+     * Check throttle conditions and flush conversation turn if necessary.
+     * Called on every streaming chunk. Flushes when either:
+     * - Time since last flush >= THROTTLE_TIME_MS (5 seconds)
+     * - Chunks since last flush >= THROTTLE_CHUNK_COUNT (50 chunks)
+     */
+    checkThrottleAndFlush(processId) {
+        const session = this.getOrCreateSession(processId);
+        session.throttleState.chunksSinceLastFlush++;
+        const timeSinceFlush = Date.now() - session.throttleState.lastFlushTime;
+        if (session.throttleState.chunksSinceLastFlush >= BaseExecutor.THROTTLE_CHUNK_COUNT ||
+            timeSinceFlush >= BaseExecutor.THROTTLE_TIME_MS) {
+            // Reset counters synchronously to prevent duplicate flushes
+            session.throttleState.chunksSinceLastFlush = 0;
+            session.throttleState.lastFlushTime = Date.now();
+            this.flushConversationTurn(processId, true).catch(() => {
+                // Non-fatal: don't fail the task because of flush
+            });
+        }
+    }
+    /**
+     * Flush current streaming content to the store as a conversation turn.
+     * When `streaming` is true, marks the turn as in-progress so the UI
+     * can show a streaming indicator. On completion, call with `streaming: false`.
+     */
+    async flushConversationTurn(processId, streaming) {
+        const session = this.sessions.get(processId);
+        const buffer = session?.outputBuffer;
+        const hasTimeline = (session?.timelineBuffer.length ?? 0) > 0;
+        if (buffer == null && !hasTimeline)
+            return;
+        // Snapshot current timeline for this flush, merging consecutive content items
+        const timelineSnapshot = (0, forge_1.mergeConsecutiveContentItems)([...(session?.timelineBuffer || [])]);
+        try {
+            const currentProcess = await this.store.getProcess(processId);
+            if (!currentProcess)
+                return;
+            const existingTurns = currentProcess.conversationTurns || [];
+            const lastTurn = existingTurns.length > 0 ? existingTurns[existingTurns.length - 1] : null;
+            let updatedTurns;
+            if (lastTurn && lastTurn.role === 'assistant' && lastTurn.streaming) {
+                // Update existing streaming assistant turn
+                updatedTurns = existingTurns.map((turn, i) => i === existingTurns.length - 1
+                    ? { ...turn, content: buffer ?? '', streaming: streaming || undefined, timeline: timelineSnapshot }
+                    : turn);
+            }
+            else {
+                // Append new assistant turn
+                updatedTurns = [
+                    ...existingTurns,
+                    {
+                        role: 'assistant',
+                        content: buffer ?? '',
+                        timestamp: new Date(),
+                        turnIndex: existingTurns.length,
+                        streaming: streaming || undefined,
+                        timeline: timelineSnapshot,
+                    },
+                ];
+            }
+            await this.store.updateProcess(processId, {
+                conversationTurns: updatedTurns,
+            });
+        }
+        catch {
+            // Non-fatal: don't fail the task because of flush
+        }
+    }
+    // ========================================================================
+    // Tool event handling
+    // ========================================================================
+    /**
+     * Builds the onToolEvent handler for a given process.
+     * `computeTurnIndex` is called lazily at event time to determine the current turn index
+     * for suggestion events — this allows callers to supply the correct index based on
+     * conversation state at the time the event fires.
+     */
+    buildToolEventHandler(processId, computeTurnIndex) {
+        return (event) => {
+            // Intercept suggestion tool completions — emit as dedicated SSE event
+            if (event.type === 'tool-complete' && event.toolName === 'suggest_follow_ups') {
+                try {
+                    const parsed = JSON.parse(event.result || '{}');
+                    const suggestions = Array.isArray(parsed?.suggestions) ? parsed.suggestions : [];
+                    if (suggestions.length > 0) {
+                        this.getOrCreateSession(processId).pendingSuggestions = suggestions;
+                        this.store.emitProcessEvent(processId, {
+                            type: 'suggestions',
+                            suggestions,
+                            turnIndex: computeTurnIndex(),
+                        });
+                    }
+                }
+                catch {
+                    // Malformed suggestions — ignore silently
+                }
+                return;
+            }
+            // Append tool timeline item
+            const timelineType = event.type === 'tool-start' ? 'tool-start'
+                : event.type === 'tool-complete' ? 'tool-complete'
+                    : 'tool-failed';
+            const now = new Date();
+            this.appendTimelineItem(processId, {
+                type: timelineType,
+                timestamp: now,
+                toolCall: {
+                    id: event.toolCallId,
+                    name: event.toolName || 'unknown',
+                    status: event.type === 'tool-start' ? 'running'
+                        : event.type === 'tool-complete' ? 'completed' : 'failed',
+                    startTime: now,
+                    ...(event.type !== 'tool-start' ? { endTime: now } : {}),
+                    args: event.parameters || {},
+                    result: event.result,
+                    error: event.error,
+                    ...(event.parentToolCallId ? { parentToolCallId: event.parentToolCallId } : {}),
+                },
+            });
+            try {
+                this.store.emitProcessEvent(processId, {
+                    type: event.type,
+                    toolCallId: event.toolCallId,
+                    toolName: event.toolName,
+                    ...(event.parentToolCallId ? { parentToolCallId: event.parentToolCallId } : {}),
+                    parameters: event.parameters,
+                    result: event.result,
+                    error: event.error,
+                });
+            }
+            catch {
+                // Non-fatal
+            }
+            // Trigger throttled flush so tool-only sessions persist timeline
+            this.checkThrottleAndFlush(processId);
+        };
+    }
+    // ========================================================================
+    // Output file management
+    // ========================================================================
+    /**
+     * Persist accumulated conversation output to disk.
+     * Non-fatal: errors are silently ignored.
+     */
+    async persistOutput(processId, content) {
+        if (!content || !this.dataDir) {
+            return;
+        }
+        try {
+            const outputPath = await output_file_manager_1.OutputFileManager.saveOutput(processId, content, this.dataDir);
+            if (outputPath) {
+                await this.store.updateProcess(processId, { rawStdoutFilePath: outputPath });
+            }
+        }
+        catch {
+            // Non-fatal: don't fail the task because of output persistence
+        }
+    }
+}
+exports.BaseExecutor = BaseExecutor;
+/** Time-based throttle: flush every N milliseconds. */
+BaseExecutor.THROTTLE_TIME_MS = 5000;
+/** Count-based throttle: flush every N chunks. */
+BaseExecutor.THROTTLE_CHUNK_COUNT = 50;
+//# sourceMappingURL=base-executor.js.map

package/dist/server/executors/base-executor.js.map

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

package/dist/server/executors/chat-base-executor.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Chat Mode Base Executor
+ *
+ * Abstract base class for the three AI chat-mode executors (chat/plan/autopilot).
+ * Owns the shared AI SDK call lifecycle: image handling, availability check, skill
+ * resolution, tool-call capture, streaming, session cleanup, and output persistence.
+ *
+ * Subclasses implement `buildModeOptions()` to supply mode-specific params:
+ * - agentMode (interactive | plan | autopilot)
+ * - systemMessage (mode-specific prompt restrictions)
+ * - tools (follow-up suggestions or other injected tools)
+ * - effectivePrompt (prompt with any mode-specific suffix appended)
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { AgentMode, AutoFolderContext, CopilotSDKService, ProcessStore, QueuedTask, SystemMessageConfig, TimelineItem, Tool } from '@plusplusoneplusplus/forge';
+import { FileToolCallCacheStore } from '@plusplusoneplusplus/forge';
+import { BaseExecutor } from './base-executor';
+export interface ChatModeExecutorOptions {
+    /** Default working directory for AI sessions */
+    workingDirectory?: string;
+    /** Whether to auto-approve AI permission requests (default: true) */
+    approvePermissions?: boolean;
+    /** The AI service instance to use for sending messages */
+    aiService: CopilotSDKService;
+    /** Default timeout in ms for tasks that do not specify their own timeoutMs */
+    defaultTimeoutMs: number;
+    /** Follow-up suggestions configuration */
+    followUpSuggestions: {
+        enabled: boolean;
+        count: number;
+    };
+    /** Shared store for tool-call Q&A capture (explore cache) */
+    toolCallCacheStore: FileToolCallCacheStore;
+    /** Resolve skill configuration for a workspace */
+    resolveSkillConfig: (wsId: string | undefined, workDir?: string) => Promise<{
+        skillDirectories?: string[];
+        disabledSkills?: string[];
+    }>;
+    /** Resolve workspace ID for a root path */
+    resolveWorkspaceIdForPath: (rootPath: string) => Promise<string>;
+}
+/** Return type for the AI call result. */
+export interface ChatModeExecutionResult {
+    response: string;
+    sessionId?: string;
+    toolCalls?: unknown[];
+    /** Merged timeline captured from the executor session before cleanup. */
+    timeline: TimelineItem[];
+    /** Follow-up suggestions emitted via suggest_follow_ups tool, if any. */
+    pendingSuggestions?: string[];
+}
+/** Mode-specific AI call parameters supplied by each concrete executor. */
+export interface ChatModeAIOptions {
+    agentMode: AgentMode | undefined;
+    systemMessage: SystemMessageConfig | undefined;
+    tools: Tool<unknown>[];
+    /** Prompt with any mode-specific suffix already appended. */
+    effectivePrompt: string;
+}
+export declare abstract class ChatBaseExecutor extends BaseExecutor {
+    protected readonly approvePermissions: boolean;
+    protected readonly defaultWorkingDirectory?: string;
+    protected readonly aiService: CopilotSDKService;
+    protected readonly defaultTimeoutMs: number;
+    protected readonly followUpSuggestions: {
+        enabled: boolean;
+        count: number;
+    };
+    protected readonly toolCallCacheStore: FileToolCallCacheStore;
+    protected readonly resolveSkillConfigFn: (wsId: string | undefined, workDir?: string) => Promise<{
+        skillDirectories?: string[];
+        disabledSkills?: string[];
+    }>;
+    protected readonly resolveWorkspaceIdForPathFn: (rootPath: string) => Promise<string>;
+    constructor(store: ProcessStore, options: ChatModeExecutorOptions, dataDir?: string);
+    /**
+     * Build mode-specific AI call options: agent mode, system message, tools,
+     * and the final effective prompt (with any mode suffix appended).
+     */
+    protected abstract buildModeOptions(task: QueuedTask, prompt: string, workingDirectory: string | undefined): Promise<ChatModeAIOptions>;
+    /** Resolve the tasks-root directory and list existing sub-folders. */
+    protected buildAutoFolderContext(workingDirectory: string, workspaceId?: string): Promise<AutoFolderContext>;
+    /**
+     * Execute a chat-mode AI task.
+     *
+     * Flow:
+     * 1. Resolve working directory from task payload
+     * 2. Call buildModeOptions() to get mode-specific params
+     * 3. Initialize session, register flush handler
+     * 4. Rehydrate and save images to temp files
+     * 5. Check AI availability
+     * 6. Resolve skill configuration
+     * 7. Set up tool-call capture
+     * 8. Send message via AI SDK with streaming callbacks
+     * 9. Return { response, sessionId, toolCalls }
+     * 10. In finally: cleanup images, session, flush handler, persist output
+     */
+    execute(task: QueuedTask, prompt: string): Promise<ChatModeExecutionResult>;
+}
+//# sourceMappingURL=chat-base-executor.d.ts.map

package/dist/server/executors/chat-base-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-base-executor.d.ts","sourceRoot":"","sources":["../../../src/server/executors/chat-base-executor.ts"],"names":[],"mappings":"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"}

package/dist/server/executors/chat-base-executor.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Chat Mode Base Executor
+ *
+ * Abstract base class for the three AI chat-mode executors (chat/plan/autopilot).
+ * Owns the shared AI SDK call lifecycle: image handling, availability check, skill
+ * resolution, tool-call capture, streaming, session cleanup, and output persistence.
+ *
+ * Subclasses implement `buildModeOptions()` to supply mode-specific params:
+ * - agentMode (interactive | plan | autopilot)
+ * - systemMessage (mode-specific prompt restrictions)
+ * - tools (follow-up suggestions or other injected tools)
+ * - effectivePrompt (prompt with any mode-specific suffix appended)
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatBaseExecutor = void 0;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const forge_1 = require("@plusplusoneplusplus/forge");
+const image_store_1 = require("./image-store");
+const task_root_resolver_1 = require("../task-root-resolver");
+const base_executor_1 = require("./base-executor");
+// ============================================================================
+// ChatBaseExecutor
+// ============================================================================
+class ChatBaseExecutor extends base_executor_1.BaseExecutor {
+    constructor(store, options, dataDir) {
+        super(store, dataDir);
+        this.approvePermissions = options.approvePermissions !== false;
+        this.defaultWorkingDirectory = options.workingDirectory;
+        this.aiService = options.aiService;
+        this.defaultTimeoutMs = options.defaultTimeoutMs;
+        this.followUpSuggestions = options.followUpSuggestions;
+        this.toolCallCacheStore = options.toolCallCacheStore;
+        this.resolveSkillConfigFn = options.resolveSkillConfig;
+        this.resolveWorkspaceIdForPathFn = options.resolveWorkspaceIdForPath;
+    }
+    // ========================================================================
+    // Shared helper — auto-folder context (used by ask and plan modes)
+    // ========================================================================
+    /** Resolve the tasks-root directory and list existing sub-folders. */
+    async buildAutoFolderContext(workingDirectory, workspaceId) {
+        const wsId = workspaceId || await this.resolveWorkspaceIdForPathFn(workingDirectory);
+        const effectiveDataDir = this.dataDir ?? path.join(os.homedir(), '.coc');
+        const tasksRoot = (0, task_root_resolver_1.resolveTaskRoot)({
+            dataDir: effectiveDataDir,
+            rootPath: workingDirectory,
+            workspaceId: wsId,
+        }).absolutePath;
+        const entries = await fs.promises
+            .readdir(tasksRoot, { withFileTypes: true })
+            .catch(() => []);
+        const existingFolders = entries.filter(e => e.isDirectory()).map(e => e.name);
+        return { tasksRoot, existingFolders };
+    }
+    // ========================================================================
+    // Shared execute — AI call lifecycle
+    // ========================================================================
+    /**
+     * Execute a chat-mode AI task.
+     *
+     * Flow:
+     * 1. Resolve working directory from task payload
+     * 2. Call buildModeOptions() to get mode-specific params
+     * 3. Initialize session, register flush handler
+     * 4. Rehydrate and save images to temp files
+     * 5. Check AI availability
+     * 6. Resolve skill configuration
+     * 7. Set up tool-call capture
+     * 8. Send message via AI SDK with streaming callbacks
+     * 9. Return { response, sessionId, toolCalls }
+     * 10. In finally: cleanup images, session, flush handler, persist output
+     */
+    async execute(task, prompt) {
+        const processId = `queue_${task.id}`;
+        const payload = task.payload;
+        const workingDirectory = payload.workingDirectory || payload.folderPath || this.defaultWorkingDirectory;
+        const { agentMode, systemMessage, tools, effectivePrompt } = await this.buildModeOptions(task, prompt, workingDirectory);
+        this.getOrCreateSession(processId).outputBuffer = '';
+        this.store.registerFlushHandler?.(processId, () => this.flushConversationTurn(processId, true));
+        // Rehydrate externalized images from blob store before image decoding
+        await (0, image_store_1.rehydrateImagesIfNeeded)(payload);
+        let attachments;
+        let imageTempDir;
+        const payloadImages = payload?.images;
+        if (Array.isArray(payloadImages) && payloadImages.length > 0) {
+            const validImages = payloadImages
+                .filter((img) => typeof img === 'string')
+                .slice(0, 10);
+            if (validImages.length > 0) {
+                const saved = (0, image_store_1.saveImagesToTempFiles)(validImages);
+                imageTempDir = saved.tempDir;
+                attachments = saved.attachments.length > 0 ? saved.attachments : undefined;
+            }
+        }
+        try {
+            const availability = await this.aiService.isAvailable();
+            if (!availability.available) {
+                throw new Error(`Copilot SDK not available: ${availability.error || 'unknown reason'}`);
+            }
+            const timeoutMs = task.config.timeoutMs || this.defaultTimeoutMs;
+            const taskWorkspaceId = payload.workspaceId;
+            const { skillDirectories, disabledSkills } = await this.resolveSkillConfigFn(taskWorkspaceId, workingDirectory);
+            let captureHandler;
+            try {
+                const capture = new forge_1.ToolCallCapture(this.toolCallCacheStore, forge_1.TASK_FILTER);
+                captureHandler = capture.createToolEventHandler();
+            }
+            catch (err) {
+                (0, forge_1.getLogger)().warn(forge_1.LogCategory.AI, `[ChatModeExecutor] ToolCallCapture setup failed: ${err}`);
+            }
+            const toolEventHandler = this.buildToolEventHandler(processId, () => 1);
+            const result = await this.aiService.sendMessage({
+                prompt: effectivePrompt,
+                mode: agentMode,
+                model: task.config.model,
+                reasoningEffort: task.config.reasoningEffort ?? 'high',
+                workingDirectory,
+                timeoutMs,
+                attachments,
+                tools: tools.length > 0 ? tools : undefined,
+                systemMessage,
+                skillDirectories,
+                disabledSkills,
+                onPermissionRequest: this.approvePermissions ? forge_1.approveAllPermissions : undefined,
+                onSessionCreated: (sessionId) => {
+                    this.store.updateProcess(processId, { sdkSessionId: sessionId }).catch(() => {
+                        // Non-fatal: store may be a stub
+                    });
+                },
+                onStreamingChunk: (chunk) => {
+                    this.getOrCreateSession(processId).outputBuffer += chunk;
+                    this.appendTimelineItem(processId, { type: 'content', timestamp: new Date(), content: chunk });
+                    try {
+                        this.store.emitProcessOutput(processId, chunk);
+                    }
+                    catch {
+                        // Non-fatal: store may be a stub
+                    }
+                    this.checkThrottleAndFlush(processId);
+                },
+                onToolEvent: captureHandler
+                    ? (event) => {
+                        try {
+                            toolEventHandler(event);
+                        }
+                        catch { /* non-fatal */ }
+                        try {
+                            captureHandler(event);
+                        }
+                        catch { /* non-fatal */ }
+                    }
+                    : toolEventHandler,
+            });
+            if (!result.success) {
+                throw new Error(result.error || 'AI execution failed');
+            }
+            // Capture session state BEFORE the finally block runs cleanup.
+            // (return value expressions are evaluated before finally executes)
+            const finalTimeline = (0, forge_1.mergeConsecutiveContentItems)(this.sessions.get(processId)?.timelineBuffer ?? []);
+            const pendingSuggestions = this.sessions.get(processId)?.pendingSuggestions;
+            return {
+                response: result.response || '(Task completed via tool execution — no text response produced)',
+                sessionId: result.sessionId,
+                toolCalls: result.toolCalls,
+                timeline: finalTimeline,
+                pendingSuggestions,
+            };
+        }
+        finally {
+            if (imageTempDir) {
+                (0, image_store_1.cleanupTempDir)(imageTempDir);
+            }
+            const buffer = this.sessions.get(processId)?.outputBuffer ?? '';
+            this.cleanupSession(processId);
+            this.store.unregisterFlushHandler?.(processId);
+            await this.persistOutput(processId, buffer);
+        }
+    }
+}
+exports.ChatBaseExecutor = ChatBaseExecutor;
+//# sourceMappingURL=chat-base-executor.js.map

package/dist/server/executors/chat-base-executor.js.map

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

package/dist/server/executors/chat-executor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Chat Executor
+ *
+ * Concrete executor for `ask`-mode chat tasks.
+ *
+ * Extends ChatBaseExecutor to supply ask-mode specific AI options:
+ * - agentMode: 'interactive'
+ * - systemMessage: READ_ONLY_SYSTEM_MESSAGE + optional auto-folder location block
+ * - tools: follow-up suggestion tool (when configured)
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { ProcessStore, QueuedTask } from '@plusplusoneplusplus/forge';
+import type { ChatModeAIOptions, ChatModeExecutorOptions } from './chat-base-executor';
+import { ChatBaseExecutor } from './chat-base-executor';
+export type ChatExecutorOptions = ChatModeExecutorOptions;
+export declare class ChatExecutor extends ChatBaseExecutor {
+    constructor(store: ProcessStore, options: ChatExecutorOptions, dataDir?: string);
+    protected buildModeOptions(task: QueuedTask, prompt: string, workingDirectory: string | undefined): Promise<ChatModeAIOptions>;
+}
+//# sourceMappingURL=chat-executor.d.ts.map

package/dist/server/executors/chat-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-executor.d.ts","sourceRoot":"","sources":["../../../src/server/executors/chat-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAER,YAAY,EACZ,UAAU,EACb,MAAM,4BAA4B,CAAC;AAOpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMxD,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAE1D,qBAAa,YAAa,SAAQ,gBAAgB;gBAClC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM;cAI/D,gBAAgB,CAC5B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACrC,OAAO,CAAC,iBAAiB,CAAC;CA6BhC"}

package/dist/server/executors/chat-executor.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Chat Executor
+ *
+ * Concrete executor for `ask`-mode chat tasks.
+ *
+ * Extends ChatBaseExecutor to supply ask-mode specific AI options:
+ * - agentMode: 'interactive'
+ * - systemMessage: READ_ONLY_SYSTEM_MESSAGE + optional auto-folder location block
+ * - tools: follow-up suggestion tool (when configured)
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatExecutor = void 0;
+const prompt_builder_1 = require("./prompt-builder");
+const chat_base_executor_1 = require("./chat-base-executor");
+class ChatExecutor extends chat_base_executor_1.ChatBaseExecutor {
+    constructor(store, options, dataDir) {
+        super(store, options, dataDir);
+    }
+    async buildModeOptions(task, prompt, workingDirectory) {
+        const payload = task.payload;
+        let autoFolderContext = undefined;
+        if (workingDirectory) {
+            autoFolderContext = await this.buildAutoFolderContext(workingDirectory, payload.workspaceId);
+        }
+        const systemMessage = await (0, prompt_builder_1.withRepoInstructions)((0, prompt_builder_1.buildModeSystemMessage)('ask', autoFolderContext), workingDirectory, 'ask');
+        const { tools, suffix } = (0, prompt_builder_1.buildFollowUpSuggestionsAddon)(this.followUpSuggestions.enabled, this.followUpSuggestions.count);
+        return {
+            agentMode: 'interactive',
+            systemMessage,
+            tools,
+            effectivePrompt: prompt + suffix,
+        };
+    }
+}
+exports.ChatExecutor = ChatExecutor;
+//# sourceMappingURL=chat-executor.js.map