qlogicagent 0.2.1 → 0.4.0

package/dist/skills/tools/mcp-client-types.js

@@ -1,53 +0,0 @@
-// ============================================================
-// MCP Client SDK Types — Full Model Context Protocol client contract.
-//
-// Defines the complete type system for MCP server connections,
-// transports, authentication, dynamic tool injection, prompts,
-// and lifecycle management.
-//
-// Reference: @modelcontextprotocol/sdk + Claude Code services/mcp/
-// ============================================================
-// ── Client Lifecycle Constants ──────────────────────────────
-export const MCP_CONNECTION_TIMEOUT_MS = 30_000;
-export const MCP_REQUEST_TIMEOUT_MS = 60_000;
-export const MCP_TOOL_CALL_TIMEOUT_MS = 100_000;
-export const MCP_MAX_RECONNECT_ATTEMPTS = 5;
-export const MCP_RECONNECT_BASE_DELAY_MS = 1_000;
-export const MCP_RECONNECT_MAX_DELAY_MS = 30_000;
-export const MCP_MAX_DESCRIPTION_LENGTH = 2048;
-export const MCP_AUTH_CACHE_TTL_MS = 15 * 60 * 1000;
-export const MCP_BATCH_SIZE_LOCAL = 3;
-export const MCP_BATCH_SIZE_REMOTE = 20;
-// ── Name Utilities ──────────────────────────────────────────
-const MCP_PREFIX = "mcp__";
-const MCP_SEPARATOR = "__";
-/** Normalize a name for use in the prefixed tool name format */
-export function normalizeNameForMcp(name) {
-    return name.replace(/[^a-zA-Z0-9_-]/g, "_");
-}
-/** Build a prefixed tool name: mcp__{server}__{tool} */
-export function buildMcpToolName(serverName, toolName) {
-    return `${MCP_PREFIX}${normalizeNameForMcp(serverName)}${MCP_SEPARATOR}${normalizeNameForMcp(toolName)}`;
-}
-/** Get the prefix for a server (for batch removal) */
-export function getMcpServerPrefix(serverName) {
-    return `${MCP_PREFIX}${normalizeNameForMcp(serverName)}${MCP_SEPARATOR}`;
-}
-/** Parse a prefixed tool name back into server + tool */
-export function parseMcpToolName(prefixedName) {
-    if (!prefixedName.startsWith(MCP_PREFIX))
-        return null;
-    const rest = prefixedName.slice(MCP_PREFIX.length);
-    const sepIndex = rest.indexOf(MCP_SEPARATOR);
-    if (sepIndex < 0)
-        return null;
-    return {
-        serverName: rest.slice(0, sepIndex),
-        toolName: rest.slice(sepIndex + MCP_SEPARATOR.length),
-        prefixedName,
-    };
-}
-/** Check if a tool name is an MCP-injected tool */
-export function isMcpToolName(name) {
-    return name.startsWith(MCP_PREFIX);
-}

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

