@nextclaw/mcp 0.1.65 → 0.1.67

package/dist/index.d.ts

@@ -1,228 +1,238 @@
-import { McpServerDefinition, McpTransport, McpServerScope, McpServerMetadata, Config } from '@nextclaw/core';
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { Config, McpServerDefinition, McpServerMetadata, McpServerScope, McpTransport } from "@nextclaw/core";
+import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 
+//#region src/types.d.ts
 type McpServerRecord = {
-    name: string;
-    definition: McpServerDefinition;
+  name: string;
+  definition: McpServerDefinition;
 };
 type McpToolCatalogEntry = {
-    qualifiedName: string;
-    serverName: string;
-    toolName: string;
-    description?: string;
-    parameters?: Record<string, unknown>;
+  qualifiedName: string;
+  serverName: string;
+  toolName: string;
+  description?: string;
+  parameters?: Record<string, unknown>;
 };
 type McpServerWarmResult = {
-    name: string;
-    ok: boolean;
-    toolCount: number;
-    error?: string;
+  name: string;
+  ok: boolean;
+  toolCount: number;
+  error?: string;
 };
 type McpDoctorReport = {
-    name: string;
-    enabled: boolean;
-    transport: McpTransport["type"];
-    accessible: boolean;
-    toolCount: number;
-    error?: string;
+  name: string;
+  enabled: boolean;
+  transport: McpTransport["type"];
+  accessible: boolean;
+  toolCount: number;
+  error?: string;
 };
 type McpConfigReconcileResult = {
-    added: string[];
-    removed: string[];
-    enabled: string[];
-    disabled: string[];
-    restarted: string[];
-    warmed: McpServerWarmResult[];
+  added: string[];
+  removed: string[];
+  enabled: string[];
+  disabled: string[];
+  restarted: string[];
+  warmed: McpServerWarmResult[];
 };
 type McpCatalogFilter = {
-    agentId?: string;
+  agentId?: string;
 };
 type McpLifecycleState = {
-    record: McpServerRecord;
-    tools: McpToolCatalogEntry[];
-    clientReady: boolean;
-    lastReadyAt?: string;
-    lastError?: string;
+  record: McpServerRecord;
+  tools: McpToolCatalogEntry[];
+  clientReady: boolean;
+  lastReadyAt?: string;
+  lastError?: string;
 };
 type McpMarketplaceTransportType = McpTransport["type"];
 type McpMarketplaceInputField = {
-    id: string;
-    label: string;
-    description?: string;
-    required?: boolean;
-    secret?: boolean;
-    defaultValue?: string;
+  id: string;
+  label: string;
+  description?: string;
+  required?: boolean;
+  secret?: boolean;
+  defaultValue?: string;
 };
 type McpMarketplaceInstallTemplate = {
-    kind: "template";
-    spec: string;
-    command: string;
-    defaultName: string;
-    transportTypes: McpMarketplaceTransportType[];
-    template: McpServerDefinition;
-    inputs: McpMarketplaceInputField[];
+  kind: "template";
+  spec: string;
+  command: string;
+  defaultName: string;
+  transportTypes: McpMarketplaceTransportType[];
+  template: McpServerDefinition;
+  inputs: McpMarketplaceInputField[];
 };
 type McpInstalledRecord = {
-    name: string;
-    enabled: boolean;
-    transport: McpTransport["type"];
-    scope: McpServerScope;
-    source: "manual" | "marketplace";
-    catalogSlug?: string;
-    displayName?: string;
-    vendor?: string;
-    docsUrl?: string;
-    homepage?: string;
-    trustLevel?: "official" | "verified" | "community";
-    installedAt?: string;
-    toolCount?: number;
-    accessible?: boolean;
-    lastReadyAt?: string;
-    lastError?: string;
+  name: string;
+  enabled: boolean;
+  transport: McpTransport["type"];
+  scope: McpServerScope;
+  source: "manual" | "marketplace";
+  catalogSlug?: string;
+  displayName?: string;
+  vendor?: string;
+  docsUrl?: string;
+  homepage?: string;
+  trustLevel?: "official" | "verified" | "community";
+  installedAt?: string;
+  toolCount?: number;
+  accessible?: boolean;
+  lastReadyAt?: string;
+  lastError?: string;
 };
 type McpMutationResult = {
-    changed: boolean;
-    name: string;
-    message: string;
-    definition?: McpServerDefinition;
+  changed: boolean;
+  name: string;
+  message: string;
+  definition?: McpServerDefinition;
 };
 type McpMaterializeInstallParams = {
-    template: McpMarketplaceInstallTemplate;
-    name?: string;
-    enabled?: boolean;
-    scope?: Partial<McpServerScope>;
-    inputs?: Record<string, string | undefined>;
-    metadata?: Partial<McpServerMetadata>;
+  template: McpMarketplaceInstallTemplate;
+  name?: string;
+  enabled?: boolean;
+  scope?: Partial<McpServerScope>;
+  inputs?: Record<string, string | undefined>;
+  metadata?: Partial<McpServerMetadata>;
 };
 declare function normalizeMcpServerName(name: string): string;
 declare function readDefaultAgentId(config: Config): string;
 declare function isServerAccessibleToAgent(params: {
-    config: Config;
-    scope: McpServerScope;
-    agentId?: string;
+  config: Config;
+  scope: McpServerScope;
+  agentId?: string;
 }): boolean;
 declare function buildQualifiedMcpToolName(serverName: string, toolName: string): string;
 declare function sanitizeMcpSegment(value: string): string;
