@plusplusoneplusplus/coc 1.0.0

package/dist/server/diff-comments-manager.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * DiffCommentsManager — types, constants, manager class, and validation helpers
+ * for diff comments.
+ *
+ * Extracted from diff-comments-handler.ts to reduce file size.
+ * The route registration remains in diff-comments-handler.ts.
+ */
+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.DiffCommentsManager = exports.DEFAULT_DIFF_SETTINGS = exports.DIFF_COMMENTS_DIR_NAME = void 0;
+exports.isValidStorageKey = isValidStorageKey;
+exports.isValidContext = isValidContext;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const base_comments_manager_1 = require("./base-comments-manager");
+// ============================================================================
+// Constants
+// ============================================================================
+/** Sub-directory name for diff comments storage. */
+exports.DIFF_COMMENTS_DIR_NAME = 'diff-comments';
+/** Default settings for new diff comment storage files. */
+exports.DEFAULT_DIFF_SETTINGS = {
+    showResolved: true,
+};
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/** Validate storage key (SHA-256 hex, 64 chars). */
+function isValidStorageKey(key) {
+    return /^[0-9a-f]{64}$/.test(key);
+}
+/** Validate that a diff comment context object has all required fields. */
+function isValidContext(ctx) {
+    return (ctx &&
+        typeof ctx === 'object' &&
+        typeof ctx.repositoryId === 'string' &&
+        typeof ctx.oldRef === 'string' &&
+        typeof ctx.newRef === 'string' &&
+        typeof ctx.filePath === 'string');
+}
+// ============================================================================
+// DiffCommentsManager
+// ============================================================================
+/**
+ * Manages diff comments storage and operations.
+ * Keyed by sha256(context) instead of filePath.
+ * Extends BaseCommentsManager for shared CRUD, read, and write logic.
+ */
+class DiffCommentsManager extends base_comments_manager_1.BaseCommentsManager {
+    /**
+     * @param dataDir - Root data directory (e.g. ~/.coc)
+     */
+    constructor(dataDir) {
+        super();
+        this.commentsRoot = path.join(dataDir, exports.DIFF_COMMENTS_DIR_NAME);
+    }
+    /** Return the workspace directory (commentsRoot/<wsId>). */
+    getWorkspaceDir(wsId) {
+        return path.join(this.commentsRoot, wsId);
+    }
+    /** Wrap comments in the diff-specific storage envelope. */
+    buildStorage(comments) {
+        return { comments, settings: exports.DEFAULT_DIFF_SETTINGS };
+    }
+    /**
+     * Derive a storage key from a diff context.
+     *
+     * Fields are concatenated without a separator — clients must use the same
+     * concatenation order to produce matching keys.
+     *
+     * Normal diff:    sha256(repositoryId + oldRef + newRef + filePath)
+     * Working-tree:   sha256(repositoryId + filePath + 'working-tree')
+     *                 (oldRef is omitted; 'working-tree' sentinel is appended)
+     */
+    hashContext(ctx) {
+        if (ctx.newRef === 'working-tree') {
+            return crypto
+                .createHash('sha256')
+                .update(ctx.repositoryId + ctx.filePath + 'working-tree')
+                .digest('hex');
+        }
+        return crypto
+            .createHash('sha256')
+            .update(ctx.repositoryId + ctx.oldRef + ctx.newRef + ctx.filePath)
+            .digest('hex');
+    }
+    /**
+     * Add a new comment.
+     * Sets `ephemeral: true` when `ctx.newRef === 'working-tree'`.
+     */
+    async addComment(wsId, ctx, commentData) {
+        const storageKey = this.hashContext(ctx);
+        const extra = ctx.newRef === 'working-tree' ? { ephemeral: true } : {};
+        return this.addCommentCore(wsId, storageKey, { ...commentData, ...extra });
+    }
+    /**
+     * Get comment counts for all storage keys in a workspace.
+     * Returns a map of storageKey → comment count.
+     *
+     * @param wsId - Workspace ID
+     * @param options - Optional filters:
+     *   - `oldRef`    Only count comments whose context.oldRef matches.
+     *   - `newRef`    Only count comments whose context.newRef matches.
+     *   - `statuses`  Only count comments with one of these status values.
+     *                 Defaults to all statuses when omitted.
+     */
+    async getCommentCounts(wsId, options) {
+        const wsDir = this.getWorkspaceDir(wsId);
+        if (!fs.existsSync(wsDir)) {
+            return {};
+        }
+        const counts = {};
+        let entries;
+        try {
+            entries = await fs.promises.readdir(wsDir);
+        }
+        catch {
+            return {};
+        }
+        for (const entry of entries) {
+            if (!entry.endsWith('.json'))
+                continue;
+            try {
+                const content = await fs.promises.readFile(path.join(wsDir, entry), 'utf8');
+                const storage = JSON.parse(content);
+                let comments = storage.comments || [];
+                // Filter by ref range when requested
+                if (options?.oldRef !== undefined || options?.newRef !== undefined) {
+                    comments = comments.filter(c => {
+                        if (options?.oldRef !== undefined && c.context?.oldRef !== options.oldRef)
+                            return false;
+                        if (options?.newRef !== undefined && c.context?.newRef !== options.newRef)
+                            return false;
+                        return true;
+                    });
+                }
+                // Filter by status when requested
+                if (options?.statuses && options.statuses.length > 0) {
+                    comments = comments.filter(c => options.statuses.includes(c.status));
+                }
+                if (comments.length === 0)
+                    continue;
+                const key = entry.slice(0, -5); // strip ".json"
+                counts[key] = comments.length;
+            }
+            catch {
+                // Skip corrupted files
+            }
+        }
+        return counts;
+    }
+    /**
+     * Get total active comment counts per commit hash.
+     *
+     * Scans all storage files in the workspace and groups comment counts by
+     * `context.newRef` (commit hash).  Only hashes present in `commitHashes`
+     * are included in the result, and only entries with a count > 0 are returned.
+     *
+     * @param wsId          - Workspace ID
+     * @param commitHashes  - The commit hashes to tally
+     * @param options       - Optional `statuses` filter (defaults to all statuses)
+     */
+    async getCommentTotals(wsId, commitHashes, options) {
+        if (commitHashes.length === 0)
+            return {};
+        const hashSet = new Set(commitHashes);
+        const wsDir = this.getWorkspaceDir(wsId);
+        if (!fs.existsSync(wsDir)) {
+            return {};
+        }
+        let entries;
+        try {
+            entries = await fs.promises.readdir(wsDir);
+        }
+        catch {
+            return {};
+        }
+        const totals = {};
+        for (const entry of entries) {
+            if (!entry.endsWith('.json'))
+                continue;
+            try {
+                const content = await fs.promises.readFile(path.join(wsDir, entry), 'utf8');
+                const storage = JSON.parse(content);
+                let comments = storage.comments || [];
+                // Filter by status when requested
+                if (options?.statuses && options.statuses.length > 0) {
+                    comments = comments.filter(c => options.statuses.includes(c.status));
+                }
+                for (const comment of comments) {
+                    const ref = comment.context?.newRef;
+                    if (ref && hashSet.has(ref)) {
+                        totals[ref] = (totals[ref] ?? 0) + 1;
+                    }
+                }
+            }
+            catch {
+                // Skip corrupted files
+            }
+        }
+        return totals;
+    }
+    /**
+     * List all comments in a workspace across all storage files.
+     */
+    async listAllComments(wsId) {
+        const wsDir = this.getWorkspaceDir(wsId);
+        if (!fs.existsSync(wsDir)) {
+            return [];
+        }
+        let entries;
+        try {
+            entries = await fs.promises.readdir(wsDir);
+        }
+        catch {
+            return [];
+        }
+        const all = [];
+        for (const entry of entries) {
+            if (!entry.endsWith('.json'))
+                continue;
+            try {
+                const content = await fs.promises.readFile(path.join(wsDir, entry), 'utf8');
+                const storage = JSON.parse(content);
+                all.push(...(storage.comments || []));
+            }
+            catch {
+                // Skip corrupted files
+            }
+        }
+        return all;
+    }
+}
+exports.DiffCommentsManager = DiffCommentsManager;
+//# sourceMappingURL=diff-comments-manager.js.map

