distill-mcp 0.6.0-beta

package/dist/sandbox/types.d.ts

@@ -0,0 +1,577 @@
+/**
+ * Sandbox Types
+ *
+ * Type definitions for the code execution SDK.
+ */
+import type { SupportedLanguage, ElementType } from "../ast/types.js";
+import type { ContentType } from "../compressors/types.js";
+/**
+ * Execution context passed to sandbox
+ */
+export interface ExecutionContext {
+    workingDir: string;
+    timeout: number;
+    memoryLimit: number;
+    maxOutputTokens: number;
+}
+/**
+ * Default execution limits
+ */
+export declare const DEFAULT_LIMITS: {
+    readonly timeout: 5000;
+    readonly maxTimeout: 30000;
+    readonly memoryLimit: 128;
+    readonly maxOutputTokens: 4000;
+};
+/**
+ * Compression result from SDK
+ */
+export interface CompressResult {
+    compressed: string;
+    stats: {
+        original: number;
+        compressed: number;
+        reductionPercent: number;
+    };
+}
+/**
+ * Log summary result
+ */
+export interface LogSummary {
+    summary: string;
+    stats: {
+        totalLines: number;
+        errorCount: number;
+        warningCount: number;
+    };
+}
+/**
+ * Code element from AST parsing
+ */
+export interface CodeElement {
+    type: ElementType;
+    name: string;
+    startLine: number;
+    endLine?: number;
+    signature?: string;
+    documentation?: string;
+}
+/**
+ * File structure from parsing
+ */
+export interface FileStructure {
+    language: SupportedLanguage;
+    functions: CodeElement[];
+    classes: CodeElement[];
+    interfaces: CodeElement[];
+    types: CodeElement[];
+    variables: CodeElement[];
+    imports: CodeElement[];
+    exports: CodeElement[];
+}
+/**
+ * Extraction target for code elements
+ */
+export interface ExtractionTarget {
+    type: ElementType;
+    name: string;
+}
+/**
+ * SDK functions available in sandbox
+ */
+export interface CtxOptSDK {
+    compress: {
+        auto: (content: string, hint?: string) => CompressResult;
+        logs: (logs: string) => LogSummary;
+        diff: (diff: string) => CompressResult;
+        semantic: (content: string, ratio?: number) => CompressResult;
+    };
+    code: {
+        parse: (content: string, language: SupportedLanguage) => FileStructure;
+        extract: (content: string, language: SupportedLanguage, target: ExtractionTarget) => string | null;
+        skeleton: (content: string, language: SupportedLanguage) => string;
+    };
+    files: {
+        read: (path: string) => string;
+        exists: (path: string) => boolean;
+        glob: (pattern: string) => string[];
+    };
+    utils: {
+        countTokens: (text: string) => number;
+        detectType: (content: string) => ContentType;
+        detectLanguage: (filePath: string) => SupportedLanguage;
+    };
+    git: {
+        diff: (ref?: string) => GitDiff;
+        log: (limit?: number) => GitCommit[];
+        blame: (file: string, line?: number) => GitBlame;
+        status: () => GitStatus;
+        branch: () => GitBranch;
+    };
+    search: {
+        grep: (pattern: string, glob?: string) => GrepResult;
+        symbols: (query: string, glob?: string) => SymbolResult;
+        files: (pattern: string) => FileResult;
+        references: (symbol: string, glob?: string) => ReferenceMatch[];
+    };
+    analyze: {
+        dependencies: (file: string) => DependencyResult;
+        callGraph: (functionName: string, file: string, depth?: number) => CallGraphResult;
+        exports: (file: string) => ExportInfo[];
+        structure: (dir?: string, depth?: number) => StructureEntry;
+    };
+    pipeline: {
+        (steps: PipelineStep[]): PipelineResult;
+        codebaseOverview: (dir?: string) => CodebaseOverview;
+        findUsages: (symbol: string, glob?: string) => SymbolUsage;
+        analyzeDeps: (file: string, depth?: number) => DependencyAnalysis;
+    };
+    multifile: {
+        compress: (patterns: string[], options?: MultiFileCompressOptions) => MultiFileCompressResult;
+        extractShared: (patterns: string[]) => SharedElements;
+        chunk: (patterns: string[], maxTokensPerChunk: number) => ChunkInfo[];
+        skeletons: (patterns: string[], depth?: number) => string;
+        readAll: (patterns: string[]) => string;
+    };
+    conversation: {
+        compress: (messages: ConversationMessage[], options?: ConversationCompressOptions) => ConversationCompressResult;
+        createMemory: (messages: ConversationMessage[], options?: ConversationCompressOptions) => ConversationMemoryResult;
+        extractDecisions: (messages: ConversationMessage[]) => Decision[];
+        extractCodeRefs: (messages: ConversationMessage[]) => CodeReference[];
+        restore: (options?: MemoryRestoreOptions) => string;
+        getMemory: () => ConversationMemory | null;
+        setMemory: (memory: ConversationMemory) => void;
+        clearMemory: () => void;
+        hasMemory: () => boolean;
+        getSummary: () => ConversationMemorySummary | null;
+    };
+}
+/**
+ * Execution result from sandbox
+ */
+export interface ExecutionResult {
+    success: boolean;
+    output: unknown;
+    error?: string;
+    stats: {
+        executionTimeMs: number;
+        tokensUsed: number;
+    };
+}
+/**
+ * Code analysis result for security
+ */
+export interface CodeAnalysis {
+    safe: boolean;
+    warnings: string[];
+    blockedPatterns: string[];
+}
+/**
+ * Host callbacks for sandbox file operations
+ */
+export interface HostCallbacks {
+    readFile: (path: string) => string;
+    fileExists: (path: string) => boolean;
+    glob: (pattern: string) => string[];
+}
+/**
+ * Git diff result
+ */
+export interface GitDiff {
+    raw: string;
+    files: GitFileChange[];
+    stats: {
+        additions: number;
+        deletions: number;
+    };
+}
+/**
+ * Individual file change in a diff
+ */
+export interface GitFileChange {
+    file: string;
+    status: "added" | "modified" | "deleted" | "renamed";
+    additions: number;
+    deletions: number;
+}
+/**
+ * Git commit information
+ */
+export interface GitCommit {
+    hash: string;
+    shortHash: string;
+    author: string;
+    date: string;
+    message: string;
+}
+/**
+ * Git blame result
+ */
+export interface GitBlame {
+    lines: GitBlameLine[];
+}
+/**
+ * Individual blame line
+ */
+export interface GitBlameLine {
+    hash: string;
+    author: string;
+    date: string;
+    line: number;
+    content: string;
+}
+/**
+ * Git repository status
+ */
+export interface GitStatus {
+    branch: string;
+    ahead: number;
+    behind: number;
+    staged: string[];
+    modified: string[];
+    untracked: string[];
+}
+/**
+ * Git branch information
+ */
+export interface GitBranch {
+    current: string;
+    branches: string[];
+}
+/**
+ * Grep match result
+ */
+export interface GrepMatch {
+    file: string;
+    line: number;
+    column: number;
+    content: string;
+    match: string;
+}
+/**
+ * Grep search result
+ */
+export interface GrepResult {
+    matches: GrepMatch[];
+    totalMatches: number;
+    filesSearched: number;
+}
+/**
+ * Symbol search result
+ */
+export interface SymbolMatch {
+    name: string;
+    type: ElementType;
+    file: string;
+    line: number;
+    signature?: string;
+}
+/**
+ * Symbol search result container
+ */
+export interface SymbolResult {
+    symbols: SymbolMatch[];
+    totalMatches: number;
+}
+/**
+ * File search result
+ */
+export interface FileMatch {
+    path: string;
+    name: string;
+    extension: string;
+    size?: number;
+}
+/**
+ * File search result container
+ */
+export interface FileResult {
+    files: FileMatch[];
+    totalMatches: number;
+}
+/**
+ * Reference location
+ */
+export interface ReferenceMatch {
+    file: string;
+    line: number;
+    column: number;
+    context: string;
+    type: "definition" | "usage" | "import";
+}
+/**
+ * Import dependency info
+ */
+export interface ImportInfo {
+    source: string;
+    names: string[];
+    isDefault: boolean;
+    isNamespace: boolean;
+    resolvedPath?: string;
+}
+/**
+ * Export info
+ */
+export interface ExportInfo {
+    name: string;
+    type: ElementType;
+    isDefault: boolean;
+    line: number;
+    signature?: string;
+}
+/**
+ * File dependencies result
+ */
+export interface DependencyResult {
+    file: string;
+    imports: ImportInfo[];
+    exports: ExportInfo[];
+    externalDeps: string[];
+    internalDeps: string[];
+}
+/**
+ * Call graph node
+ */
+export interface CallNode {
+    name: string;
+    file: string;
+    line: number;
+    calls: string[];
+    calledBy: string[];
+}
+/**
+ * Call graph result
+ */
+export interface CallGraphResult {
+    root: string;
+    nodes: CallNode[];
+    depth: number;
+}
+/**
+ * Directory structure entry
+ */
+export interface StructureEntry {
+    path: string;
+    type: "file" | "directory";
+    name: string;
+    children?: StructureEntry[];
+    language?: string;
+    exports?: number;
+    functions?: number;
+    classes?: number;
+    size?: number;
+}
+/**
+ * Pipeline step types
+ */
+export type PipelineStep = {
+    glob: string;
+} | {
+    filter: (item: unknown) => boolean;
+} | {
+    read: boolean;
+} | {
+    map: (item: unknown) => unknown;
+} | {
+    reduce: (acc: unknown, item: unknown) => unknown;
+    initial: unknown;
+} | {
+    compress: "auto" | "semantic" | "logs";
+    ratio?: number;
+} | {
+    limit: number;
+} | {
+    sort: "asc" | "desc";
+    by?: string;
+} | {
+    unique: boolean | string;
+};
+/**
+ * Pipeline execution result
+ */
+export interface PipelineResult<T = unknown> {
+    data: T;
+    stats: {
+        stepsExecuted: number;
+        itemsProcessed: number;
+        executionTimeMs: number;
+    };
+}
+/**
+ * Codebase overview result
+ */
+export interface CodebaseOverview {
+    totalFiles: number;
+    totalLines: number;
+    languages: Record<string, number>;
+    largestFiles: Array<{
+        path: string;
+        lines: number;
+    }>;
+    structure: StructureEntry;
+}
+/**
+ * Symbol usage result
+ */
+export interface SymbolUsage {
+    symbol: string;
+    definitions: Array<{
+        file: string;
+        line: number;
+    }>;
+    usages: Array<{
+        file: string;
+        line: number;
+        context: string;
+    }>;
+    totalReferences: number;
+}
+/**
+ * Dependency analysis result
+ */
+export interface DependencyAnalysis {
+    file: string;
+    directDeps: string[];
+    transitiveDeps: string[];
+    externalPackages: string[];
+    circularDeps: string[];
+}
+/**
+ * Multi-file compression options
+ */
+export interface MultiFileCompressOptions {
+    maxTokens?: number;
+    strategy?: "deduplicate" | "skeleton" | "smart-chunk";
+    preservePatterns?: string[];
+}
+/**
+ * Multi-file compression result
+ */
+export interface MultiFileCompressResult {
+    compressed: string;
+    filesIncluded: string[];
+    sharedElements: SharedElements;
+    stats: {
+        originalTokens: number;
+        compressedTokens: number;
+        filesProcessed: number;
+        deduplicatedItems: number;
+        reductionPercent: number;
+    };
+}
+/**
+ * Shared elements across files
+ */
+export interface SharedElements {
+    imports: Array<{
+        source: string;
+        names: string[];
+        usedIn: string[];
+    }>;
+    types: Array<{
+        name: string;
+        kind: string;
+        definition: string;
+        usedIn: string[];
+    }>;
+    constants: Array<{
+        name: string;
+        value: string;
+        usedIn: string[];
+    }>;
+}
+/**
+ * Chunk information for smart chunking
+ */
+export interface ChunkInfo {
+    id: string;
+    files: string[];
+    tokens: number;
+    dependencies: string[];
+}
+/**
+ * Conversation message
+ */
+export interface ConversationMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+}
+/**
+ * Conversation compression options
+ */
+export interface ConversationCompressOptions {
+    strategy: "rolling-summary" | "key-extraction" | "hybrid";
+    maxTokens: number;
+    preserveSystem?: boolean;
+    preserveLastN?: number;
+}
+/**
+ * Conversation compression result
+ */
+export interface ConversationCompressResult {
+    compressedMessages: ConversationMessage[];
+    summary?: string;
+    keyPoints?: string[];
+    originalTokens: number;
+    compressedTokens: number;
+    savings: number;
+}
+/**
+ * Decision extracted from conversation
+ */
+export interface Decision {
+    decision: string;
+    context: string;
+    timestamp: number;
+}
+/**
+ * Code reference from conversation
+ */
+export interface CodeReference {
+    file: string;
+    element?: string;
+    action: "created" | "modified" | "discussed" | "deleted";
+}
+/**
+ * Conversation memory state
+ */
+export interface ConversationMemory {
+    summary: string;
+    decisions: Decision[];
+    codeReferences: CodeReference[];
+    compressedHistory: ConversationMessage[];
+    lastUpdated: number;
+}
+/**
+ * Options for memory restoration
+ */
+export interface MemoryRestoreOptions {
+    includeSummary?: boolean;
+    recentMessages?: number;
+    includeCodeRefs?: boolean;
+    includeDecisions?: boolean;
+}
+/**
+ * Conversation memory result
+ */
+export interface ConversationMemoryResult {
+    context: string;
+    memory: ConversationMemory;
+    stats: {
+        originalTokens: number;
+        compressedTokens: number;
+        decisionsExtracted: number;
+        codeRefsFound: number;
+    };
+}
+/**
+ * Conversation memory summary
+ */
+export interface ConversationMemorySummary {
+    summary: string;
+    decisionsCount: number;
+    codeRefsCount: number;
+    messagesCount: number;
+    lastUpdated: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sandbox/types.d.ts.map

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

package/dist/sandbox/types.js

@@ -0,0 +1,14 @@
+/**
+ * Sandbox Types
+ *
+ * Type definitions for the code execution SDK.
+ */
+/**
+ * Default execution limits
+ */
+export const DEFAULT_LIMITS = {
+    timeout: 5000, // 5 seconds
+    maxTimeout: 30000, // 30 seconds max
+    memoryLimit: 128, // 128MB
+    maxOutputTokens: 4000,
+};

package/dist/server.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CtxOpt MCP Server
+ *
+ * Main server implementation with dynamic tool loading.
+ * Only core tools are loaded at startup to minimize token consumption.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type MiddlewareChain } from "./middleware/chain.js";
+import { type ToolRegistry } from "./tools/registry.js";
+export type LoadingMode = "lazy" | "core" | "all";
+export interface ServerConfig {
+    verbose?: boolean;
+    /** Load all tools at startup instead of using dynamic loading */
+    loadAllTools?: boolean;
+    /**
+     * Tool loading mode:
+     * - "lazy": Only 2 meta-tools (browse_tools, run_tool) - 95% token savings
+     * - "core": Core tools + discover_tools (default)
+     * - "all": Load all tools at startup
+     */
+    mode?: LoadingMode;
+}
+export interface ServerInstance {
+    server: Server;
+    middleware: MiddlewareChain;
+    tools: ToolRegistry;
+}
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(config?: ServerConfig): Promise<ServerInstance>;
+/**
+ * Run the MCP server on stdio transport
+ */
+export declare function runServer(config?: ServerConfig): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIpF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAK5E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+GrF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBxE"}