@alpsckr/unitycli 0.4.0

package/dist/tools/editor/state.js

@@ -0,0 +1,286 @@
+import { executeBridgePayload } from "../../bridge/index.js";
+import { withObservationSelection } from "../../bridge/types.js";
+import { InstanceRegistryError, applyProjectProcessClaimInspection, inspectProjectProcessClaims, selectObservationInstanceForFlags, verifyRegistrySessionProcess, } from "../../instances.js";
+import { ProjectIdentityError } from "../../project-identity.js";
+import { EditorBlockerObserver, sanitizeEditorBlockers } from "../../editor-blocker-observer.js";
+import { defineTool } from "../define.js";
+import { StructuredToolError } from "../errors.js";
+const STATE_FIELDS = ["compile", "import", "build", "playMode", "prefabStage", "activeScene", "runtime"];
+const FRESH_SNAPSHOT_MS = 10_000;
+// Windows冷启动需在同一上限内完成Bridge、PID/start和canonical project三重证明。
+const OBSERVATION_BUDGET_MS = 4_000;
+// Bridge子调用只能消费前半段预算；modal时必须给独立process/UI observer留下原deadline内的证明窗口。
+const BLOCKER_OBSERVATION_RESERVE_MS = 2_000;
+const SENSITIVE_KEYS = new Set(["endpoint", "endpointurl", "bridgeendpoint", "bridgeendpointurl", "bridgeurl", "port", "actualport", "preferredport", "listenerid", "listenergeneration", "generation", "commandline"]);
+export default defineTool({
+    name: "editor.state",
+    summary: "Read the selected Unity Editor session state, progress, and external blockers without waiting.",
+    description: "Read selected Unity project identity and active Editor session. Input must be empty. This read-only Tool never waits, refreshes Unity, writes a journal, or dismisses dialogs. It combines bounded main-thread snapshot, Registry v3, verified process identity, and Windows modal observation to classify transition, blocker, unresponsive, unverifiable, offline, and verified conflict. Ready proves only current session state; after a started mutation timeout, read affected business state before a new request.",
+    group: "editor",
+    destructiveHint: false,
+    sideEffects: [],
+    handler: "offline",
+    target: "editor",
+    playModeSupport: "supported",
+    examples: [{ description: "Read the current selected Editor state.", argv: ["tools", "run", "editor.state", "--input", "{}"], input: {} }],
+    async execute(_request, context) { return readEditorState(context); },
+});
+/** 聚合路径完全只读，总预算固定；任一 snapshot 只可单独作为状态字段来源。 */
+export async function readEditorState(context, dependencies = {}) {
+    const startedAt = Date.now();
+    const selectObservation = dependencies.selectObservation ?? selectObservationInstanceForFlags;
+    const observer = dependencies.observer ?? new EditorBlockerObserver();
+    const observationDeadlineMs = Math.min(startedAt + OBSERVATION_BUDGET_MS, context.absoluteDeadlineMs ?? Number.POSITIVE_INFINITY);
+    if (!context.dataDir)
+        throw new StructuredToolError("E_INSTANCE_NOT_FOUND", "UnityCLI data directory is required to resolve the selected Editor instance.", ["Pass --instance <instanceId|projectPath|alias> or run from a Unity project directory."]);
+    let selection;
+    let instance;
+    try {
+        selection = await selectObservation(context.flags ?? {}, context.dataDir, remaining(observationDeadlineMs));
+        instance = selection.instance;
+    }
+    catch (error) {
+        if (error instanceof InstanceRegistryError || error instanceof ProjectIdentityError) {
+            throw new StructuredToolError(error.code, error.message, error instanceof InstanceRegistryError ? error.nextActions : ["Pass --instance <instanceId|canonicalProjectPath|alias> or run from a local Unity project directory."], error.details);
+        }
+        throw error;
+    }
+    // conflict已由多个verified claim证明；raw unverifiable仍允许observer重新证明唯一PID/start后发现exact modal。
+    if (instance.status === "conflict")
+        return makeResult(instance, undefined, "conflict", undefined, [], [], false);
+    const session = instance.activeSession;
+    if (!session) {
+        const observed = await observer.observe(identityOf(instance), observationDeadlineMs);
+        if (observed.outcome === "observed-blocked")
+            return makeResult(instance, undefined, "blocked", undefined, [], sanitizeEditorBlockers(observed.blockers), false);
+        if (observed.outcome === "conflict")
+            return makeResult(instance, undefined, "conflict", undefined, [], [], false);
+        if (observed.outcome === "offline")
+            return makeResult(instance, undefined, "offline", undefined, [], [], false);
+        if (observed.outcome === "observed-empty")
+            return makeResult(instance, undefined, "transitioning", undefined, [], [], false);
+        return makeResult(instance, undefined, "unverifiable", undefined, [], [], false);
+    }
+    const fallbackBudgetMs = remaining(observationDeadlineMs);
+    if (fallbackBudgetMs <= 0)
+        return makeResult(instance, session, "unresponsive", undefined, [], [], false);
+    // 正常Bridge成功路径不访问Windows UI；失败后才证明process和modal。
+    // bridgeExecute是隔离测试transport，生产CLI不提供；测试必须复用已通过selector的同一Registry session identity。
+    const verificationPromise = dependencies.verifySession
+        ? dependencies.verifySession(identityOf(instance), session, fallbackBudgetMs)
+        : context.bridgeExecute
+            ? Promise.resolve("verified")
+            : verifyRegistrySessionProcess(identityOf(instance), session, fallbackBudgetMs);
+    const processClaimsPromise = dependencies.inspectClaims
+        ? dependencies.inspectClaims(identityOf(instance), fallbackBudgetMs)
+        : context.bridgeExecute
+            ? Promise.resolve({ verification: "verified", processIds: [session.processId], processClaims: [{ processId: session.processId, processStartedAt: session.processStartedAt }] })
+            : inspectProjectProcessClaims(identityOf(instance), fallbackBudgetMs);
+    const bridgeDeadlineMs = Math.max(Date.now(), observationDeadlineMs - BLOCKER_OBSERVATION_RESERVE_MS);
+    const bridge = await probeBridge(context, bridgeDeadlineMs, session, selection);
+    if (bridge && isLiveSnapshot(bridge.snapshot)) {
+        const processClaims = await processClaimsPromise;
+        const inspected = applyProjectProcessClaimInspection(instance, processClaims);
+        if (inspected.status === "conflict" || inspected.status === "unverifiable")
+            return makeResult(inspected, undefined, inspected.status, undefined, [], sanitizeEditorBlockers(inspected.blockers), false);
+        const progress = sanitizeProgress(bridge.progress);
+        const blockers = sanitizeEditorBlockers(bridge.blockers);
+        return makeResult(inspected, session, observedStatus(bridge.snapshot, progress, blockers), bridge.snapshot, progress, blockers, true);
+    }
+    const [verification, processClaims] = await Promise.all([verificationPromise, processClaimsPromise]);
+    const inspected = applyProjectProcessClaimInspection(instance, processClaims);
+    if (inspected.status === "conflict")
+        return makeResult(inspected, undefined, "conflict", undefined, [], sanitizeEditorBlockers(inspected.blockers), false);
+    if (inspected.status === "unverifiable") {
+        // 第一次process scan不完整时只允许独立observer重新证明blocker/conflict/offline；不得恢复ready或信任registry session。
+        const independent = await observer.observe(identityOf(instance), observationDeadlineMs);
+        if (independent.outcome === "observed-blocked")
+            return makeResult(inspected, undefined, "blocked", undefined, [], sanitizeEditorBlockers(independent.blockers), false);
+        if (independent.outcome === "conflict")
+            return makeResult(inspected, undefined, "conflict", undefined, [], [], false);
+        if (independent.outcome === "offline")
+            return makeResult(inspected, undefined, "offline", undefined, [], [], false);
+        return makeResult(inspected, undefined, "unverifiable", undefined, [], [], false);
+    }
+    const observed = await observeVerifiedRegistrySession(identityOf(instance), session, observationDeadlineMs, verification, processClaims, observer);
+    if (observed.outcome === "conflict")
+        return makeResult(inspected, undefined, "conflict", undefined, [], [], false);
+    if (observed.outcome === "offline")
+        return makeResult(inspected, undefined, "offline", undefined, [], [], false);
+    if (observed.outcome === "unproven")
+        return makeResult(inspected, undefined, "unverifiable", undefined, [], [], false);
+    const snapshot = parseSnapshot(session.lastUnitySnapshot, session);
+    const progress = sanitizeProgress(session.progress);
+    const blockers = [...sanitizeEditorBlockers(session.blockers), ...observed.blockers];
+    const status = observed.outcome === "unsupported"
+        ? "unresponsive"
+        : fallbackStatus(session, progress, blockers);
+    return makeResult(inspected, session, status, snapshot, progress, blockers, false);
+}
+/** 将身份与可响应性终态映射为稳定公开错误；blocked/transitioning 仍由具体业务决定。 */
+export function rejectUnavailableEditorState(state, operation) {
+    if (state.status === "conflict") {
+        throw new StructuredToolError("E_INSTANCE_CONFLICT", `Multiple verified Unity Editor processes claim the project selected for ${operation}.`, ["Close duplicate Unity Editor processes and retry after editor.state reports one verified session."], { status: state.status });
+    }
+    if (state.status === "unverifiable") {
+        throw new StructuredToolError("E_INSTANCE_UNVERIFIABLE", `${operation} cannot prove one Unity process identity safely.`, ["Inspect instances list and editor.state; do not retry a prior mutation whose outcome is unknown."], { status: state.status });
+    }
+    if (state.status === "unresponsive") {
+        throw new StructuredToolError("E_UNITY_UNRESPONSIVE", `${operation} cannot proceed because the verified Unity Editor main thread is not responsive.`, ["Inspect editor.state and editor.dialogs before deciding whether to submit a new request."], { status: state.status }, true, 250);
+    }
+    if (state.status === "offline") {
+        throw new StructuredToolError("E_INSTANCE_NOT_RUNNING", `${operation} requires an open Unity Editor.`, ["Open the selected Unity project and retry."], { status: state.status });
+    }
+}
+/**
+ * registry fallback 只有在 session PID、project claim 与 start identity 全部一致后才允许 UIAutomation。
+ * 任何多 PID、不可验证或 PID 复用迹象都在 observer 调用前 fail closed。
+ */
+export async function observeVerifiedRegistrySession(identity, session, deadlineMs, verification, processClaims, observer = new EditorBlockerObserver({ inspect: async () => processClaims })) {
+    if (verification === "dead")
+        return { outcome: "offline", blockers: [] };
+    if (verification !== "verified" || processClaims.verification !== "verified")
+        return { outcome: "unproven", blockers: [], reason: "process-claims-unverifiable" };
+    if (processClaims.processIds.length === 0)
+        return { outcome: "offline", blockers: [] };
+    if (processClaims.processIds.length !== 1)
+        return { outcome: "conflict", blockers: [], reason: "multiple-process-claims" };
+    if (processClaims.processIds[0] !== session.processId)
+        return { outcome: "unproven", blockers: [], reason: "session-process-mismatch" };
+    const claim = processClaims.processClaims?.find((item) => item.processId === session.processId);
+    if (!claim || Date.parse(claim.processStartedAt) !== Date.parse(session.processStartedAt))
+        return { outcome: "unproven", blockers: [], reason: "session-process-mismatch" };
+    return observer.observe(identity, deadlineMs, session);
+}
+/** Bridge observation inherits this read's one absolute deadline; it never restarts a remaining budget. */
+async function probeBridge(context, observationDeadlineMs, session, selection) {
+    if (remaining(observationDeadlineMs) <= 0)
+        return undefined;
+    // selector 只在外层执行一次；私有 Symbol 调用字段保留真实 instanceId，不会进入 Bridge body。
+    const result = await executeBridgePayload(context.requestId, "internal.editor.state.snapshot", {}, { instance: selection.instance.instanceId }, { bridgeExecute: context.bridgeExecute, dataDir: context.dataDir, rootAdmission: context.rootAdmission }, undefined, withObservationSelection({ mode: "observeNow", mutation: false, observationAbsoluteDeadlineMs: observationDeadlineMs }, selection));
+    if (!result.ok || !result.data || typeof result.data !== "object" || Array.isArray(result.data))
+        return undefined;
+    const data = result.data;
+    const snapshot = parseSnapshot(data.snapshot ?? data, session);
+    return snapshot ? { snapshot, progress: data.progress, blockers: data.blockers } : undefined;
+}
+/** snapshot 必须为完整 v1 单包，禁止混合 listener 或 registry 的字段。 */
+function parseSnapshot(value, session) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const raw = value;
+    if (raw.schemaVersion !== 1 || typeof raw.observedAt !== "string" || !Number.isFinite(Date.parse(raw.observedAt))
+        || typeof raw.sourceEditorSessionId !== "string" || !Number.isInteger(raw.sourceListenerGeneration)
+        || !raw.fields || typeof raw.fields !== "object" || Array.isArray(raw.fields)
+        || !hasExactKeys(raw, ["schemaVersion", "observedAt", "sourceEditorSessionId", "sourceListenerGeneration", "fields"]))
+        return undefined;
+    const observedAtMs = Date.parse(raw.observedAt);
+    if (observedAtMs > Date.now())
+        return undefined;
+    if (session && (raw.sourceEditorSessionId !== session.editorSessionId || raw.sourceListenerGeneration !== session.listener.generation))
+        return undefined;
+    const fields = raw.fields;
+    if (Object.keys(fields).length !== STATE_FIELDS.length || STATE_FIELDS.some((name) => !validKnownField(fields[name])))
+        return undefined;
+    return raw;
+}
+function validKnownField(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const field = value;
+    if (typeof field.known !== "boolean" || !Object.keys(field).every((key) => key === "known" || key === "value"))
+        return false;
+    return field.known ? Object.prototype.hasOwnProperty.call(field, "value") : !Object.prototype.hasOwnProperty.call(field, "value");
+}
+function hasExactKeys(value, names) {
+    const keys = Object.keys(value);
+    return keys.length === names.length && names.every((name) => Object.prototype.hasOwnProperty.call(value, name));
+}
+function makeResult(instance, session, status, snapshot, progress, blockers, live) {
+    const now = Date.now();
+    const observedAt = snapshot?.observedAt ?? null;
+    const observedAtMs = observedAt ? Date.parse(observedAt) : Number.NaN;
+    const age = Number.isFinite(observedAtMs) && observedAtMs <= now ? now - observedAtMs : null;
+    const freshness = live && snapshot && age !== null && age <= FRESH_SNAPSHOT_MS ? "live" : age === null ? "unknown" : age <= FRESH_SNAPSHOT_MS ? "fresh" : "stale";
+    const state = Object.fromEntries(STATE_FIELDS.map((field) => {
+        const item = snapshot?.fields[field];
+        return [field, item?.known ? { known: true, value: safeValue(item.value) } : { known: false }];
+    }));
+    return {
+        identity: identityOf(instance),
+        session: { known: !!session, editorSessionId: session?.editorSessionId ?? null },
+        status,
+        state,
+        progress,
+        blockers,
+        observation: { freshness },
+    };
+}
+function identityOf(instance) {
+    return { instanceId: instance.instanceId, canonicalProjectPath: instance.canonicalProjectPath, displayProjectPath: instance.displayProjectPath };
+}
+function remaining(observationDeadlineMs) { return Math.max(0, observationDeadlineMs - Date.now()); }
+function isLiveSnapshot(snapshot) {
+    const observedAtMs = Date.parse(snapshot.observedAt);
+    return Number.isFinite(observedAtMs) && observedAtMs <= Date.now() && Date.now() - observedAtMs <= FRESH_SNAPSHOT_MS;
+}
+function observedStatus(snapshot, progress, blockers) {
+    if (blockers.length > 0)
+        return "blocked";
+    if (!snapshot || !isLiveSnapshot(snapshot) || progress.length > 0 || snapshotTransitioning(snapshot))
+        return "transitioning";
+    return "ready";
+}
+function fallbackStatus(session, progress, blockers) {
+    if (session.lifecycle === "blocked" || blockers.length > 0)
+        return "blocked";
+    if (session.lifecycle !== "ready" || progress.length > 0)
+        return "transitioning";
+    // Registry publication是历史快照；Bridge/main-thread未响应时不能独立证明ready。
+    return "unresponsive";
+}
+function snapshotTransitioning(snapshot) {
+    for (const field of ["compile", "import", "build"])
+        if (snapshot.fields[field].known && snapshot.fields[field].value === true)
+            return true;
+    return snapshot.fields.playMode.known && snapshot.fields.playMode.value === "transitioning";
+}
+function safeRecord(value, parentKey) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const result = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (isSensitiveKey(key, parentKey))
+            continue;
+        if (Array.isArray(child))
+            result[key] = child.map((item) => safeValue(item, key));
+        else
+            result[key] = safeValue(child, key);
+    }
+    return result;
+}
+function isSensitiveKey(key, parentKey) {
+    const normalized = key.replace(/[^a-z0-9]/gi, "").toLowerCase();
+    return SENSITIVE_KEYS.has(normalized) || (parentKey?.replace(/[^a-z0-9]/gi, "").toLowerCase() === "listener" && normalized === "id");
+}
+function safeValue(value, parentKey) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : null;
+    if (Array.isArray(value))
+        return value.map((item) => safeValue(item, parentKey));
+    return safeRecord(value, parentKey) ?? null;
+}
+const PROGRESS_SOURCES = new Set(["unity", "registry"]);
+function sanitizeProgress(value) {
+    return Array.isArray(value) ? value.flatMap((item) => {
+        const record = safeRecord(item);
+        if (!record || typeof record.kind !== "string" || record.kind.length === 0 || typeof record.title !== "string"
+            || typeof record.canWait !== "boolean" || !PROGRESS_SOURCES.has(record.source)
+            || (record.value !== undefined && record.value !== null && (typeof record.value !== "number" || record.value < 0 || record.value > 1)))
+            return [];
+        return [{ kind: record.kind, title: record.title, ...(Object.prototype.hasOwnProperty.call(record, "value") ? { value: record.value } : {}), canWait: record.canWait, source: record.source }];
+    }) : [];
+}
+//# sourceMappingURL=state.js.map

