@alpsckr/unitycli 0.4.0

package/dist/tools/code/exec.js

@@ -0,0 +1,59 @@
+import { executeRuntimeCode } from "../../runtime-code.js";
+import { defineTool } from "../define.js";
+/** 读取命令层 instance flag；它不进入 code.exec 业务 Request。 */
+function instanceFlag(context) {
+    const value = context.flags?.instance;
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+const returnValueExample = {
+    code: "return UnityEngine.SceneManagement.SceneManager.GetActiveScene().rootCount;",
+};
+const moveProbeExample = {
+    code: "var go = GameObject.Find(\"ProbeTarget\"); go.transform.position = new Vector3(1f, go.transform.position.y, go.transform.position.z); return null;",
+    completionProbe: {
+        readTool: "scene.gameobject",
+        input: { target: "ProbeTarget", includeComponents: false },
+        assertions: [{ path: "/gameObject/transform/position/x", operator: "approx", before: 0, after: 1, tolerance: 0.0001 }],
+    },
+};
+/** 仅在已打开 Editor 中执行一次可信 C# Runtime Code。 */
+async function runCodeExec(request, context) {
+    return executeRuntimeCode({
+        ...request,
+        args: request.args,
+        timeoutMs: context.execution.timeoutMs,
+        absoluteDeadlineMs: context.absoluteDeadlineMs,
+        dryRun: context.execution.dryRun,
+        instance: instanceFlag(context),
+    }, {
+        dataDir: context.dataDir ?? context.projectPath,
+        rootAdmission: context.rootAdmission,
+        bridgeExecute: context.bridgeExecute,
+    }, context.requestId);
+}
+export default defineTool({
+    name: "code.exec",
+    summary: "Execute trusted synchronous C# in the live Editor; started code cannot be force-stopped by timeout.",
+    description: "Synchronously compile and execute trusted C# 8 on Unity's main thread. Submit code, file, or stdin; snippets become Run(string argsJson) bodies and must return, while complete Run methods compile as-is. Returns diagnostics, streams/value, and optional completion readback; completionProbe is optional and only asserts declared Editor state. The Tool has no capability reduction and does not reject infinite loops, long sleeps, blocking waits, lock contention, process/network/file work, or long Unity API calls. Prefer a bounded alternative when possible; necessary code executes unchanged. Timeout stops only CLI waiting and cannot interrupt Run. State may be partial or outcome-unknown, not proof execution stopped; inspect before retrying. Recovery may require terminating the Editor. External command hosts must wait for this CLI process to exit and allow at least 5000ms beyond --timeout-ms. Dry-run reports source hash and planned effects only; it neither compiles nor executes or proves termination.",
+    group: "code",
+    destructiveHint: true,
+    supportsDryRun: true,
+    sideEffects: ["user-code-execution", "scene-modify", "asset-modify", "session-affecting"],
+    playModeSupport: "session-affecting",
+    permissions: ["execute-user-code", "unity-editor-api"],
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    target: "editor",
+    timeoutMs: 60_000,
+    examples: [{
+            description: "Execute C# and return a value (no completion probe needed).",
+            argv: ["tools", "run", "code.exec", "--input", JSON.stringify(returnValueExample)],
+            input: returnValueExample,
+        }, {
+            description: "Move a controlled scene object and prove its X position.",
+            argv: ["tools", "run", "code.exec", "--input", JSON.stringify(moveProbeExample)],
+            input: moveProbeExample,
+        }],
+    async execute(request, context) { return runCodeExec(request, context); },
+});
+//# sourceMappingURL=exec.js.map

package/dist/tools/code/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/tools/code/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAyB5D,qDAAqD;AACrD,SAAS,YAAY,CAAC,OAAoB;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,MAAM,kBAAkB,GAAoB;IAC1C,IAAI,EAAE,6EAA6E;CACpF,CAAC;AAEF,MAAM,gBAAgB,GAAoB;IACxC,IAAI,EAAE,oJAAoJ;IAC1J,eAAe,EAAE;QACf,QAAQ,EAAE,kBAAkB;QAC5B,KAAK,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,EAAE;QAC1D,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;KACvH;CACF,CAAC;AAEF,4CAA4C;AAC5C,KAAK,UAAU,WAAW,CAAC,OAAwB,EAAE,OAAoB;IACvE,OAAO,kBAAkB,CAAC;QACxB,GAAG,OAAO;QACV,IAAI,EAAE,OAAO,CAAC,IAA2C;QACzD,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS;QACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;QAChC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC;KAChC,EAAE;QACD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW;QAC/C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,EAAE,OAAO,CAAC,SAAS,CAA8D,CAAC;AACrF,CAAC;AAED,eAAe,UAAU,CAAyD;IAChF,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,qGAAqG;IAC9G,WAAW,EAAE,g/BAAg/B;IAC7/B,KAAK,EAAE,MAAM;IACb,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,CAAC,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,CAAC;IACzF,eAAe,EAAE,mBAAmB;IACpC,WAAW,EAAE,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;IACtD,OAAO,EAAE,QAAQ;IACjB,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC;YACT,WAAW,EAAE,6DAA6D;YAC1E,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAClF,KAAK,EAAE,kBAAwC;SAChD,EAAE;YACD,WAAW,EAAE,0DAA0D;YACvE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAChF,KAAK,EAAE,gBAAsC;SAC9C,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1E,CAAC,CAAC"}

package/dist/tools/commands.d.ts

@@ -0,0 +1,5 @@
+import type { CliResult } from "../types.js";
+import { type ToolsRuntime } from "./dispatcher.js";
+export type { ToolsRuntime } from "./dispatcher.js";
+/** 解析 tools 子命令形态后统一交给 dispatcher，避免发现命令形成第二套路由。 */
+export declare function handleToolsCommand(command: string | undefined, positional: string[], flags: Record<string, string | boolean>, runtime: ToolsRuntime, requestId: string): Promise<CliResult>;

package/dist/tools/commands.js

@@ -0,0 +1,45 @@
+import { getString } from "../args.js";
+import { failure } from "../output.js";
+import { dispatchTool } from "./dispatcher.js";
+/** 解析 tools 子命令形态后统一交给 dispatcher，避免发现命令形成第二套路由。 */
+export async function handleToolsCommand(command, positional, flags, runtime, requestId) {
+    const flagError = rejectUnknownToolFlags(command, positional, flags, requestId);
+    if (flagError)
+        return flagError;
+    if (command === "run") {
+        const name = positional[0] ?? getString(flags, "name") ?? getString(flags, "tool");
+        return dispatchTool(name, positional[1], flags, runtime, requestId);
+    }
+    if (command === "group") {
+        if (positional[0] === "list") {
+            return dispatchTool("tools.group-list", positional[1], flags, runtime, requestId, { group: positional[1] });
+        }
+        return dispatchTool("tools.group", undefined, flags, runtime, requestId);
+    }
+    if (command === "search") {
+        const keyword = positional[0] ?? getString(flags, "keyword") ?? getString(flags, "query");
+        return dispatchTool("tools.search", undefined, flags, runtime, requestId, { keyword });
+    }
+    if (command === "describe") {
+        const name = positional[0] ?? getString(flags, "name") ?? getString(flags, "tool");
+        return dispatchTool("tools.describe", undefined, flags, runtime, requestId, { name });
+    }
+    return failure(requestId, "UNKNOWN_TOOLS_COMMAND", "Expected tools group, tools group list <group>, tools describe <tool>, tools run <tool>, or tools search <k1|k2|...>.", [
+        "Run unitycli tools group to see tool categories.",
+        "Run unitycli tools describe <tool> for full metadata."
+    ]);
+}
+/** 公开 Tool 参数只允许 JSON input 与明确命令控制项，未知 flag 不进入业务 schema。 */
+function rejectUnknownToolFlags(command, positional, flags, requestId) {
+    const common = ["instance", "raw"];
+    const allowed = command === "run"
+        ? [...common, "input", "input-file", "stdin", "dry-run", "timeout-ms", "artifact-dir", "runtime"]
+        : common;
+    const unknown = Object.keys(flags).find((flag) => !allowed.includes(flag));
+    if (!unknown)
+        return undefined;
+    return failure(requestId, "E_UNKNOWN_OPTION", `Unknown option for tools ${command ?? ""}: --${unknown}.`, [
+        command === "run" ? "Put business fields inside --input <json>." : "Run unitycli --help for the supported options."
+    ], { option: `--${unknown}`, command: `tools ${command ?? ""}`.trim(), positional });
+}
+//# sourceMappingURL=commands.js.map

package/dist/tools/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/tools/commands.ts"],"names":[],"mappings":"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"}

package/dist/tools/completion-probe.d.ts

@@ -0,0 +1,22 @@
+import type { AnyJson } from "../schema/any-json.js";
+export type CompletionProbeReadTool = "scene.gameobject" | "scene.gameobject.component";
+export type CompletionProbeOperator = "equals" | "notEquals" | "approx" | "exists" | "lengthEquals" | "contains";
+/** 高风险同步动作的声明式 before/after proof。 */
+export interface CompletionProbe {
+    readTool: CompletionProbeReadTool;
+    input: Record<string, AnyJson>;
+    assertions: CompletionProbeAssertion[];
+}
+export interface CompletionProbeAssertion {
+    path: string;
+    operator: CompletionProbeOperator;
+    before: AnyJson;
+    after: AnyJson;
+    tolerance?: number;
+}
+export interface CompletionProbeReadback {
+    assertions: Array<{
+        path: string;
+        value: AnyJson;
+    }>;
+}

package/dist/tools/completion-probe.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=completion-probe.js.map

package/dist/tools/completion-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-probe.js","sourceRoot":"","sources":["../../src/tools/completion-probe.ts"],"names":[],"mappings":""}

package/dist/tools/define.d.ts

@@ -0,0 +1,77 @@
+/**
+ * TS Tool 声明工厂与运行时注册表。
+ * 一个能力文件默认导出一个 defineTool；公开 schema 由构建期从 Request/Result 类型生成并注入。
+ */
+import type { BridgeRuntime } from "../bridge/index.js";
+import type { ToolMetadata, PlayModeSupport, ToolHandler } from "./metadata/types.js";
+/** defineTool 的输入。schema 不在此处，由构建期从 Request/Result 类型生成注入。 */
+export interface ToolDefinition<TReq = unknown, TRes = unknown> {
+    name: string;
+    summary: string;
+    description: string;
+    group: string;
+    destructiveHint: boolean;
+    /** 副作用类别,如 ['file-write','scene-modify']。 */
+    sideEffects?: string[];
+    playModeSupport?: PlayModeSupport;
+    supportsDryRun?: boolean;
+    timeoutMs?: number;
+    permissions?: string[];
+    /** 执行路由:bridge/bridge-runtime/offline/hybrid。 */
+    handler?: ToolHandler;
+    supportStatus?: import("./metadata/types.js").ToolSupportStatus;
+    target?: string;
+    requiresPackages?: string[];
+    examples?: import("./metadata/types.js").ToolExample[];
+    /** bridge-runtime 定义仍提供 fail-closed guard；dispatcher 按 handler 选择唯一 Bridge executor。 */
+    execute: (req: TReq, ctx: ToolContext) => Promise<TRes> | TRes;
+}
+/** 工具执行上下文（运行时由框架注入）。 */
+export interface ToolContext {
+    requestId: string;
+    projectPath: string;
+    /** dispatcher 入口冻结的绝对截止时间；本地前置工作与 Bridge 等待必须共同消费。 */
+    absoluteDeadlineMs?: number;
+    /** 命令层执行控制，不属于 Tool Request 或公开业务 schema。 */
+    execution: {
+        dryRun?: boolean;
+        timeoutMs?: number;
+    };
+    /** CLI data 目录,用于离线 cache。 */
+    dataDir?: string;
+    /** TS mutation 在全部前置校验后、首个业务 effect 前调用；dispatcher 注入 durable barrier。 */
+    commitEffect?: () => Promise<void>;
+    /** 当前 direct TS mutation 是否由 local root journal 托管；仅用于派生内部 child requestId。 */
+    localJournalActive?: boolean;
+    /** artifact 目录(可写)。 */
+    artifactDir: string;
+    /** bridge 日志路径。 */
+    logPath?: string;
+    /** tools run 合并后的原始 flags,供 action 型工具执行内部确认与 dry-run 判定。 */
+    flags?: Record<string, string | boolean>;
+    /** 测试或宿主注入的实例 Tool descriptor。 */
+    projectTools?: ToolMetadata[];
+    /** 同一公开根调用共享的私有准入lease；所有Bridge子请求必须显式复用。 */
+    rootAdmission?: BridgeRuntime["rootAdmission"];
+    /** 统一catalog公开根分别复用Editor/Runtime准入lease。 */
+    rootAdmissions?: BridgeRuntime["rootAdmissions"];
+    /** 可选 live Bridge 执行器，仅供 defineTool 的隔离测试 transport。 */
+    bridgeExecute?: BridgeRuntime["bridgeExecute"];
+    /** 测试或宿主注入的文档抓取器,用于 docs online fallback,避免工具内部直接绑定全局网络。 */
+    fetch?: (url: string) => Promise<{
+        ok: boolean;
+        status: number;
+        text: () => Promise<string>;
+    }>;
+}
+/**
+ * 声明一个 TS 工具。在 src/tools/<域>/<工具>.ts 中 `export default defineTool({...})`。
+ * 返回原 definition(便于文件 default 导出)。
+ */
+export declare function defineTool<TReq, TRes>(definition: ToolDefinition<TReq, TRes>): ToolDefinition<TReq, TRes>;
+/** 构建期注入 schema(gen-tool-schemas.mjs 调用)。 */
+export declare function injectToolSchema(name: string, inputSchema: Record<string, unknown>, outputSchema?: Record<string, unknown>): void;
+/** 获取所有已注册 TS defineTool 工具的 metadata（含构建期注入的 schema）。 */
+export declare function defineToolMetadata(): ToolMetadata[];
+/** 按 name 查找已注册的 TS defineTool 工具定义(执行用)。 */
+export declare function findDefineTool(name: string): ToolDefinition | undefined;

package/dist/tools/define.js

@@ -0,0 +1,58 @@
+/**
+ * TS Tool 声明工厂与运行时注册表。
+ * 一个能力文件默认导出一个 defineTool；公开 schema 由构建期从 Request/Result 类型生成并注入。
+ */
+const registry = new Map();
+/**
+ * 声明一个 TS 工具。在 src/tools/<域>/<工具>.ts 中 `export default defineTool({...})`。
+ * 返回原 definition(便于文件 default 导出)。
+ */
+export function defineTool(definition) {
+    if (!definition.name)
+        throw new Error("defineTool requires name");
+    if (registry.has(definition.name)) {
+        throw new Error(`duplicate defineTool registration: ${definition.name}`);
+    }
+    registry.set(definition.name, { definition: definition });
+    return definition;
+}
+/** 构建期注入 schema(gen-tool-schemas.mjs 调用)。 */
+export function injectToolSchema(name, inputSchema, outputSchema) {
+    const entry = registry.get(name);
+    if (!entry)
+        return;
+    entry.inputSchema = inputSchema;
+    entry.outputSchema = outputSchema;
+}
+/** 获取所有已注册 TS defineTool 工具的 metadata（含构建期注入的 schema）。 */
+export function defineToolMetadata() {
+    const result = [];
+    for (const [, entry] of registry) {
+        const d = entry.definition;
+        result.push({
+            name: d.name,
+            summary: d.summary,
+            description: d.description,
+            group: d.group,
+            inputSchema: entry.inputSchema ?? {},
+            outputSchema: entry.outputSchema,
+            destructiveHint: d.destructiveHint,
+            sideEffects: d.sideEffects,
+            playModeSupport: d.playModeSupport,
+            supportsDryRun: d.supportsDryRun,
+            timeoutMs: d.timeoutMs,
+            permissions: d.permissions,
+            examples: d.examples,
+            handler: d.handler,
+            supportStatus: d.supportStatus,
+            target: d.target,
+            requiresPackages: d.requiresPackages,
+        });
+    }
+    return result;
+}
+/** 按 name 查找已注册的 TS defineTool 工具定义(执行用)。 */
+export function findDefineTool(name) {
+    return registry.get(name)?.definition;
+}
+//# sourceMappingURL=define.js.map

package/dist/tools/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/tools/define.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2EH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAa,UAAsC;IAC3E,IAAI,CAAC,UAAU,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAClE,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,sCAAsC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,UAA4B,EAAE,CAAC,CAAC;IAC5E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,WAAoC,EAAE,YAAsC;IACzH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC;AACpC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;YACpC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;AACxC,CAAC"}

package/dist/tools/diagnose/capabilities.d.ts

@@ -0,0 +1,13 @@
+import type { AnyJson } from "../../schema/any-json.js";
+export interface DiagnoseCapabilitiesRequest {
+}
+export interface DiagnoseCapabilitiesObject {
+    [key: string]: AnyJson;
+}
+export interface DiagnoseCapabilitiesResult {
+    catalog: DiagnoseCapabilitiesObject;
+    runtime?: DiagnoseCapabilitiesObject;
+    extensions: DiagnoseCapabilitiesObject;
+}
+declare const _default: import("../define.js").ToolDefinition<DiagnoseCapabilitiesRequest, DiagnoseCapabilitiesResult>;
+export default _default;

package/dist/tools/diagnose/capabilities.js

@@ -0,0 +1,34 @@
+import { handleCapabilitiesCommand } from "../../capabilities.js";
+import { defineTool } from "../define.js";
+import { StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "diagnose.capabilities",
+    summary: "Summarize the selected Unity instance's complete Tool, Extension, and runtime capabilities.",
+    description: "Summarize the complete unified capability catalog of the selected live Unity instance. Package, Extension, and project-defined capabilities use the same catalog.",
+    group: "diagnose",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Summarize the instance selected from CWD", argv: ["tools", "run", "diagnose.capabilities", "--input", "{}"] },
+        { description: "Summarize an explicitly selected instance", argv: ["tools", "run", "diagnose.capabilities", "--instance", "<projectPath>"] }
+    ],
+    /** 复用统一 live catalog，来源只作为汇总维度。 */
+    async execute(request, ctx) {
+        const flags = { ...ctx.flags };
+        const runtime = {
+            dataDir: ctx.dataDir,
+            rootAdmission: ctx.rootAdmission,
+            rootAdmissions: ctx.rootAdmissions,
+            bridgeExecute: ctx.bridgeExecute,
+            projectTools: ctx.projectTools
+        };
+        const result = await handleCapabilitiesCommand(flags, runtime, ctx.requestId);
+        if (!result.ok) {
+            throw StructuredToolError.from(result.error);
+        }
+        return result.data;
+    }
+});
+//# sourceMappingURL=capabilities.js.map