package/dist/server/diff-comments-manager.js.map

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

package/dist/server/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Centralized API Error Handling
+ *
+ * Provides a structured APIError class, factory functions for common HTTP errors,
+ * and a handleAPIError function for consistent error responses across all API routes.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import * as http from 'http';
+/**
+ * Structured API error with HTTP status code and optional metadata.
+ * Use factory functions (e.g., badRequest, notFound) for common error types.
+ */
+export declare class APIError extends Error {
+    statusCode: number;
+    code?: string | undefined;
+    details?: unknown | undefined;
+    constructor(statusCode: number, message: string, code?: string | undefined, details?: unknown | undefined);
+}
+export declare function badRequest(message: string, details?: unknown): APIError;
+export declare function notFound(resource: string): APIError;
+export declare function forbidden(message: string): APIError;
+export declare function invalidJSON(): APIError;
+export declare function missingFields(fields: string[]): APIError;
+export declare function internalError(message?: string): APIError;
+export declare function conflict(message: string): APIError;
+/**
+ * Handle an error and send appropriate HTTP response.
+ * - APIError instances use their statusCode and metadata
+ * - Unknown errors are logged and sent as 500 Internal Server Error
+ */
+export declare function handleAPIError(res: http.ServerResponse, error: unknown): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/server/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAEpB,UAAU,EAAE,MAAM;IAElB,IAAI,CAAC,EAAE,MAAM;IACb,OAAO,CAAC,EAAE,OAAO;gBAHjB,UAAU,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,OAAO,YAAA;CAK/B;AAMD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAEvE;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAEnD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEnD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAExD;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAgC,GAAG,QAAQ,CAEjF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAElD;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAmB7E"}