package/dist/tools/editor/state.js.map

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

package/dist/tools/errors.d.ts

@@ -0,0 +1,30 @@
+import { type EditorBlocker } from "../editor-blocker-observer.js";
+/**
+ * TS defineTool 统一结构化错误。
+ *
+ * 由本地 TS 工具抛出,`tools run` 捕获后转换为标准 failure envelope。
+ * 适用于 docs/reflect/package 等不属于 Bridge 的离线能力,避免退化成 COMMAND_FAILED。
+ */
+export declare class StructuredToolError extends Error {
+    readonly code: string;
+    readonly nextActions: string[];
+    readonly details?: Record<string, unknown> | undefined;
+    readonly transient?: boolean | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(code: string, message: string, nextActions?: string[], details?: Record<string, unknown> | undefined, transient?: boolean | undefined, retryAfterMs?: number | undefined);
+    /** 跨内部抽象边界转发完整错误语义，不丢失 wire retry 元数据。 */
+    static from(error: {
+        code: string;
+        message: string;
+        nextActions?: string[];
+        details?: unknown;
+        transient?: boolean;
+        retryAfterMs?: number;
+    }): StructuredToolError;
+}
+/** 仅转发已公开的 blocker DTO，禁止旧字段或内部观察数据穿透。 */
+export declare function blockersFromDetails(details: Record<string, unknown> | undefined): EditorBlocker[] | undefined;
+/** effect 已开始后的 timeout 保留原错误码，并提供当前 modal 的明确恢复操作。 */
+export declare function blockerTimeoutMessage(operation: string, blockers: EditorBlocker[] | undefined): string;
+/** 超时恢复操作：先引导读 editor.state 等待过渡完成，再处理 modal dialog；两者同时给出，不因 dialog 丢弃等待引导。 */
+export declare function blockerNextActions(): string[];

