/**
 * AutoSnippet V3 MCP Server — 整合版
 *
 * Model Context Protocol (stdio transport)
 * 提供给 IDE AI Agent (Cursor/VSCode Copilot) 的工具集
 *
 * V3.3 整合：39 → 16 工具（14 agent + 2 admin）
 * 通过 ASD_MCP_TIER 环境变量控制可见工具集（agent/admin）
 *
 * 冷启动双路径:
 *   - 外部 Agent 路径: bootstrap (Mission Briefing) → dimension_complete × N → wiki(plan) → wiki(finalize)
 *   - 内部 Agent 路径: bootstrap.js bootstrapKnowledge() → orchestrator.js AI pipeline (Phase 5)
 *
 * Gateway 权限 gating: 写操作经过 Gateway 权限/宪法/审计检查（支持动态 resolver）
 *
 * 本文件仅包含服务编排层（初始化、路由、Gateway gating、生命周期）。
 * 工具定义 → tools.js
 * Handler 实现 → handlers/*.js
 * 整合路由 → handlers/consolidated.js
 */
import { McpServer as SdkMcpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { CapabilityProbe } from '#core/capability/CapabilityProbe.js';
import Logger from '#infra/logging/Logger.js';
import type { IntentState, McpContext, McpServiceContainer } from './handlers/types.js';
/** MCP session tracking (with intent lifecycle) */
interface McpSession {
    id: string;
    startedAt: number;
    toolCallCount: number;
    toolsUsed: Set<string>;
    lastActivityAt: number;
    intent: IntentState;
}
/** McpServer constructor options */
interface McpServerOptions {
    container?: McpServiceContainer | null;
    bootstrap?: BootstrapLike | null;
}
/** Bootstrap instance minimal shape */
interface BootstrapLike {
    initialize(): Promise<Record<string, unknown>>;
    shutdown(): Promise<void>;
}
/** Tool handler function (sync or async, compatible with wrapHandler) */
type ToolHandlerFn = (ctx: McpContext, args: Record<string, unknown>) => Promise<unknown> | unknown;
export declare class McpServer {
    container: McpServiceContainer | null;
    logger: ReturnType<typeof Logger.getInstance>;
    _autoApproveMarked: boolean;
    _capabilityProbe: CapabilityProbe | null;
    _lastTaskOperation: string;
    _session: McpSession;
    _startedAt: number;
    bootstrap: BootstrapLike | null;
    sdkServer: SdkMcpServer | null;
    constructor(options?: McpServerOptions);
    /** 共享上下文对象，传给所有 handler */
    get _ctx(): {
        container: McpServiceContainer | null;
        logger: import("winston").Logger;
        startedAt: number;
        session: McpSession;
    };
    initialize(): Promise<this>;
    /**
     * 注册 ListTools / CallTool 请求处理器
     * ListTools 基于 ASD_MCP_TIER 过滤可见工具
     */
    _registerHandlers(): void;
    _handleToolCall(name: string, args: Record<string, unknown>): Promise<unknown>;
    /**
     * Post-tool-call hook: update session stats + intent behavior tracking.
     * Always called (non-blocking, synchronous).
     *
     * - Session stats: toolCallCount, toolsUsed, lastActivityAt
     * - Intent tracking (when active): toolCalls, searchQueries, mentionedFiles, drift detection
     */
    _trackSession(toolName: string, result: unknown): void;
    /**
     * Inject active decisions + intent context into tool results.
     * Currently deferred — enable by uncommenting the call in _handleToolCall.
     */
    _injectDecisions(toolName: string, result: unknown): Promise<unknown>;
    private _detectDrift;
    private _computeKeywordOverlap;
    private _computeOverlap;
    private _extractSearchQuery;
    private _extractMentionedFiles;
    private _inferModule;
    /**
     * 解析工具名到 handler 函数（V3 整合版）
     */
    _resolveHandler(name: string): ToolHandlerFn | null;
    /**
     * 获取（或懒创建）CapabilityProbe 实例，用于探测子仓库写权限
     * 配置来自 constitution capabilities.git_write
     */
    _getCapabilityProbe(): CapabilityProbe;
    /**
     * Gateway 权限 gating — 写操作验证权限/宪法/审计
     * 只读工具直接跳过（不在 TOOL_GATEWAY_MAP 中）
     * 支持动态 resolver（operation-based 工具按参数解析 action/resource）
     *
     * actor 解析：使用 CapabilityProbe 探测本地用户的子仓库权限
     *   - admin  → 'developer'    全权限
     *   - contributor → 'contributor' 只读，写操作被拒绝
     *   - visitor → 'visitor'      最小权限
     * 探测失败时降级为 'external_agent'（向后兼容）
     */
    _gatewayGate(toolName: string, args: Record<string, unknown>): Promise<void>;
    start(): Promise<void>;
    shutdown(): Promise<void>;
}
export declare function startMcpServer(): Promise<McpServer>;
export default McpServer;