qlogicagent 0.2.1 → 0.4.0

package/dist/skills/tools/lsp-tool.d.ts

@@ -1,153 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const LSP_TOOL_NAME: "lsp";
-export type LspOperation = "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "diagnostics" | "completion" | "signatureHelp" | "rename" | "codeAction";
-export interface LspToolParams {
-    /** LSP operation to perform */
-    operation: LspOperation;
-    /** File path (absolute or relative to workspace root) */
-    filePath: string;
-    /** Line number (1-indexed) */
-    line?: number;
-    /** Character position (1-indexed) */
-    character?: number;
-    /** New name (for rename operation) */
-    newName?: string;
-    /** Include context lines around results */
-    includeContext?: boolean;
-}
-export declare const LSP_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly operation: {
-            readonly type: "string";
-            readonly enum: readonly ["goToDefinition", "findReferences", "hover", "documentSymbol", "diagnostics", "completion", "signatureHelp", "rename", "codeAction"];
-            readonly description: string;
-        };
-        readonly filePath: {
-            readonly type: "string";
-            readonly description: "File path. Absolute or relative to workspace root.";
-        };
-        readonly line: {
-            readonly type: "number";
-            readonly description: "Line number (1-indexed). Required for positional operations.";
-        };
-        readonly character: {
-            readonly type: "number";
-            readonly description: "Character position (1-indexed). Required for positional operations.";
-        };
-        readonly newName: {
-            readonly type: "string";
-            readonly description: "New name for rename operation.";
-        };
-        readonly includeContext: {
-            readonly type: "boolean";
-            readonly description: "Include surrounding code context in results (default: true).";
-        };
-    };
-    readonly required: readonly ["operation", "filePath"];
-};
-export interface LspLocation {
-    filePath: string;
-    line: number;
-    character: number;
-    endLine?: number;
-    endCharacter?: number;
-    context?: string;
-}
-export interface LspSymbol {
-    name: string;
-    kind: string;
-    range: {
-        startLine: number;
-        endLine: number;
-    };
-    children?: LspSymbol[];
-}
-export interface LspDiagnostic {
-    message: string;
-    severity: "error" | "warning" | "info" | "hint";
-    line: number;
-    character: number;
-    source?: string;
-    code?: string | number;
-}
-export interface LspHoverInfo {
-    contents: string;
-    range?: {
-        startLine: number;
-        startCharacter: number;
-        endLine: number;
-        endCharacter: number;
-    };
-}
-export interface LspCompletion {
-    label: string;
-    kind: string;
-    detail?: string;
-    insertText?: string;
-}
-export interface LspRenameEdit {
-    filePath: string;
-    edits: Array<{
-        line: number;
-        character: number;
-        endLine: number;
-        endCharacter: number;
-        newText: string;
-    }>;
-}
-export interface LspCodeAction {
-    title: string;
-    kind?: string;
-    isPreferred?: boolean;
-}
-export type LspResult = {
-    type: "locations";
-    locations: LspLocation[];
-} | {
-    type: "symbols";
-    symbols: LspSymbol[];
-} | {
-    type: "diagnostics";
-    diagnostics: LspDiagnostic[];
-} | {
-    type: "hover";
-    hover: LspHoverInfo | null;
-} | {
-    type: "completions";
-    completions: LspCompletion[];
-} | {
-    type: "rename";
-    edits: LspRenameEdit[];
-} | {
-    type: "codeActions";
-    actions: LspCodeAction[];
-} | {
-    type: "signatureHelp";
-    signatures: string[];
-};
-/**
- * Host-provided LSP backend.
- * The host manages language server lifecycle and connections.
- */
-export interface LspToolDeps {
-    /** Execute an LSP operation. Host dispatches to appropriate language server. */
-    executeOperation(params: {
-        operation: LspOperation;
-        filePath: string;
-        line?: number;
-        character?: number;
-        newName?: string;
-        includeContext?: boolean;
-    }): Promise<LspResult>;
-    /** Check if file exists and get its size */
-    statFile?(filePath: string): Promise<{
-        exists: boolean;
-        size: number;
-    } | null>;
-    /** Resolve relative path to absolute */
-    resolvePath(filePath: string): string;
-    /** List supported language IDs (e.g. ['typescript', 'python', 'rust']) */
-    supportedLanguages?(): string[];
-}
-export declare function createLspTool(deps: LspToolDeps): PortableTool<LspToolParams>;

package/dist/skills/tools/lsp-tool.js

