attocode 0.1.0

package/dist/src/integrations/image-renderer.js

@@ -0,0 +1,306 @@
+/**
+ * Image Renderer
+ *
+ * Renders images inline in the terminal using the best available protocol.
+ * Supports Kitty, iTerm2/WezTerm, and falls back to block characters.
+ *
+ * @example
+ * ```typescript
+ * const renderer = createImageRenderer();
+ * await renderer.renderFile('/path/to/image.png');
+ * ```
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { extname } from 'node:path';
+/**
+ * Supported image formats.
+ */
+const SUPPORTED_FORMATS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp']);
+// =============================================================================
+// PROTOCOL DETECTION
+// =============================================================================
+/**
+ * Detect the best available image protocol for the current terminal.
+ */
+export function detectProtocol() {
+    const env = process.env;
+    // Kitty terminal
+    if (env.KITTY_WINDOW_ID) {
+        return 'kitty';
+    }
+    // iTerm2 (also used by WezTerm)
+    if (env.ITERM_SESSION_ID || env.TERM_PROGRAM === 'iTerm.app') {
+        return 'iterm';
+    }
+    // WezTerm (uses iTerm protocol)
+    if (env.TERM_PROGRAM === 'WezTerm') {
+        return 'iterm';
+    }
+    // Check for sixel support via TERM
+    if (env.TERM && (env.TERM.includes('sixel') ||
+        env.TERM === 'xterm' ||
+        env.TERM === 'xterm-256color')) {
+        // Note: Sixel detection is imperfect; many terminals don't advertise it
+        return 'sixel';
+    }
+    // Fall back to block characters
+    return 'block';
+}
+/**
+ * Check if a protocol is available.
+ */
+export function isProtocolAvailable(protocol) {
+    const detected = detectProtocol();
+    if (protocol === 'block')
+        return true;
+    if (protocol === 'none')
+        return true;
+    if (protocol === detected)
+        return true;
+    // Kitty protocol requires Kitty terminal
+    if (protocol === 'kitty')
+        return detected === 'kitty';
+    // iTerm protocol works in iTerm2 and WezTerm
+    if (protocol === 'iterm')
+        return detected === 'iterm';
+    // Sixel is harder to detect reliably
+    if (protocol === 'sixel')
+        return detected === 'sixel';
+    return false;
+}
+// =============================================================================
+// IMAGE RENDERER
+// =============================================================================
+/**
+ * Image renderer class.
+ */
+export class ImageRenderer {
+    config;
+    protocol;
+    constructor(config = {}) {
+        this.config = {
+            protocol: config.protocol ?? 'auto',
+            maxWidth: config.maxWidth ?? 80,
+            maxHeight: config.maxHeight ?? 24,
+            preserveAspectRatio: config.preserveAspectRatio ?? true,
+        };
+        this.protocol = this.config.protocol === 'auto'
+            ? detectProtocol()
+            : this.config.protocol;
+    }
+    /**
+     * Get the current protocol.
+     */
+    getProtocol() {
+        return this.protocol;
+    }
+    /**
+     * Check if image rendering is supported.
+     */
+    isSupported() {
+        return this.protocol !== 'none';
+    }
+    /**
+     * Check if a file is a supported image format.
+     */
+    isSupportedFormat(filePath) {
+        const ext = extname(filePath).toLowerCase();
+        return SUPPORTED_FORMATS.has(ext);
+    }
+    /**
+     * Render an image from a file path.
+     */
+    async renderFile(filePath) {
+        if (!existsSync(filePath)) {
+            return {
+                output: '',
+                protocol: this.protocol,
+                success: false,
+                error: `File not found: ${filePath}`,
+            };
+        }
+        if (!this.isSupportedFormat(filePath)) {
+            return {
+                output: '',
+                protocol: this.protocol,
+                success: false,
+                error: `Unsupported image format: ${extname(filePath)}`,
+            };
+        }
+        try {
+            const data = await readFile(filePath);
+            return this.renderBuffer(data, filePath);
+        }
+        catch (err) {
+            return {
+                output: '',
+                protocol: this.protocol,
+                success: false,
+                error: `Failed to read file: ${err.message}`,
+            };
+        }
+    }
+    /**
+     * Render an image from a buffer.
+     */
+    async renderBuffer(data, filename) {
+        switch (this.protocol) {
+            case 'kitty':
+                return this.renderKitty(data);
+            case 'iterm':
+                return this.renderITerm(data, filename);
+            case 'sixel':
+                return this.renderSixel(data);
+            case 'block':
+                return this.renderBlock(data);
+            case 'none':
+                return {
+                    output: '[Image display not supported in this terminal]',
+                    protocol: 'none',
+                    success: false,
+                    error: 'No image protocol available',
+                };
+        }
+    }
+    /**
+     * Render using Kitty graphics protocol.
+     * @see https://sw.kovidgoyal.net/kitty/graphics-protocol/
+     */
+    renderKitty(data) {
+        const base64 = data.toString('base64');
+        const chunks = [];
+        // Split into 4096-byte chunks for transmission
+        const chunkSize = 4096;
+        for (let i = 0; i < base64.length; i += chunkSize) {
+            const chunk = base64.slice(i, i + chunkSize);
+            const isLast = i + chunkSize >= base64.length;
+            // Kitty graphics protocol escape sequence
+            // a=T (transmit), f=100 (PNG), m=0/1 (more chunks coming)
+            const params = i === 0
+                ? `a=T,f=100,m=${isLast ? 0 : 1}`
+                : `m=${isLast ? 0 : 1}`;
+            chunks.push(`\x1b_G${params};${chunk}\x1b\\`);
+        }
+        return {
+            output: chunks.join(''),
+            protocol: 'kitty',
+            success: true,
+        };
+    }
+    /**
+     * Render using iTerm2 inline images protocol.
+     * @see https://iterm2.com/documentation-images.html
+     */
+    renderITerm(data, filename) {
+        const base64 = data.toString('base64');
+        // iTerm2 inline image format
+        // name=<base64 filename>, size=<bytes>, width=auto, height=auto, inline=1
+        const name = filename ? Buffer.from(filename).toString('base64') : '';
+        const params = [
+            `name=${name}`,
+            `size=${data.length}`,
+            `width=${this.config.maxWidth}`,
+            `height=${this.config.maxHeight}`,
+            `preserveAspectRatio=${this.config.preserveAspectRatio ? 1 : 0}`,
+            'inline=1',
+        ].join(';');
+        const output = `\x1b]1337;File=${params}:${base64}\x07`;
+        return {
+            output,
+            protocol: 'iterm',
+            success: true,
+        };
+    }
+    /**
+     * Render using Sixel graphics (limited support).
+     * This is a stub - full sixel encoding is complex.
+     */
+    renderSixel(_data) {
+        // Sixel encoding is complex and requires image processing
+        // Fall back to block rendering for now
+        return {
+            output: '[Sixel rendering not implemented - install terminal-image for fallback]',
+            protocol: 'sixel',
+            success: false,
+            error: 'Sixel encoding not implemented',
+        };
+    }
+    /**
+     * Render using block characters (fallback).
+     * Uses terminal-image if available.
+     */
+    async renderBlock(data) {
+        try {
+            // Dynamic import to avoid bundling issues
+            const terminalImage = await import('terminal-image');
+            const output = await terminalImage.default.buffer(data, {
+                width: this.config.maxWidth,
+                height: this.config.maxHeight,
+                preserveAspectRatio: this.config.preserveAspectRatio,
+            });
+            return {
+                output,
+                protocol: 'block',
+                success: true,
+            };
+        }
+        catch (err) {
+            return {
+                output: '[Image: terminal-image package not available]',
+                protocol: 'block',
+                success: false,
+                error: `Block rendering failed: ${err.message}`,
+            };
+        }
+    }
+    /**
+     * Render an image with a caption.
+     */
+    async renderWithCaption(filePath, caption) {
+        const result = await this.renderFile(filePath);
+        const lines = [];
+        if (result.success) {
+            lines.push(result.output);
+        }
+        else {
+            lines.push(`[Image: ${result.error}]`);
+        }
+        if (caption) {
+            lines.push(`  ${caption}`);
+        }
+        return lines.join('\n');
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create an image renderer with auto-detected protocol.
+ */
+export function createImageRenderer(config) {
+    return new ImageRenderer(config);
+}
+// =============================================================================
+// UTILITIES
+// =============================================================================
+/**
+ * Get protocol info for display.
+ */
+export function getProtocolInfo() {
+    const detected = detectProtocol();
+    const terminal = process.env.TERM_PROGRAM || process.env.TERM;
+    return {
+        detected,
+        terminal,
+        supported: detected !== 'none',
+    };
+}
+/**
+ * Check if a file can be rendered as an image.
+ */
+export function canRenderImage(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return SUPPORTED_FORMATS.has(ext);
+}
+//# sourceMappingURL=image-renderer.js.map

package/dist/src/integrations/image-renderer.js.map

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

package/dist/src/integrations/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Lesson 25: Integration Module Exports
+ *
+ * Clean re-exports of all integration modules.
+ */
+export { HookManager, createHookManager } from './hooks.js';
+export { MemoryManager, createMemoryManager } from './memory.js';
+export { PlanningManager, createPlanningManager, type ReflectionResult } from './planning.js';
+export { Tracer, MetricsCollector, Logger, ObservabilityManager, createObservabilityManager, } from './observability.js';
+export { SandboxManager, HumanInLoopManager, SafetyManager, createSafetyManager, } from './safety.js';
+export { RoutingManager, createRoutingManager } from './routing.js';
+export { RulesManager, createRulesManager, parseRulesFromMarkdown, DEFAULT_RULE_SOURCES, type RuleSource, type RulesConfig, type LoadedRule, type RulesEvent, type RulesEventListener, } from './rules.js';
+export { ExecutionEconomicsManager, createEconomicsManager, QUICK_BUDGET, STANDARD_BUDGET, LARGE_BUDGET, UNLIMITED_BUDGET, type ExecutionBudget, type ExecutionUsage, type BudgetCheckResult, type ExtensionRequest, type EconomicsEvent, type EconomicsEventListener, } from './economics.js';
+export { AgentRegistry, createAgentRegistry, filterToolsForAgent, formatAgentList, type AgentDefinition, type LoadedAgent, type SpawnOptions, type SpawnResult, type RegistryEvent, type RegistryEventListener, } from './agent-registry.js';
+export { MultiAgentManager, createMultiAgentManager, CODER_ROLE, REVIEWER_ROLE, ARCHITECT_ROLE, RESEARCHER_ROLE, type AgentRole, type TeamConfig, type TeamTask, type TeamResult, type ConsensusStrategy, type MultiAgentEvent, type MultiAgentEventListener, } from './multi-agent.js';
+export { ReActManager, createReActManager, extractThoughts, extractActions, hasCoherentReasoning, type ReActConfig, type ReActStep, type ReActAction, type ReActTrace, type ReActEvent, type ReActEventListener, } from './react.js';
+export { ExecutionPolicyManager, createExecutionPolicyManager, STRICT_POLICY, BALANCED_POLICY, PERMISSIVE_POLICY, type PolicyLevel, type IntentType, type ExecutionPolicyConfig, type PolicyEvaluation, type PermissionGrant, type IntentClassification, type PolicyEvent, type PolicyEventListener, } from './execution-policy.js';
+export { ThreadManager, createThreadManager, createWithHistory, exportThread, getThreadLineage, type Thread, type Checkpoint, type CheckpointState, type MergeStrategy, type ThreadEvent, type ThreadEventListener, } from './thread-manager.js';
+export { SessionStore, createSessionStore, formatSessionList, type SessionMetadata, type SessionEntry, type SessionStoreConfig, type SessionEvent, type SessionEventListener, } from './session-store.js';
+export { SQLiteStore, createSQLiteStore, type SQLiteStoreConfig, type Goal, type GoalStatus, type Juncture, type JunctureType, type WorkerResult, type WorkerResultStatus, type WorkerResultRef, type SessionManifest, } from './sqlite-store.js';
+export { MIGRATIONS, applyMigrations as applySchemaMigrations, getMigrationStatus as getSchemaMigrationStatus, needsMigration as schemaNeedsMigration, detectFeatures, type Migration, type MigrationResult, type SchemaFeatures, } from '../persistence/schema.js';
+export { StreamHandler, createStreamHandler, formatChunkForTerminal, adaptOpenRouterStream, adaptAnthropicStream, type StreamChunk, type StreamCallback, type StreamConfig, type StreamEvent, type StreamEventListener, } from './streaming.js';
+export { Compactor, createCompactor, formatCompactionResult, getContextUsage, getContextBreakdown, formatContextBreakdown, type CompactionConfig, type CompactionResult, type CompactionEvent, type CompactionEventListener, type ContextBreakdown, type ToolDefinition, } from './compaction.js';
+export { MCPClient, createMCPClient, formatServerList, getSampleMCPConfig, type MCPServerConfig, type MCPConfigFile, type MCPClientConfig, type MCPServerInfo, type MCPEvent, type MCPEventListener, type MCPToolSummary, type MCPContextStats, } from './mcp-client.js';
+export { createMCPToolSearchTool, createMCPToolListTool, createMCPContextStatsTool, createMCPMetaTools, formatToolSummaries, formatContextStats, type MCPToolSearchResult, type MCPToolSearchOptions, } from './mcp-tool-search.js';
+export { CancellationManager, createCancellationManager, createCancellationTokenSource, createTimeoutToken, createLinkedToken, withCancellation, sleep, race, toAbortSignal, isCancellationError, CancellationError, CancellationToken, type CancellationToken as CancellationTokenType, type CancellationTokenSource, type CancellableOptions, type CancellationEvent, type CancellationEventListener, } from './cancellation.js';
+export { ResourceManager, createResourceManager, createStrictResourceManager, createLenientResourceManager, combinedShouldContinue, isResourceLimitError, ResourceLimitError, type ResourceLimitsConfig, type ResourceUsage, type ResourceStatus, type ResourceCheck, type ResourceEvent, type ResourceEventListener, } from './resources.js';
+export { HierarchicalConfigManager, createHierarchicalConfig, createAndLoadConfig, getSampleGlobalConfig, getSampleWorkspaceConfig, ensureConfigDirectories, type ConfigLevel, type LevelConfig, type ResolvedConfig, type ConfigEvent, type ConfigEventListener, type HierarchicalConfigOptions, } from './hierarchical-config.js';
+export { LSPManager, createLSPManager, createAndStartLSPManager, type LSPConfig, type LanguageServerConfig, type LSPPosition, type LSPRange, type LSPLocation, type LSPDiagnostic, type LSPCompletion, type DiagnosticSeverity, type CompletionKind, type LSPEvent, type LSPEventListener, } from './lsp.js';
+export { SemanticCacheManager, createSemanticCacheManager, createStrictCache, createLenientCache, withSemanticCache, cosineSimilarity, type SemanticCacheConfig, type CacheEntry, type CacheHit, type CacheStats, type EmbeddingFunction, type CacheEvent, type CacheEventListener, } from './semantic-cache.js';
+export { SandboxManager as OSSandboxManager, createSandboxManager as createOSSandboxManager, createSandbox, sandboxExec, SeatbeltSandbox, DockerSandbox, BasicSandbox, type Sandbox, type ExecResult, type SandboxOptions, type SandboxMode, type SandboxManagerConfig as OSSandboxManagerConfig, type SandboxEvent as OSSandboxEvent, type SandboxEventListener as OSSandboxEventListener, } from './sandbox/index.js';
+export { SkillManager, createSkillManager, formatSkillList, getSampleSkillContent, getDefaultSkillDirectories, type Skill, type SkillTrigger, type SkillsConfig, type SkillEvent, type SkillEventListener, } from './skills.js';
+export { IgnoreManager, createIgnoreManager, quickShouldIgnore, getSampleAgentignore, getBuiltinIgnorePatterns, type IgnorePattern, type IgnoreConfig, type IgnoreEvent, type IgnoreEventListener, } from './ignore.js';
+export { PTYShellManager, createPTYShell, createAndStartPTYShell, createPTYShellTool, formatShellState, type PTYShellConfig, type CommandResult, type ShellState, type PTYEvent, type PTYEventListener, } from './pty-shell.js';
+export { ContextEngineeringManager, createContextEngineering, createMinimalContextEngineering, createFullContextEngineering, stableStringify, calculateOptimalFrequency, createReconstructionPrompt, extractInsights, type ContextEngineeringConfig, type ContextMessage, type ContextEngineeringStats, type ContextEngineeringEvent, type ContextEngineeringEventListener, } from './context-engineering.js';
+export { CodebaseContextManager, createCodebaseContext, buildContextFromChunks, summarizeRepoStructure, type CodeChunk, type MinimalCodeChunk, type CodeChunkType, type RepoMap, type CodebaseContextConfig, type SelectionOptions, type SelectionStrategy, type SelectionResult, type CodebaseContextEvent, type CodebaseContextEventListener, } from './codebase-context.js';
+export { SharedBlackboard, createSharedBlackboard, createFindingFromOutput, extractFindings, type Finding, type FindingType, type ResourceClaim, type ClaimType, type Subscription, type FindingFilter, type BlackboardConfig, type BlackboardEvent, type BlackboardEventListener, type BlackboardStats, } from './shared-blackboard.js';
+export { SmartDecomposer, createSmartDecomposer, createDecompositionPrompt, parseDecompositionResponse, type SmartSubtask, type SubtaskStatus, type SubtaskType, type DependencyGraph, type ResourceConflict, type SmartDecompositionResult, type DecompositionStrategy, type SmartDecomposerConfig, type LLMDecomposeFunction, type DecomposeContext, type LLMDecomposeResult, type SmartDecomposerEvent, type SmartDecomposerEventListener, } from './smart-decomposer.js';
+export { ResultSynthesizer, createResultSynthesizer, createSynthesisPrompt, type AgentOutput, type OutputType, type FileChange, type Hunk, type ResultConflict, type ConflictType, type ConflictResolution, type ResolutionStrategy, type SynthesisResult, type SynthesisStats, type SynthesisMethod, type ResultSynthesizerConfig, type LLMSynthesizeFunction, type LLMSynthesisResult, type ResultSynthesizerEvent, type ResultSynthesizerEventListener, } from './result-synthesizer.js';
+export { PendingPlanManager, createPendingPlanManager, formatPlanStatus, type PendingPlan, type ProposedChange, type PlanStatus, type PlanApprovalResult, type PendingPlanEvent, type PendingPlanEventListener, } from './pending-plan.js';
+export { PersistenceDebugger, persistenceDebug, saveCheckpointToStore, loadSessionState, type AnySessionStore, type CheckpointData, } from './persistence.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/integrations/index.d.ts.map

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

package/dist/src/integrations/index.js

@@ -0,0 +1,73 @@
+/**
+ * Lesson 25: Integration Module Exports
+ *
+ * Clean re-exports of all integration modules.
+ */
+// Core integrations (Lessons 10-22)
+export { HookManager, createHookManager } from './hooks.js';
+export { MemoryManager, createMemoryManager } from './memory.js';
+export { PlanningManager, createPlanningManager } from './planning.js';
+export { Tracer, MetricsCollector, Logger, ObservabilityManager, createObservabilityManager, } from './observability.js';
+export { SandboxManager, HumanInLoopManager, SafetyManager, createSafetyManager, } from './safety.js';
+export { RoutingManager, createRoutingManager } from './routing.js';
+// Rules system (from Lesson 12)
+export { RulesManager, createRulesManager, parseRulesFromMarkdown, DEFAULT_RULE_SOURCES, } from './rules.js';
+// Economics system (token budgets, progress detection)
+export { ExecutionEconomicsManager, createEconomicsManager, QUICK_BUDGET, STANDARD_BUDGET, LARGE_BUDGET, UNLIMITED_BUDGET, } from './economics.js';
+// Extensible agent registry
+export { AgentRegistry, createAgentRegistry, filterToolsForAgent, formatAgentList, } from './agent-registry.js';
+// Multi-agent coordination (from Lesson 17)
+export { MultiAgentManager, createMultiAgentManager, CODER_ROLE, REVIEWER_ROLE, ARCHITECT_ROLE, RESEARCHER_ROLE, } from './multi-agent.js';
+// ReAct pattern (from Lesson 18)
+export { ReActManager, createReActManager, extractThoughts, extractActions, hasCoherentReasoning, } from './react.js';
+// Execution policies (from Lesson 23)
+export { ExecutionPolicyManager, createExecutionPolicyManager, STRICT_POLICY, BALANCED_POLICY, PERMISSIVE_POLICY, } from './execution-policy.js';
+// Thread management (from Lesson 24)
+export { ThreadManager, createThreadManager, createWithHistory, exportThread, getThreadLineage, } from './thread-manager.js';
+// Session persistence
+export { SessionStore, createSessionStore, formatSessionList, } from './session-store.js';
+// SQLite session persistence (preferred for production)
+export { SQLiteStore, createSQLiteStore, } from './sqlite-store.js';
+// Schema management (embedded migrations)
+export { MIGRATIONS, applyMigrations as applySchemaMigrations, getMigrationStatus as getSchemaMigrationStatus, needsMigration as schemaNeedsMigration, detectFeatures, } from '../persistence/schema.js';
+// Streaming responses
+export { StreamHandler, createStreamHandler, formatChunkForTerminal, adaptOpenRouterStream, adaptAnthropicStream, } from './streaming.js';
+// Context compaction
+export { Compactor, createCompactor, formatCompactionResult, getContextUsage, getContextBreakdown, formatContextBreakdown, } from './compaction.js';
+// MCP client
+export { MCPClient, createMCPClient, formatServerList, getSampleMCPConfig, } from './mcp-client.js';
+// MCP tool search (dynamic tool discovery)
+export { createMCPToolSearchTool, createMCPToolListTool, createMCPContextStatsTool, createMCPMetaTools, formatToolSummaries, formatContextStats, } from './mcp-tool-search.js';
+// Cancellation tokens
+export { CancellationManager, createCancellationManager, createCancellationTokenSource, createTimeoutToken, createLinkedToken, withCancellation, sleep, race, toAbortSignal, isCancellationError, CancellationError, CancellationToken, } from './cancellation.js';
+// Resource monitoring
+export { ResourceManager, createResourceManager, createStrictResourceManager, createLenientResourceManager, combinedShouldContinue, isResourceLimitError, ResourceLimitError, } from './resources.js';
+// Hierarchical configuration
+export { HierarchicalConfigManager, createHierarchicalConfig, createAndLoadConfig, getSampleGlobalConfig, getSampleWorkspaceConfig, ensureConfigDirectories, } from './hierarchical-config.js';
+// LSP (Language Server Protocol)
+export { LSPManager, createLSPManager, createAndStartLSPManager, } from './lsp.js';
+// Semantic Cache
+export { SemanticCacheManager, createSemanticCacheManager, createStrictCache, createLenientCache, withSemanticCache, cosineSimilarity, } from './semantic-cache.js';
+// OS-Specific Sandbox (renamed to avoid conflict with SandboxManager from safety.js)
+export { SandboxManager as OSSandboxManager, createSandboxManager as createOSSandboxManager, createSandbox, sandboxExec, SeatbeltSandbox, DockerSandbox, BasicSandbox, } from './sandbox/index.js';
+// Skills Standard
+export { SkillManager, createSkillManager, formatSkillList, getSampleSkillContent, getDefaultSkillDirectories, } from './skills.js';
+// Ignore File Support
+export { IgnoreManager, createIgnoreManager, quickShouldIgnore, getSampleAgentignore, getBuiltinIgnorePatterns, } from './ignore.js';
+// Persistent PTY Shell
+export { PTYShellManager, createPTYShell, createAndStartPTYShell, createPTYShellTool, formatShellState, } from './pty-shell.js';
+// Context Engineering (Manus-inspired tricks P, Q, R, S, T)
+export { ContextEngineeringManager, createContextEngineering, createMinimalContextEngineering, createFullContextEngineering, stableStringify, calculateOptimalFrequency, createReconstructionPrompt, extractInsights, } from './context-engineering.js';
+// Codebase Context (intelligent code selection)
+export { CodebaseContextManager, createCodebaseContext, buildContextFromChunks, summarizeRepoStructure, } from './codebase-context.js';
+// Shared Blackboard (subagent coordination)
+export { SharedBlackboard, createSharedBlackboard, createFindingFromOutput, extractFindings, } from './shared-blackboard.js';
+// Smart Decomposer (semantic task decomposition)
+export { SmartDecomposer, createSmartDecomposer, createDecompositionPrompt, parseDecompositionResponse, } from './smart-decomposer.js';
+// Result Synthesizer (structured result merging)
+export { ResultSynthesizer, createResultSynthesizer, createSynthesisPrompt, } from './result-synthesizer.js';
+// Pending Plan (plan mode write interception)
+export { PendingPlanManager, createPendingPlanManager, formatPlanStatus, } from './pending-plan.js';
+// Persistence utilities (debug logging, checkpoint management)
+export { PersistenceDebugger, persistenceDebug, saveCheckpointToStore, loadSessionState, } from './persistence.js';
+//# sourceMappingURL=index.js.map

package/dist/src/integrations/index.js.map

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

package/dist/src/integrations/lsp.d.ts

@@ -0,0 +1,196 @@
+/**
+ * LSP Integration
+ *
+ * Language Server Protocol client manager for code intelligence.
+ * Provides definitions, completions, hover info, and references.
+ * Wraps and extends the SimpleLSPClient from tricks/lsp-client.ts.
+ *
+ * Usage:
+ *   const lsp = createLSPManager({ autoDetect: true });
+ *   await lsp.autoStart('/path/to/project');
+ *   const def = await lsp.getDefinition('file.ts', 10, 5);
+ */
+/**
+ * Position in a document (0-indexed).
+ */
+export interface LSPPosition {
+    line: number;
+    character: number;
+}
+/**
+ * Range in a document.
+ */
+export interface LSPRange {
+    start: LSPPosition;
+    end: LSPPosition;
+}
+/**
+ * Location in a document.
+ */
+export interface LSPLocation {
+    uri: string;
+    range: LSPRange;
+}
+/**
+ * Diagnostic severity.
+ */
+export type DiagnosticSeverity = 'error' | 'warning' | 'information' | 'hint';
+/**
+ * Diagnostic message.
+ */
+export interface LSPDiagnostic {
+    range: LSPRange;
+    message: string;
+    severity: DiagnosticSeverity;
+    source?: string;
+    code?: string | number;
+}
+/**
+ * Completion item kind.
+ */
+export type CompletionKind = 'text' | 'method' | 'function' | 'constructor' | 'field' | 'variable' | 'class' | 'interface' | 'module' | 'property' | 'keyword' | 'snippet';
+/**
+ * Completion item.
+ */
+export interface LSPCompletion {
+    label: string;
+    kind: CompletionKind;
+    detail?: string;
+    documentation?: string;
+    insertText?: string;
+}
+/**
+ * Language server configuration.
+ */
+export interface LanguageServerConfig {
+    /** Command to start the server */
+    command: string;
+    /** Arguments for the server */
+    args?: string[];
+    /** File extensions this server handles */
+    extensions: string[];
+    /** Language ID for the server */
+    languageId: string;
+}
+/**
+ * LSP manager configuration.
+ */
+export interface LSPConfig {
+    /** Enable/disable LSP support */
+    enabled?: boolean;
+    /** Custom server configurations */
+    servers?: Record<string, LanguageServerConfig>;
+    /** Auto-detect and start servers based on file types */
+    autoDetect?: boolean;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Root URI of the workspace */
+    rootUri?: string;
+}
+/**
+ * LSP event types.
+ */
+export type LSPEvent = {
+    type: 'lsp.started';
+    languageId: string;
+    command: string;
+} | {
+    type: 'lsp.stopped';
+    languageId: string;
+} | {
+    type: 'lsp.error';
+    languageId: string;
+    error: string;
+} | {
+    type: 'lsp.diagnostics';
+    uri: string;
+    diagnostics: LSPDiagnostic[];
+};
+export type LSPEventListener = (event: LSPEvent) => void;
+/**
+ * Manages multiple LSP clients for different languages.
+ */
+export declare class LSPManager {
+    private clients;
+    private config;
+    private eventListeners;
+    private diagnosticsCache;
+    constructor(config?: LSPConfig);
+    /**
+     * Auto-detect and start LSP servers based on project files.
+     */
+    autoStart(workspaceRoot?: string): Promise<string[]>;
+    /**
+     * Start a specific language server.
+     */
+    startServer(languageId: string, rootUri?: string): Promise<void>;
+    /**
+     * Stop a specific language server.
+     */
+    stopServer(languageId: string): Promise<void>;
+    /**
+     * Stop all language servers.
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Get definition for a symbol.
+     */
+    getDefinition(file: string, line: number, col: number): Promise<LSPLocation | null>;
+    /**
+     * Get completions at a position.
+     */
+    getCompletions(file: string, line: number, col: number): Promise<LSPCompletion[]>;
+    /**
+     * Get hover information.
+     */
+    getHover(file: string, line: number, col: number): Promise<string | null>;
+    /**
+     * Get all references to a symbol.
+     */
+    getReferences(file: string, line: number, col: number, includeDeclaration?: boolean): Promise<LSPLocation[]>;
+    /**
+     * Get cached diagnostics for a file.
+     */
+    getDiagnostics(file: string): LSPDiagnostic[];
+    /**
+     * Notify about a file being opened.
+     */
+    notifyFileOpened(file: string, content: string): void;
+    /**
+     * Notify about a file being changed.
+     */
+    notifyFileChanged(file: string, content: string, version?: number): void;
+    /**
+     * Notify about a file being closed.
+     */
+    notifyFileClosed(file: string): void;
+    /**
+     * Get list of active language servers.
+     */
+    getActiveServers(): string[];
+    /**
+     * Check if a language server is running.
+     */
+    isServerRunning(languageId: string): boolean;
+    /**
+     * Subscribe to LSP events.
+     */
+    subscribe(listener: LSPEventListener): () => void;
+    /**
+     * Cleanup all resources.
+     */
+    cleanup(): Promise<void>;
+    private getClientForFile;
+    private detectLanguages;
+    private commandExists;
+    private emit;
+}
+/**
+ * Create an LSP manager.
+ */
+export declare function createLSPManager(config?: LSPConfig): LSPManager;
+/**
+ * Create an LSP manager and auto-start servers.
+ */
+export declare function createAndStartLSPManager(workspaceRoot?: string, config?: LSPConfig): Promise<LSPManager>;
+//# sourceMappingURL=lsp.d.ts.map