-
+//#endregion
+//#region src/config/mcp-config-normalizer.d.ts
 declare function listMcpServers(config: Config): McpServerRecord[];
 declare function getMcpServer(config: Config, name: string): McpServerRecord | undefined;
-
+//#endregion
+//#region src/client/mcp-client-factory.d.ts
 type McpClientHandle = {
-    client: Client;
-    transport: Transport;
+  client: Client;
+  transport: Transport;
 };
 declare class McpClientFactory {
-    private readonly _config?;
-    constructor(_config?: Config | undefined);
-    create(record: McpServerRecord): McpClientHandle;
+  private readonly _config?;
+  constructor(_config?: Config | undefined);
+  create(record: McpServerRecord): McpClientHandle;
 }
-
+//#endregion
+//#region src/lifecycle/mcp-server-lifecycle-manager.d.ts
 declare class McpServerLifecycleManager {
-    private readonly options;
-    private readonly pendingConnections;
-    private readonly readyConnections;
-    constructor(options: {
-        getConfig: () => Config;
-        clientFactory?: McpClientFactory;
-        now?: () => Date;
-    });
-    warmServer(record: McpServerRecord): Promise<McpLifecycleState>;
-    getCachedCatalog(serverName: string): McpToolCatalogEntry[];
-    getCachedState(serverName: string): McpLifecycleState | undefined;
-    callTool(record: McpServerRecord, toolName: string, args: Record<string, unknown>): Promise<unknown>;
-    closeAll(): Promise<void>;
-    closeServer(serverName: string): Promise<void>;
-    private ensureConnection;
-    private connect;
-    private stripConnection;
-    private normalizeToolResult;
+  private readonly options;
+  private readonly pendingConnections;
+  private readonly readyConnections;
+  constructor(options: {
+    getConfig: () => Config;
+    clientFactory?: McpClientFactory;
+    now?: () => Date;
+  });
+  warmServer(record: McpServerRecord): Promise<McpLifecycleState>;
+  getCachedCatalog(serverName: string): McpToolCatalogEntry[];
+  getCachedState(serverName: string): McpLifecycleState | undefined;
+  callTool(record: McpServerRecord, toolName: string, args: Record<string, unknown>): Promise<unknown>;
+  closeAll(): Promise<void>;
+  closeServer(serverName: string): Promise<void>;
+  private ensureConnection;
+  private connect;
+  private stripConnection;
+  private normalizeToolResult;
 }
