@sema-agent/client-core 0.111.0 → 0.112.0

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

@@ -0,0 +1,161 @@
+import type { McpServerSpec } from '@sema-agent/sdk';
+import type { SettingsDocument } from '../../host.js';
+import type { SampledRecord } from '../../ownKey.js';
+import { type LocalConfigHostFacts, type LocalConfigPreview, type LocalConfigReceipt, type LocalConfigRefusal, type LocalConfigStorePort, type LocalConfigUnavailableCause } from '../kernel.js';
+import { type McpServerNameUnusableReason } from '../../mcpWireCaps.js';
+import { type HostSettingsSource } from '../../hostSettingsSource.js';
+import type { UiLanguage } from '../../env/uiLanguage.js';
+import { type McpServerFileReading, type McpServerHostFacts, type McpServerProblem, type McpServerRowScope, type McpServerScope } from './servers.js';
+export interface McpSecretMapEdit {
+    readonly set?: Readonly<Record<string, string>>;
+    readonly delete?: readonly string[];
+}
+export interface McpSecretKeep {
+    readonly base: string;
+    readonly members: readonly string[];
+}
+export type McpServerEdit = {
+    readonly op: 'add';
+    readonly name: string;
+    readonly entry: SampledRecord;
+    readonly scope: McpServerScope;
+    readonly onNameTaken?: 'refuse' | 'replace' | 'rename';
+} | {
+    readonly op: 'update';
+    readonly name: string;
+    readonly scope: McpServerScope;
+    readonly base: string;
+    readonly set?: SampledRecord;
+    readonly unset?: readonly string[];
+    readonly env?: McpSecretMapEdit;
+    readonly headers?: McpSecretMapEdit;
+    readonly keep?: McpSecretKeep;
+} | {
+    readonly op: 'remove';
+    readonly name: string;
+    readonly scope?: McpServerScope;
+} | {
+    readonly op: 'setEnabled';
+    readonly name: string;
+    readonly enabled: boolean;
+} | {
+    readonly op: 'setProjectApproval';
+    readonly name: string;
+    readonly approval: 'approve' | 'reject' | 'clear';
+} | {
+    readonly op: 'importFromSibling';
+    readonly entries: Readonly<Record<string, SampledRecord>>;
+    readonly scope: McpServerScope;
+};
+export declare const MCP_SERVER_EDIT_OPS: readonly ["add", "update", "remove", "setEnabled", "setProjectApproval", "importFromSibling"];
+export type McpServerEditOp = (typeof MCP_SERVER_EDIT_OPS)[number];
+export interface McpServerEditContext {
+    readonly lane: LocalConfigHostFacts;
+    readonly host?: McpServerHostFacts;
+    readonly projectKey?: string;
+    readonly enterprise?: McpServerFileReading;
+    readonly settings?: HostSettingsSource | 'none';
+    readonly lang?: UiLanguage;
+}
+export type McpServerRefusalDetail = {
+    readonly refusal: 'edit_malformed';
+    readonly path: string | null;
+} | {
+    readonly refusal: 'name_unusable';
+    readonly nameReason: McpServerNameUnusableReason;
+} | {
+    readonly refusal: 'name_reserved';
+    readonly by: 'package' | 'host';
+} | {
+    readonly refusal: 'mcp_entry_invalid';
+    readonly problems: readonly McpServerProblem[];
+} | {
+    readonly refusal: 'name_taken';
+    readonly scope: McpServerScope;
+    readonly exhausted: boolean;
+} | {
+    readonly refusal: 'not_found';
+} | {
+    readonly refusal: 'ambiguous_scope';
+    readonly scopes: readonly McpServerScope[];
+} | {
+    readonly refusal: 'scope_not_offered';
+    readonly scope: McpServerScope;
+    readonly why: 'project_config_root' | 'no_project_key' | 'layer_not_admitted';
+} | {
+    readonly refusal: 'scope_unreadable';
+} | {
+    readonly refusal: 'policy_locked';
+    readonly by: 'enterprise_config' | 'plugin_only';
+} | {
+    readonly refusal: 'base_conflict';
+} | {
+    readonly refusal: 'credentials_need_reentry';
+    readonly env: readonly string[];
+    readonly headers: readonly string[];
+    readonly args: readonly number[];
+} | {
+    readonly refusal: 'untrusted_folder';
+};
+export type McpServerRefusalWord = McpServerRefusalDetail['refusal'];
+export declare const refusalReasonOf: (w: McpServerRefusalWord) => LocalConfigRefusal;
+export interface McpServerEditPlan {
+    readonly op: McpServerEditOp;
+    readonly name: string;
+    readonly scope?: McpServerScope;
+    readonly renamedFrom?: string;
+    readonly replaced?: true;
+    readonly imported?: readonly {
+        readonly name: string;
+        readonly renamedFrom?: string;
+    }[];
+    readonly skipped?: readonly {
+        readonly name: string;
+        readonly reason: McpServerRefusalWord;
+    }[];
+}
+export type McpServerEditNotice = {
+    readonly kind: 'shadowed_by';
+    readonly scope: McpServerRowScope;
+} | {
+    readonly kind: 'endpoint_differs';
+    readonly scope: McpServerRowScope;
+} | {
+    readonly kind: 'deployment_wins';
+} | {
+    readonly kind: 'env_missing';
+    readonly names: readonly string[];
+};
+export type McpServerProbeTarget = {
+    readonly kind: 'spec';
+    readonly spec: McpServerSpec;
+} | {
+    readonly kind: 'none';
+    readonly why: 'removed' | 'not_active' | 'env_missing' | 'edit_refused';
+};
+export interface McpServerEditOutcome {
+    readonly receipt: LocalConfigReceipt | LocalConfigPreview;
+    readonly refusal?: McpServerRefusalDetail;
+    readonly plan?: McpServerEditPlan;
+    readonly notices: readonly McpServerEditNotice[];
+    readonly probe?: McpServerProbeTarget;
+}
+export declare function withPath(doc: {} | null | undefined, path: readonly string[], value: {} | null | undefined): SettingsDocument | undefined;
+export declare const mcpRowBaseOf: (revision: string | null) => string | null;
+export declare function shapeMcpServerEdit(v: {} | null | undefined): {
+    readonly ok: true;
+    readonly edit: McpServerEdit;
+} | {
+    readonly ok: false;
+    readonly path: string | null;
+};
+export declare function applyMcpServerEdit(edit: McpServerEdit, store: LocalConfigStorePort, ctx: McpServerEditContext, opts?: {
+    readonly dryRun?: true;
+}): Promise<McpServerEditOutcome>;
+export type McpServerProbeTargetReading = {
+    readonly kind: 'unavailable';
+    readonly cause: LocalConfigUnavailableCause;
+} | {
+    readonly kind: 'refused';
+} | McpServerProbeTarget;
+export declare function mcpServerProbeTargetOf(edit: McpServerEdit, store: LocalConfigStorePort, ctx: McpServerEditContext): Promise<McpServerProbeTargetReading>;