tracelattice 1.2.5

package/dist/core/ThoughtProcessor.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Core thought processing logic and validation.
+ *
+ * This module provides the `ThoughtProcessor` class which handles the main
+ * sequential thinking request processing pipeline, including input validation,
+ * history management, and response formatting.
+ *
+ * @module processor
+ */
+import type { Logger } from '../logger/StructuredLogger.js';
+import type { IHistoryManager } from './IHistoryManager.js';
+import type { ThoughtData } from './thought.js';
+import type { ThoughtEvaluator } from './ThoughtEvaluator.js';
+import { ThoughtFormatter } from './ThoughtFormatter.js';
+/**
+ * The return type expected by MCP tool invocations.
+ *
+ * This structure matches the MCP protocol for tool results,
+ * supporting both success and error responses.
+ *
+ * @example
+ * ```typescript
+ * const successResult: CallToolResult = {
+ *   content: [{ type: 'text', text: '{"status":"success"}' }]
+ * };
+ *
+ * const errorResult: CallToolResult = {
+ *   content: [{ type: 'text', text: '{"error":"Something went wrong"}' }],
+ *   isError: true
+ * };
+ * ```
+ */
+export interface CallToolResult {
+    /** Array of content blocks (typically text) to return to the client. */
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    /** Whether this result represents an error condition. */
+    isError?: boolean;
+}
+/**
+ * Core processor for sequential thinking requests.
+ *
+ * This class handles the main processing pipeline for thought requests,
+ * coordinating between history management, validation, and response formatting.
+ * It serves as the central entry point for the sequential thinking tool.
+ *
+ * @remarks
+ * **Processing Pipeline:**
+ * 1. Validate and normalize the input thought
+ * 2. Add the thought to history (triggers auto-trimming if needed)
+ * 3. Format the thought for logging/display
+ * 4. Compute quality signals via ThoughtEvaluator
+ * 5. Return structured response with metadata and reasoning enrichment
+ *
+ * **Validation Rules:**
+ * - `thought_number` must be >= 1
+ * - `total_thoughts` must be >= 1
+ * - If `thought_number > total_thoughts`, `total_thoughts` is auto-adjusted
+ *
+ * **Error Handling:**
+ * All errors are caught and returned as formatted error responses
+ * with `isError: true` set, preventing crashes from malformed input.
+ *
+ * @example
+ * ```typescript
+ * const processor = new ThoughtProcessor(historyManager, formatter, new ThoughtEvaluator());
+ *
+ * const result = await processor.process({
+ *   thought: 'I need to analyze the codebase structure',
+ *   thought_number: 1,
+ *   total_thoughts: 5,
+ *   next_thought_needed: true,
+ *   available_mcp_tools: ['Read', 'Grep', 'Glob'],
+ *   current_step: {
+ *     step_description: 'Analyze codebase structure',
+ *     recommended_tools: [{
+ *       tool_name: 'Glob',
+ *       confidence: 0.9,
+ *       rationale: 'Best for finding files by pattern',
+ *       priority: 1
+ *     }],
+ *     expected_outcome: 'List of all TypeScript files'
+ *   }
+ * });
+ * ```
+ */
+export declare class ThoughtProcessor {
+    private historyManager;
+    private thoughtFormatter;
+    /** Logger for debugging and monitoring. */
+    private _logger;
+    /** Evaluator for quality signal computation. */
+    private readonly _thoughtEvaluator;
+    /**
+     * Per-session cooldown tracker: session_id → pattern → last_fired_thought_number.
+     * Prevents re-firing the same pattern hint within 3 thoughts.
+     */
+    private _hintCooldowns;
+    /**
+     * Creates a new ThoughtProcessor instance.
+     *
+     * @param historyManager - The history manager for storing thoughts
+     * @param thoughtFormatter - The formatter for output formatting
+     * @param thoughtEvaluator - Evaluator for quality signal computation
+     * @param logger - Optional logger for diagnostics (defaults to NullLogger)
+     *
+     * @example
+     * ```typescript
+     * const processor = new ThoughtProcessor(
+     *   historyManager,
+     *   new ThoughtFormatter(),
+     *   new ThoughtEvaluator(),
+     *   logger,
+     * );
+     * ```
+     */
+    constructor(historyManager: IHistoryManager, thoughtFormatter: ThoughtFormatter, thoughtEvaluator: ThoughtEvaluator, logger?: Logger);
+    /**
+     * Internal logging method.
+     * @param message - The message to log
+     * @param meta - Optional metadata
+     * @private
+     */
+    private log;
+    /**
+     * Generate actionable hints from pattern signals.
+     * Rules: max 3 hints, warning-severity only, cooldown of 3 thoughts per pattern per session.
+     *
+     * @param patterns - Detected pattern signals
+     * @param currentThoughtNumber - The current thought number being processed
+     * @param sessionId - Session identifier for cooldown scoping
+     * @returns Array of hint strings (max 3), empty if no warnings
+     */
+    private _generateHints;
+    /**
+     * Processes a thought through the sequential thinking pipeline.
+     *
+     * This method validates the input, adds it to history, formats the output,
+     * computes quality signals via the ThoughtEvaluator, and returns
+     * a structured response with metadata about the current state.
+     *
+     * @param input - The thought data to process
+     * @returns A Promise resolving to the formatted tool result containing:
+     *   - `thought_number` — Current thought index
+     *   - `total_thoughts` — Estimated total thoughts
+     *   - `next_thought_needed` — Whether to continue
+     *   - `branches` — Active branch IDs
+     *   - `thought_history_length` — Number of thoughts in history
+     *   - `available_mcp_tools` — MCP tools available for recommendation
+     *   - `available_skills` — Skills available for recommendation
+     *   - `current_step` — Current step recommendation
+     *   - `previous_steps` — Previously recommended steps
+     *   - `remaining_steps` — Upcoming step descriptions
+     *   - `thought_type` — Classification of thought purpose (optional)
+     *   - `quality_score` — Self-assessed quality score 0-1 (optional)
+     *   - `confidence` — Self-assessed confidence 0-1 (optional)
+     *   - `hypothesis_id` — Hypothesis link for verification chains (optional)
+ *   - `confidence_signals` — Computed reasoning quality signals (includes structural_quality and quality_components)
+ *   - `reasoning_stats` — Aggregated reasoning analytics
+ *   - `reasoning_hints` — (Conditional) Actionable hints from pattern analysis, max 3, warning-severity only (optional)
+     *
+     * @example
+     * ```typescript
+     * const result = await processor.process({
+     *   thought: 'I should read the README file',
+     *   thought_number: 1,
+     *   total_thoughts: 3,
+     *   next_thought_needed: true
+     * });
+     *
+     * console.log(result.content[0].text);
+     * // Output includes: thought_number, total_thoughts, next_thought_needed,
+     * // branches, thought_history_length, and any recommendations
+     * ```
+     */
+    process(input: ThoughtData): Promise<CallToolResult>;
+    /**
+     * Validates and normalizes thought input.
+     *
+     * Ensures that thought numbers are consistent and within valid ranges.
+     * If `thought_number` exceeds `total_thoughts`, `total_thoughts` is
+     * automatically adjusted to match and a warning is emitted.
+     *
+     * @param input - The input to validate
+     * @returns Object with validated input and any warnings generated
+     * @private
+     *
+     * @example
+     * ```typescript
+     * // Auto-adjusts total_thoughts when thought_number exceeds it
+     * const { result, warnings } = this.validateInput(input);
+     * // result.total_thoughts === 10 (auto-adjusted from 5)
+     * // warnings === ['Auto-adjusted total_thoughts from 5 to 10 to match thought_number']
+     * ```
+     */
+    private validateInput;
+    /**
+     * Validates cross-field references against actual thought history.
+     * Drops invalid references with a warning log — never rejects.
+     * LLMs frequently send optimistic references to thoughts that don't exist yet.
+     *
+     * @param input - The thought data to validate
+     * @returns Object with cleaned input and any warnings generated
+     * @private
+     *
+     * @example
+     * ```typescript
+     * // verification_target=999 with only 3 thoughts in history
+     * const { result, warnings } = this._validateCrossReferences(input);
+     * // result.verification_target === undefined
+     * // warnings === ['Dropped dangling verification_target: 999 (history has 3 thoughts)']
+     * ```
+     */
+    private _validateCrossReferences;
+}
+//# sourceMappingURL=ThoughtProcessor.d.ts.map