package/dist/tools/diagnose/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/tools/diagnose/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAanD,eAAe,UAAU,CAA0D;IACjF,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,6FAA6F;IACtG,WAAW,EAAE,mKAAmK;IAChL,KAAK,EAAE,UAAU;IACjB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,0CAA0C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QAC7H,EAAE,WAAW,EAAE,2CAA2C,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE;KAC7I;IACD,mCAAmC;IACnC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG;QACxB,MAAM,KAAK,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAuC;YAClD,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,MAAM,CAAC,IAAkC,CAAC;IACnD,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/dispatcher.d.ts

@@ -0,0 +1,27 @@
+import { type BridgeRuntime } from "../bridge/index.js";
+import { EditorBlockerObserver } from "../editor-blocker-observer.js";
+import type { ProjectToolRuntime } from "../project-tool-discovery.js";
+import type { CliResult } from "../types.js";
+import { type GeneratedToolCompletionContract } from "./.generated-completion-registry.js";
+import { type ToolMetadata } from "./metadata/index.js";
+export type ToolsRuntime = ProjectToolRuntime & Partial<BridgeRuntime> & {
+    dataDir?: string;
+    fetch?: (url: string) => Promise<{
+        ok: boolean;
+        status: number;
+        text: () => Promise<string>;
+    }>;
+};
+/**
+ * Tool 分发顺序固定为输入解析、catalog 解析、schema 校验、目标选择、执行与 envelope。
+ * 调用即授权，只保留 schema、目标与 descriptor 的正确性验证。
+ */
+export declare function dispatchTool(name: string | undefined, positionalTarget: string | undefined, flags: Record<string, string | boolean>, runtime: ToolsRuntime, requestId: string, seed?: Record<string, unknown>, resolvedTool?: ToolMetadata): Promise<CliResult>;
+/** 公开统一catalog对每个在线target session分别占一个slot，禁止跨池旁路输出。 */
+export declare function dispatchCatalogProjection(command: string, input: Record<string, unknown>, flags: Record<string, string | boolean>, runtime: ToolsRuntime, requestId: string, execute: (rootRuntime: ToolsRuntime) => Promise<CliResult>): Promise<CliResult>;
+/** Tool自己的wait未按时settle时由框架结束CLI等待；已开始的Unity effect不因此停止。 */
+export declare function settleToolExecutionAtDeadline(toolName: string, requestId: string, mutation: boolean, absoluteDeadlineMs: number, run: () => Promise<CliResult>): Promise<CliResult>;
+/** TS Tool 的 terminal proof 与 C# driver 使用同一 execution-class 约束。 */
+export declare function validateLocalCompletionProof(toolName: string, completion: GeneratedToolCompletionContract | NonNullable<ToolMetadata["completionContract"]>, result: unknown, input?: Record<string, unknown>): void;
+/** Bridge wrappers may discard supervisor details; append one independent read-only modal diagnosis to target failures. */
+export declare function enrichTargetFailureWithDialogBlocker(result: CliResult, flags: Record<string, string | boolean>, runtime: ToolsRuntime, observer?: EditorBlockerObserver): Promise<CliResult>;