@@ -1,227 +0,0 @@
-// ============================================================
-// LSP Tool — Language Server Protocol code intelligence.
-// Reference: claude-code-haha/src/tools/LSPTool/LSPTool.ts
-// Category: coding (read-only)
-// ============================================================
-export const LSP_TOOL_NAME = "lsp";
-export const LSP_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        operation: {
-            type: "string",
-            enum: [
-                "goToDefinition",
-                "findReferences",
-                "hover",
-                "documentSymbol",
-                "diagnostics",
-                "completion",
-                "signatureHelp",
-                "rename",
-                "codeAction",
-            ],
-            description: "LSP operation:\n" +
-                "- goToDefinition: jump to symbol definition\n" +
-                "- findReferences: find all usages of a symbol\n" +
-                "- hover: get type/docs for symbol at position\n" +
-                "- documentSymbol: list all symbols in file (classes, functions, etc)\n" +
-                "- diagnostics: get errors/warnings for a file\n" +
-                "- completion: get completions at position\n" +
-                "- signatureHelp: get function signature at call site\n" +
-                "- rename: preview rename of symbol\n" +
-                "- codeAction: get available quick-fixes/refactorings",
-        },
-        filePath: {
-            type: "string",
-            description: "File path. Absolute or relative to workspace root.",
-        },
-        line: {
-            type: "number",
-            description: "Line number (1-indexed). Required for positional operations.",
-        },
-        character: {
-            type: "number",
-            description: "Character position (1-indexed). Required for positional operations.",
-        },
-        newName: {
-            type: "string",
-            description: "New name for rename operation.",
-        },
-        includeContext: {
-            type: "boolean",
-            description: "Include surrounding code context in results (default: true).",
-        },
-    },
-    required: ["operation", "filePath"],
-};
-// ── Dependencies ────────────────────────────────────────────
-const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB
-// Positional operations require line and character
-const POSITIONAL_OPS = [
-    "goToDefinition",
-    "findReferences",
-    "hover",
-    "completion",
-    "signatureHelp",
-    "rename",
-    "codeAction",
-];
-export function createLspTool(deps) {
-    return {
-        name: LSP_TOOL_NAME,
-        label: "LSP",
-        description: "Query language servers for code intelligence. Supports go-to-definition, find-references, " +
-            "hover (type info), document symbols, diagnostics (errors/warnings), completions, " +
-            "signature help, rename preview, and code actions. Read-only — does not modify files.",
-        parameters: LSP_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            if (!params.filePath || params.filePath.trim().length === 0) {
-                return {
-                    content: [{ type: "text", text: "Error: filePath is required." }],
-                    details: { type: "lsp", error: "missing_filePath" },
-                };
-            }
-            // Block UNC paths (NTLM credential leak risk on Windows)
-            if (params.filePath.startsWith("\\\\") || params.filePath.startsWith("//")) {
-                return {
-                    content: [{ type: "text", text: "Error: UNC paths are not allowed." }],
-                    details: { type: "lsp", error: "unc_blocked" },
-                };
-            }
-            // Validate positional params
-            if (POSITIONAL_OPS.includes(params.operation)) {
-                if (params.line == null || params.character == null) {
-                    return {
-                        content: [{ type: "text", text: `Error: line and character are required for ${params.operation}.` }],
-                        details: { type: "lsp", error: "missing_position" },
-                    };
-                }
-                if (params.line < 1 || params.character < 1) {
-                    return {
-                        content: [{ type: "text", text: "Error: line and character must be ≥ 1." }],
-                        details: { type: "lsp", error: "invalid_position" },
-                    };
-                }
-            }
-            // Rename requires newName
-            if (params.operation === "rename" && !params.newName) {
-                return {
-                    content: [{ type: "text", text: "Error: newName is required for rename operation." }],
-                    details: { type: "lsp", error: "missing_newName" },
-                };
-            }
-            const resolved = deps.resolvePath(params.filePath);
-            // File size check
-            if (deps.statFile) {
-                const stat = await deps.statFile(resolved);
-                if (!stat || !stat.exists) {
-                    return {
-                        content: [{ type: "text", text: `Error: file not found: ${params.filePath}` }],
-                        details: { type: "lsp", error: "file_not_found" },
-                    };
-                }
-                if (stat.size > MAX_FILE_SIZE) {
-                    return {
-                        content: [{ type: "text", text: `Error: file too large (${(stat.size / 1024 / 1024).toFixed(1)}MB, max 10MB).` }],
-                        details: { type: "lsp", error: "file_too_large" },
-                    };
-                }
-            }
-            const result = await deps.executeOperation({
-                operation: params.operation,
-                filePath: resolved,
-                line: params.line,
-                character: params.character,
-                newName: params.newName,
-                includeContext: params.includeContext ?? true,
-            });
-            return { content: [{ type: "text", text: formatLspResult(params.operation, result) }], details: { type: "lsp", operation: params.operation } };
-        },
-    };
-}
-// ── Output formatting ───────────────────────────────────────
-function formatLspResult(operation, result) {
-    switch (result.type) {
-        case "locations": {
-            if (result.locations.length === 0)
-                return "No results found.";
-            const lines = [`Found ${result.locations.length} location(s):`, ""];
-            for (const loc of result.locations.slice(0, 50)) {
-                lines.push(`  ${loc.filePath}:${loc.line}:${loc.character}`);
-                if (loc.context)
-                    lines.push(`    ${loc.context.trim()}`);
-            }
-            if (result.locations.length > 50)
-                lines.push(`  ... and ${result.locations.length - 50} more`);
-            return lines.join("\n");
-        }
-        case "symbols": {
-            if (result.symbols.length === 0)
-                return "No symbols found.";
-            const lines = [`Document symbols (${result.symbols.length}):`, ""];
-            for (const sym of result.symbols) {
-                lines.push(`  ${sym.kind} ${sym.name} (L${sym.range.startLine}-${sym.range.endLine})`);
-                if (sym.children) {
-                    for (const child of sym.children.slice(0, 10)) {
-                        lines.push(`    ${child.kind} ${child.name} (L${child.range.startLine})`);
-                    }
-                    if (sym.children.length > 10)
-                        lines.push(`    ... and ${sym.children.length - 10} more`);
-                }
-            }
-            return lines.join("\n");
-        }
-        case "diagnostics": {
-            if (result.diagnostics.length === 0)
-                return "No diagnostics (clean file).";
-            const lines = [`Diagnostics (${result.diagnostics.length}):`, ""];
-            for (const d of result.diagnostics) {
-                const icon = d.severity === "error" ? "❌" : d.severity === "warning" ? "⚠️" : "ℹ️";
-                lines.push(`  ${icon} L${d.line}:${d.character} [${d.source || ""}${d.code ? `:${d.code}` : ""}] ${d.message}`);
-            }
-            return lines.join("\n");
-        }
-        case "hover": {
-            if (!result.hover)
-                return "No hover information available.";
-            return result.hover.contents;
-        }
-        case "completions": {
-            if (result.completions.length === 0)
-                return "No completions available.";
-            const lines = [`Completions (${result.completions.length}):`, ""];
-            for (const c of result.completions.slice(0, 20)) {
-                lines.push(`  [${c.kind}] ${c.label}${c.detail ? ` — ${c.detail}` : ""}`);
-            }
-            if (result.completions.length > 20)
-                lines.push(`  ... and ${result.completions.length - 20} more`);
-            return lines.join("\n");
-        }
-        case "signatureHelp": {
-            if (result.signatures.length === 0)
-                return "No signature information available.";
-            return result.signatures.join("\n");
-        }
-        case "rename": {
-            if (result.edits.length === 0)
-                return "No edits generated for rename.";
-            const total = result.edits.reduce((sum, f) => sum + f.edits.length, 0);
-            const lines = [`Rename would affect ${total} location(s) in ${result.edits.length} file(s):`, ""];
-            for (const file of result.edits) {
-                lines.push(`  ${file.filePath} (${file.edits.length} edits)`);
-            }
-            return lines.join("\n");
-        }
-        case "codeActions": {
-            if (result.actions.length === 0)
-                return "No code actions available.";
-            const lines = [`Available code actions (${result.actions.length}):`, ""];
-            for (const a of result.actions) {
-                lines.push(`  ${a.isPreferred ? "★" : "-"} ${a.title}${a.kind ? ` [${a.kind}]` : ""}`);
-            }
-            return lines.join("\n");
-        }
-        default:
-            return "Unknown result type.";
-    }
-}