-
+//#endregion
+//#region src/registry/mcp-registry-service.d.ts
 declare class McpRegistryService {
-    private readonly options;
-    private readonly lifecycleManager;
-    constructor(options: {
-        getConfig: () => Config;
-        lifecycleManager?: McpServerLifecycleManager;
-    });
-    listServers(): McpServerRecord[];
-    getServer(name: string): McpServerRecord | undefined;
-    prewarmEnabledServers(): Promise<McpServerWarmResult[]>;
-    warmServer(name: string): Promise<McpServerWarmResult>;
-    reconcileConfig(params: {
-        prevConfig: Config;
-        nextConfig: Config;
-    }): Promise<McpConfigReconcileResult>;
-    listAccessibleTools(filter?: McpCatalogFilter): McpToolCatalogEntry[];
-    getCachedState(serverName: string): McpLifecycleState | undefined;
-    callTool(params: {
-        serverName: string;
-        toolName: string;
-        args: Record<string, unknown>;
-    }): Promise<unknown>;
-    close(): Promise<void>;
-    private warmRecord;
+  private readonly options;
+  private readonly lifecycleManager;
+  constructor(options: {
+    getConfig: () => Config;
+    lifecycleManager?: McpServerLifecycleManager;
+  });
+  listServers(): McpServerRecord[];
+  getServer(name: string): McpServerRecord | undefined;
+  prewarmEnabledServers(): Promise<McpServerWarmResult[]>;
+  warmServer(name: string): Promise<McpServerWarmResult>;
+  reconcileConfig(params: {
+    prevConfig: Config;
+    nextConfig: Config;
+  }): Promise<McpConfigReconcileResult>;
+  listAccessibleTools(filter?: McpCatalogFilter): McpToolCatalogEntry[];
+  getCachedState(serverName: string): McpLifecycleState | undefined;
+  callTool(params: {
+    serverName: string;
+    toolName: string;
+    args: Record<string, unknown>;
+  }): Promise<unknown>;
+  close(): Promise<void>;
+  private warmRecord;
 }
-
+//#endregion
+//#region src/doctor/mcp-doctor-service.d.ts
 declare class McpDoctorService {
-    private readonly options;
-    constructor(options: {
-        getConfig: () => Config;
-        registryService?: McpRegistryService;
-    });
-    inspect(name?: string): Promise<McpDoctorReport[]>;
+  private readonly options;
+  constructor(options: {
+    getConfig: () => Config;
+    registryService?: McpRegistryService;
+  });
+  inspect(name?: string): Promise<McpDoctorReport[]>;
 }
-
+//#endregion
+//#region src/doctor/mcp-doctor-facade.d.ts
 declare class McpDoctorFacade {
-    private readonly options;
-    private readonly doctorService;
-    constructor(options: {
-        getConfig: () => Config;
-        registryService?: McpRegistryService;
-    });
-    inspect(name?: string): Promise<McpDoctorReport[]>;
-    inspectOne(name: string): Promise<McpDoctorReport | null>;
+  private readonly options;
+  private readonly doctorService;
+  constructor(options: {
+    getConfig: () => Config;
+    registryService?: McpRegistryService;
+  });
+  inspect(name?: string): Promise<McpDoctorReport[]>;
+  inspectOne(name: string): Promise<McpDoctorReport | null>;
 }
-
+//#endregion
+//#region src/install/mcp-install-template-materializer.d.ts
 declare class McpInstallTemplateMaterializer {
-    materialize(params: McpMaterializeInstallParams): {
-        name: string;
-        definition: McpServerDefinition;
-    };
-    private applyInputs;
-    private mergeScope;
-    private mergeMetadata;
+  materialize(params: McpMaterializeInstallParams): {
+    name: string;
+    definition: McpServerDefinition;
+  };
+  private applyInputs;
+  private mergeScope;
+  private mergeMetadata;
 }
