@autopilot-agent/cli 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# @autopilot-agent/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Autopilot 的终端宿主包。普通用户安装主包 `autopilot-agent@0.2.0`，无需分别安装各个 scoped 包：
+
+```bash
+npm install -g autopilot-agent@0.2.0
+ap --help
+```
+
+完整安装、Anthropic / Chat Completions 配置、使用和限制见 [主包手册](https://github.com/C-Clay-W/autopilot/blob/main/packages/autopilot-agent/README.md)，完整 argv / slash 语法见 [CLI 参考](https://github.com/C-Clay-W/autopilot/blob/main/agent/doc/CLI-Reference.md)。开发参考随源码更新，可能先于已发布版本的行为。
+
+## 结构与职责
+
+- parser.ts 解析 argv 与交互命令，main.ts 编排入口、输出及退出。
+- composition-root.ts 注入共享 Core Runtime 与 Node Adapters，controller.ts 管理任务、审批与恢复。
+- tui/ 使用 React / Ink；renderer.ts 与 event-projector.ts 支持纯文本和 JSONL。
+- 内部依赖为 Core、Adapters、Presentation，0.2.0 使用匹配的精确版本。
+
+本包的 bin 提供 ap/autopilot，主入口包再转发至本包的 dist/main.js，不复制 Runtime。TTY 使用交互界面；显式 --output text/jsonl 用于脚本，JSONL 不输出 ANSI 或交互提示。
+
+## 编程入口
+
+包根导出 parseArgv、parseSlashAction、renderHelp、createCliCompositionRoot、createCliController、main、事件投影和 TUI 相关类型。优先把它作为终端应用使用；自行嵌入时需要处理输入输出、Trust、审批和退出清理，不在模块导入时自动启动任务。
+
+```typescript
+import { parseArgv, renderHelp } from "@autopilot-agent/cli";
+
+const parsed = parseArgv(["chat", "解释项目结构", "--output", "text"]);
+console.log(parsed);
+console.log(renderHelp());
+```
+
+## 源码开发
+
+从 monorepo 根安装依赖，依次构建 Core、Adapters、Presentation，再执行：
+
+```bash
+npm run build -w apps/cli
+node apps/cli/dist/main.js --help
+npm run test -w apps/cli -- test/parser.test.ts
+```
+
+build 使用 TypeScript，输出 dist/*.js 与声明，不在 npm 包中发布源码映射和测试。当前 Node 声明为 >=20.11.0 <22；建议整仓构建使用 Node 20.20.2。
+
+CLI 使用用户级 settings.json，默认工作区为当前目录，可显式指定 --workspace-root。CLI 不读取开发仓库 Web env，也不因配置中含 RAG 字段而自动启用私有知识库工具。重要项目保留版本控制，OS 沙箱、MCP 和平台限制见主包手册。
+
+## 0.2.0 版本
+
+本包随 npm 0.2.0 发布，内部依赖使用匹配的精确版本。Windows 命令、后台 Job 与 host MCP 逐次审批后以当前用户权限直接执行，审批不提供 OS 隔离；macOS 继续使用 Seatbelt。实机与进程树生命周期仍需按实际验证确认。
+
+## 许可证
+
+公开源码采用 [MIT 许可证](https://github.com/C-Clay-W/autopilot/blob/main/LICENSE)。第三方依赖保留各自许可证。

package/dist/activity-animation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * CLI TUI 活动状态与离散动画。
+ *
+ * 状态由安全事件类型归约得到，动画只消费显式状态和共享时钟；稳定文案始终
+ * 可见。活动 glyph 采用 Claude Code 的单字符 ping-pong 形式，不把状态包装成
+ * 调试风格的进度条。
+ */
+import { type ReactNode } from "react";
+import type { CliTurnStatus } from "./types.js";
+import type { TuiAnimationClock } from "./animation-clock.js";
+export type CliActivityPhase = "requesting" | "thinking" | "waiting" | "transition" | "responding" | "stalled" | "terminal";
+export interface CliActivityState {
+    phase: CliActivityPhase;
+    lastProgressAt: number;
+    transitionStartedAt?: number;
+    hasActiveTool: boolean;
+    stallable: boolean;
+}
+export interface CliActivityView {
+    phase: CliActivityPhase;
+    label: string;
+    frame: string;
+}
+interface CliActivityEventLike {
+    type: string;
+}
+export declare const CLI_ACTIVITY_STALLED_AFTER_MS = 20000;
+export declare const CLI_ACTIVITY_TRANSITION_MS = 2000;
+/** 与 CC SpinnerGlyph 一致，glyph 每 120ms 前进一格；共享时钟仍可用 50ms tick。 */
+export declare const CLI_ACTIVITY_SPINNER_FRAME_MS = 120;
+/** 创建一个等待 Provider 首个事件的初始活动状态。 */
+export declare function createInitialCliActivityState(now: number): CliActivityState;
+/** 按安全事件类型归约活动状态，不读取事件文案或模型原始输出。 */
+export declare function reduceCliActivityState(previous: CliActivityState, event: CliActivityEventLike, now: number): CliActivityState;
+/** 把投影终态映射为不会继续驱动动画的活动状态。 */
+export declare function settleCliActivityState(previous: CliActivityState, status: CliTurnStatus, now: number): CliActivityState;
+/** 返回指定活动阶段对应的单 glyph 帧；外层 Box 负责固定占位宽度。 */
+export declare function getCliActivityFrame(phase: CliActivityPhase, now: number): string;
+/** 根据当前时间解析过场、stalled 和审批等待，形成最终可见活动状态。 */
+export declare function resolveCliActivityView(input: {
+    activity: CliActivityState;
+    status: CliTurnStatus;
+    now: number;
+    waitingForApproval?: boolean;
+}): CliActivityView | undefined;
+/** 渲染稳定活动文案和可选的固定宽度离散帧。 */
+export declare function TuiActivityLine(props: {
+    activity: CliActivityState;
+    status: CliTurnStatus;
+    waitingForApproval: boolean;
+    useColor: boolean;
+    screenReader: boolean;
+    reducedMotion: boolean;
+    animationActive: boolean;
+    clock: TuiAnimationClock;
+    startedAt?: number;
+    activeForm?: string;
+}): ReactNode;
+export {};

package/dist/activity-animation.js

@@ -0,0 +1,148 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * CLI TUI 活动状态与离散动画。
+ *
+ * 状态由安全事件类型归约得到，动画只消费显式状态和共享时钟；稳定文案始终
+ * 可见。活动 glyph 采用 Claude Code 的单字符 ping-pong 形式，不把状态包装成
+ * 调试风格的进度条。
+ */
+import { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import { formatTuiDuration } from "./tui/format.js";
+export const CLI_ACTIVITY_STALLED_AFTER_MS = 20_000;
+export const CLI_ACTIVITY_TRANSITION_MS = 2_000;
+/** CC v2.1.88 的默认 spinner glyph；首尾重复保证 ping-pong 转向自然。 */
+const CLI_ACTIVITY_SPINNER_FRAMES = ["·", "✢", "*", "✶", "✻", "✽", "✽", "✻", "✶", "*", "✢", "·"];
+/** 与 CC SpinnerGlyph 一致，glyph 每 120ms 前进一格；共享时钟仍可用 50ms tick。 */
+export const CLI_ACTIVITY_SPINNER_FRAME_MS = 120;
+/** 创建一个等待 Provider 首个事件的初始活动状态。 */
+export function createInitialCliActivityState(now) {
+    return {
+        phase: "requesting",
+        lastProgressAt: now,
+        hasActiveTool: false,
+        stallable: true,
+    };
+}
+/** 将活动状态推进到指定稳定阶段，并记录本次可观察进展时间。 */
+function advanceCliActivityState(previous, phase, now, options = {}) {
+    return {
+        ...previous,
+        phase,
+        lastProgressAt: now,
+        hasActiveTool: options.hasActiveTool ?? previous.hasActiveTool,
+        stallable: options.stallable ?? previous.stallable,
+        transitionStartedAt: options.transitionStartedAt,
+    };
+}
+/** 按安全事件类型归约活动状态，不读取事件文案或模型原始输出。 */
+export function reduceCliActivityState(previous, event, now) {
+    switch (event.type) {
+        case "turn_started":
+            return createInitialCliActivityState(now);
+        case "reasoning_summary":
+        case "reasoning_hidden":
+        case "model_recovery":
+        case "context_overflow":
+        case "context_compact_started":
+        case "context_compacted":
+            return advanceCliActivityState(previous, "thinking", now, { hasActiveTool: false, stallable: true });
+        case "tool_started":
+            return advanceCliActivityState(previous, "transition", now, { hasActiveTool: true, stallable: false, transitionStartedAt: now });
+        case "tool_result":
+            return advanceCliActivityState(previous, "transition", now, { hasActiveTool: false, stallable: true, transitionStartedAt: now });
+        case "approval_required":
+            return advanceCliActivityState(previous, "waiting", now, { hasActiveTool: false, stallable: false });
+        case "answer_delta":
+            return advanceCliActivityState(previous, "responding", now, { hasActiveTool: false, stallable: true });
+        case "status":
+            return previous;
+        default:
+            return previous;
+    }
+}
+/** 把投影终态映射为不会继续驱动动画的活动状态。 */
+export function settleCliActivityState(previous, status, now) {
+    if (status === "idle" || status === "running" || status === "waiting_approval")
+        return previous;
+    return advanceCliActivityState(previous, "terminal", now, { hasActiveTool: false, stallable: false });
+}
+/** 返回指定活动阶段对应的单 glyph 帧；外层 Box 负责固定占位宽度。 */
+export function getCliActivityFrame(phase, now) {
+    if (phase === "terminal")
+        return "";
+    return CLI_ACTIVITY_SPINNER_FRAMES[Math.floor(Math.max(0, now) / CLI_ACTIVITY_SPINNER_FRAME_MS) % CLI_ACTIVITY_SPINNER_FRAMES.length] ?? "·";
+}
+function formatCliActivityElapsed(durationMs) {
+    const totalSeconds = Math.max(1, Math.floor(Math.max(0, durationMs) / 1_000));
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (minutes < 60)
+        return `${minutes}m ${String(seconds).padStart(2, "0")}s`;
+    return `${Math.floor(minutes / 60)}h ${String(minutes % 60).padStart(2, "0")}m ${String(seconds).padStart(2, "0")}s`;
+}
+/** 返回活动阶段的稳定文案，供动画降级和 screen reader 使用。 */
+function getCliActivityLabel(phase, input = {}) {
+    switch (phase) {
+        case "requesting": return "Preparing · waiting for first event";
+        case "thinking": return "Thinking · planning next step";
+        case "waiting": return input.hasActiveTool ? "Waiting · tool result" : "Waiting · provider response";
+        case "transition": return "Running action · starting tool";
+        case "responding": return "Answering · receiving output";
+        case "stalled": return `Still working · no new event for ${formatCliActivityElapsed(input.idleForMs ?? 0)}`;
+        case "terminal": return "Completed";
+    }
+}
+/** 根据当前时间解析过场、stalled 和审批等待，形成最终可见活动状态。 */
+export function resolveCliActivityView(input) {
+    const { activity, status, now } = input;
+    if (status === "idle")
+        return undefined;
+    if (status !== "running" && status !== "waiting_approval")
+        return { phase: "terminal", label: status, frame: "" };
+    if (input.waitingForApproval || status === "waiting_approval") {
+        return { phase: "waiting", label: "Waiting for approval", frame: getCliActivityFrame("waiting", now) };
+    }
+    let phase = activity.phase;
+    if (phase === "transition" && activity.transitionStartedAt !== undefined && now - activity.transitionStartedAt >= CLI_ACTIVITY_TRANSITION_MS) {
+        phase = activity.hasActiveTool ? "waiting" : "thinking";
+    }
+    if (activity.hasActiveTool && phase !== "transition")
+        phase = "waiting";
+    if (activity.stallable && !activity.hasActiveTool && phase !== "waiting" && now - activity.lastProgressAt >= CLI_ACTIVITY_STALLED_AFTER_MS) {
+        phase = "stalled";
+    }
+    return {
+        phase,
+        label: getCliActivityLabel(phase, { idleForMs: Math.max(0, now - activity.lastProgressAt), hasActiveTool: activity.hasActiveTool }),
+        frame: getCliActivityFrame(phase, now),
+    };
+}
+/** 渲染稳定活动文案和可选的固定宽度离散帧。 */
+export function TuiActivityLine(props) {
+    const [clockTime, setClockTime] = useState(props.clock.now());
+    const view = resolveCliActivityView({ activity: props.activity, status: props.status, now: clockTime, waitingForApproval: props.waitingForApproval });
+    const shouldAnimate = props.animationActive && !props.screenReader && !props.reducedMotion && view !== undefined && view.phase !== "terminal";
+    const shouldTick = shouldAnimate || (props.startedAt !== undefined && (props.status === "running" || props.status === "waiting_approval"));
+    useEffect(function subscribeActivityClock() {
+        props.clock.setActive(shouldTick);
+        if (!shouldTick) {
+            setClockTime(props.clock.now());
+            return;
+        }
+        setClockTime(props.clock.now());
+        return props.clock.subscribe(function updateActivityClock(time) {
+            // 禁动画仍按秒刷新累计时间，复用同一枚时钟。
+            setClockTime(function next(previous) { return shouldAnimate || Math.floor(previous / 1000) !== Math.floor(time / 1000) ? time : previous; });
+        });
+    }, [props.clock, shouldAnimate, shouldTick]);
+    if (!view)
+        return null;
+    if (view.phase === "terminal")
+        return null;
+    const frame = shouldAnimate ? view.frame : "·";
+    const isStalled = view.phase === "stalled";
+    return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsx(Text, { bold: isStalled, color: props.useColor ? "ansi256(208)" : undefined, children: frame }) }), _jsxs(Text, { bold: isStalled, dimColor: props.useColor && !isStalled, children: [props.activeForm ?? view.label, props.startedAt !== undefined ? ` · ${formatTuiDuration(Math.max(0, clockTime - props.startedAt))}` : ""] })] }));
+}

