@hasna/mcps 0.0.14 → 0.0.16

package/dist/lib/credentials.d.ts

@@ -0,0 +1,18 @@
+import type { CredentialReference, CredentialReferenceMap, McpServerEntry } from "../types.js";
+export declare class CredentialReferenceError extends Error {
+    constructor(message: string);
+}
+export declare const REDACTED_CREDENTIAL_VALUE = "<redacted>";
+export declare function isSecretLikeEnvKey(key: string): boolean;
+export declare function isSecretLikeValue(value: string): boolean;
+export declare function normalizeCredentialRef(ref: CredentialReference): CredentialReference;
+export declare function normalizeCredentialRefs(refs: CredentialReferenceMap | undefined): CredentialReferenceMap;
+export declare function parseCredentialRefs(value: unknown): CredentialReferenceMap;
+export declare function normalizeLiteralEnv(env: Record<string, string> | undefined): Record<string, string>;
+export declare function redactEnv(env: Record<string, string>): Record<string, string>;
+export declare function redactServerCredentials<T extends {
+    env: Record<string, string>;
+    credentialRefs?: CredentialReferenceMap;
+}>(server: T): T;
+export declare function resolveServerEnv(server: McpServerEntry): Record<string, string>;
+export declare function credentialRefPlaceholders(refs: CredentialReferenceMap | undefined): Record<string, string>;

package/dist/lib/doctor.d.ts

@@ -1,4 +1,5 @@
 import type { McpServerEntry } from "../types.js";
+import { type LocalCommandConsent } from "./local-command-consent.js";
 export interface DoctorCheck {
     name: string;
     pass: boolean;
@@ -11,4 +12,6 @@ export interface DoctorReport {
     checks: DoctorCheck[];
     healthy: boolean;
 }
-export declare function diagnoseServer(server: McpServerEntry): Promise<DoctorReport>;
+export declare function diagnoseServer(server: McpServerEntry, options?: {
+    localCommandConsent?: LocalCommandConsent;
+}): Promise<DoctorReport>;

package/dist/lib/install.d.ts

@@ -1,8 +1,12 @@
 import type { McpServerEntry } from "../types.js";
+import { type LocalCommandConsent } from "./local-command-consent.js";
 export type AgentTarget = "claude" | "codex" | "gemini";
 export interface InstallResult {
     agent: AgentTarget;
     success: boolean;
     error?: string;
 }
-export declare function installToAgents(entry: McpServerEntry, targets?: AgentTarget[]): InstallResult[];
+export interface InstallToAgentsOptions {
+    localCommandConsent?: LocalCommandConsent;
+}
+export declare function installToAgents(entry: McpServerEntry, targets?: AgentTarget[], options?: InstallToAgentsOptions): InstallResult[];

package/dist/lib/local-command-consent.d.ts

@@ -0,0 +1,38 @@
+import type { McpServerEntry } from "../types.js";
+export type LocalCommandOperation = "register" | "install" | "launch" | "diagnose";
+export type LocalCommandRiskSeverity = "warning" | "danger";
+export interface LocalCommandInput {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    transport?: McpServerEntry["transport"];
+    operation?: LocalCommandOperation;
+}
+export interface LocalCommandConsent {
+    approved?: boolean;
+    allowRisky?: boolean;
+    source?: string;
+}
+export interface LocalCommandRisk {
+    code: string;
+    severity: LocalCommandRiskSeverity;
+    message: string;
+    evidence?: string;
+}
+export interface LocalCommandReview {
+    requiresConsent: boolean;
+    operation: LocalCommandOperation;
+    command: string;
+    args: string[];
+    displayCommand: string;
+    envKeys: string[];
+    risks: LocalCommandRisk[];
+    hasDangerousRisk: boolean;
+}
+export declare class LocalCommandConsentError extends Error {
+    readonly review: LocalCommandReview;
+    constructor(message: string, review: LocalCommandReview);
+}
+export declare function inspectLocalCommand(input: LocalCommandInput): LocalCommandReview;
+export declare function formatLocalCommandReview(review: LocalCommandReview): string;
+export declare function assertLocalCommandConsent(input: LocalCommandInput, consent?: LocalCommandConsent): LocalCommandReview;

package/dist/lib/proxy.d.ts

@@ -1,5 +1,9 @@
+import { type LocalCommandConsent } from "./local-command-consent.js";
 import type { McpServerEntry, McpTool, ConnectedServer } from "../types.js";
-export declare function connectToServer(entry: McpServerEntry): Promise<ConnectedServer>;
+export interface ConnectOptions {
+    localCommandConsent?: LocalCommandConsent;
+}
+export declare function connectToServer(entry: McpServerEntry, options?: ConnectOptions): Promise<ConnectedServer>;
 export declare function disconnectServer(id: string): Promise<void>;
 export declare function disconnectAll(): Promise<void>;
 export declare function listAllTools(): McpTool[];
@@ -10,4 +14,4 @@ export declare function callTool(prefixedName: string, args: Record<string, unkn
     }>;
 }>;
 export declare function refreshTools(id: string): Promise<McpTool[]>;
-export declare function connectAllEnabled(): Promise<ConnectedServer[]>;
+export declare function connectAllEnabled(options?: ConnectOptions): Promise<ConnectedServer[]>;

package/dist/lib/registry.d.ts

@@ -1,13 +1,15 @@
-import type { McpServerEntry, AddServerOptions } from "../types.js";
+import type { CredentialReference, McpServerEntry, AddServerOptions } from "../types.js";
 export declare function addServer(opts: AddServerOptions): McpServerEntry;
 export declare function removeServer(id: string): void;
 export declare function listServers(): McpServerEntry[];
 export declare function getServer(id: string): McpServerEntry | null;
-export declare function updateServer(id: string, updates: Partial<Pick<McpServerEntry, "name" | "description" | "command" | "args" | "env" | "transport" | "url" | "enabled">>): McpServerEntry;
+export declare function updateServer(id: string, updates: Partial<Pick<McpServerEntry, "name" | "description" | "command" | "args" | "env" | "credentialRefs" | "transport" | "url" | "enabled">>): McpServerEntry;
 export declare function enableServer(id: string): McpServerEntry;
 export declare function disableServer(id: string): McpServerEntry;
 export declare function setServerEnv(id: string, key: string, value: string): void;
 export declare function unsetServerEnv(id: string, key: string): void;
+export declare function setServerCredentialRef(id: string, key: string, ref: CredentialReference): void;
+export declare function unsetServerCredentialRef(id: string, key: string): void;
 export declare function cacheTools(serverId: string, tools: Array<{
     name: string;
     description: string;

package/dist/lib/remote.d.ts

@@ -1,4 +1,7 @@
+import { type LocalCommandConsent } from "./local-command-consent.js";
 import type { RegistryServer, McpServerEntry } from "../types.js";
 export declare function searchRegistry(query: string): Promise<RegistryServer[]>;
 export declare function getRegistryServer(id: string): Promise<RegistryServer | null>;
-export declare function installFromRegistry(id: string): Promise<McpServerEntry>;
+export declare function installFromRegistry(id: string, options?: {
+    localCommandConsent?: LocalCommandConsent;
+}): Promise<McpServerEntry>;