package/dist/core/ThoughtProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThoughtProcessor.d.ts","sourceRoot":"","sources":["../../src/core/ThoughtProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC9B,wEAAwE;IACxE,OAAO,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IAEH,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,gBAAgB;IAgC3B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,gBAAgB;IAhCzB,2CAA2C;IAC3C,OAAO,CAAC,OAAO,CAAS;IAExB,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IAErD;;;OAGG;IACH,OAAO,CAAC,cAAc,CAA0C;IAEhE;;;;;;;;;;;;;;;;;OAiBG;gBAEM,cAAc,EAAE,eAAe,EAC/B,gBAAgB,EAAE,gBAAgB,EAC1C,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,CAAC,EAAE,MAAM;IAMhB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAIX;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IA8BtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACU,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IA6GjE;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,wBAAwB;CAmGhC"}

package/dist/core/ThoughtProcessor.js

@@ -0,0 +1,205 @@
+import { NullLogger } from "../logger/NullLogger.js";
+import { normalizeInput } from "./InputNormalizer.js";
+class ThoughtProcessor {
+    historyManager;
+    thoughtFormatter;
+    _logger;
+    _thoughtEvaluator;
+    _hintCooldowns = new Map();
+    constructor(historyManager, thoughtFormatter, thoughtEvaluator, logger){
+        this.historyManager = historyManager;
+        this.thoughtFormatter = thoughtFormatter;
+        this._thoughtEvaluator = thoughtEvaluator;
+        this._logger = logger ?? new NullLogger();
+    }
+    log(message, meta) {
+        this._logger.info(message, meta);
+    }
+    _generateHints(patterns, currentThoughtNumber, sessionId) {
+        const warnings = patterns.filter((p)=>'warning' === p.severity);
+        if (0 === warnings.length) return [];
+        const sessionKey = sessionId ?? '__global__';
+        if (!this._hintCooldowns.has(sessionKey)) this._hintCooldowns.set(sessionKey, new Map());
+        const cooldowns = this._hintCooldowns.get(sessionKey);
+        const hints = [];
+        for (const warning of warnings){
+            if (hints.length >= 3) break;
+            const lastFired = cooldowns.get(warning.pattern);
+            if (void 0 === lastFired || !(currentThoughtNumber - lastFired < 3)) {
+                hints.push(warning.message);
+                cooldowns.set(warning.pattern, currentThoughtNumber);
+            }
+        }
+        return hints;
+    }
+    async process(input) {
+        try {
+            const normalizedInput = normalizeInput(input);
+            const sessionId = normalizedInput.session_id;
+            if (normalizedInput.reset_state) {
+                this.historyManager.clear(sessionId);
+                this.log('State reset for session', {
+                    sessionId: sessionId ?? '__global__'
+                });
+            }
+            if (!normalizedInput.available_mcp_tools) normalizedInput.available_mcp_tools = this.historyManager.getAvailableMcpTools(sessionId);
+            if (!normalizedInput.available_skills) normalizedInput.available_skills = this.historyManager.getAvailableSkills(sessionId);
+            const { result: validatedInput, warnings: validateWarnings } = this.validateInput(normalizedInput);
+            const { result: checkedInput, warnings: refWarnings } = this._validateCrossReferences(validatedInput, sessionId);
+            const allWarnings = [
+                ...validateWarnings,
+                ...refWarnings
+            ];
+            this.historyManager.addThought(checkedInput);
+            const formattedThought = this.thoughtFormatter.formatThought(checkedInput);
+            this.log(formattedThought, {
+                sessionId: sessionId ?? '__global__'
+            });
+            const history = this.historyManager.getHistory(sessionId);
+            const branches = this.historyManager.getBranches(sessionId);
+            const confidenceSignals = this._thoughtEvaluator.computeConfidenceSignals(history, branches);
+            const reasoningStats = this._thoughtEvaluator.computeReasoningStats(history, branches);
+            const patternSignals = this._thoughtEvaluator.computePatternSignals(history, branches);
+            const reasoningHints = this._generateHints(patternSignals, checkedInput.thought_number, sessionId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            thought_number: checkedInput.thought_number,
+                            total_thoughts: checkedInput.total_thoughts,
+                            next_thought_needed: checkedInput.next_thought_needed ?? true,
+                            branches: this.historyManager.getBranchIds(sessionId),
+                            thought_history_length: this.historyManager.getHistoryLength(sessionId),
+                            available_mcp_tools: checkedInput.available_mcp_tools,
+                            available_skills: checkedInput.available_skills,
+                            current_step: checkedInput.current_step,
+                            previous_steps: checkedInput.previous_steps,
+                            remaining_steps: checkedInput.remaining_steps,
+                            thought_type: checkedInput.thought_type,
+                            quality_score: checkedInput.quality_score,
+                            confidence: checkedInput.confidence,
+                            hypothesis_id: checkedInput.hypothesis_id,
+                            confidence_signals: confidenceSignals,
+                            reasoning_stats: reasoningStats,
+                            ...reasoningHints.length > 0 && {
+                                reasoning_hints: reasoningHints
+                            },
+                            ...allWarnings.length > 0 && {
+                                warnings: allWarnings
+                            },
+                            ...sessionId ? {
+                                session_id: sessionId
+                            } : {}
+                        }, null, 2)
+                    }
+                ]
+            };
+        } catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                            status: 'failed'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+    validateInput(input) {
+        const warnings = [];
+        if (input.thought_number > input.total_thoughts) {
+            const originalTotal = input.total_thoughts;
+            warnings.push(`Auto-adjusted total_thoughts from ${originalTotal} to ${input.thought_number} to match thought_number`);
+            this._logger.warn('Auto-adjusted total_thoughts to match thought_number', {
+                thought_number: input.thought_number,
+                original_total_thoughts: originalTotal,
+                adjusted_total_thoughts: input.thought_number
+            });
+            input.total_thoughts = input.thought_number;
+        }
+        return {
+            result: input,
+            warnings
+        };
+    }
+    _validateCrossReferences(input, sessionId) {
+        const warnings = [];
+        const historyLength = this.historyManager.getHistoryLength(sessionId);
+        const branchIds = new Set(this.historyManager.getBranchIds(sessionId));
+        if (void 0 !== input.verification_target && input.verification_target > historyLength) {
+            warnings.push(`Dropped dangling verification_target: ${input.verification_target} (history has ${historyLength} thoughts)`);
+            this._logger.warn('Dropped dangling verification_target', {
+                verification_target: input.verification_target,
+                historyLength
+            });
+            input.verification_target = void 0;
+        }
+        if (void 0 !== input.revises_thought && input.revises_thought > historyLength) {
+            warnings.push(`Dropped dangling revises_thought: ${input.revises_thought} (history has ${historyLength} thoughts)`);
+            this._logger.warn('Dropped dangling revises_thought', {
+                revises_thought: input.revises_thought,
+                historyLength
+            });
+            input.revises_thought = void 0;
+        }
+        if (void 0 !== input.branch_from_thought && input.branch_from_thought > historyLength) {
+            warnings.push(`Dropped dangling branch_from_thought: ${input.branch_from_thought} (history has ${historyLength} thoughts)`);
+            this._logger.warn('Dropped dangling branch_from_thought', {
+                branch_from_thought: input.branch_from_thought,
+                historyLength
+            });
+            input.branch_from_thought = void 0;
+        }
+        if (input.synthesis_sources?.length) {
+            const valid = input.synthesis_sources.filter((n)=>n <= historyLength);
+            if (valid.length < input.synthesis_sources.length) {
+                const dropped = input.synthesis_sources.filter((n)=>n > historyLength);
+                warnings.push(`Filtered dangling synthesis_sources: [${dropped.join(', ')}] (history has ${historyLength} thoughts)`);
+                this._logger.warn('Filtered dangling synthesis_sources', {
+                    original: input.synthesis_sources,
+                    filtered: valid,
+                    historyLength
+                });
+            }
+            input.synthesis_sources = valid.length > 0 ? valid : void 0;
+        }
+        if (input.merge_from_thoughts?.length) {
+            const valid = input.merge_from_thoughts.filter((n)=>n <= historyLength);
+            if (valid.length < input.merge_from_thoughts.length) {
+                const dropped = input.merge_from_thoughts.filter((n)=>n > historyLength);
+                warnings.push(`Filtered dangling merge_from_thoughts: [${dropped.join(', ')}] (history has ${historyLength} thoughts)`);
+                this._logger.warn('Filtered dangling merge_from_thoughts', {
+                    original: input.merge_from_thoughts,
+                    filtered: valid,
+                    historyLength
+                });
+            }
+            input.merge_from_thoughts = valid.length > 0 ? valid : void 0;
+        }
+        if (input.merge_branch_ids?.length) {
+            const valid = input.merge_branch_ids.filter((id)=>branchIds.has(id));
+            if (valid.length < input.merge_branch_ids.length) {
+                const dropped = input.merge_branch_ids.filter((id)=>!branchIds.has(id));
+                warnings.push(`Filtered dangling merge_branch_ids: [${dropped.join(', ')}]`);
+                this._logger.warn('Filtered dangling merge_branch_ids', {
+                    original: input.merge_branch_ids,
+                    filtered: valid,
+                    existingBranches: Array.from(branchIds)
+                });
+            }
+            input.merge_branch_ids = valid.length > 0 ? valid : void 0;
+        }
+        return {
+            result: input,
+            warnings
+        };
+    }
+}
+export { ThoughtProcessor };
+
+//# sourceMappingURL=ThoughtProcessor.js.map