package/dist/tools/errors.js

@@ -0,0 +1,46 @@
+import { sanitizeEditorBlockers } from "../editor-blocker-observer.js";
+/**
+ * TS defineTool 统一结构化错误。
+ *
+ * 由本地 TS 工具抛出,`tools run` 捕获后转换为标准 failure envelope。
+ * 适用于 docs/reflect/package 等不属于 Bridge 的离线能力,避免退化成 COMMAND_FAILED。
+ */
+export class StructuredToolError extends Error {
+    code;
+    nextActions;
+    details;
+    transient;
+    retryAfterMs;
+    constructor(code, message, nextActions = [], details, transient, retryAfterMs) {
+        super(message);
+        this.code = code;
+        this.nextActions = nextActions;
+        this.details = details;
+        this.transient = transient;
+        this.retryAfterMs = retryAfterMs;
+    }
+    /** 跨内部抽象边界转发完整错误语义，不丢失 wire retry 元数据。 */
+    static from(error) {
+        return new StructuredToolError(error.code, error.message, error.nextActions ?? [], error.details, error.transient, error.retryAfterMs);
+    }
+}
+/** 仅转发已公开的 blocker DTO，禁止旧字段或内部观察数据穿透。 */
+export function blockersFromDetails(details) {
+    if (!details)
+        return undefined;
+    const blockers = sanitizeEditorBlockers(details.blockers);
+    return blockers.length > 0 ? blockers : undefined;
+}
+/** effect 已开始后的 timeout 保留原错误码，并提供当前 modal 的明确恢复操作。 */
+export function blockerTimeoutMessage(operation, blockers) {
+    return blockers?.[0] ? `${operation} did not return a terminal result before the request deadline; modal dialog '${blockers[0].title}' was observed.` : `${operation} did not return a terminal result before the request deadline.`;
+}
+/** 超时恢复操作：先引导读 editor.state 等待过渡完成，再处理 modal dialog；两者同时给出，不因 dialog 丢弃等待引导。 */
+export function blockerNextActions() {
+    return [
+        "Run unitycli tools run editor.state to check whether the Editor is still transitioning and wait until it reports ready.",
+        "Run unitycli tools run editor.dialogs to inspect the current modal dialog.",
+        "Run unitycli tools run editor.dialog.click with a current dialogId and exact button label.",
+    ];
+}
+//# sourceMappingURL=errors.js.map