-
+//#endregion
+//#region src/manage/mcp-mutation-service.d.ts
 declare class McpMutationService {
-    private readonly options;
-    private readonly materializer;
-    constructor(options: {
-        getConfig: () => Config;
-        saveConfig: (config: Config) => void;
-        materializer?: McpInstallTemplateMaterializer;
-    });
-    listServerNames(): string[];
-    addServer(name: string, definition: McpServerDefinition): McpMutationResult;
-    updateServer(name: string, definition: McpServerDefinition): McpMutationResult;
-    removeServer(name: string): McpMutationResult;
-    toggleEnabled(name: string, enabled: boolean): McpMutationResult;
-    installFromTemplate(params: Omit<McpMaterializeInstallParams, "template"> & {
-        template: McpMarketplaceInstallTemplate;
-    }): McpMutationResult;
-    duplicateServer(sourceName: string, targetName: string): McpMutationResult;
-    renameServer(sourceName: string, targetName: string): McpMutationResult;
+  private readonly options;
+  private readonly materializer;
+  constructor(options: {
+    getConfig: () => Config;
+    saveConfig: (config: Config) => void;
+    materializer?: McpInstallTemplateMaterializer;
+  });
+  listServerNames(): string[];
+  addServer(name: string, definition: McpServerDefinition): McpMutationResult;
+  updateServer(name: string, definition: McpServerDefinition): McpMutationResult;
+  removeServer(name: string): McpMutationResult;
+  toggleEnabled(name: string, enabled: boolean): McpMutationResult;
+  installFromTemplate(params: Omit<McpMaterializeInstallParams, "template"> & {
+    template: McpMarketplaceInstallTemplate;
+  }): McpMutationResult;
+  duplicateServer(sourceName: string, targetName: string): McpMutationResult;
+  renameServer(sourceName: string, targetName: string): McpMutationResult;
 }
-
+//#endregion
+//#region src/view/mcp-installed-view-service.d.ts
 declare class McpInstalledViewService {
-    private readonly options;
-    private readonly registryService;
-    constructor(options: {
-        getConfig: () => Config;
-        registryService?: McpRegistryService;
-    });
-    listInstalled(): McpInstalledRecord[];
+  private readonly options;
+  private readonly registryService;
+  constructor(options: {
+    getConfig: () => Config;
+    registryService?: McpRegistryService;
+  });
+  listInstalled(): McpInstalledRecord[];
 }
-
-export { type McpCatalogFilter, McpClientFactory, type McpConfigReconcileResult, McpDoctorFacade, type McpDoctorReport, McpDoctorService, McpInstallTemplateMaterializer, type McpInstalledRecord, McpInstalledViewService, type McpLifecycleState, type McpMarketplaceInputField, type McpMarketplaceInstallTemplate, type McpMarketplaceTransportType, type McpMaterializeInstallParams, type McpMutationResult, McpMutationService, McpRegistryService, McpServerLifecycleManager, type McpServerRecord, type McpServerWarmResult, type McpToolCatalogEntry, buildQualifiedMcpToolName, getMcpServer, isServerAccessibleToAgent, listMcpServers, normalizeMcpServerName, readDefaultAgentId, sanitizeMcpSegment };
+//#endregion
+export { McpCatalogFilter, McpClientFactory, McpConfigReconcileResult, McpDoctorFacade, McpDoctorReport, McpDoctorService, McpInstallTemplateMaterializer, McpInstalledRecord, McpInstalledViewService, McpLifecycleState, McpMarketplaceInputField, McpMarketplaceInstallTemplate, McpMarketplaceTransportType, McpMaterializeInstallParams, McpMutationResult, McpMutationService, McpRegistryService, McpServerLifecycleManager, McpServerRecord, McpServerWarmResult, McpToolCatalogEntry, buildQualifiedMcpToolName, getMcpServer, isServerAccessibleToAgent, listMcpServers, normalizeMcpServerName, readDefaultAgentId, sanitizeMcpSegment };