@@ -1,249 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import type { McpServerConfig, McpConnectionStatus, McpServerCapabilities, McpToolAnnotations, McpToolsChangedEvent, McpPromptDefinition, McpPromptMessage, McpElicitResult, McpAuthState, McpLogEntry, McpLogLevel } from "./mcp-client-types.js";
-export type { McpServerConfig, McpStdioConfig, McpSseConfig, McpHttpConfig, McpWsConfig, McpInProcessConfig, McpServerState, McpConnectionStatus, McpServerCapabilities, McpExternalTool, McpToolAnnotations, McpToolIdentifier, McpToolsChangedEvent, McpResourceDefinition, McpResourceTemplate, McpPersistedResourceContent, McpResourceContentItem, McpPromptDefinition, McpPromptArgument, McpPromptMessage, McpPromptContent, McpElicitResult, McpElicitRequest, McpOAuthConfig, McpOAuthTokens, McpAuthState, McpLogEntry, McpLogLevel, McpTransportType, } from "./mcp-client-types.js";
-export { normalizeNameForMcp, buildMcpToolName, getMcpServerPrefix, parseMcpToolName, isMcpToolName, MCP_CONNECTION_TIMEOUT_MS, MCP_REQUEST_TIMEOUT_MS, MCP_TOOL_CALL_TIMEOUT_MS, MCP_MAX_RECONNECT_ATTEMPTS, MCP_MAX_DESCRIPTION_LENGTH, } from "./mcp-client-types.js";
-export declare const MCP_TOOL_NAME: "mcp";
-export type McpAction = "list_servers" | "list_tools" | "call_tool" | "list_resources" | "read_resource" | "list_prompts" | "get_prompt" | "authenticate" | "manage_server";
-export interface McpToolParams {
-    action: McpAction;
-    /** Server name (required for most actions) */
-    server?: string;
-    /** Tool name on the MCP server (for call_tool) */
-    toolName?: string;
-    /** Arguments for the MCP tool call or prompt arguments */
-    arguments?: Record<string, unknown>;
-    /** Resource URI (for read_resource) */
-    uri?: string;
-    /** Prompt name (for get_prompt) */
-    promptName?: string;
-    /** Server management sub-action */
-    manageAction?: McpManageAction;
-    /** Server config (for manage_server add) */
-    config?: McpServerConfig;
-}
-export type McpManageAction = "add" | "remove" | "restart" | "health_check" | "enable" | "disable";
-export declare const MCP_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["list_servers", "list_tools", "call_tool", "list_resources", "read_resource", "list_prompts", "get_prompt", "authenticate", "manage_server"];
-            readonly description: string;
-        };
-        readonly server: {
-            readonly type: "string";
-            readonly description: "MCP server name. Required for all actions except list_servers.";
-        };
-        readonly toolName: {
-            readonly type: "string";
-            readonly description: "Tool name on the MCP server. Required for call_tool.";
-        };
-        readonly arguments: {
-            readonly type: "object";
-            readonly description: "Arguments for the tool call or prompt. Used with call_tool and get_prompt.";
-        };
-        readonly uri: {
-            readonly type: "string";
-            readonly description: "Resource URI. Required for read_resource.";
-        };
-        readonly promptName: {
-            readonly type: "string";
-            readonly description: "Prompt name. Required for get_prompt.";
-        };
-        readonly manageAction: {
-            readonly type: "string";
-            readonly enum: readonly ["add", "remove", "restart", "health_check", "enable", "disable"];
-            readonly description: "Sub-action for manage_server.";
-        };
-        readonly config: {
-            readonly type: "object";
-            readonly description: "Server configuration. Required for manage_server add.";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-export interface McpServer {
-    name: string;
-    status: McpConnectionStatus;
-    transport: string;
-    toolCount: number;
-    resourceCount: number;
-    promptCount: number;
-    capabilities?: McpServerCapabilities;
-    serverVersion?: string;
-    error?: string;
-    connectedAt?: number;
-}
-export interface McpToolInfo {
-    name: string;
-    description?: string;
-    inputSchema?: Record<string, unknown>;
-    annotations?: McpToolAnnotations;
-    /** Prefixed name used in tool list */
-    prefixedName?: string;
-}
-export interface McpResource {
-    uri: string;
-    name: string;
-    mimeType?: string;
-    description?: string;
-    server?: string;
-}
-export interface McpResourceContent {
-    uri: string;
-    mimeType?: string;
-    text?: string;
-    blobSavedTo?: string;
-    blobSize?: number;
-}
-export interface McpCallResult {
-    success: boolean;
-    content?: string;
-    error?: string;
-    isError?: boolean;
-    /** Structured content blocks (images, resources) */
-    contentBlocks?: Array<{
-        type: "text" | "image" | "resource";
-        text?: string;
-        data?: string;
-        mimeType?: string;
-    }>;
-}
-export interface McpAuthResult {
-    status: "auth_url" | "already_authenticated" | "unsupported" | "step_up_required" | "error";
-    authUrl?: string;
-    message?: string;
-    /** Required scopes for step-up auth */
-    requiredScopes?: string[];
-}
-export interface McpPromptResult {
-    description?: string;
-    messages: McpPromptMessage[];
-}
-export interface McpManageResult {
-    success: boolean;
-    message: string;
-    /** Updated server state after the operation */
-    serverState?: McpServer;
-}
-/**
- * Host-provided MCP client backend — full lifecycle management.
- *
- * Implements the complete MCP client SDK contract:
- * - Transport abstraction (stdio/SSE/HTTP/WS/in-process)
- * - Connection lifecycle (connect/disconnect/reconnect/health)
- * - OAuth authentication with PKCE + token refresh
- * - Dynamic tool injection (tools/list_changed notification)
- * - Resource management with binary blob persistence
- * - Prompt support
- * - Server configuration CRUD
- */
-export interface McpToolDeps {
-    /** List all configured MCP servers with full state */
-    listServers(): Promise<McpServer[]>;
-    /**
-     * List tools from a specific server.
-     * Results are cached; invalidated on tools/list_changed notification.
-     */
-    listTools(server: string): Promise<McpToolInfo[]>;
-    /**
-     * Call a tool on an MCP server.
-     * Handles: connection ensure → permission check → execute → parse result.
-     */
-    callTool(server: string, toolName: string, args?: Record<string, unknown>, signal?: AbortSignal): Promise<McpCallResult>;
-    /**
-     * List resources from a server (or all servers if not specified).
-     * Uses LRU cache; invalidated on resources/list_changed.
-     */
-    listResources(server?: string): Promise<McpResource[]>;
-    /**
-     * Read a specific resource by URI.
-     * Handles binary blob persistence: base64 → disk file → returns path.
-     */
-    readResource(server: string, uri: string): Promise<McpResourceContent[]>;
-    /**
-     * List prompts available from a server.
-     * Prompts are reusable templates that servers expose.
-     */
-    listPrompts?(server: string): Promise<McpPromptDefinition[]>;
-    /**
-     * Get a specific prompt with arguments expanded.
-     * Returns the prompt messages ready for injection into conversation.
-     */
-    getPrompt?(server: string, promptName: string, args?: Record<string, string>): Promise<McpPromptResult>;
-    /**
-     * Initiate OAuth authentication with a server.
-     * Supports: PKCE flow, token refresh, step-up auth.
-     *
-     * For stdio servers: returns "not_applicable".
-     * For SSE/HTTP servers: returns auth_url or triggers silent auth.
-     */
-    authenticate(server: string): Promise<McpAuthResult>;
-    /**
-     * Check current auth state of a server (without initiating a flow).
-     * Optional — host may not track auth state for all servers.
-     */
-    getAuthState?(server: string): Promise<McpAuthState>;
-    /**
-     * Add a new MCP server configuration.
-     * Optionally auto-connects after adding.
-     */
-    addServer?(name: string, config: McpServerConfig): Promise<McpManageResult>;
-    /**
-     * Remove an MCP server (disconnect + delete config).
-     * Also removes all injected tools with the server's prefix.
-     */
-    removeServer?(name: string): Promise<McpManageResult>;
-    /**
-     * Restart (disconnect + reconnect) a server.
-     * Clears caches and re-fetches tools/resources/prompts.
-     */
-    restartServer?(name: string): Promise<McpManageResult>;
-    /**
-     * Health check a server's connection.
-     * Returns the updated server state with latency info.
-     */
-    healthCheck?(server: string): Promise<McpManageResult>;
-    /**
-     * Enable/disable a server (disabled servers don't auto-connect).
-     */
-    setServerEnabled?(name: string, enabled: boolean): Promise<McpManageResult>;
-    /**
-     * Register a callback for when a server's tool list changes.
-     * The host calls this when it receives tools/list_changed notifications.
-     *
-     * The callback receives the event with previous and current tool lists,
-     * enabling the orchestration layer to hot-swap injected tools.
-     */
-    onToolsChanged?(callback: (event: McpToolsChangedEvent) => void): void;
-    /**
-     * Get all currently injected MCP tools across all servers.
-     * Returns the flattened list of tools with their prefixed names.
-     */
-    getInjectedTools?(): Promise<McpToolInfo[]>;
-    /**
-     * Handle an elicitation request from an MCP server.
-     * The server asks the user for input/consent; the host presents UI.
-     * Optional — defaults to deny if not implemented.
-     */
-    handleElicitation?(server: string, message: string, schema?: Record<string, unknown>): Promise<McpElicitResult>;
-    /**
-     * Get recent log entries from MCP servers.
-     * Optional — useful for debugging server-side issues.
-     */
-    getServerLogs?(server: string, level?: McpLogLevel, limit?: number): Promise<McpLogEntry[]>;
-}
-export declare function createMcpTool(deps: McpToolDeps): PortableTool<McpToolParams>;
-export interface McpAuthProxyDeps {
-    /** Initiate OAuth for the specified server */
-    authenticate(server: string): Promise<McpAuthResult>;
-    /** Optional callback after successful auth — e.g. reconnect, refresh tools */
-    onAuthComplete?(server: string): Promise<void>;
-}
-/**
- * Create a dynamic per-server authentication proxy tool.
- * One instance per unauthenticated MCP server.
- *
- * Tool name follows CC convention: `mcp__<normalizedServer>__authenticate`
- */
-export declare function createMcpAuthProxy(serverName: string, deps: McpAuthProxyDeps): PortableTool<Record<string, never>>;