package/dist/tools/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAsB,MAAM,+BAA+B,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAEjC;IAEA;IACA;IACA;IACA;IANX,YACW,IAAY,EACrB,OAAe,EACN,cAAwB,EAAE,EAC1B,OAAiC,EACjC,SAAmB,EACnB,YAAqB;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAPN,SAAI,GAAJ,IAAI,CAAQ;QAEZ,gBAAW,GAAX,WAAW,CAAe;QAC1B,YAAO,GAAP,OAAO,CAA0B;QACjC,cAAS,GAAT,SAAS,CAAU;QACnB,iBAAY,GAAZ,YAAY,CAAS;IAGhC,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,IAAI,CAAC,KAOX;QACC,OAAO,IAAI,mBAAmB,CAC5B,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,WAAW,IAAI,EAAE,EACvB,KAAK,CAAC,OAA8C,EACpD,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,YAAY,CACnB,CAAC;IACJ,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,UAAU,mBAAmB,CAAC,OAA4C;IAC9E,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,QAAqC;IAC5F,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,gFAAgF,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,gEAAgE,CAAC;AACvO,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,yHAAyH;QACzH,4EAA4E;QAC5E,4FAA4F;KAC7F,CAAC;AACJ,CAAC"}

package/dist/tools/metadata/derived.d.ts

