gthinking 1.2.1 → 2.1.1

package/dist/types/synthesis.js

@@ -1,3 +1,141 @@
 "use strict";
+/**
+ * Synthesis Types for gthinking v2.0.0
+ * Types for synthesis and final output generation
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormattedOutputSchema = exports.FormatOptionsSchema = exports.OutputFormatSchema = exports.OutputFormat = exports.SynthesisResultSchema = exports.ConfidenceBreakdownSchema = exports.DevilsAdvocatePointSchema = exports.EvaluationResultSchema = exports.RecommendationSchema = exports.SynthesisRequestSchema = void 0;
+const zod_1 = require("zod");
+const core_1 = require("./core");
+/**
+ * Synthesis Request Schema
+ */
+exports.SynthesisRequestSchema = zod_1.z.object({
+    query: zod_1.z.string().min(1),
+    stageResults: zod_1.z.array(zod_1.z.object({
+        stage: zod_1.z.string(),
+        result: zod_1.z.unknown(),
+        confidence: zod_1.z.number().min(0).max(1),
+    })).min(1),
+    options: zod_1.z.object({
+        includeDevilsAdvocate: zod_1.z.boolean().default(true),
+        includeConfidenceBreakdown: zod_1.z.boolean().default(true),
+        maxRecommendations: zod_1.z.number().positive().default(5),
+        format: zod_1.z.enum(['detailed', 'summary', 'structured', 'narrative']).default('detailed'),
+        language: zod_1.z.string().default('en'),
+    }).default({}),
+});
+/**
+ * Recommendation Schema
+ */
+exports.RecommendationSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    priority: zod_1.z.number().min(1).max(5),
+    title: zod_1.z.string(),
+    description: zod_1.z.string(),
+    rationale: zod_1.z.string(),
+    confidence: zod_1.z.number().min(0).max(1),
+    actions: zod_1.z.array(zod_1.z.string()),
+    expectedOutcome: zod_1.z.string(),
+    risks: zod_1.z.array(zod_1.z.string()).default([]),
+    resources: zod_1.z.array(zod_1.z.string()).default([]),
+    timeline: zod_1.z.string().optional(),
+});
+/**
+ * Evaluation Result Schema
+ */
+exports.EvaluationResultSchema = zod_1.z.object({
+    criterion: zod_1.z.string(),
+    score: zod_1.z.number().min(0).max(1),
+    weight: zod_1.z.number().min(0).max(1),
+    explanation: zod_1.z.string(),
+    confidence: zod_1.z.number().min(0).max(1),
+});
+/**
+ * Devil's Advocate Point Schema
+ */
+exports.DevilsAdvocatePointSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    target: zod_1.z.string(), // What is being challenged
+    challenge: zod_1.z.string(),
+    reasoning: zod_1.z.string(),
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    suggestedAlternative: zod_1.z.string().optional(),
+    confidence: zod_1.z.number().min(0).max(1),
+});
+/**
+ * Confidence Breakdown Schema
+ */
+exports.ConfidenceBreakdownSchema = zod_1.z.object({
+    overall: zod_1.z.number().min(0).max(1),
+    byStage: zod_1.z.record(zod_1.z.number().min(0).max(1)),
+    bySource: zod_1.z.record(zod_1.z.number().min(0).max(1)),
+    factors: zod_1.z.array(zod_1.z.object({
+        factor: zod_1.z.string(),
+        impact: zod_1.z.number().min(-1).max(1),
+        description: zod_1.z.string(),
+    })),
+});
+/**
+ * Synthesis Result Schema
+ */
+exports.SynthesisResultSchema = core_1.BaseResultSchema.extend({
+    query: zod_1.z.string(),
+    summary: zod_1.z.string(),
+    keyFindings: zod_1.z.array(zod_1.z.string()),
+    recommendations: zod_1.z.array(exports.RecommendationSchema),
+    evaluation: zod_1.z.array(exports.EvaluationResultSchema),
+    devilsAdvocate: zod_1.z.array(exports.DevilsAdvocatePointSchema).default([]),
+    confidenceBreakdown: exports.ConfidenceBreakdownSchema,
+    nextSteps: zod_1.z.array(zod_1.z.string()).default([]),
+    additionalConsiderations: zod_1.z.array(zod_1.z.string()).default([]),
+    sources: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        name: zod_1.z.string(),
+        type: zod_1.z.string(),
+        credibility: zod_1.z.number().min(0).max(1),
+    })).default([]),
+    metadata: zod_1.z.record(zod_1.z.unknown()).default({}),
+});
+/**
+ * Output Format Enum
+ */
+var OutputFormat;
+(function (OutputFormat) {
+    OutputFormat["JSON"] = "json";
+    OutputFormat["MARKDOWN"] = "markdown";
+    OutputFormat["HTML"] = "html";
+    OutputFormat["PLAIN"] = "plain";
+    OutputFormat["STRUCTURED"] = "structured";
+})(OutputFormat || (exports.OutputFormat = OutputFormat = {}));
+/**
+ * Output Format Schema
+ */
+exports.OutputFormatSchema = zod_1.z.nativeEnum(OutputFormat);
+/**
+ * Format Options Schema
+ */
+exports.FormatOptionsSchema = zod_1.z.object({
+    format: exports.OutputFormatSchema.default(OutputFormat.MARKDOWN),
+    includeMetadata: zod_1.z.boolean().default(false),
+    includeTimestamps: zod_1.z.boolean().default(true),
+    includeConfidence: zod_1.z.boolean().default(true),
+    maxLength: zod_1.z.number().positive().optional(),
+    language: zod_1.z.string().default('en'),
+    template: zod_1.z.string().optional(),
+});
+/**
+ * Formatted Output Schema
+ */
+exports.FormattedOutputSchema = zod_1.z.object({
+    content: zod_1.z.string(),
+    format: exports.OutputFormatSchema,
+    metadata: zod_1.z.object({
+        generatedAt: zod_1.z.date(),
+        version: zod_1.z.string(),
+        confidence: zod_1.z.number().min(0).max(1),
+        wordCount: zod_1.z.number().nonnegative(),
+        charCount: zod_1.z.number().nonnegative(),
+    }),
+});
 //# sourceMappingURL=synthesis.js.map