package/dist/skills/tools/mcp-client-types.d.ts

@@ -1,269 +0,0 @@
-/** Supported MCP transport types */
-export type McpTransportType = "stdio" | "sse" | "http" | "ws" | "in-process";
-/** Stdio transport configuration */
-export interface McpStdioConfig {
-    type: "stdio";
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-    cwd?: string;
-}
-/** SSE transport configuration */
-export interface McpSseConfig {
-    type: "sse";
-    url: string;
-    headers?: Record<string, string>;
-    /** OAuth config for auth-required SSE servers */
-    oauth?: McpOAuthConfig;
-}
-/** Streamable HTTP transport configuration (MCP 2025-03-26) */
-export interface McpHttpConfig {
-    type: "http";
-    url: string;
-    headers?: Record<string, string>;
-    /** OAuth config for auth-required HTTP servers */
-    oauth?: McpOAuthConfig;
-}
-/** WebSocket transport configuration */
-export interface McpWsConfig {
-    type: "ws";
-    url: string;
-    headers?: Record<string, string>;
-}
-/** In-process transport (bundled MCP servers) */
-export interface McpInProcessConfig {
-    type: "in-process";
-    /** Module identifier to load */
-    moduleId: string;
-    /** Init args passed to the in-process server */
-    initArgs?: Record<string, unknown>;
-}
-/** Union of all transport configurations */
-export type McpServerConfig = McpStdioConfig | McpSseConfig | McpHttpConfig | McpWsConfig | McpInProcessConfig;
-/** OAuth configuration for remote MCP servers */
-export interface McpOAuthConfig {
-    /** Client ID (or URL-based client_id per CIMD/SEP-991) */
-    clientId?: string;
-    /** Client secret (optional, for confidential clients) */
-    clientSecret?: string;
-    /** Override authorization endpoint (otherwise discovered via RFC 8414) */
-    authorizationEndpoint?: string;
-    /** Override token endpoint */
-    tokenEndpoint?: string;
-    /** Requested scopes */
-    scopes?: string[];
-    /** Fixed callback port (otherwise picks random available port) */
-    callbackPort?: number;
-    /** Audience for token exchange (RFC 8693) */
-    audience?: string;
-}
-/** OAuth token set */
-export interface McpOAuthTokens {
-    accessToken: string;
-    tokenType: string;
-    refreshToken?: string;
-    expiresAt?: number;
-    scope?: string;
-}
-/** Authentication state of a server */
-export type McpAuthState = {
-    status: "authenticated";
-    tokens: McpOAuthTokens;
-} | {
-    status: "needs-auth";
-    authUrl?: string;
-    message?: string;
-} | {
-    status: "refreshing";
-} | {
-    status: "step-up-required";
-    scope: string;
-    authUrl?: string;
-} | {
-    status: "not-applicable";
-};
-/** Server connection status */
-export type McpConnectionStatus = "connected" | "connecting" | "disconnected" | "failed" | "needs-auth" | "disabled";
-/** Server capabilities (as reported by initialize) */
-export interface McpServerCapabilities {
-    tools?: {
-        listChanged?: boolean;
-    };
-    resources?: {
-        subscribe?: boolean;
-        listChanged?: boolean;
-    };
-    prompts?: {
-        listChanged?: boolean;
-    };
-    logging?: Record<string, unknown>;
-    experimental?: Record<string, unknown>;
-}
-/** Full server connection state */
-export interface McpServerState {
-    name: string;
-    config: McpServerConfig;
-    status: McpConnectionStatus;
-    capabilities?: McpServerCapabilities;
-    serverVersion?: string;
-    serverInstructions?: string;
-    error?: string;
-    /** Timestamp of last successful connection */
-    connectedAt?: number;
-    /** Number of reconnect attempts since last disconnect */
-    reconnectAttempts?: number;
-}
-/**
- * An MCP tool definition as reported by tools/list.
- * The host converts these into PortableTool entries for the LLM.
- */
-export interface McpExternalTool {
-    /** Tool name on the MCP server (original) */
-    name: string;
-    /** Tool description */
-    description?: string;
-    /** JSON Schema for input parameters */
-    inputSchema?: Record<string, unknown>;
-    /** Annotations from the server (readOnlyHint, destructiveHint, etc.) */
-    annotations?: McpToolAnnotations;
-}
-/** Tool behavior annotations (MCP 2025-03-26 spec) */
-export interface McpToolAnnotations {
-    /** Hints that the tool performs only reads */
-    readOnlyHint?: boolean;
-    /** Hints that the tool may be destructive */
-    destructiveHint?: boolean;
-    /** Hints that the tool is idempotent */
-    idempotentHint?: boolean;
-    /** Hints about concurrency safety */
-    openWorldHint?: boolean;
-    /** Human-readable title for UI display */
-    title?: string;
-}
-/**
- * Prefixed tool name format: mcp__{normalizedServer}__{normalizedTool}
- * This ensures no collisions with built-in tools.
- */
-export interface McpToolIdentifier {
-    serverName: string;
-    toolName: string;
-    /** Full prefixed name: mcp__{server}__{tool} */
-    prefixedName: string;
-}
-/**
- * Notification payload when a server's tool list changes.
- * The host should re-fetch tools/list and hot-swap the tool set.
- */
-export interface McpToolsChangedEvent {
-    serverName: string;
-    /** Previous tool names (for diff-based cleanup) */
-    previousTools: string[];
-    /** Updated tool list */
-    currentTools: McpExternalTool[];
-}
-/** MCP Resource definition */
-export interface McpResourceDefinition {
-    uri: string;
-    name: string;
-    mimeType?: string;
-    description?: string;
-    /** Size in bytes (if known) */
-    size?: number;
-}
-/** Resource template (parameterized URI) */
-export interface McpResourceTemplate {
-    uriTemplate: string;
-    name: string;
-    mimeType?: string;
-    description?: string;
-}
-/** Content of a read resource */
-export interface McpResourceContentItem {
-    uri: string;
-    mimeType?: string;
-    /** Text content (mutually exclusive with blob) */
-    text?: string;
-    /** Base64-encoded binary (mutually exclusive with text) */
-    blob?: string;
-}
-/** Persisted resource content (after binary blob handling) */
-export interface McpPersistedResourceContent {
-    uri: string;
-    mimeType?: string;
-    text?: string;
-    /** Path where binary was saved to disk */
-    blobSavedTo?: string;
-    /** Size of persisted binary in bytes */
-    blobSize?: number;
-}
-/** MCP Prompt definition from prompts/list */
-export interface McpPromptDefinition {
-    name: string;
-    description?: string;
-    arguments?: McpPromptArgument[];
-}
-/** Argument for an MCP prompt */
-export interface McpPromptArgument {
-    name: string;
-    description?: string;
-    required?: boolean;
-}
-/** Result of prompts/get — prompt content messages */
-export interface McpPromptMessage {
-    role: "user" | "assistant";
-    content: McpPromptContent;
-}
-export type McpPromptContent = {
-    type: "text";
-    text: string;
-} | {
-    type: "image";
-    data: string;
-    mimeType: string;
-} | {
-    type: "resource";
-    resource: {
-        uri: string;
-        text?: string;
-        blob?: string;
-        mimeType?: string;
-    };
-};
-/** MCP Elicitation request (server asks user for input) */
-export interface McpElicitRequest {
-    message: string;
-    requestedSchema?: Record<string, unknown>;
-}
-/** Elicitation response */
-export interface McpElicitResult {
-    action: "accept" | "deny" | "cancel";
-    content?: Record<string, unknown>;
-}
-export type McpLogLevel = "debug" | "info" | "warning" | "error" | "critical";
-export interface McpLogEntry {
-    serverName: string;
-    level: McpLogLevel;
-    logger?: string;
-    data: unknown;
-    timestamp: number;
-}
-export declare const MCP_CONNECTION_TIMEOUT_MS = 30000;
-export declare const MCP_REQUEST_TIMEOUT_MS = 60000;
-export declare const MCP_TOOL_CALL_TIMEOUT_MS = 100000;
-export declare const MCP_MAX_RECONNECT_ATTEMPTS = 5;
-export declare const MCP_RECONNECT_BASE_DELAY_MS = 1000;
-export declare const MCP_RECONNECT_MAX_DELAY_MS = 30000;
-export declare const MCP_MAX_DESCRIPTION_LENGTH = 2048;
-export declare const MCP_AUTH_CACHE_TTL_MS: number;
-export declare const MCP_BATCH_SIZE_LOCAL = 3;
-export declare const MCP_BATCH_SIZE_REMOTE = 20;
-/** Normalize a name for use in the prefixed tool name format */
-export declare function normalizeNameForMcp(name: string): string;
-/** Build a prefixed tool name: mcp__{server}__{tool} */
-export declare function buildMcpToolName(serverName: string, toolName: string): string;
-/** Get the prefix for a server (for batch removal) */
-export declare function getMcpServerPrefix(serverName: string): string;
-/** Parse a prefixed tool name back into server + tool */
-export declare function parseMcpToolName(prefixedName: string): McpToolIdentifier | null;
-/** Check if a tool name is an MCP-injected tool */
-export declare function isMcpToolName(name: string): boolean;