package/dist/core/ThoughtProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/ThoughtProcessor.js","sources":["../../src/core/ThoughtProcessor.ts"],"sourcesContent":["/**\n * Core thought processing logic and validation.\n *\n * This module provides the `ThoughtProcessor` class which handles the main\n * sequential thinking request processing pipeline, including input validation,\n * history management, and response formatting.\n *\n * @module processor\n */\n\nimport { NullLogger } from '../logger/NullLogger.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\nimport type { IHistoryManager } from './IHistoryManager.js';\nimport { normalizeInput } from './InputNormalizer.js';\nimport type { ThoughtData } from './thought.js';\nimport type { ThoughtEvaluator } from './ThoughtEvaluator.js';\nimport { ThoughtFormatter } from './ThoughtFormatter.js';\nimport type { PatternSignal } from './reasoning.js';\n\n/**\n * The return type expected by MCP tool invocations.\n *\n * This structure matches the MCP protocol for tool results,\n * supporting both success and error responses.\n *\n * @example\n * ```typescript\n * const successResult: CallToolResult = {\n *   content: [{ type: 'text', text: '{\"status\":\"success\"}' }]\n * };\n *\n * const errorResult: CallToolResult = {\n *   content: [{ type: 'text', text: '{\"error\":\"Something went wrong\"}' }],\n *   isError: true\n * };\n * ```\n */\nexport interface CallToolResult {\n\t/** Array of content blocks (typically text) to return to the client. */\n\tcontent: Array<{\n\t\ttype: 'text';\n\t\ttext: string;\n\t}>;\n\n\t/** Whether this result represents an error condition. */\n\tisError?: boolean;\n}\n\n/**\n * Core processor for sequential thinking requests.\n *\n * This class handles the main processing pipeline for thought requests,\n * coordinating between history management, validation, and response formatting.\n * It serves as the central entry point for the sequential thinking tool.\n *\n * @remarks\n * **Processing Pipeline:**\n * 1. Validate and normalize the input thought\n * 2. Add the thought to history (triggers auto-trimming if needed)\n * 3. Format the thought for logging/display\n * 4. Compute quality signals via ThoughtEvaluator\n * 5. Return structured response with metadata and reasoning enrichment\n *\n * **Validation Rules:**\n * - `thought_number` must be >= 1\n * - `total_thoughts` must be >= 1\n * - If `thought_number > total_thoughts`, `total_thoughts` is auto-adjusted\n *\n * **Error Handling:**\n * All errors are caught and returned as formatted error responses\n * with `isError: true` set, preventing crashes from malformed input.\n *\n * @example\n * ```typescript\n * const processor = new ThoughtProcessor(historyManager, formatter, new ThoughtEvaluator());\n *\n * const result = await processor.process({\n *   thought: 'I need to analyze the codebase structure',\n *   thought_number: 1,\n *   total_thoughts: 5,\n *   next_thought_needed: true,\n *   available_mcp_tools: ['Read', 'Grep', 'Glob'],\n *   current_step: {\n *     step_description: 'Analyze codebase structure',\n *     recommended_tools: [{\n *       tool_name: 'Glob',\n *       confidence: 0.9,\n *       rationale: 'Best for finding files by pattern',\n *       priority: 1\n *     }],\n *     expected_outcome: 'List of all TypeScript files'\n *   }\n * });\n * ```\n */\nexport class ThoughtProcessor {\n\t/** Logger for debugging and monitoring. */\n\tprivate _logger: Logger;\n\n\t/** Evaluator for quality signal computation. */\n\tprivate readonly _thoughtEvaluator: ThoughtEvaluator;\n\n\t/**\n\t * Per-session cooldown tracker: session_id → pattern → last_fired_thought_number.\n\t * Prevents re-firing the same pattern hint within 3 thoughts.\n\t */\n\tprivate _hintCooldowns = new Map<string, Map<string, number>>();\n\n\t/**\n\t * Creates a new ThoughtProcessor instance.\n\t *\n\t * @param historyManager - The history manager for storing thoughts\n\t * @param thoughtFormatter - The formatter for output formatting\n\t * @param thoughtEvaluator - Evaluator for quality signal computation\n\t * @param logger - Optional logger for diagnostics (defaults to NullLogger)\n\t *\n\t * @example\n\t * ```typescript\n\t * const processor = new ThoughtProcessor(\n\t *   historyManager,\n\t *   new ThoughtFormatter(),\n\t *   new ThoughtEvaluator(),\n\t *   logger,\n\t * );\n\t * ```\n\t */\n\tconstructor(\n\t\tprivate historyManager: IHistoryManager,\n\t\tprivate thoughtFormatter: ThoughtFormatter,\n\t\tthoughtEvaluator: ThoughtEvaluator,\n\t\tlogger?: Logger\n\t) {\n\t\tthis._thoughtEvaluator = thoughtEvaluator;\n\t\tthis._logger = logger ?? new NullLogger();\n\t}\n\n\t/**\n\t * Internal logging method.\n\t * @param message - The message to log\n\t * @param meta - Optional metadata\n\t * @private\n\t */\n\tprivate log(message: string, meta?: Record<string, unknown>): void {\n\t\tthis._logger.info(message, meta);\n\t}\n\n\t/**\n\t * Generate actionable hints from pattern signals.\n\t * Rules: max 3 hints, warning-severity only, cooldown of 3 thoughts per pattern per session.\n\t *\n\t * @param patterns - Detected pattern signals\n\t * @param currentThoughtNumber - The current thought number being processed\n\t * @param sessionId - Session identifier for cooldown scoping\n\t * @returns Array of hint strings (max 3), empty if no warnings\n\t */\n\tprivate _generateHints(\n\t\tpatterns: PatternSignal[],\n\t\tcurrentThoughtNumber: number,\n\t\tsessionId?: string\n\t): string[] {\n\t\tconst warnings = patterns.filter((p) => p.severity === 'warning');\n\t\tif (warnings.length === 0) return [];\n\n\t\tconst sessionKey = sessionId ?? '__global__';\n\t\tif (!this._hintCooldowns.has(sessionKey)) {\n\t\t\tthis._hintCooldowns.set(sessionKey, new Map());\n\t\t}\n\t\tconst cooldowns = this._hintCooldowns.get(sessionKey)!;\n\n\t\tconst hints: string[] = [];\n\t\tfor (const warning of warnings) {\n\t\t\tif (hints.length >= 3) break;\n\n\t\t\tconst lastFired = cooldowns.get(warning.pattern);\n\t\t\tif (lastFired !== undefined && currentThoughtNumber - lastFired < 3) {\n\t\t\t\tcontinue; // Still in cooldown\n\t\t\t}\n\n\t\t\thints.push(warning.message);\n\t\t\tcooldowns.set(warning.pattern, currentThoughtNumber);\n\t\t}\n\n\t\treturn hints;\n\t}\n\n\t/**\n\t * Processes a thought through the sequential thinking pipeline.\n\t *\n\t * This method validates the input, adds it to history, formats the output,\n\t * computes quality signals via the ThoughtEvaluator, and returns\n\t * a structured response with metadata about the current state.\n\t *\n\t * @param input - The thought data to process\n\t * @returns A Promise resolving to the formatted tool result containing:\n\t *   - `thought_number` — Current thought index\n\t *   - `total_thoughts` — Estimated total thoughts\n\t *   - `next_thought_needed` — Whether to continue\n\t *   - `branches` — Active branch IDs\n\t *   - `thought_history_length` — Number of thoughts in history\n\t *   - `available_mcp_tools` — MCP tools available for recommendation\n\t *   - `available_skills` — Skills available for recommendation\n\t *   - `current_step` — Current step recommendation\n\t *   - `previous_steps` — Previously recommended steps\n\t *   - `remaining_steps` — Upcoming step descriptions\n\t *   - `thought_type` — Classification of thought purpose (optional)\n\t *   - `quality_score` — Self-assessed quality score 0-1 (optional)\n\t *   - `confidence` — Self-assessed confidence 0-1 (optional)\n\t *   - `hypothesis_id` — Hypothesis link for verification chains (optional)\n *   - `confidence_signals` — Computed reasoning quality signals (includes structural_quality and quality_components)\n *   - `reasoning_stats` — Aggregated reasoning analytics\n *   - `reasoning_hints` — (Conditional) Actionable hints from pattern analysis, max 3, warning-severity only (optional)\n\t *\n\t * @example\n\t * ```typescript\n\t * const result = await processor.process({\n\t *   thought: 'I should read the README file',\n\t *   thought_number: 1,\n\t *   total_thoughts: 3,\n\t *   next_thought_needed: true\n\t * });\n\t *\n\t * console.log(result.content[0].text);\n\t * // Output includes: thought_number, total_thoughts, next_thought_needed,\n\t * // branches, thought_history_length, and any recommendations\n\t * ```\n\t */\n\tpublic async process(input: ThoughtData): Promise<CallToolResult> {\n\t\ttry {\n\t\t\t// Normalize input to handle common LLM field name mistakes\n\t\t\tconst normalizedInput = normalizeInput(input);\n\t\t\tconst sessionId = normalizedInput.session_id;\n\n\t\t\t// Handle reset_state: clear session before processing\n\t\t\tif (normalizedInput.reset_state) {\n\t\t\t\tthis.historyManager.clear(sessionId);\n\t\t\t\tthis.log('State reset for session', { sessionId: sessionId ?? '__global__' });\n\t\t\t}\n\n\t\t\t// Persist available_mcp_tools/available_skills across calls within a session.\n\t\t\t// If the caller omits these, reuse the last-seen values from the session.\n\t\t\tif (!normalizedInput.available_mcp_tools) {\n\t\t\t\tnormalizedInput.available_mcp_tools = this.historyManager.getAvailableMcpTools(sessionId);\n\t\t\t}\n\t\t\tif (!normalizedInput.available_skills) {\n\t\t\t\tnormalizedInput.available_skills = this.historyManager.getAvailableSkills(sessionId);\n\t\t\t}\n\n\t\t\tconst { result: validatedInput, warnings: validateWarnings } =\n\t\t\t\tthis.validateInput(normalizedInput);\n\t\t\tconst { result: checkedInput, warnings: refWarnings } =\n\t\t\t\tthis._validateCrossReferences(validatedInput, sessionId);\n\t\t\tconst allWarnings = [...validateWarnings, ...refWarnings];\n\n\t\t\tthis.historyManager.addThought(checkedInput);\n\n\t\t\tconst formattedThought = this.thoughtFormatter.formatThought(checkedInput);\n\t\t\tthis.log(formattedThought, { sessionId: sessionId ?? '__global__' });\n\n\t\t\t// Compute quality signals — fetch history/branches once\n\t\t\tconst history = this.historyManager.getHistory(sessionId);\n\t\t\tconst branches = this.historyManager.getBranches(sessionId);\n\n\t\t\tconst confidenceSignals = this._thoughtEvaluator.computeConfidenceSignals(\n\t\t\t\thistory,\n\t\t\t\tbranches\n\t\t\t);\n\t\t\tconst reasoningStats = this._thoughtEvaluator.computeReasoningStats(\n\t\t\t\thistory,\n\t\t\t\tbranches\n\t\t\t);\n\n\t\t\t// Detect reasoning patterns and generate hints\n\t\t\tconst patternSignals = this._thoughtEvaluator.computePatternSignals(\n\t\t\t\thistory,\n\t\t\t\tbranches\n\t\t\t);\n\t\t\tconst reasoningHints = this._generateHints(\n\t\t\t\tpatternSignals,\n\t\t\t\tcheckedInput.thought_number,\n\t\t\t\tsessionId\n\t\t\t);\n\n\t\t\treturn {\n\t\t\t\tcontent: [\n\t\t\t\t\t{\n\t\t\t\t\t\ttype: 'text' as const,\n\t\t\t\t\t\ttext: JSON.stringify(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\tthought_number: checkedInput.thought_number,\n\t\t\t\t\t\t\ttotal_thoughts: checkedInput.total_thoughts,\n\t\t\t\t\t\t\tnext_thought_needed: checkedInput.next_thought_needed ?? true,\n\t\t\t\t\t\t\tbranches: this.historyManager.getBranchIds(sessionId),\n\t\t\t\t\t\t\tthought_history_length: this.historyManager.getHistoryLength(sessionId),\n\t\t\t\t\t\t\tavailable_mcp_tools: checkedInput.available_mcp_tools,\n\t\t\t\t\t\t\tavailable_skills: checkedInput.available_skills,\n\t\t\t\t\t\t\tcurrent_step: checkedInput.current_step,\n\t\t\t\t\t\t\tprevious_steps: checkedInput.previous_steps,\n\t\t\t\t\t\t\tremaining_steps: checkedInput.remaining_steps,\n\t\t\t\t\t\t\t// Reasoning enrichment fields\n\t\t\t\t\t\t\tthought_type: checkedInput.thought_type,\n\t\t\t\t\t\t\tquality_score: checkedInput.quality_score,\n\t\t\t\t\t\t\tconfidence: checkedInput.confidence,\n\t\t\t\t\t\t\thypothesis_id: checkedInput.hypothesis_id,\n\t\t\t\t\t\t\tconfidence_signals: confidenceSignals,\n\t\t\t\t\t\t\treasoning_stats: reasoningStats,\n\t\t\t\t\t\t\t...(reasoningHints.length > 0 && { reasoning_hints: reasoningHints }),\n\t\t\t\t\t\t\t...(allWarnings.length > 0 && { warnings: allWarnings }),\n\t\t\t\t\t\t\t...(sessionId ? { session_id: sessionId } : {}),\n\t\t\t\t\t\t},\n\t\t\t\t\t\tnull,\n\t\t\t\t\t\t2\n\t\t\t\t\t),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t};\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tcontent: [\n\t\t\t\t\t{\n\t\t\t\t\t\ttype: 'text' as const,\n\t\t\t\t\t\ttext: JSON.stringify(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t\tstatus: 'failed',\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tnull,\n\t\t\t\t\t\t\t2\n\t\t\t\t\t\t),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tisError: true,\n\t\t\t};\n\t\t}\n\t}\n\n\t/**\n\t * Validates and normalizes thought input.\n\t *\n\t * Ensures that thought numbers are consistent and within valid ranges.\n\t * If `thought_number` exceeds `total_thoughts`, `total_thoughts` is\n\t * automatically adjusted to match and a warning is emitted.\n\t *\n\t * @param input - The input to validate\n\t * @returns Object with validated input and any warnings generated\n\t * @private\n\t *\n\t * @example\n\t * ```typescript\n\t * // Auto-adjusts total_thoughts when thought_number exceeds it\n\t * const { result, warnings } = this.validateInput(input);\n\t * // result.total_thoughts === 10 (auto-adjusted from 5)\n\t * // warnings === ['Auto-adjusted total_thoughts from 5 to 10 to match thought_number']\n\t * ```\n\t */\n\tprivate validateInput(input: ThoughtData): {\n\t\tresult: ThoughtData;\n\t\twarnings: string[];\n\t} {\n\t\tconst warnings: string[] = [];\n\t\tif (input.thought_number > input.total_thoughts) {\n\t\t\tconst originalTotal = input.total_thoughts;\n\t\t\twarnings.push(\n\t\t\t\t`Auto-adjusted total_thoughts from ${originalTotal} to ${input.thought_number} to match thought_number`\n\t\t\t);\n\t\t\tthis._logger.warn('Auto-adjusted total_thoughts to match thought_number', {\n\t\t\t\tthought_number: input.thought_number,\n\t\t\t\toriginal_total_thoughts: originalTotal,\n\t\t\t\tadjusted_total_thoughts: input.thought_number,\n\t\t\t});\n\t\t\tinput.total_thoughts = input.thought_number;\n\t\t}\n\t\treturn { result: input, warnings };\n\t}\n\n\t/**\n\t * Validates cross-field references against actual thought history.\n\t * Drops invalid references with a warning log — never rejects.\n\t * LLMs frequently send optimistic references to thoughts that don't exist yet.\n\t *\n\t * @param input - The thought data to validate\n\t * @returns Object with cleaned input and any warnings generated\n\t * @private\n\t *\n\t * @example\n\t * ```typescript\n\t * // verification_target=999 with only 3 thoughts in history\n\t * const { result, warnings } = this._validateCrossReferences(input);\n\t * // result.verification_target === undefined\n\t * // warnings === ['Dropped dangling verification_target: 999 (history has 3 thoughts)']\n\t * ```\n\t */\n\tprivate _validateCrossReferences(input: ThoughtData, sessionId?: string): {\n\t\tresult: ThoughtData;\n\t\twarnings: string[];\n\t} {\n\t\tconst warnings: string[] = [];\n\t\tconst historyLength = this.historyManager.getHistoryLength(sessionId);\n\t\tconst branchIds = new Set(this.historyManager.getBranchIds(sessionId));\n\n\t\t// verification_target: must reference existing thought\n\t\tif (input.verification_target !== undefined && input.verification_target > historyLength) {\n\t\t\twarnings.push(\n\t\t\t\t`Dropped dangling verification_target: ${input.verification_target} (history has ${historyLength} thoughts)`\n\t\t\t);\n\t\t\tthis._logger.warn('Dropped dangling verification_target', {\n\t\t\t\tverification_target: input.verification_target,\n\t\t\t\thistoryLength,\n\t\t\t});\n\t\t\tinput.verification_target = undefined;\n\t\t}\n\n\t\t// revises_thought: must reference existing thought\n\t\tif (input.revises_thought !== undefined && input.revises_thought > historyLength) {\n\t\t\twarnings.push(\n\t\t\t\t`Dropped dangling revises_thought: ${input.revises_thought} (history has ${historyLength} thoughts)`\n\t\t\t);\n\t\t\tthis._logger.warn('Dropped dangling revises_thought', {\n\t\t\t\trevises_thought: input.revises_thought,\n\t\t\t\thistoryLength,\n\t\t\t});\n\t\t\tinput.revises_thought = undefined;\n\t\t}\n\n\t\t// branch_from_thought: must reference existing thought\n\t\tif (input.branch_from_thought !== undefined && input.branch_from_thought > historyLength) {\n\t\t\twarnings.push(\n\t\t\t\t`Dropped dangling branch_from_thought: ${input.branch_from_thought} (history has ${historyLength} thoughts)`\n\t\t\t);\n\t\t\tthis._logger.warn('Dropped dangling branch_from_thought', {\n\t\t\t\tbranch_from_thought: input.branch_from_thought,\n\t\t\t\thistoryLength,\n\t\t\t});\n\t\t\tinput.branch_from_thought = undefined;\n\t\t}\n\n\t\t// synthesis_sources: filter to existing thoughts only\n\t\tif (input.synthesis_sources?.length) {\n\t\t\tconst valid = input.synthesis_sources.filter((n: number) => n <= historyLength);\n\t\t\tif (valid.length < input.synthesis_sources.length) {\n\t\t\t\tconst dropped = input.synthesis_sources.filter((n: number) => n > historyLength);\n\t\t\t\twarnings.push(\n\t\t\t\t\t`Filtered dangling synthesis_sources: [${dropped.join(', ')}] (history has ${historyLength} thoughts)`\n\t\t\t\t);\n\t\t\t\tthis._logger.warn('Filtered dangling synthesis_sources', {\n\t\t\t\t\toriginal: input.synthesis_sources,\n\t\t\t\t\tfiltered: valid,\n\t\t\t\t\thistoryLength,\n\t\t\t\t});\n\t\t\t}\n\t\t\tinput.synthesis_sources = valid.length > 0 ? valid : undefined;\n\t\t}\n\n\t\t// merge_from_thoughts: filter to existing thoughts only\n\t\tif (input.merge_from_thoughts?.length) {\n\t\t\tconst valid = input.merge_from_thoughts.filter((n: number) => n <= historyLength);\n\t\t\tif (valid.length < input.merge_from_thoughts.length) {\n\t\t\t\tconst dropped = input.merge_from_thoughts.filter(\n\t\t\t\t\t(n: number) => n > historyLength\n\t\t\t\t);\n\t\t\t\twarnings.push(\n\t\t\t\t\t`Filtered dangling merge_from_thoughts: [${dropped.join(', ')}] (history has ${historyLength} thoughts)`\n\t\t\t\t);\n\t\t\t\tthis._logger.warn('Filtered dangling merge_from_thoughts', {\n\t\t\t\t\toriginal: input.merge_from_thoughts,\n\t\t\t\t\tfiltered: valid,\n\t\t\t\t\thistoryLength,\n\t\t\t\t});\n\t\t\t}\n\t\t\tinput.merge_from_thoughts = valid.length > 0 ? valid : undefined;\n\t\t}\n\n\t\t// merge_branch_ids: filter to existing branches only\n\t\tif (input.merge_branch_ids?.length) {\n\t\t\tconst valid = input.merge_branch_ids.filter((id: string) => branchIds.has(id));\n\t\t\tif (valid.length < input.merge_branch_ids.length) {\n\t\t\t\tconst dropped = input.merge_branch_ids.filter(\n\t\t\t\t\t(id: string) => !branchIds.has(id)\n\t\t\t\t);\n\t\t\t\twarnings.push(`Filtered dangling merge_branch_ids: [${dropped.join(', ')}]`);\n\t\t\t\tthis._logger.warn('Filtered dangling merge_branch_ids', {\n\t\t\t\t\toriginal: input.merge_branch_ids,\n\t\t\t\t\tfiltered: valid,\n\t\t\t\t\texistingBranches: Array.from(branchIds),\n\t\t\t\t});\n\t\t\t}\n\t\t\tinput.merge_branch_ids = valid.length > 0 ? valid : undefined;\n\t\t}\n\n\t\treturn { result: input, warnings };\n\t}\n}\n"],"names":["ThoughtProcessor","Map","historyManager","thoughtFormatter","thoughtEvaluator","logger","NullLogger","message","meta","patterns","currentThoughtNumber","sessionId","warnings","p","sessionKey","cooldowns","hints","warning","lastFired","undefined","input","normalizedInput","normalizeInput","validatedInput","validateWarnings","checkedInput","refWarnings","allWarnings","formattedThought","history","branches","confidenceSignals","reasoningStats","patternSignals","reasoningHints","JSON","error","Error","String","originalTotal","historyLength","branchIds","Set","valid","n","dropped","id","Array"],"mappings":"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"}

