codehere 0.1.1

package/dist/infrastructure/xai/cot-visualizer.d.ts

@@ -0,0 +1,103 @@
+/**
+ * INTERNAL ONLY — infrastructure helper, not a user-facing feature.
+ *
+ * Chain-of-Thought (CoT) Visualizer - Visualizes AI reasoning steps in a human-readable format.
+ * Used internally for logging and debugging. Not guaranteed to be stable.
+ *
+ * Do not rely on this directly.
+ *
+ * @internal
+ */
+export interface CoTStep {
+    stepId: string;
+    stepNumber: number;
+    type: 'thought' | 'action' | 'observation' | 'decision' | 'error';
+    content: string;
+    timestamp: number;
+    metadata?: {
+        tool?: string;
+        toolParams?: Record<string, any>;
+        confidence?: number;
+        reasoning?: string;
+        alternatives?: string[];
+        [key: string]: any;
+    };
+}
+export interface CoTTrajectory {
+    trajectoryId: string;
+    query: string;
+    steps: CoTStep[];
+    currentStep: number;
+    status: 'in_progress' | 'completed' | 'failed' | 'cancelled';
+    startedAt: number;
+    completedAt?: number;
+}
+/**
+ * Chain-of-Thought Visualizer
+ * Formats reasoning steps for human-readable display
+ */
+export declare class CoTVisualizer {
+    /**
+     * Create new CoT trajectory
+     */
+    createTrajectory(query: string): CoTTrajectory;
+    /**
+     * Add thought step
+     */
+    addThought(trajectory: CoTTrajectory, thought: string, metadata?: CoTStep['metadata']): string;
+    /**
+     * Add action step (tool call, edit, etc.)
+     */
+    addAction(trajectory: CoTTrajectory, action: string, metadata?: {
+        tool?: string;
+        toolParams?: Record<string, any>;
+        reasoning?: string;
+        alternatives?: string[];
+    }): string;
+    /**
+     * Add observation step (tool result, file content, etc.)
+     */
+    addObservation(trajectory: CoTTrajectory, observation: string, metadata?: CoTStep['metadata']): string;
+    /**
+     * Add decision step (choice point, branching)
+     */
+    addDecision(trajectory: CoTTrajectory, decision: string, options: string[], chosen: string, rationale?: string): string;
+    /**
+     * Add error step
+     */
+    addError(trajectory: CoTTrajectory, error: string, errorDetails?: any): string;
+    /**
+     * Mark trajectory as completed
+     */
+    completeTrajectory(trajectory: CoTTrajectory): void;
+    /**
+     * Format trajectory for console output (human-readable)
+     */
+    formatForConsole(trajectory: CoTTrajectory, options?: {
+        showMetadata?: boolean;
+        maxSteps?: number;
+        compact?: boolean;
+    }): string;
+    /**
+     * Format trajectory for JSON export
+     */
+    formatForJSON(trajectory: CoTTrajectory): string;
+    /**
+     * Format trajectory for interactive UI (structured data)
+     */
+    formatForUI(trajectory: CoTTrajectory): {
+        query: string;
+        status: string;
+        steps: Array<{
+            number: number;
+            type: string;
+            content: string;
+            timestamp: number;
+            metadata?: any;
+        }>;
+        duration?: number;
+    };
+    private formatStep;
+    private getStepIcon;
+}
+//# sourceMappingURL=cot-visualizer.d.ts.map

package/dist/infrastructure/xai/cot-visualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cot-visualizer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/xai/cot-visualizer.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/xai/cot-visualizer.js

