@od-oneapp/config 2026.2.2001-canary.1

package/typescript/dist/src/server/session-management.js.map

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

package/typescript/dist/src/server/session-recovery.d.ts

@@ -0,0 +1,91 @@
+export interface SessionCheckpoint {
+    sessionId: string;
+    timestamp: number;
+    agentType: string;
+    packagePath: string;
+    workingDirectory?: string;
+    progress: {
+        phase: string;
+        completedSteps: number;
+        totalSteps: number;
+        currentStep: string;
+        processingState: Record<string, any>;
+    };
+    analysis: {
+        completedFiles: string[];
+        pendingFiles: string[];
+        results: Record<string, any>;
+        errors: Array<{
+            file: string;
+            error: string;
+            timestamp: number;
+        }>;
+    };
+    context: {
+        userMessage?: string;
+        options?: Record<string, unknown>;
+        environment?: Record<string, string>;
+    };
+    metrics: {
+        startTime: number;
+        lastUpdateTime: number;
+        memoryUsage: number;
+        filesProcessed: number;
+        errorsEncountered: number;
+    };
+}
+export interface RecoveryOptions {
+    maxSessionAge?: number;
+    sessionDir?: string;
+    autoCleanup?: boolean;
+    retentionDays?: number;
+    validateCheckpoint?: (checkpoint: SessionCheckpoint) => boolean;
+}
+export interface RecoveryResult {
+    success: boolean;
+    sessionId: string;
+    checkpoint?: SessionCheckpoint;
+    resumeData?: {
+        pendingFiles: string[];
+        partialResults: Record<string, any>;
+        nextStep: string;
+        continuationContext: Record<string, any>;
+    };
+    error?: string;
+    recommendations?: string[];
+}
+export interface SessionSummary {
+    sessionId: string;
+    agentType: string;
+    lastUpdate: number;
+    status: 'active' | 'crashed' | 'completed' | 'stale';
+    progress: number;
+    filesProcessed: number;
+    estimatedCompletion?: number;
+}
+export declare class SessionRecoveryManager {
+    private options;
+    constructor(options?: RecoveryOptions);
+    saveCheckpoint(checkpoint: SessionCheckpoint): Promise<boolean>;
+    loadCheckpoint(sessionId: string): Promise<SessionCheckpoint | null>;
+    recoverSession(sessionId: string): Promise<RecoveryResult>;
+    listRecoverableSessions(): Promise<SessionSummary[]>;
+    cleanupSessions(): Promise<{
+        cleaned: number;
+        errors: string[];
+    }>;
+    deleteSession(sessionId: string): Promise<boolean>;
+    createCheckpoint(agentType: string, packagePath: string, userMessage?: string, options?: Record<string, unknown>): SessionCheckpoint;
+    private ensureSessionDirectory;
+    private getCheckpointPath;
+    private validateSessionState;
+    private generateResumeData;
+    private determineNextStep;
+    private calculateProgressPercentage;
+    private determineSessionStatus;
+    private estimateCompletion;
+}
+export declare function getSessionRecoveryManager(options?: RecoveryOptions): SessionRecoveryManager;
+export declare function hasRecoverableSessions(sessionDir?: string): Promise<boolean>;
+export declare function autoRecoverLatestSession(sessionDir?: string): Promise<RecoveryResult | null>;
+//# sourceMappingURL=session-recovery.d.ts.map

package/typescript/dist/src/server/session-recovery.d.ts.map

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

package/typescript/dist/src/server/session-recovery.js