package/dist/core/reasoning.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Reasoning type definitions for advanced sequential thinking.
+ *
+ * Provides type-level constructs for classifying thoughts, computing confidence
+ * signals from reasoning history, and aggregating session analytics.
+ *
+ * @module core/reasoning
+ */
+/**
+ * Classification of thought purpose — enables type-specific formatting, evaluation, and analytics.
+ *
+ * @example
+ * ```typescript
+ * const thoughtType: ThoughtType = 'hypothesis';
+ *
+ * // Use in conditional formatting
+ * if (thoughtType === 'verification') {
+ *   console.log('Verifying a hypothesis...');
+ * }
+ * ```
+ */
+export type ThoughtType = 'regular' | 'hypothesis' | 'verification' | 'critique' | 'synthesis' | 'meta';
+/**
+ * A detected reasoning pattern — surfaced as metadata or a warning.
+ *
+ * @example
+ * ```typescript
+ * const signal: PatternSignal = {
+ *   pattern: 'hypothesis-without-verification',
+ *   severity: 'warning',
+ *   message: 'Hypothesis H1 has no matching verification thought.',
+ *   thought_range: [3, 7],
+ * };
+ * ```
+ */
+export interface PatternSignal {
+    /** Machine-readable pattern identifier. */
+    pattern: string;
+    /** Severity: 'warning' surfaces as a hint, 'info' is metadata only. */
+    severity: 'info' | 'warning';
+    /** Human-readable description of the detected pattern. */
+    message: string;
+    /** Thought number range [start, end] where the pattern was detected. */
+    thought_range: [number, number];
+}
+/**
+ * Signals about reasoning quality computed from history.
+ *
+ * These metrics are derived from the thought chain and provide insight into
+ * the depth, breadth, and completeness of the reasoning process.
+ *
+ * @example
+ * ```typescript
+ * const signals: ConfidenceSignals = {
+ *   reasoning_depth: 5,
+ *   revision_count: 1,
+ *   branch_count: 2,
+ *   thought_type_distribution: {
+ *     regular: 3,
+ *     hypothesis: 1,
+ *     verification: 1,
+ *     critique: 0,
+ *     synthesis: 0,
+ *     meta: 0,
+ *   },
+ *   has_hypothesis: true,
+ *   has_verification: true,
+ *   average_confidence: 0.85,
+ *   structural_quality: 0.72,
+ *   quality_components: {
+ *     type_diversity: 0.65,
+ *     verification_coverage: 1.0,
+ *     depth_efficiency: 0.6,
+ *     confidence_stability: 0.85,
+ *   },
+ * };
+ * ```
+ */
+export interface ConfidenceSignals {
+    /** Length of thought chain to this point. */
+    reasoning_depth: number;
+    /** How many revisions in this chain. */
+    revision_count: number;
+    /** Active branches. */
+    branch_count: number;
+    /** Distribution of thought types used. */
+    thought_type_distribution: Record<ThoughtType, number>;
+    /** Whether any hypothesis exists in chain. */
+    has_hypothesis: boolean;
+    /** Whether any verification exists. */
+    has_verification: boolean;
+    /** Mean of explicit confidence values, null if none. */
+    average_confidence: number | null;
+    /**
+     * Composite structural quality score (0-1).
+     * Geometric mean of quality_components with floor of 0.01 per component.
+     * Only present when history has ≥1 thought.
+     */
+    structural_quality?: number;
+    /**
+     * Individual quality components that feed into structural_quality.
+     * Only present when structural_quality is present.
+     */
+    quality_components?: {
+        /** Shannon entropy of thought_type distribution / log2(6), normalized 0-1. */
+        type_diversity: number;
+        /** verified_hypotheses / total_hypotheses. 1.0 if no hypotheses exist. */
+        verification_coverage: number;
+        /** max(chain_depth, branch_count + 1) / total_thoughts, clamped to [0, 1]. Branching is desirable. */
+        depth_efficiency: number;
+        /** 1 - stddev(confidence values). Defaults to 0.5 if no confidence values. */
+        confidence_stability: number;
+    };
+}
+/**
+ * Aggregated analytics about the reasoning session.
+ *
+ * Provides a comprehensive summary of the reasoning process including
+ * thought counts, branch metrics, hypothesis tracking, and quality scores.
+ *
+ * @example
+ * ```typescript
+ * const stats: ReasoningStats = {
+ *   total_thoughts: 12,
+ *   total_branches: 3,
+ *   total_revisions: 2,
+ *   total_merges: 1,
+ *   chain_depth: 8,
+ *   thought_type_counts: {
+ *     regular: 6,
+ *     hypothesis: 2,
+ *     verification: 2,
+ *     critique: 1,
+ *     synthesis: 1,
+ *     meta: 0,
+ *   },
+ *   hypothesis_count: 2,
+ *   verified_hypothesis_count: 1,
+ *   unresolved_hypothesis_count: 1,
+ *   average_quality_score: 0.78,
+ *   average_confidence: 0.82,
+ * };
+ * ```
+ */
+export interface ReasoningStats {
+    /** Total thoughts in session. */
+    total_thoughts: number;
+    /** Total branches created. */
+    total_branches: number;
+    /** Total revision operations. */
+    total_revisions: number;
+    /** Total merge operations (DAG topology). */
+    total_merges: number;
+    /** Longest sequential chain depth. */
+    chain_depth: number;
+    /** Count of each thought type. */
+    thought_type_counts: Record<ThoughtType, number>;
+    /** Hypotheses created. */
+    hypothesis_count: number;
+    /** Hypotheses that have been verified. */
+    verified_hypothesis_count: number;
+    /** Hypotheses without verification. */
+    unresolved_hypothesis_count: number;
+    /** Average quality score across thoughts with scores, null if none. */
+    average_quality_score: number | null;
+    /** Average confidence across thoughts with confidence, null if none. */
+    average_confidence: number | null;
+}
+//# sourceMappingURL=reasoning.d.ts.map