@@ -0,0 +1,283 @@
+/**
+ * INTERNAL ONLY — infrastructure helper, not a user-facing feature.
+ *
+ * Chain-of-Thought (CoT) Visualizer - Visualizes AI reasoning steps in a human-readable format.
+ * Used internally for logging and debugging. Not guaranteed to be stable.
+ *
+ * Do not rely on this directly.
+ *
+ * @internal
+ */
+import { colors } from '../../ui.js';
+/**
+ * Chain-of-Thought Visualizer
+ * Formats reasoning steps for human-readable display
+ */
+export class CoTVisualizer {
+    /**
+     * Create new CoT trajectory
+     */
+    createTrajectory(query) {
+        return {
+            trajectoryId: `cot-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            query,
+            steps: [],
+            currentStep: 0,
+            status: 'in_progress',
+            startedAt: Date.now(),
+        };
+    }
+    /**
+     * Add thought step
+     */
+    addThought(trajectory, thought, metadata) {
+        const stepId = `step-${Date.now()}-thought`;
+        const step = {
+            stepId,
+            stepNumber: trajectory.steps.length + 1,
+            type: 'thought',
+            content: thought,
+            timestamp: Date.now(),
+            metadata,
+        };
+        trajectory.steps.push(step);
+        trajectory.currentStep = trajectory.steps.length;
+        return stepId;
+    }
+    /**
+     * Add action step (tool call, edit, etc.)
+     */
+    addAction(trajectory, action, metadata) {
+        const stepId = `step-${Date.now()}-action`;
+        const step = {
+            stepId,
+            stepNumber: trajectory.steps.length + 1,
+            type: 'action',
+            content: action,
+            timestamp: Date.now(),
+            metadata,
+        };
+        trajectory.steps.push(step);
+        trajectory.currentStep = trajectory.steps.length;
+        return stepId;
+    }
+    /**
+     * Add observation step (tool result, file content, etc.)
+     */
+    addObservation(trajectory, observation, metadata) {
+        const stepId = `step-${Date.now()}-observation`;
+        const step = {
+            stepId,
+            stepNumber: trajectory.steps.length + 1,
+            type: 'observation',
+            content: observation,
+            timestamp: Date.now(),
+            metadata,
+        };
+        trajectory.steps.push(step);
+        trajectory.currentStep = trajectory.steps.length;
+        return stepId;
+    }
+    /**
+     * Add decision step (choice point, branching)
+     */
+    addDecision(trajectory, decision, options, chosen, rationale) {
+        const stepId = `step-${Date.now()}-decision`;
+        const step = {
+            stepId,
+            stepNumber: trajectory.steps.length + 1,
+            type: 'decision',
+            content: decision,
+            timestamp: Date.now(),
+            metadata: {
+                options,
+                chosen,
+                reasoning: rationale,
+            },
+        };
+        trajectory.steps.push(step);
+        trajectory.currentStep = trajectory.steps.length;
+        return stepId;
+    }
+    /**
+     * Add error step
+     */
+    addError(trajectory, error, errorDetails) {
+        const stepId = `step-${Date.now()}-error`;
+        const step = {
+            stepId,
+            stepNumber: trajectory.steps.length + 1,
+            type: 'error',
+            content: error,
+            timestamp: Date.now(),
+            metadata: {
+                errorDetails,
+            },
+        };
+        trajectory.steps.push(step);
+        trajectory.currentStep = trajectory.steps.length;
+        trajectory.status = 'failed';
+        return stepId;
+    }
+    /**
+     * Mark trajectory as completed
+     */
+    completeTrajectory(trajectory) {
+        trajectory.status = 'completed';
+        trajectory.completedAt = Date.now();
+    }
+    /**
+     * Format trajectory for console output (human-readable)
+     */
+    formatForConsole(trajectory, options) {
+        const { showMetadata = false, maxSteps, compact = false } = options || {};
+        const steps = maxSteps ? trajectory.steps.slice(0, maxSteps) : trajectory.steps;
+        let output = '';
+        if (!compact) {
+            output += `\n${'═'.repeat(80)}\n`;
+            output += `Chain of Thought: ${trajectory.query.substring(0, 60)}${trajectory.query.length > 60 ? '...' : ''}\n`;
+            output += `${'═'.repeat(80)}\n\n`;
+        }
+        for (const step of steps) {
+            output += this.formatStep(step, { showMetadata, compact });
+        }
+        if (trajectory.status === 'completed' && !compact) {
+            output += `\n${'─'.repeat(80)}\n`;
+            output += `✓ Completed in ${trajectory.steps.length} steps`;
+            if (trajectory.completedAt && trajectory.startedAt) {
+                const duration = ((trajectory.completedAt - trajectory.startedAt) / 1000).toFixed(2);
+                output += ` (${duration}s)\n`;
+            }
+            output += `${'─'.repeat(80)}\n`;
+        }
+        return output;
+    }
+    /**
+     * Format trajectory for JSON export
+     */
+    formatForJSON(trajectory) {
+        return JSON.stringify(trajectory, null, 2);
+    }
+    /**
+     * Format trajectory for interactive UI (structured data)
+     */
+    formatForUI(trajectory) {
+        return {
+            query: trajectory.query,
+            status: trajectory.status,
+            steps: trajectory.steps.map(step => ({
+                number: step.stepNumber,
+                type: step.type,
+                content: step.content,
+                timestamp: step.timestamp,
+                metadata: step.metadata,
+            })),
+            duration: trajectory.completedAt && trajectory.startedAt
+                ? trajectory.completedAt - trajectory.startedAt
+                : undefined,
+        };
+    }
+    // Private helpers
+    formatStep(step, options) {
+        const { showMetadata = false, compact = false } = options;
+        let output = '';
+        const maxWidth = process.stdout.columns || 80;
+        const indent = '  ';
+        const contentWidth = maxWidth - indent.length - 10; // Reserve space for prefix/icon
+        const prefix = compact ? '' : `[Step ${step.stepNumber}] `;
+        const icon = this.getStepIcon(step.type);
+        // Word wrap helper for long content
+        const wrapText = (text, width, prefix = '') => {
+            if (compact && text.length > 150) {
+                // In compact mode, truncate long content
+                return text.substring(0, 150) + '...';
+            }
+            const words = text.split(' ');
+            const lines = [];
+            let currentLine = '';
+            for (const word of words) {
+                if ((currentLine + word).length > width) {
+                    if (currentLine)
+                        lines.push(prefix + currentLine.trim());
+                    currentLine = word + ' ';
+                }
+                else {
+                    currentLine += word + ' ';
+                }
+            }
+            if (currentLine)
+                lines.push(prefix + currentLine.trim());
+            return lines.join('\n');
+        };
+        switch (step.type) {
+            case 'thought':
+                output += colors.dim(`${prefix}${icon}`) + ` ${colors.bold('Thought:')}\n`;
+                output += wrapText(step.content, contentWidth, indent);
+                // Show reasoning quality if available
+                if (showMetadata && step.metadata?.confidence !== undefined) {
+                    const conf = step.metadata.confidence;
+                    const confLabel = conf >= 0.8 ? colors.green('✓ High') : conf >= 0.6 ? colors.yellow('⚠ Medium') : colors.red('✗ Low');
+                    output += `\n${indent}└─ Confidence: ${confLabel} ${colors.dim(`(${(conf * 100).toFixed(0)}%)`)}`;
+                }
+                break;
+            case 'action':
+                output += colors.dim(`${prefix}${icon}`) + ` ${colors.cyan('Action:')} ${colors.cyan(step.content)}\n`;
+                if (showMetadata && step.metadata?.tool) {
+                    output += `${indent}└─ Tool: ${colors.cyan(step.metadata.tool)}\n`;
+                    if (step.metadata.reasoning) {
+                        output += `${indent}└─ Reasoning: ${colors.dim(wrapText(step.metadata.reasoning, contentWidth - 14, ''))}\n`;
+                    }
+                }
+                break;
+            case 'observation':
+                const obsText = compact && step.content.length > 150
+                    ? step.content.substring(0, 150) + '...'
+                    : step.content;
+                output += colors.dim(`${prefix}${icon}`) + ` ${colors.green('Observation:')}\n`;
+                output += wrapText(obsText, contentWidth, indent);
+                break;
+            case 'decision':
+                output += colors.dim(`${prefix}${icon}`) + ` ${colors.magenta('Decision:')} ${colors.magenta(step.content)}\n`;
+                if (showMetadata && step.metadata?.options) {
+                    output += `${indent}└─ Options: ${colors.dim(step.metadata.options.join(', '))}\n`;
+                    output += `${indent}└─ Chosen: ${colors.green(step.metadata.chosen)}\n`;
+                    if (step.metadata.reasoning) {
+                        output += `${indent}└─ Reasoning: ${colors.dim(wrapText(step.metadata.reasoning, contentWidth - 14, ''))}\n`;
+                    }
+                    if (step.metadata.confidence !== undefined) {
+                        const conf = step.metadata.confidence;
+                        const confLabel = conf >= 0.8 ? colors.green('✓ High') : conf >= 0.6 ? colors.yellow('⚠ Medium') : colors.red('✗ Low');
+                        output += `${indent}└─ Confidence: ${confLabel} ${colors.dim(`(${(conf * 100).toFixed(0)}%)`)}\n`;
+                    }
+                }
+                break;
+            case 'error':
+                output += colors.dim(`${prefix}${icon}`) + ` ${colors.red('Error:')} ${colors.red(step.content)}\n`;
+                if (showMetadata && step.metadata?.errorDetails) {
+                    output += `${indent}└─ Details: ${colors.dim(JSON.stringify(step.metadata.errorDetails))}\n`;
+                }
+                break;
+        }
+        if (!compact) {
+            output += '\n';
+        }
+        return output;
+    }
+    getStepIcon(type) {
+        switch (type) {
+            case 'thought':
+                return '💭';
+            case 'action':
+                return '⚡';
+            case 'observation':
+                return '👁️';
+            case 'decision':
+                return '🔀';
+            case 'error':
+                return '❌';
+            default:
+                return '•';
+        }
+    }
+}
+//# sourceMappingURL=cot-visualizer.js.map

package/dist/infrastructure/xai/cot-visualizer.js.map

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

package/dist/infrastructure/xai/decision-tree-log.d.ts

@@ -0,0 +1,100 @@
+/**
+ * INTERNAL ONLY — infrastructure helper, not a user-facing feature.
+ *
+ * Decision Tree Log - Complete audit trail for multi-step agentic workflows.
+ * Used internally for logging/debugging. Not guaranteed to be stable.
+ *
+ * Do not rely on this directly.
+ *
+ * @internal
+ */
+export interface DecisionNode {
+    id: string;
+    type: 'goal' | 'plan' | 'tool' | 'synthesis' | 'error';
+    timestamp: number;
+    description: string;
+    metadata: Record<string, any>;
+    children?: DecisionNode[];
+    childNodeIds?: string[];
+    parentId?: string;
+}
+export interface GoalInterpretation {
+    parsedIntent: string;
+    constraints: string[];
+    dependencies: string[];
+    confidence: number;
+}
+export interface ToolRationale {
+    toolName: string;
+    parameters: Record<string, any>;
+    reasoning: string;
+    alternativeTools?: string[];
+    executionTime?: number;
+    rawOutput?: any;
+}
+export interface ExternalDataProvenance {
+    source: string;
+    timestamp: number;
+    freshness: number;
+    trustLevel: 'high' | 'medium' | 'low';
+    url?: string;
+}
+export interface IntegrationStep {
+    inputData: any;
+    processingDescription: string;
+    outputData: any;
+    transformations: string[];
+}
+/**
+ * Decision Tree Log
+ * Maintains complete execution trace for agentic workflows
+ */
+export declare class DecisionTreeLog {
+    private nodes;
+    private rootNodeId;
+    /**
+     * Log goal interpretation
+     */
+    logGoalInterpretation(goalId: string, interpretation: GoalInterpretation, parentId?: string): string;
+    /**
+     * Log plan step
+     */
+    logPlanStep(planId: string, stepDescription: string, metadata: Record<string, any>, parentId: string): string;
+    /**
+     * Log tool execution with rationale
+     */
+    logToolExecution(toolId: string, rationale: ToolRationale, parentId: string): string;
+    /**
+     * Log external data provenance
+     */
+    logExternalData(dataId: string, provenance: ExternalDataProvenance, parentId: string): string;
+    /**
+     * Log integration step (how LLM processed external data)
+     */
+    logIntegrationStep(integrationId: string, step: IntegrationStep, parentId: string): string;
+    /**
+     * Log error
+     */
+    logError(errorId: string, error: Error, context: Record<string, any>, parentId: string): string;
+    /**
+     * Get complete execution tree
+     */
+    getExecutionTree(): DecisionNode | null;
+    /**
+     * Build tree structure recursively
+     */
+    private buildTree;
+    /**
+     * Add child node to parent
+     */
+    private addChild;
+    /**
+     * Get trace for fault attribution
+     */
+    getErrorTrace(errorId: string): DecisionNode[];
+    /**
+     * Clear log
+     */
+    clear(): void;
+}
+//# sourceMappingURL=decision-tree-log.d.ts.map

package/dist/infrastructure/xai/decision-tree-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-tree-log.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/xai/decision-tree-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,GAAG,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,GAAG,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,UAAU,CAAuB;IAEzC;;OAEG;IACH,qBAAqB,CACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,kBAAkB,EAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAuBT;;OAEG;IACH,WAAW,CACT,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM;IAeT;;OAEG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,GACf,MAAM;IAsBT;;OAEG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,sBAAsB,EAClC,QAAQ,EAAE,MAAM,GACf,MAAM;IAsBT;;OAEG;IACH,kBAAkB,CAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM;IAmBT;;OAEG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,QAAQ,EAAE,MAAM,GACf,MAAM;IAmBT;;OAEG;IACH,gBAAgB,IAAI,YAAY,GAAG,IAAI;IAQvC;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAiB9C;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}