@@ -0,0 +1,34 @@
+import type { ToolContractProfile, ToolMetadata, ToolRiskLevel, ToolSource } from "./types.js";
+export declare function toolPublicRoute(tool: {
+    name: string;
+}): string;
+/** 生成文档归类；少数跨 group 文档归属由集中 override 维护。 */
+export declare function toolDocsTopic(tool: {
+    name: string;
+    group: string;
+    source?: ToolSource;
+    target?: string;
+}): string;
+/** 生成可用范围；除 runtime 工具外默认是 Editor session。 */
+export declare function toolAvailabilityScope(tool: {
+    availabilityScope?: string;
+    target?: string;
+}): string;
+/** 生成工具来源，注册扩展和项目工具时由调用方提供 fallback。 */
+export declare function toolSource(tool: ToolMetadata | {
+    source?: ToolSource;
+}, fallback?: ToolSource): ToolSource;
+/** 统一 completion 保证档位；只有官方 attribute discovery 可声明弱保证。 */
+export declare function toolContractProfile(tool: {
+    contractProfile?: ToolContractProfile;
+}): ToolContractProfile;
+/** 判断工具是否可能长时间运行，用于 capability summary。 */
+export declare function isLongRunningTool(tool: {
+    name: string;
+    longRunning?: boolean;
+    sideEffects?: string[];
+}): boolean;
+/** 风险级别仅作内部派生，公开 descriptor 不投影。 */
+export declare function inferToolRiskLevel(tool: Pick<ToolMetadata, "name" | "destructiveHint" | "permissions" | "sideEffects">): ToolRiskLevel;
+/** known Tool 使用 completion contract；custom Tool 无契约时按 descriptor 风险信号保守归类。 */
+export declare function toolIsMutation(tool: Pick<ToolMetadata, "name" | "destructiveHint" | "supportsDryRun" | "sideEffects" | "playModeSupport">): boolean;