package/dist/core/reasoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.d.ts","sourceRoot":"","sources":["../../src/core/reasoning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GACpB,SAAS,GACT,YAAY,GACZ,cAAc,GACd,UAAU,GACV,WAAW,GACX,MAAM,CAAC;AAEV;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAEhB,wEAAwE;IACxE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,iBAAiB;IACjC,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IAEvB,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEvD,8CAA8C;IAC9C,cAAc,EAAE,OAAO,CAAC;IAExB,uCAAuC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAE1B,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QACpB,8EAA8E;QAC9E,cAAc,EAAE,MAAM,CAAC;QACvB,0EAA0E;QAC1E,qBAAqB,EAAE,MAAM,CAAC;QAC9B,sGAAsG;QACtG,gBAAgB,EAAE,MAAM,CAAC;QACzB,8EAA8E;QAC9E,oBAAoB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,cAAc;IAC9B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IAEvB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IAEvB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IAExB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEjD,0BAA0B;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,0CAA0C;IAC1C,yBAAyB,EAAE,MAAM,CAAC;IAElC,uCAAuC;IACvC,2BAA2B,EAAE,MAAM,CAAC;IAEpC,uEAAuE;IACvE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC"}

package/dist/core/reasoning.js

@@ -0,0 +1 @@
+export { };