package/dist/types/synthesis.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Cache Utility for gthinking v2.0.0
+ * In-memory caching with TTL support
+ */
+/**
+ * Cache statistics interface
+ */
+export interface CacheStats {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    evictions: number;
+    totalAccesses: number;
+}
+/**
+ * Cache configuration interface
+ */
+export interface CacheConfig {
+    maxSize: number;
+    defaultTTL: number;
+    checkInterval: number;
+}
+/**
+ * In-memory cache with TTL support
+ */
+export declare class Cache<T> {
+    private cache;
+    private config;
+    private stats;
+    private cleanupInterval;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Get a value from the cache
+     * @param key - The cache key
+     * @returns The cached value or undefined
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set a value in the cache
+     * @param key - The cache key
+     * @param value - The value to cache
+     * @param ttl - Time to live in milliseconds (optional)
+     */
+    set(key: string, value: T, ttl?: number): void;
+    /**
+     * Check if a key exists in the cache
+     * @param key - The cache key
+     * @returns True if the key exists and hasn't expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a key from the cache
+     * @param key - The cache key
+     * @returns True if the key was deleted
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     * @returns Cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset cache statistics
+     */
+    resetStats(): void;
+    /**
+     * Get all keys in the cache
+     * @returns Array of cache keys
+     */
+    keys(): string[];
+    /**
+     * Get the number of entries in the cache
+     * @returns Number of entries
+     */
+    size(): number;
+    /**
+     * Dispose of the cache and stop cleanup interval
+     */
+    dispose(): void;
+    /**
+     * Check if an entry has expired
+     * @param entry - The cache entry
+     * @returns True if the entry has expired
+     */
+    private isExpired;
+    /**
+     * Evict the least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Clean up expired entries
+     */
+    private cleanup;
+    /**
+     * Start the cleanup interval
+     */
+    private startCleanupInterval;
+}
+/**
+ * Cache manager for managing multiple cache instances
+ */
+export declare class CacheManager {
+    private caches;
+    /**
+     * Get or create a cache instance
+     * @param name - The cache name
+     * @param config - Cache configuration
+     * @returns Cache instance
+     */
+    getCache<T>(name: string, config?: Partial<CacheConfig>): Cache<T>;
+    /**
+     * Delete a cache instance
+     * @param name - The cache name
+     */
+    deleteCache(name: string): void;
+    /**
+     * Clear all caches
+     */
+    clearAll(): void;
+    /**
+     * Dispose of all caches
+     */
+    dispose(): void;
+    /**
+     * Get all cache names
+     * @returns Array of cache names
+     */
+    getCacheNames(): string[];
+}
+export declare const cacheManager: CacheManager;
+/**
+ * Memoize decorator for caching function results
+ * @param fn - The function to memoize
+ * @param keyGenerator - Function to generate cache key from arguments
+ * @param ttl - Time to live in milliseconds
+ * @returns Memoized function
+ */
+export declare function memoize<T extends (...args: unknown[]) => unknown>(fn: T, keyGenerator?: (...args: Parameters<T>) => string, ttl?: number): T;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAWD;;GAEG;AACH,qBAAa,KAAK,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,eAAe,CAA+B;gBAE1C,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAK7C;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAwBtC;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBrD;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAehC;;;;OAIG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;;OAGG;IACI,QAAQ,IAAI,UAAU;IAc7B;;OAEG;IACI,UAAU,IAAI,IAAI;IASzB;;;OAGG;IACI,IAAI,IAAI,MAAM,EAAE;IAIvB;;;OAGG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,OAAO,IAAI,IAAI;IAQtB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;OAEG;IACH,OAAO,CAAC,OAAO;IAgBf;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAK7B;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA0C;IAExD;;;;;OAKG;IACI,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAOzE;;;OAGG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQtC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAMvB;;OAEG;IACI,OAAO,IAAI,IAAI;IAOtB;;;OAGG;IACI,aAAa,IAAI,MAAM,EAAE;CAGjC;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC/D,EAAE,EAAE,CAAC,EACL,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,EACjD,GAAG,CAAC,EAAE,MAAM,GACX,CAAC,CAgBH"}