@@ -0,0 +1,384 @@
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+import { logError, logWarn } from '@repo/shared/logs';
+import { checkFileAccess, getFileStats, safeMkdir, safeReaddir, safeReadFile, safeUnlink, safeWriteFile, } from './files';
+export class SessionRecoveryManager {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            maxSessionAge: options.maxSessionAge ?? 24 * 60 * 60 * 1000,
+            sessionDir: options.sessionDir ?? '.claude-sessions',
+            autoCleanup: options.autoCleanup ?? true,
+            retentionDays: options.retentionDays ?? 7,
+            validateCheckpoint: options.validateCheckpoint,
+        };
+    }
+    async saveCheckpoint(checkpoint) {
+        try {
+            await this.ensureSessionDirectory();
+            const checkpointPath = this.getCheckpointPath(checkpoint.sessionId);
+            const checkpointData = {
+                ...checkpoint,
+                timestamp: Date.now(),
+                metrics: {
+                    ...checkpoint.metrics,
+                    lastUpdateTime: Date.now(),
+                },
+            };
+            await safeWriteFile(checkpointPath, JSON.stringify(checkpointData, null, 2), {
+                allowedBasePaths: [this.options.sessionDir],
+                encoding: 'utf8',
+            });
+            return true;
+        }
+        catch (error) {
+            logError('Failed to save checkpoint', { error, sessionId: checkpoint.sessionId });
+            return false;
+        }
+    }
+    async loadCheckpoint(sessionId) {
+        try {
+            const checkpointPath = this.getCheckpointPath(sessionId);
+            const data = (await safeReadFile(checkpointPath, {
+                allowedBasePaths: [this.options.sessionDir],
+                encoding: 'utf8',
+            }));
+            const checkpoint = JSON.parse(data);
+            if (this.options.validateCheckpoint && !this.options.validateCheckpoint(checkpoint)) {
+                logWarn(`Invalid checkpoint for session ${sessionId}`, { sessionId });
+                return null;
+            }
+            return checkpoint;
+        }
+        catch (_error) {
+            return null;
+        }
+    }
+    async recoverSession(sessionId) {
+        try {
+            const checkpoint = await this.loadCheckpoint(sessionId);
+            if (!checkpoint) {
+                return {
+                    success: false,
+                    sessionId,
+                    error: 'Checkpoint not found or invalid',
+                    recommendations: [
+                        'Session may have been completed or cleaned up',
+                        'Try starting a new analysis session',
+                    ],
+                };
+            }
+            const sessionAge = Date.now() - checkpoint.timestamp;
+            if (sessionAge > this.options.maxSessionAge) {
+                return {
+                    success: false,
+                    sessionId,
+                    checkpoint,
+                    error: 'Session is too old to recover',
+                    recommendations: [
+                        'Session has exceeded maximum recovery age',
+                        'Consider starting a fresh analysis',
+                        `Session age: ${Math.round(sessionAge / (60 * 60 * 1000))} hours`,
+                    ],
+                };
+            }
+            const validation = await this.validateSessionState(checkpoint);
+            if (!validation.valid) {
+                return {
+                    success: false,
+                    sessionId,
+                    checkpoint,
+                    error: `Session validation failed: ${validation.reason}`,
+                    recommendations: validation.recommendations ?? [
+                        'Session state appears to be corrupted',
+                        'Consider starting a new analysis',
+                    ],
+                };
+            }
+            const resumeData = this.generateResumeData(checkpoint);
+            return {
+                success: true,
+                sessionId,
+                checkpoint,
+                resumeData,
+                recommendations: [
+                    `Session can be resumed from ${checkpoint.progress.phase}`,
+                    `${checkpoint.analysis.pendingFiles.length} files remaining to process`,
+                    `Previous progress: ${this.calculateProgressPercentage(checkpoint)}%`,
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                sessionId,
+                error: `Recovery failed: ${error instanceof Error ? error.message : String(error)}`,
+                recommendations: ['Check session directory permissions', 'Verify session data integrity'],
+            };
+        }
+    }
+    async listRecoverableSessions() {
+        try {
+            await this.ensureSessionDirectory();
+            const files = await safeReaddir(this.options.sessionDir, {
+                allowedBasePaths: [this.options.sessionDir],
+            });
+            const sessionFiles = files.filter(f => f.endsWith('.json'));
+            const sessions = [];
+            for (const file of sessionFiles) {
+                try {
+                    const sessionId = file.replace('.json', '');
+                    const checkpoint = await this.loadCheckpoint(sessionId);
+                    if (!checkpoint)
+                        continue;
+                    const status = this.determineSessionStatus(checkpoint);
+                    const progress = this.calculateProgressPercentage(checkpoint);
+                    sessions.push({
+                        sessionId,
+                        agentType: checkpoint.agentType,
+                        lastUpdate: checkpoint.metrics.lastUpdateTime,
+                        status,
+                        progress,
+                        filesProcessed: checkpoint.metrics.filesProcessed,
+                        estimatedCompletion: this.estimateCompletion(checkpoint),
+                    });
+                }
+                catch (_error) {
+                    continue;
+                }
+            }
+            return sessions.sort((a, b) => b.lastUpdate - a.lastUpdate);
+        }
+        catch (err) {
+            logError('Failed to list sessions', { error: err });
+            return [];
+        }
+    }
+    async cleanupSessions() {
+        const result = { cleaned: 0, errors: [] };
+        try {
+            const sessions = await this.listRecoverableSessions();
+            const now = Date.now();
+            const retentionMs = this.options.retentionDays * 24 * 60 * 60 * 1000;
+            for (const session of sessions) {
+                try {
+                    const shouldCleanup = (session.status === 'completed' && now - session.lastUpdate > retentionMs) ||
+                        session.status === 'stale' ||
+                        now - session.lastUpdate > this.options.maxSessionAge * 2;
+                    if (shouldCleanup) {
+                        await this.deleteSession(session.sessionId);
+                        result.cleaned++;
+                    }
+                }
+                catch (error) {
+                    result.errors.push(`Failed to cleanup session ${session.sessionId}: ${error}`);
+                }
+            }
+        }
+        catch (error) {
+            result.errors.push(`Cleanup failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return result;
+    }
+    async deleteSession(sessionId) {
+        try {
+            const checkpointPath = this.getCheckpointPath(sessionId);
+            await safeUnlink(checkpointPath, {
+                allowedBasePaths: [this.options.sessionDir],
+            });
+            return true;
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+    createCheckpoint(agentType, packagePath, userMessage, options) {
+        const sessionId = `session_${Date.now()}_${randomUUID().slice(0, 8)}`;
+        return {
+            sessionId,
+            timestamp: Date.now(),
+            agentType,
+            packagePath,
+            progress: {
+                phase: 'initialization',
+                completedSteps: 0,
+                totalSteps: 0,
+                currentStep: 'starting',
+                processingState: {},
+            },
+            analysis: {
+                completedFiles: [],
+                pendingFiles: [],
+                results: {},
+                errors: [],
+            },
+            context: {
+                userMessage,
+                options: options ?? {},
+                environment: {
+                    NODE_VERSION: process.version,
+                    PLATFORM: process.platform,
+                    MEMORY_LIMIT: '6144',
+                },
+            },
+            metrics: {
+                startTime: Date.now(),
+                lastUpdateTime: Date.now(),
+                memoryUsage: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
+                filesProcessed: 0,
+                errorsEncountered: 0,
+            },
+        };
+    }
+    async ensureSessionDirectory() {
+        try {
+            await checkFileAccess(this.options.sessionDir, {
+                allowedBasePaths: [this.options.sessionDir],
+            });
+        }
+        catch {
+            await safeMkdir(this.options.sessionDir, {
+                allowedBasePaths: [this.options.sessionDir],
+                recursive: true,
+            });
+        }
+    }
+    getCheckpointPath(sessionId) {
+        return join(this.options.sessionDir, `${sessionId}.json`);
+    }
+    async validateSessionState(checkpoint) {
+        try {
+            try {
+                await getFileStats(checkpoint.packagePath, {
+                    allowedBasePaths: [checkpoint.packagePath],
+                });
+            }
+            catch {
+                return {
+                    valid: false,
+                    reason: 'Package path no longer exists',
+                    recommendations: [
+                        'The project directory may have been moved or deleted',
+                        'Update the package path or start a new session',
+                    ],
+                };
+            }
+            if (checkpoint.workingDirectory) {
+                try {
+                    await getFileStats(checkpoint.workingDirectory, {
+                        allowedBasePaths: [checkpoint.workingDirectory],
+                    });
+                }
+                catch {
+                    return {
+                        valid: false,
+                        reason: 'Working directory no longer exists',
+                        recommendations: [
+                            'The working directory (worktree) may have been cleaned up',
+                            'Session may need to recreate working environment',
+                        ],
+                    };
+                }
+            }
+            if (!checkpoint.sessionId || !checkpoint.agentType || !checkpoint.packagePath) {
+                return {
+                    valid: false,
+                    reason: 'Missing required checkpoint fields',
+                    recommendations: ['Checkpoint data appears to be corrupted'],
+                };
+            }
+            return { valid: true };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                reason: `Validation error: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    generateResumeData(checkpoint) {
+        const nextStep = this.determineNextStep(checkpoint);
+        return {
+            pendingFiles: [...checkpoint.analysis.pendingFiles],
+            partialResults: { ...checkpoint.analysis.results },
+            nextStep,
+            continuationContext: {
+                phase: checkpoint.progress.phase,
+                processingState: checkpoint.progress.processingState,
+                previousErrors: checkpoint.analysis.errors,
+                lastProcessedFile: checkpoint.analysis.completedFiles.slice(-1)[0],
+                environmentContext: checkpoint.context.environment,
+            },
+        };
+    }
+    determineNextStep(checkpoint) {
+        if (checkpoint.analysis.pendingFiles.length === 0) {
+            return 'finalization';
+        }
+        switch (checkpoint.progress.phase) {
+            case 'initialization':
+                return 'file_discovery';
+            case 'file_discovery':
+                return 'analysis';
+            case 'analysis':
+                return checkpoint.analysis.pendingFiles.length > 0 ? 'continue_analysis' : 'reporting';
+            case 'reporting':
+                return 'finalization';
+            default:
+                return 'analysis';
+        }
+    }
+    calculateProgressPercentage(checkpoint) {
+        const totalFiles = checkpoint.analysis.completedFiles.length + checkpoint.analysis.pendingFiles.length;
+        if (totalFiles === 0)
+            return 0;
+        return Math.round((checkpoint.analysis.completedFiles.length / totalFiles) * 100);
+    }
+    determineSessionStatus(checkpoint) {
+        const age = Date.now() - checkpoint.metrics.lastUpdateTime;
+        const oneHour = 60 * 60 * 1000;
+        if (checkpoint.analysis.pendingFiles.length === 0 &&
+            checkpoint.progress.phase === 'completed') {
+            return 'completed';
+        }
+        if (age > oneHour * 2) {
+            return 'stale';
+        }
+        if (age > oneHour && checkpoint.analysis.errors.length > 0) {
+            return 'crashed';
+        }
+        return 'active';
+    }
+    estimateCompletion(checkpoint) {
+        const totalFiles = checkpoint.analysis.completedFiles.length + checkpoint.analysis.pendingFiles.length;
+        if (totalFiles === 0 || checkpoint.analysis.completedFiles.length === 0) {
+            return undefined;
+        }
+        const elapsed = checkpoint.metrics.lastUpdateTime - checkpoint.metrics.startTime;
+        const averageTimePerFile = elapsed / checkpoint.analysis.completedFiles.length;
+        const remainingTime = averageTimePerFile * checkpoint.analysis.pendingFiles.length;
+        return Date.now() + remainingTime;
+    }
+}
+let globalRecoveryManager = null;
+export function getSessionRecoveryManager(options) {
+    if (!globalRecoveryManager) {
+        globalRecoveryManager = new SessionRecoveryManager(options);
+    }
+    return globalRecoveryManager;
+}
+export async function hasRecoverableSessions(sessionDir) {
+    const manager = getSessionRecoveryManager({ sessionDir });
+    const sessions = await manager.listRecoverableSessions();
+    return sessions.filter(s => s.status === 'crashed' || s.status === 'active').length > 0;
+}
+export async function autoRecoverLatestSession(sessionDir) {
+    const manager = getSessionRecoveryManager({ sessionDir });
+    const sessions = await manager.listRecoverableSessions();
+    const recoverableSession = sessions.find(s => s.status === 'crashed' || s.status === 'active');
+    if (!recoverableSession) {
+        return null;
+    }
+    return await manager.recoverSession(recoverableSession.sessionId);
+}
+//# sourceMappingURL=session-recovery.js.map

package/typescript/dist/src/server/session-recovery.js.map

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

package/typescript/dist/src/server/session.d.ts

@@ -0,0 +1,18 @@
+import { BoundedCache } from './cache';
+export interface AgentSession {
+    sessionId: string;
+    agentType: string;
+    logger: any | null;
+    cache: BoundedCache | null;
+    startTime: number;
+}
+export interface SessionOptions {
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    cacheSize?: number;
+    cacheTTL?: number;
+    enableAnalytics?: boolean;
+}
+export declare function initializeAgentSession(sessionId: string, agentType: string, options?: SessionOptions): Promise<AgentSession>;
+export declare function closeAgentSession(session: AgentSession): Promise<void>;
+export declare function getSessionCacheKey(sessionId: string, operation: string, ...parts: string[]): string;
+//# sourceMappingURL=session.d.ts.map

package/typescript/dist/src/server/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../core-utils/src/server/session.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMvC,MAAM,WAAW,YAAY;IAE3B,SAAS,EAAE,MAAM,CAAC;IAElB,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAEnB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAE3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE/C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAsBD,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAoCvB;AAcD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5E;AAiBD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,KAAK,EAAE,MAAM,EAAE,GACjB,MAAM,CAIR"}

package/typescript/dist/src/server/session.js

@@ -0,0 +1,46 @@
+import { BoundedCache } from './cache';
+import { createMCPLogger } from './logger';
+export async function initializeAgentSession(sessionId, agentType, options = {}) {
+    const { logLevel = 'info', cacheSize = 100, cacheTTL = 1800000, enableAnalytics = true, } = options;
+    const logger = createMCPLogger({
+        sessionId: `${agentType}-${sessionId}`,
+        logLevel,
+        logDir: './logs',
+        maxBufferSize: 16384,
+        maxFileSize: 10485760,
+        maxFiles: 5,
+    });
+    const cache = new BoundedCache({
+        maxSize: cacheSize,
+        ttl: cacheTTL,
+        enableAnalytics,
+    });
+    await logger.info(`🚀 Initializing ${agentType} session: ${sessionId}`);
+    await logger.info(`📊 Cache: size=${cacheSize}, ttl=${cacheTTL}ms, analytics=${enableAnalytics}`);
+    return {
+        sessionId,
+        agentType,
+        logger,
+        cache,
+        startTime: Date.now(),
+    };
+}
+export async function closeAgentSession(session) {
+    const duration = Date.now() - session.startTime;
+    if (session.logger) {
+        await session.logger.info(`✅ Closing ${session.agentType} session after ${duration}ms`);
+        if (session.cache) {
+            const analytics = session.cache.getAnalytics();
+            await session.logger.info(`📈 Cache stats: ${analytics.hitRate} hit rate, ${analytics.currentSize} entries`);
+        }
+        await session.logger.close();
+    }
+    if (session.cache) {
+        session.cache.clear();
+    }
+}
+export function getSessionCacheKey(sessionId, operation, ...parts) {
+    const key = [sessionId, operation, ...parts].filter(Boolean).join(':');
+    return key.length > 100 ? `${key.substring(0, 97)}...` : key;
+}
+//# sourceMappingURL=session.js.map

package/typescript/dist/src/server/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../../core-utils/src/server/session.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAoD3C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiB,EACjB,SAAiB,EACjB,UAA0B,EAAE;IAE5B,MAAM,EACJ,QAAQ,GAAG,MAAM,EACjB,SAAS,GAAG,GAAG,EACf,QAAQ,GAAG,OAAO,EAClB,eAAe,GAAG,IAAI,GACvB,GAAG,OAAO,CAAC;IAGZ,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,SAAS,EAAE,GAAG,SAAS,IAAI,SAAS,EAAE;QACtC,QAAQ;QACR,MAAM,EAAE,QAAQ;QAChB,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,CAAC;KACZ,CAAC,CAAC;IAGH,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC;QAC7B,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,QAAQ;QACb,eAAe;KAChB,CAAC,CAAC;IAGH,MAAM,MAAM,CAAC,IAAI,CAAC,mBAAmB,SAAS,aAAa,SAAS,EAAE,CAAC,CAAC;IACxE,MAAM,MAAM,CAAC,IAAI,CAAC,kBAAkB,SAAS,SAAS,QAAQ,iBAAiB,eAAe,EAAE,CAAC,CAAC;IAElG,OAAO;QACL,SAAS;QACT,SAAS;QACT,MAAM;QACN,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAcD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAqB;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAEhD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,SAAS,kBAAkB,QAAQ,IAAI,CAAC,CAAC;QAGxF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CACvB,mBAAmB,SAAS,CAAC,OAAO,cAAc,SAAS,CAAC,WAAW,UAAU,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAiBD,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,SAAiB,EACjB,GAAG,KAAe;IAElB,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvE,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAC/D,CAAC"}

package/typescript/dist/src/server/simple-tools.d.ts

@@ -0,0 +1,15 @@
+export interface SimpleRetryOperationArgs {
+    operation: () => Promise<any>;
+    maxRetries?: number;
+    initialDelay?: number;
+}
+export declare function retryOperationTool(args: SimpleRetryOperationArgs): Promise<{
+    success: boolean;
+    result: any;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    result?: undefined;
+}>;
+//# sourceMappingURL=simple-tools.d.ts.map

package/typescript/dist/src/server/simple-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-tools.d.ts","sourceRoot":"","sources":["../../../../../core-utils/src/server/simple-tools.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,wBAAwB;IAEvC,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAE9B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAYD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,wBAAwB;;;;;;;;GAWtE"}

package/typescript/dist/src/server/simple-tools.js

@@ -0,0 +1,15 @@
+import { retryOperation, RetryPredicates } from './retry';
+export async function retryOperationTool(args) {
+    try {
+        const result = await retryOperation(args.operation, {
+            maxRetries: args.maxRetries,
+            initialDelay: args.initialDelay,
+            shouldRetry: RetryPredicates.temporaryErrors,
+        });
+        return { success: true, result };
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+    }
+}
+//# sourceMappingURL=simple-tools.js.map

package/typescript/dist/src/server/simple-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-tools.js","sourceRoot":"","sources":["../../../../../core-utils/src/server/simple-tools.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAyB1D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAA8B;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE;YAClD,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,eAAe,CAAC,eAAe;SAC7C,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAC7F,CAAC;AACH,CAAC"}