package/dist/server/errors.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Centralized API Error Handling
+ *
+ * Provides a structured APIError class, factory functions for common HTTP errors,
+ * and a handleAPIError function for consistent error responses across all API routes.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIError = void 0;
+exports.badRequest = badRequest;
+exports.notFound = notFound;
+exports.forbidden = forbidden;
+exports.invalidJSON = invalidJSON;
+exports.missingFields = missingFields;
+exports.internalError = internalError;
+exports.conflict = conflict;
+exports.handleAPIError = handleAPIError;
+const api_handler_1 = require("./api-handler");
+const server_logger_1 = require("./server-logger");
+/**
+ * Structured API error with HTTP status code and optional metadata.
+ * Use factory functions (e.g., badRequest, notFound) for common error types.
+ */
+class APIError extends Error {
+    constructor(statusCode, message, code, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.details = details;
+        this.name = 'APIError';
+    }
+}
+exports.APIError = APIError;
+// ============================================================================
+// Factory Functions
+// ============================================================================
+function badRequest(message, details) {
+    return new APIError(400, message, 'BAD_REQUEST', details);
+}
+function notFound(resource) {
+    return new APIError(404, `${resource} not found`, 'NOT_FOUND');
+}
+function forbidden(message) {
+    return new APIError(403, message, 'FORBIDDEN');
+}
+function invalidJSON() {
+    return new APIError(400, 'Invalid JSON body', 'INVALID_JSON');
+}
+function missingFields(fields) {
+    return new APIError(400, `Missing required fields: ${fields.join(', ')}`, 'MISSING_FIELDS', { fields });
+}
+function internalError(message = 'Internal server error') {
+    return new APIError(500, message, 'INTERNAL_ERROR');
+}
+function conflict(message) {
+    return new APIError(409, message, 'CONFLICT');
+}
+// ============================================================================
+// Centralized Error Handler
+// ============================================================================
+/**
+ * Handle an error and send appropriate HTTP response.
+ * - APIError instances use their statusCode and metadata
+ * - Unknown errors are logged and sent as 500 Internal Server Error
+ */
+function handleAPIError(res, error) {
+    if (error instanceof APIError) {
+        const body = { error: error.message };
+        if (error.code) {
+            body.code = error.code;
+        }
+        if (error.details !== undefined) {
+            body.details = error.details;
+        }
+        if (error.statusCode >= 500) {
+            (0, server_logger_1.getServerLogger)().error({ statusCode: error.statusCode, code: error.code, err: error }, error.message);
+        }
+        else {
+            (0, server_logger_1.getServerLogger)().warn({ statusCode: error.statusCode, code: error.code }, error.message);
+        }
+        (0, api_handler_1.sendJSON)(res, error.statusCode, body);
+    }
+    else {
+        (0, server_logger_1.getServerLogger)().error({ err: error }, 'Unexpected API error');
+        (0, api_handler_1.sendJSON)(res, 500, { error: 'Internal server error', code: 'INTERNAL_ERROR' });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/server/errors.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Autopilot Executor
+ *
+ * Concrete executor for `autopilot`-mode chat tasks.
+ *
+ * Extends ChatBaseExecutor to supply autopilot-mode specific AI options:
+ * - agentMode: 'autopilot'
+ * - systemMessage: undefined (no read-only restriction — full read/write access)
+ * - 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 AutopilotExecutorOptions = ChatModeExecutorOptions;
+export declare class AutopilotExecutor extends ChatBaseExecutor {
+    constructor(store: ProcessStore, options: AutopilotExecutorOptions, dataDir?: string);
+    protected buildModeOptions(task: QueuedTask, prompt: string, _workingDirectory: string | undefined): Promise<ChatModeAIOptions>;
+}
+//# sourceMappingURL=autopilot-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-executor.d.ts","sourceRoot":"","sources":["../../../src/server/executors/autopilot-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAER,YAAY,EACZ,UAAU,EACb,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMxD,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAE/D,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACvC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,MAAM;cAIpE,gBAAgB,CAC5B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACtC,OAAO,CAAC,iBAAiB,CAAC;CAahC"}

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

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Autopilot Executor
+ *
+ * Concrete executor for `autopilot`-mode chat tasks.
+ *
+ * Extends ChatBaseExecutor to supply autopilot-mode specific AI options:
+ * - agentMode: 'autopilot'
+ * - systemMessage: undefined (no read-only restriction — full read/write access)
+ * - 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.AutopilotExecutor = void 0;
+const prompt_builder_1 = require("./prompt-builder");
+const chat_base_executor_1 = require("./chat-base-executor");
+class AutopilotExecutor extends chat_base_executor_1.ChatBaseExecutor {
+    constructor(store, options, dataDir) {
+        super(store, options, dataDir);
+    }
+    async buildModeOptions(task, prompt, _workingDirectory) {
+        const { tools, suffix } = (0, prompt_builder_1.buildFollowUpSuggestionsAddon)(this.followUpSuggestions.enabled, this.followUpSuggestions.count);
+        return {
+            agentMode: 'autopilot',
+            systemMessage: undefined,
+            tools,
+            effectivePrompt: prompt + suffix,
+        };
+    }
+}
+exports.AutopilotExecutor = AutopilotExecutor;
+//# sourceMappingURL=autopilot-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-executor.js","sourceRoot":"","sources":["../../../src/server/executors/autopilot-executor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAOH,qDAE0B;AAE1B,6DAAwD;AAQxD,MAAa,iBAAkB,SAAQ,qCAAgB;IACnD,YAAY,KAAmB,EAAE,OAAiC,EAAE,OAAgB;QAChF,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAES,KAAK,CAAC,gBAAgB,CAC5B,IAAgB,EAChB,MAAc,EACd,iBAAqC;QAErC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAA,8CAA6B,EACnD,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAChC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CACjC,CAAC;QAEF,OAAO;YACH,SAAS,EAAE,WAAwB;YACnC,aAAa,EAAE,SAAS;YACxB,KAAK;YACL,eAAe,EAAE,MAAM,GAAG,MAAM;SACnC,CAAC;IACN,CAAC;CACJ;AAtBD,8CAsBC"}

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

@@ -0,0 +1,74 @@
+/**
+ * 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.
+ */
+import type { ProcessStore, TimelineItem, ToolEvent } from '@plusplusoneplusplus/forge';
+/**
+ * Consolidated per-process state held for the lifetime of a single task execution.
+ * A single entry is created on first access and deleted atomically in cleanupSession().
+ */
+export interface ProcessSessionState {
+    outputBuffer: string;
+    timelineBuffer: TimelineItem[];
+    throttleState: {
+        chunksSinceLastFlush: number;
+        lastFlushTime: number;
+    };
+    pendingSuggestions: string[] | undefined;
+}
+export declare abstract class BaseExecutor {
+    protected readonly store: ProcessStore;
+    protected readonly dataDir?: string;
+    /** Set of task IDs that have been cancelled. */
+    protected readonly cancelledTasks: Set<string>;
+    /** Consolidated per-process session state. */
+    protected readonly sessions: Map<string, ProcessSessionState>;
+    /** Time-based throttle: flush every N milliseconds. */
+    protected static readonly THROTTLE_TIME_MS = 5000;
+    /** Count-based throttle: flush every N chunks. */
+    protected static readonly THROTTLE_CHUNK_COUNT = 50;
+    constructor(store: ProcessStore, dataDir?: string);
+    /** Get or create the session state for a process. */
+    protected getOrCreateSession(processId: string): ProcessSessionState;
+    /** Delete all session state for a process in one atomic operation. */
+    protected cleanupSession(processId: string): void;
+    /** Append a timeline item to the in-memory buffer for a process. */
+    protected appendTimelineItem(processId: string, item: TimelineItem): void;
+    /**
+     * 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)
+     */
+    protected checkThrottleAndFlush(processId: string): void;
+    /**
+     * 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`.
+     */
+    protected flushConversationTurn(processId: string, streaming: boolean): Promise<void>;
+    /**
+     * 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.
+     */
+    protected buildToolEventHandler(processId: string, computeTurnIndex: () => number): (event: ToolEvent) => void;
+    /**
+     * Persist accumulated conversation output to disk.
+     * Non-fatal: errors are silently ignored.
+     */
+    protected persistOutput(processId: string, content: string): Promise<void>;
+}
+//# sourceMappingURL=base-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-executor.d.ts","sourceRoot":"","sources":["../../../src/server/executors/base-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAQxF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,kBAAkB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5C;AAMD,8BAAsB,YAAY;IAC9B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEpC,gDAAgD;IAChD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAE3D,8CAA8C;IAC9C,SAAS,CAAC,QAAQ,CAAC,QAAQ,mCAA0C;IAErE,uDAAuD;IACvD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,QAAQ;IAElD,kDAAkD;IAClD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,MAAM;gBAExC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM;IASjD,qDAAqD;IACrD,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB;IAcpE,sEAAsE;IACtE,SAAS,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQjD,oEAAoE;IACpE,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAazE;;;;;OAKG;IACH,SAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAkBxD;;;;OAIG;cACa,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD3F;;;;;OAKG;IACH,SAAS,CAAC,qBAAqB,CAC3B,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,MAAM,GAC/B,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI;IAgE7B;;;OAGG;cACa,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnF"}