package/dist/utils/cache.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * Cache Utility for gthinking v2.0.0
+ * In-memory caching with TTL support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheManager = exports.CacheManager = exports.Cache = void 0;
+exports.memoize = memoize;
+const logger_1 = require("./logger");
+const logger = new logger_1.Logger('Cache');
+/**
+ * Default cache configuration
+ */
+const defaultConfig = {
+    maxSize: 1000,
+    defaultTTL: 3600000, // 1 hour
+    checkInterval: 60000, // 1 minute
+};
+/**
+ * In-memory cache with TTL support
+ */
+class Cache {
+    cache = new Map();
+    config;
+    stats = {
+        hits: 0,
+        misses: 0,
+        evictions: 0,
+        totalAccesses: 0,
+    };
+    cleanupInterval = null;
+    constructor(config = {}) {
+        this.config = { ...defaultConfig, ...config };
+        this.startCleanupInterval();
+    }
+    /**
+     * Get a value from the cache
+     * @param key - The cache key
+     * @returns The cached value or undefined
+     */
+    get(key) {
+        this.stats.totalAccesses++;
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return undefined;
+        }
+        // Check if entry has expired
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            this.stats.misses++;
+            return undefined;
+        }
+        // Update access count
+        entry.accessCount++;
+        this.stats.hits++;
+        return entry.value;
+    }
+    /**
+     * Set a value in the cache
+     * @param key - The cache key
+     * @param value - The value to cache
+     * @param ttl - Time to live in milliseconds (optional)
+     */
+    set(key, value, ttl) {
+        // Evict entries if cache is full
+        if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {
+            this.evictLRU();
+        }
+        const entry = {
+            value,
+            timestamp: Date.now(),
+            ttl: ttl ?? this.config.defaultTTL,
+            accessCount: 0,
+        };
+        this.cache.set(key, entry);
+    }
+    /**
+     * Check if a key exists in the cache
+     * @param key - The cache key
+     * @returns True if the key exists and hasn't expired
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delete a key from the cache
+     * @param key - The cache key
+     * @returns True if the key was deleted
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all entries from the cache
+     */
+    clear() {
+        this.cache.clear();
+        logger.info('Cache cleared');
+    }
+    /**
+     * Get cache statistics
+     * @returns Cache statistics
+     */
+    getStats() {
+        const totalAccesses = this.stats.totalAccesses;
+        const hitRate = totalAccesses > 0 ? this.stats.hits / totalAccesses : 0;
+        return {
+            size: this.cache.size,
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            hitRate,
+            evictions: this.stats.evictions,
+            totalAccesses,
+        };
+    }
+    /**
+     * Reset cache statistics
+     */
+    resetStats() {
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+            totalAccesses: 0,
+        };
+    }
+    /**
+     * Get all keys in the cache
+     * @returns Array of cache keys
+     */
+    keys() {
+        return Array.from(this.cache.keys());
+    }
+    /**
+     * Get the number of entries in the cache
+     * @returns Number of entries
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Dispose of the cache and stop cleanup interval
+     */
+    dispose() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.clear();
+    }
+    /**
+     * Check if an entry has expired
+     * @param entry - The cache entry
+     * @returns True if the entry has expired
+     */
+    isExpired(entry) {
+        return Date.now() - entry.timestamp > entry.ttl;
+    }
+    /**
+     * Evict the least recently used entry
+     */
+    evictLRU() {
+        let oldestKey = null;
+        let oldestTimestamp = Infinity;
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.timestamp < oldestTimestamp) {
+                oldestTimestamp = entry.timestamp;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            this.stats.evictions++;
+            logger.debug(`Evicted LRU entry: ${oldestKey}`);
+        }
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let expiredCount = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > entry.ttl) {
+                this.cache.delete(key);
+                expiredCount++;
+            }
+        }
+        if (expiredCount > 0) {
+            logger.debug(`Cleaned up ${expiredCount} expired entries`);
+        }
+    }
+    /**
+     * Start the cleanup interval
+     */
+    startCleanupInterval() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, this.config.checkInterval);
+    }
+}
+exports.Cache = Cache;
+/**
+ * Cache manager for managing multiple cache instances
+ */
+class CacheManager {
+    caches = new Map();
+    /**
+     * Get or create a cache instance
+     * @param name - The cache name
+     * @param config - Cache configuration
+     * @returns Cache instance
+     */
+    getCache(name, config) {
+        if (!this.caches.has(name)) {
+            this.caches.set(name, new Cache(config));
+        }
+        return this.caches.get(name);
+    }
+    /**
+     * Delete a cache instance
+     * @param name - The cache name
+     */
+    deleteCache(name) {
+        const cache = this.caches.get(name);
+        if (cache) {
+            cache.dispose();
+            this.caches.delete(name);
+        }
+    }
+    /**
+     * Clear all caches
+     */
+    clearAll() {
+        for (const cache of this.caches.values()) {
+            cache.clear();
+        }
+    }
+    /**
+     * Dispose of all caches
+     */
+    dispose() {
+        for (const [name, cache] of this.caches.entries()) {
+            cache.dispose();
+        }
+        this.caches.clear();
+    }
+    /**
+     * Get all cache names
+     * @returns Array of cache names
+     */
+    getCacheNames() {
+        return Array.from(this.caches.keys());
+    }
+}
+exports.CacheManager = CacheManager;
+// Export a singleton cache manager
+exports.cacheManager = new CacheManager();
+/**
+ * Memoize decorator for caching function results
+ * @param fn - The function to memoize
+ * @param keyGenerator - Function to generate cache key from arguments
+ * @param ttl - Time to live in milliseconds
+ * @returns Memoized function
+ */
+function memoize(fn, keyGenerator, ttl) {
+    const cache = new Cache();
+    return function (...args) {
+        const key = keyGenerator ? keyGenerator(...args) : JSON.stringify(args);
+        const cached = cache.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const result = fn(...args);
+        cache.set(key, result, ttl);
+        return result;
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/id-generator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * ID Generator Utility for gthinking v2.0.0
+ * Secure and collision-resistant ID generation
+ */
+/**
+ * Generate a random UUID v4
+ * @returns A random UUID string
+ */
+export declare function generateUUID(): string;
+/**
+ * Generate a deterministic UUID v5 based on a namespace and name
+ * @param namespace - The namespace UUID
+ * @param name - The name to hash
+ * @returns A deterministic UUID string
+ */
+export declare function generateDeterministicUUID(namespace: string, name: string): string;
+/**
+ * Generate a short ID (8 characters) for internal use
+ * Note: This is not cryptographically secure, use only for non-sensitive IDs
+ * @returns A short random string
+ */
+export declare function generateShortId(): string;
+/**
+ * Generate a timestamp-based ID with random suffix
+ * @param prefix - Optional prefix for the ID
+ * @returns A timestamp-based ID string
+ */
+export declare function generateTimestampId(prefix?: string): string;
+/**
+ * Generate a sequential ID with padding
+ * @param sequence - The sequence number
+ * @param padding - The number of digits to pad to
+ * @returns A padded sequential ID string
+ */
+export declare function generateSequentialId(sequence: number, padding?: number): string;
+/**
+ * Generate a compound ID from multiple parts
+ * @param parts - The parts to combine
+ * @param separator - The separator to use (default: '_')
+ * @returns A compound ID string
+ */
+export declare function generateCompoundId(parts: string[], separator?: string): string;
+/**
+ * Validate if a string is a valid UUID
+ * @param id - The string to validate
+ * @returns True if the string is a valid UUID
+ */
+export declare function isValidUUID(id: string): boolean;
+/**
+ * Namespace UUIDs for deterministic ID generation
+ */
+export declare const Namespaces: {
+    readonly DNS: "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
+    readonly URL: "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
+    readonly OID: "6ba7b812-9dad-11d1-80b4-00c04fd430c8";
+    readonly X500: "6ba7b814-9dad-11d1-80b4-00c04fd430c8";
+    readonly SESSION: "a7b8c9d0-e1f2-4a3b-8c4d-5e6f7a8b9c0d";
+    readonly TASK: "b8c9d0e1-f2a3-5b4c-9d5e-6f7a8b9c0d1e";
+    readonly IDEA: "c9d0e1f2-a3b4-6c5d-0e6f-7a8b9c0d1e2f";
+};
+/**
+ * ID Generator class for managing ID generation with prefixes
+ */
+export declare class IdGenerator {
+    private counters;
+    /**
+     * Generate a prefixed ID with an auto-incrementing counter
+     * @param prefix - The prefix for the ID
+     * @returns A prefixed ID string
+     */
+    generatePrefixedId(prefix: string): string;
+    /**
+     * Reset the counter for a specific prefix
+     * @param prefix - The prefix to reset
+     */
+    resetCounter(prefix: string): void;
+    /**
+     * Reset all counters
+     */
+    resetAllCounters(): void;
+    /**
+     * Get the current counter value for a prefix
+     * @param prefix - The prefix to check
+     * @returns The current counter value
+     */
+    getCounter(prefix: string): number;
+}
+export declare const idGenerator: IdGenerator;
+//# sourceMappingURL=id-generator.d.ts.map