@sema-agent/client-core 0.111.0 → 0.112.0

package/dist/localConfig/mcp/servers.d.ts

@@ -0,0 +1,165 @@
+import type { McpServerSpec } from '@sema-agent/sdk';
+import type { SettingsDocument } from '../../host.js';
+import type { LocalConfigFileReading } from '../kernel.js';
+import { type McpConfigDropReason } from '../../mcpWireCaps.js';
+import { type HostSettingsSource } from '../../hostSettingsSource.js';
+import type { UiLanguage } from '../../env/uiLanguage.js';
+export declare const MCP_SERVER_SCOPES: readonly ["user", "project", "local"];
+export type McpServerScope = (typeof MCP_SERVER_SCOPES)[number];
+export type McpServerFileReading = LocalConfigFileReading;
+export interface McpServerFilesReading {
+    readonly global?: McpServerFileReading;
+    readonly projectKey?: string;
+    readonly projectChain?: readonly McpServerFileReading[];
+    readonly enterprise?: McpServerFileReading;
+}
+export interface McpServerEnvFacts {
+    readonly values?: Readonly<Record<string, string | undefined>>;
+    readonly hostSecretNames?: readonly string[];
+}
+export interface McpServerHostFacts {
+    readonly permissionMode?: 'bypass' | 'other';
+    readonly nonInteractive?: boolean;
+    readonly sessionApproved?: readonly string[];
+    readonly reservedNames?: readonly string[];
+    readonly defaultOffNames?: readonly string[];
+    readonly deploymentNames?: readonly string[] | 'unknown';
+    readonly projectConfigRootSet?: boolean;
+    readonly env?: McpServerEnvFacts;
+}
+export type McpSupplementarySlot<T> = T | 'unreadable';
+type RawTable = Readonly<Record<string, unknown>>;
+export interface McpServerSupplementarySources {
+    readonly claudeai?: McpSupplementarySlot<RawTable>;
+    readonly plugin?: McpSupplementarySlot<RawTable>;
+    readonly agent?: McpSupplementarySlot<{
+        readonly fromFlagSettings: boolean;
+        readonly servers: RawTable;
+    }>;
+    readonly dynamic?: McpSupplementarySlot<RawTable>;
+    readonly strictDynamicOnly?: boolean;
+}
+export type McpServerRowScope = McpServerScope | 'managed' | 'enterprise' | 'claudeai' | 'plugin' | 'agent' | 'dynamic';
+export declare const MCP_SERVER_ROW_STATES: readonly ["active", "pending_approval", "rejected", "disabled", "withheld", "unusable"];
+export type McpServerRowState = (typeof MCP_SERVER_ROW_STATES)[number];
+export declare const MCP_SERVER_WITHHELD_CAUSES: readonly ["narrowing_conflict", "narrowing_invalid", "layer_unreadable", "policy_locked"];
+export type McpServerWithheldCause = (typeof MCP_SERVER_WITHHELD_CAUSES)[number];
+export type McpServerApprovedBy = 'settings' | 'session' | 'bypass' | 'non_interactive';
+export type McpServerSourceFile = 'global' | 'project' | 'enterprise' | 'managed' | 'supplementary';
+export interface McpServerProblem {
+    readonly reason: McpConfigDropReason | 'name_reserved';
+    readonly path?: string;
+    readonly notice: string;
+}
+export interface McpServerRow {
+    readonly name: string;
+    readonly scope: McpServerRowScope;
+    readonly entry: {} | null | undefined;
+    readonly shadows: readonly McpServerRowScope[];
+    readonly state: McpServerRowState;
+    readonly withheldBy?: McpServerWithheldCause;
+    readonly approvedBy?: McpServerApprovedBy;
+    readonly problems?: readonly McpServerProblem[];
+    readonly origin: {
+        readonly file: McpServerSourceFile;
+        readonly revision: string | null;
+    };
+    readonly writable: boolean;
+    readonly spec?: McpServerSpec;
+    readonly missing: readonly string[];
+    readonly withheldVars: readonly string[];
+}
+export type McpDeploymentRows = {
+    readonly state: 'unknown';
+} | {
+    readonly state: 'read';
+    readonly names: readonly string[];
+};
+export interface McpServersReport {
+    readonly rows: readonly McpServerRow[];
+    readonly unreadable: readonly McpServerSourceFile[];
+    readonly locked: 'enterprise_config' | 'plugin_only' | undefined;
+    readonly purpose: 'report' | 'load';
+    readonly approvalsWithheld: readonly {
+        readonly layer: 'projectSettings' | 'localSettings';
+        readonly cause: 'trust_withheld';
+    }[];
+    readonly deployment: McpDeploymentRows;
+    readonly pluginRoster: 'host_supplied' | 'absent';
+    readonly promptsAndResources: 'not_yet';
+}
+export declare function ownData(v: {} | null | undefined, key: string): {
+    readonly ok: true;
+    readonly value: {} | null | undefined;
+} | {
+    readonly ok: false;
+};
+export declare function stringListOf(v: {} | null | undefined): string[] | undefined;
+export type McpNameListReading = {
+    readonly kind: 'absent';
+} | {
+    readonly kind: 'list';
+    readonly list: readonly string[];
+} | {
+    readonly kind: 'bad';
+};
+export declare function nameListOf(holder: {} | null | undefined, key: string): McpNameListReading;
+export declare function subTableOf(doc: {} | null | undefined, path: readonly string[]): {
+    readonly kind: 'table';
+    readonly table: object;
+} | {
+    readonly kind: 'absent';
+} | {
+    readonly kind: 'bad';
+};
+export declare function documentOf(r: McpServerFileReading | undefined): SettingsDocument | undefined;
+export declare const localScopePath: (projectKey: string) => readonly string[];
+export declare const USER_SCOPE_PATH: readonly string[];
+export declare const PROJECT_FILE_PATH: readonly string[];
+export declare function mcpProjectChainOf(startDir: string, sep: '/' | '\\', fence?: string): readonly string[];
+export declare function mcpPathWithinFence(physicalPath: string, fence: string, sep: '/' | '\\'): boolean;
+export interface McpExpansion {
+    readonly entry: {} | null | undefined;
+    readonly missing: readonly string[];
+    readonly withheld: readonly string[];
+}
+export declare function expandMcpServerEntry(entry: {} | null | undefined, env: McpServerEnvFacts | undefined, target: 'plain' | 'remote'): McpExpansion;
+export declare function expansionTargetOf(entry: {} | null | undefined): 'plain' | 'remote';
+export interface JudgedEntry {
+    readonly name: string;
+    readonly raw: {} | null | undefined;
+    readonly spec: McpServerSpec | undefined;
+    readonly problems: readonly McpServerProblem[];
+    readonly missing: readonly string[];
+    readonly withheld: readonly string[];
+    readonly vote: {
+        readonly kind: 'absent';
+    } | {
+        readonly kind: 'list';
+        readonly list: readonly string[];
+    } | {
+        readonly kind: 'bad';
+    } | {
+        readonly kind: 'none';
+    };
+    readonly reserved: boolean;
+    readonly envSig?: string;
+}
+export interface JudgeTableOptions {
+    readonly expand: boolean;
+    readonly reserved: ReadonlySet<string>;
+    readonly lang?: UiLanguage | undefined;
+    readonly signature?: boolean;
+}
+export declare function judgeTable(table: {} | null | undefined, env: McpServerEnvFacts | undefined, opts: JudgeTableOptions): readonly JudgedEntry[] | undefined;
+export declare function fileReadingOf(holder: {} | null | undefined, key: string, missing: 'absent' | 'unreadable'): McpServerFileReading;
+export interface McpServersMergeInput {
+    readonly files: McpServerFilesReading;
+    readonly facts: McpServerHostFacts;
+    readonly settings: HostSettingsSource | 'none';
+    readonly supplementarySources?: McpServerSupplementarySources;
+    readonly lang?: UiLanguage;
+}
+export declare function mergeMcpServers(input: McpServersMergeInput, purpose: 'report' | 'load'): McpServersReport;
+export declare function mcpServersReport(files: McpServerFilesReading, facts: McpServerHostFacts, settings: HostSettingsSource | 'none', supplementarySources?: McpServerSupplementarySources, lang?: UiLanguage): McpServersReport;
+export {};