package/dist/tools/metadata/derived.js

@@ -0,0 +1,136 @@
+import { GENERATED_TOOL_COMPLETION_CONTRACTS } from "../.generated-completion-registry.js";
+const TOOL_MUTATION_CONTRACTS = new Map(GENERATED_TOOL_COMPLETION_CONTRACTS.map((contract) => [contract.toolName, contract.mutation]));
+const TOOL_PUBLIC_ROUTE_OVERRIDES = new Map([
+    ["tools.group", "tools group"],
+    ["tools.group-list", "tools group list"],
+    ["tools.search", "tools search"],
+    ["tools.describe", "tools describe"]
+]);
+export function toolPublicRoute(tool) {
+    return TOOL_PUBLIC_ROUTE_OVERRIDES.get(tool.name) ?? `tools run ${tool.name}`;
+}
+const DOCS_TOPIC_OVERRIDES = new Map([
+    ["type.schema", "reflection"]
+]);
+const LONG_RUNNING_TOOL_NAMES = new Set([
+    "asset.refresh",
+    "build.run",
+    "cinemachine.create",
+    "code.exec",
+    "editor.compile",
+    "editor.refresh",
+    "graphics.bake-start",
+    "navmesh.bake",
+    "navmesh.surface.bake",
+    "occlusion.bake",
+    "package.resolve",
+    "probuilder.create-poly-shape",
+    "probuilder.create-shape",
+    "profiler.capture",
+    "profiler.export",
+    "profiler.memory-snapshot.take",
+    "test.run"
+]);
+const CRITICAL_RISK_EFFECTS = new Set([
+    "arbitrary-method-invocation",
+    "user-code-execution"
+]);
+const HIGH_RISK_EFFECTS = new Set([
+    "asset-delete",
+    "asset-delete-nested",
+    "lightmapping-data-clear",
+    "manifest-change",
+    "object-modify",
+    "project-file-delete",
+    "project-file-write"
+]);
+const MEDIUM_RISK_EFFECTS = new Set([
+    "console-clear",
+    "editor-menu",
+    "lightmapping-bake",
+    "prefab-unlink",
+    "reflection-probe-bake",
+    "session-affecting",
+    "shader-recompile",
+    "unknown-editor-side-effect"
+]);
+const HIGH_RISK_TOOL_PREFIXES = ["object.", "scriptable-object."];
+const HIGH_RISK_TOOL_NAMES = new Set(["component.modify"]);
+const MEDIUM_RISK_TOOL_NAMES = new Set([
+    "animation.clip.create",
+    "animation.clip.modify",
+    "console.clear",
+    "graphics.bake-reflection-probe",
+    "graphics.bake-start",
+    "navmesh.bake",
+    "navmesh.bake-clear",
+    "navmesh.surface.bake",
+    "occlusion.bake",
+    "occlusion.bake-clear",
+    "material.assign",
+    "package.resolve",
+    "prefab.stage-open",
+    "scene.load",
+    "scene.save",
+    "scene.unload",
+    "screenshot.surround",
+    "test.run",
+    "texture.modify",
+    "ui.attach-document",
+    "ui.detach-document",
+    "ui.document.update",
+    "ui.link-stylesheet",
+    "ui.update-panel-settings"
+]);
+/** 生成文档归类；少数跨 group 文档归属由集中 override 维护。 */
+export function toolDocsTopic(tool) {
+    if (tool.name.startsWith("animator.") || tool.name.startsWith("controller."))
+        return "animation";
+    return DOCS_TOPIC_OVERRIDES.get(tool.name) ?? tool.group;
+}
+/** 生成可用范围；除 runtime 工具外默认是 Editor session。 */
+export function toolAvailabilityScope(tool) {
+    if (tool.availabilityScope && tool.availabilityScope !== "editorSession")
+        return tool.availabilityScope;
+    if (tool.target === "runtime")
+        return "playModeSession";
+    return "editorSession";
+}
+/** 生成工具来源，注册扩展和项目工具时由调用方提供 fallback。 */
+export function toolSource(tool, fallback = "built-in") {
+    return tool.source ?? fallback;
+}
+/** 统一 completion 保证档位；只有官方 attribute discovery 可声明弱保证。 */
+export function toolContractProfile(tool) {
+    return tool.contractProfile ?? "native";
+}
+/** 判断工具是否可能长时间运行，用于 capability summary。 */
+export function isLongRunningTool(tool) {
+    if (tool.longRunning)
+        return true;
+    if (LONG_RUNNING_TOOL_NAMES.has(tool.name))
+        return true;
+    return tool.sideEffects?.some((effect) => effect === "lightmapping-bake" || effect === "editor-long-running") ?? false;
+}
+/** 风险级别仅作内部派生，公开 descriptor 不投影。 */
+export function inferToolRiskLevel(tool) {
+    const effects = tool.sideEffects ?? [];
+    if (tool.permissions?.includes("execute-user-code") || tool.permissions?.includes("arbitrary-method-invocation") || effects.some((effect) => CRITICAL_RISK_EFFECTS.has(effect)))
+        return "critical";
+    if (HIGH_RISK_TOOL_NAMES.has(tool.name) || HIGH_RISK_TOOL_PREFIXES.some((prefix) => tool.name.startsWith(prefix)) || effects.some((effect) => HIGH_RISK_EFFECTS.has(effect)))
+        return "high";
+    if (MEDIUM_RISK_TOOL_NAMES.has(tool.name) || effects.some((effect) => MEDIUM_RISK_EFFECTS.has(effect)))
+        return "medium";
+    return tool.destructiveHint || effects.length > 0 ? "low" : "safe";
+}
+/** known Tool 使用 completion contract；custom Tool 无契约时按 descriptor 风险信号保守归类。 */
+export function toolIsMutation(tool) {
+    const contracted = TOOL_MUTATION_CONTRACTS.get(tool.name);
+    if (contracted !== undefined)
+        return contracted;
+    return tool.destructiveHint
+        || tool.supportsDryRun === true
+        || (tool.sideEffects?.length ?? 0) > 0
+        || tool.playModeSupport === "session-affecting";
+}
+//# sourceMappingURL=derived.js.map