package/dist/animation-clock.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI TUI 共享动画时钟。
+ *
+ * 时钟只负责向订阅者发出当前时间，不持有任何业务状态；终端活动区不可见、
+ * screen reader、reduced-motion 或终态时可以停止订阅，测试也可以注入时间和调度器。
+ */
+export interface TuiAnimationClock {
+    now(): number;
+    subscribe(listener: (time: number) => void): () => void;
+    setActive(active: boolean): void;
+    tick(): void;
+    dispose(): void;
+}
+/** 共享时钟可注入的调度器配置，避免动画单测依赖真实 setInterval。 */
+export interface TuiAnimationClockOptions {
+    now?: () => number;
+    frameMs?: number;
+    schedule?: (listener: () => void, frameMs: number) => unknown;
+    cancel?: (handle: unknown) => void;
+}
+/** 创建可暂停、可注入且只在有订阅者时运行的 TUI 时钟。 */
+export declare function createTuiAnimationClock(options?: TuiAnimationClockOptions): TuiAnimationClock;

package/dist/animation-clock.js

@@ -0,0 +1,76 @@
+/**
+ * CLI TUI 共享动画时钟。
+ *
+ * 时钟只负责向订阅者发出当前时间，不持有任何业务状态；终端活动区不可见、
+ * screen reader、reduced-motion 或终态时可以停止订阅，测试也可以注入时间和调度器。
+ */
+/** 使用 Node 默认定时器启动一枚共享时钟任务。 */
+function scheduleDefaultTimer(listener, frameMs) {
+    return setInterval(listener, frameMs);
+}
+/** 清理由 Node 默认定时器创建的共享时钟任务。 */
+function cancelDefaultTimer(handle) {
+    clearInterval(handle);
+}
+/** 创建可暂停、可注入且只在有订阅者时运行的 TUI 时钟。 */
+export function createTuiAnimationClock(options = {}) {
+    const now = options.now ?? function readCurrentTime() { return Date.now(); };
+    const frameMs = Math.max(16, options.frameMs ?? 50);
+    const schedule = options.schedule ?? scheduleDefaultTimer;
+    const cancel = options.cancel ?? cancelDefaultTimer;
+    const listeners = new Set();
+    let timer;
+    let active = true;
+    let disposed = false;
+    /** 停止当前定时器，确保没有订阅者或时钟暂停时不继续唤醒进程。 */
+    function stopTimer() {
+        if (timer === undefined)
+            return;
+        cancel(timer);
+        timer = undefined;
+    }
+    /** 根据订阅者和 active 状态启动唯一的共享定时器。 */
+    function ensureTimer() {
+        if (disposed || !active || listeners.size === 0 || timer !== undefined)
+            return;
+        timer = schedule(function emitScheduledTick() { clock.tick(); }, frameMs);
+    }
+    const clock = {
+        now,
+        subscribe(listener) {
+            if (disposed)
+                return function ignoreDisposedSubscription() { };
+            listeners.add(listener);
+            ensureTimer();
+            return function unsubscribe() {
+                listeners.delete(listener);
+                if (listeners.size === 0)
+                    stopTimer();
+            };
+        },
+        setActive(nextActive) {
+            if (disposed || active === nextActive)
+                return;
+            active = nextActive;
+            if (!active)
+                stopTimer();
+            else
+                ensureTimer();
+        },
+        tick() {
+            if (disposed || !active)
+                return;
+            const time = now();
+            for (const listener of [...listeners])
+                listener(time);
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            stopTimer();
+            listeners.clear();
+        },
+    };
+    return clock;
+}