package/dist/tools/metadata/derived.js.map

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

package/dist/tools/metadata/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tool metadata index for TS-local tools.
+ *
+ * 设计原则:
+ * - TS local Tool 的 metadata 真源是 defineTool registry。
+ * - C# built-in、Extension 与 Project-defined descriptor 都从选定实例的 live registry 读取。
+ * - static catalog 只供生成、契约和离线审计，不进入公开 discovery。
+ * - 每项能力只有一个 descriptor owner，不维护 TS 手写重复 metadata。
+ */
+import "../.generated-registry.js";
+import type { PlayModeSupport, ResolvedToolMetadata, ToolMetadata, ToolSource } from "./types.js";
+export { supportStatusForTool, toolHandler } from "./status.js";
+export { inferToolRiskLevel, isLongRunningTool, toolAvailabilityScope, toolContractProfile, toolDocsTopic, toolIsMutation, toolPublicRoute, toolSource } from "./derived.js";
+export type { PlayModeSupport, ResolvedToolMetadata, ToolCompletionContract, ToolContractProfile, ToolExample, ToolHandler, ToolMetadata, ToolSource, ToolRiskLevel, ToolSupportStatus } from "./types.js";
+/** Extension groups are discovered from extension manifests, not TS tool metadata. */
+export declare const EXTENSION_GROUPS: Set<string>;
+/** Normalize a ToolMetadata entry to include generated source and Play Mode defaults. */
+export declare function normalizeToolMetadata(tool: ToolMetadata, source?: ToolSource): ResolvedToolMetadata;
+/** 根据执行目标和副作用推导默认 Play Mode 语义。 */
+export declare function inferPlayModeSupport(tool: ToolMetadata): PlayModeSupport;
+/** Return TS-local tool metadata only. C# built-in/extension/project tools require a live bridge. */
+export declare function builtinToolMetadata(): ResolvedToolMetadata[];
+/** Return all locally registered metadata entries (TS-local only). */
+export declare function allRegisteredToolMetadata(): ResolvedToolMetadata[];
+/** Return distinct TS-local group names only. C# groups require a live bridge. */
+export declare function builtinToolGroups(): string[];
+/** Return distinct group names from locally visible metadata (TS-local only). */
+export declare function allRegisteredToolGroups(): string[];
+/** Find a single TS-local Tool by dotted name；仅供生成、契约与内部测试。 */
+export declare function findToolByName(name: string): ResolvedToolMetadata | undefined;
+/** Filter TS-local Tools by group；仅供生成、契约与内部测试。 */
+export declare function filterToolsByGroup(group: string): ResolvedToolMetadata[];
+/** Search TS-local Tools；仅供生成、契约与内部测试。 */
+export declare function searchTools(keyword: string): ResolvedToolMetadata[];