package/dist/composition-root.d.ts

@@ -0,0 +1,105 @@
+/**
+ * CLI Composition Root。
+ *
+ * 负责选择 Core 默认 Runtime、共享 Node Adapter、canonical workspaceRoot、
+ * trust policy 和显式 stateRoot；不负责命令解析、事件投影或 Runtime 状态机。
+ */
+import { type AgentRuntime, type CapabilityLoader, type CreateRuntimeBootstrapServiceOptions, type RuntimeBootstrapService, type SafeBootstrapConfig, type SandboxCapabilityReport, type WorkspaceTrustEntry, type WorkspaceTrustPolicy } from "@autopilot-agent/core";
+import type { CliRuntimeStatusDefaults, CliSkillSummary } from "./types.js";
+import { type WorkspaceRegistryEntry, type NodeCapabilityLoader, type NodeSettingsLoader } from "@autopilot-agent/adapters";
+import type { AutopilotSettingsScope } from "@autopilot-agent/core";
+/** Doctor 单项结果；只含状态和脱敏摘要，绝不包含路径、凭据或 Provider 正文。 */
+export interface CliDoctorCheck {
+    name: string;
+    status: "PASS" | "WARN" | "FAIL" | "SKIP";
+    detail: string;
+}
+/** CLI Composition Root 的装配选项。 */
+export interface CreateCliCompositionRootOptions {
+    config?: SafeBootstrapConfig;
+    stateRoot?: string;
+    trustRoot?: string;
+    workspaceRoot?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    trustPolicy?: WorkspaceTrustPolicy;
+    capabilityLoader?: CliCapabilityLoader;
+    defaultRunConfig?: CreateRuntimeBootstrapServiceOptions["defaultRunConfig"];
+    /** 已信任 settings Loader 的测试 seam；生产默认创建 Node Loader。 */
+    settingsLoader?: NodeSettingsLoader;
+    /** Doctor 连通性探测的测试 seam；生产默认使用全局 fetch。 */
+    connectivityFetch?: typeof fetch;
+    /** Web Search 请求的 fake HTTP 测试 seam；生产默认使用平台原生 fetch。 */
+    webSearchFetch?: typeof fetch;
+}
+/** CLI 能力加载器：沿用 Node 的开发能力，但禁止 RAG loader 进入 CLI 装配边界。 */
+export type CliCapabilityLoader = CapabilityLoader & Partial<Pick<NodeCapabilityLoader, "probeWebSearchConnectivity">>;
+/** CLI Composition Root 对外暴露的启动边界。 */
+export interface CliCompositionRoot {
+    readonly stateRoot: string;
+    /** 仅由已解析的业务命令调用，保障当前用户配置根存在且安全。 */
+    ensureUserConfigDirectory(): void;
+    /** Trust 成功后创建当前项目的 .autopilot 与临时文件目录，不生成 settings 文件。 */
+    ensureProjectAutopilotDirectory(workspaceRoot: string): void;
+    establishTrust(): Promise<{
+        workspaceRoot: string;
+        trustEntry: WorkspaceTrustEntry;
+    }>;
+    /** Trust 前解析 canonical 工作区并读取信任状态；未信任时返回记录而不抛 WorkspaceTrustError。 */
+    resolveTrust(): Promise<{
+        workspaceRoot: string;
+        trustEntry: WorkspaceTrustEntry;
+    }>;
+    /** 授予精确 canonical 工作区信任并返回持久化后的记录。 */
+    grantTrust(workspaceRoot: string): Promise<WorkspaceTrustEntry>;
+    /** 读取指定工作区的当前信任状态。 */
+    getTrustStatus(workspaceRoot: string): Promise<WorkspaceTrustEntry>;
+    /** 撤销当前 canonical workspace 的 Trust；调用后不得继续创建 Runtime。 */
+    revokeTrust(workspaceRoot: string): Promise<WorkspaceTrustEntry>;
+    /** 读取宿主级工作区索引；不会扫描磁盘或创建状态根。 */
+    listWorkspaceRegistry(): WorkspaceRegistryEntry[];
+    /** 仅注销 Registry 索引条目，不删除任何工作区数据。 */
+    removeWorkspaceRegistry(workspaceId: string): boolean;
+    /** 读取显式 scope 的脱敏 settings。 */
+    showConfig(scope: AutopilotSettingsScope, workspaceRoot: string): Record<string, unknown>;
+    /** 读取显式 scope 下允许公开的单个 settings 值。 */
+    getConfig(scope: AutopilotSettingsScope, key: string, workspaceRoot: string): unknown;
+    /** 写入显式 scope 下允许公开的单个 settings 值。 */
+    setConfig(scope: AutopilotSettingsScope, key: string, value: string, workspaceRoot: string): Record<string, unknown>;
+    /** 执行默认离线或显式受限连通性 Doctor 检查。 */
+    doctor(workspaceRoot: string, connectivity: boolean): Promise<CliDoctorCheck[]>;
+    /** 读取当前平台沙箱能力报告（脱敏）；绑定传入的 canonical workspace。 */
+    sandboxStatus(workspaceRoot: string): Promise<SandboxCapabilityReport>;
+    /** 显式触发沙箱 setup（Windows UAC 安装；macOS 仅返回当前能力报告）。 */
+    sandboxSetup(workspaceRoot: string): Promise<SandboxCapabilityReport>;
+    createRuntime(workspaceRoot: string): Promise<AgentRuntime>;
+    bootstrap(): Promise<AgentRuntime>;
+    getBootstrapService(): RuntimeBootstrapService;
+    /** 只向 Controller 暴露可安全显示的已热更新 settings 默认值。 */
+    getRuntimeStatusDefaults(): CliRuntimeStatusDefaults;
+    /** 返回不含凭据的首次运行配置诊断；undefined 表示可继续启动。 */
+    getStartupConfigurationError(): string | undefined;
+    listSkills(): Promise<CliSkillSummary[]>;
+    resolveSkill(skill: string): Promise<{
+        skillId: string;
+        contentHash: string;
+    }>;
+    /** 返回不含环境变量的 MCP server 审批摘要与执行隔离事实。 */
+    listMcp(workspaceRoot: string): Promise<Array<{
+        serverName: string;
+        program: string;
+        args: string[];
+        cwd: string;
+        approved: boolean;
+        executionMode: "sandbox" | "host";
+        isolation: "sandboxed" | "unisolated";
+    }>>;
+    /** 保存精确 configHash 绑定的 workspace grant；调用方必须已完成 CLI 确认。 */
+    approveMcp(workspaceRoot: string, serverName: string): Promise<{
+        serverName: string;
+    }>;
+    /** 删除 server 当前 configHash 对应的 workspace grant。 */
+    revokeMcp(workspaceRoot: string, serverName: string): Promise<boolean>;
+}
+/** 创建 CLI Composition Root；只有 Runtime bootstrap 的 trust 成功阶段才初始化状态 manifest。 */
+export declare function createCliCompositionRoot(options?: CreateCliCompositionRootOptions): CliCompositionRoot;