@alpsckr/unitycli 0.4.0

package/dist/tools/asset/refresh.js

@@ -0,0 +1,97 @@
+import { createHash } from "node:crypto";
+import { executeBridgePayload } from "../../bridge/index.js";
+import { withTransitionBinding } from "../../bridge/types.js";
+import { defineTool } from "../define.js";
+import { waitForEditorTransitionEnd } from "../editor/readiness.js";
+import { rejectUnavailableEditorState } from "../editor/state.js";
+import { StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "asset.refresh",
+    summary: "Reimport one Assets/ asset with content and AssetDatabase readback proof; supports --dry-run preview.",
+    description: "Reimport one Assets/ asset and return only after its continued file digest and AssetDatabase GUID are stable. Whole-database refresh has no attributable business completion identity and is rejected. forceUpdate and importRecursive map to ImportAssetOptions. Supports --dry-run to preview the planned import.",
+    group: "asset",
+    destructiveHint: false,
+    supportsDryRun: true,
+    sideEffects: ["asset-import"],
+    target: "editor",
+    playModeSupport: "editor-only",
+    timeoutMs: 30_000,
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    examples: [{ description: "Preview reimporting one asset", argv: ["tools", "run", "asset.refresh", "--input", "{\"forceUpdate\":true,\"path\":\"Assets/Textures/Icon.png\"}", "--dry-run"] }],
+    async execute(request, context) {
+        const path = request.path ?? request.assetPath ?? request.target;
+        if (!path)
+            throw new StructuredToolError("E_ASSET_REFRESH_PROOF_MISSING", "asset.refresh requires one asset path because whole-database refresh has no attributable completion proof.", ["Pass an Assets/* path to reimport one observable asset."]);
+        if (context.execution.dryRun)
+            return { dryRun: true, path, options: options(request), plannedEffects: [{ type: "asset.import", path, sideEffects: options(request) }] };
+        const deadline = context.absoluteDeadlineMs ?? Date.now() + (context.execution.timeoutMs ?? 30_000);
+        const state = await waitForEditorTransitionEnd(context, childId(context.requestId, "_asset_refresh_state"), deadline);
+        if (state.status === "blocked")
+            throw new StructuredToolError("E_UNITY_BLOCKED", "Unity Editor is blocked and cannot refresh assets.", ["Resolve the Editor blocker, then retry."], { blockers: state.blockers });
+        rejectUnavailableEditorState(state, "asset.refresh");
+        if (!state.session.known || !state.session.editorSessionId)
+            throw new StructuredToolError("E_EDITOR_SESSION_REPLACED", "asset.refresh could not bind one verified Editor session.", ["Inspect editor.state and retry after the session is stable."]);
+        if (state.status !== "ready")
+            throw new StructuredToolError("E_UNITY_TRANSITIONING", "asset.refresh requires a stable Editor generation.", ["Wait for editor.state to become ready, then retry."], undefined, true, 250);
+        if (state.state.playMode.value !== "edit")
+            throw new StructuredToolError("E_TOOL_PLAYMODE_UNAVAILABLE", "asset.refresh is editor-only and cannot run in Play Mode.", ["Exit Play Mode before running asset.refresh."], { toolName: "asset.refresh", playModeSupport: "editor-only" });
+        const flags = { ...(context.flags ?? {}), instance: state.identity.instanceId };
+        const execute = withTransitionBinding({ mode: "execute", mutation: true, absoluteDeadlineMs: deadline });
+        const observe = withTransitionBinding({ mode: "read", mutation: false, absoluteDeadlineMs: deadline });
+        let root = record((await bridge(context.requestId, "internal.asset.refresh.start", { ...request }, flags, context, execute)).data);
+        if (root.terminal !== true && (root.terminal !== false || root.accepted !== true))
+            throw invalid();
+        const rootRequestDigest = root.terminal === true ? undefined : typeof root.rootRequestDigest === "string" && /^[a-f0-9]{64}$/.test(root.rootRequestDigest) ? root.rootRequestDigest : undefined;
+        if (root.terminal !== true && !rootRequestDigest)
+            throw invalid();
+        while (root.terminal !== true) {
+            if (Date.now() >= deadline)
+                throw timeout();
+            await delay(100);
+            try {
+                root = record((await bridge(childId(context.requestId, "_asset_refresh_status"), "internal.asset.refresh.status", { rootRequestId: context.requestId, rootRequestDigest }, flags, context, observe)).data);
+            }
+            catch {
+                throw timeout();
+            }
+        }
+        return terminal(root, context.requestId);
+    },
+});
+async function bridge(requestId, command, input, flags, context, invocation) {
+    const result = await executeBridgePayload(requestId, command, input, flags, { dataDir: context.dataDir, rootAdmission: context.rootAdmission, bridgeExecute: context.bridgeExecute }, undefined, invocation);
+    if (!result.ok)
+        throw StructuredToolError.from(result.error ?? { code: "BRIDGE_CONNECTION_FAILED", message: "Live asset refresh bridge failed." });
+    return { data: result.data };
+}
+function terminal(root, requestId) {
+    const envelope = record(root.rootEnvelope);
+    if (envelope.requestId !== requestId || envelope.ok !== true)
+        throw terminalError(envelope, requestId);
+    const data = record(envelope.data);
+    const effects = effectsOf(data.plannedEffects);
+    if (typeof data.path !== "string" || typeof data.options !== "string" || data.refreshed !== true || !effects || effects.length !== 1 || effects[0].path !== data.path || effects[0].sideEffects !== undefined)
+        throw invalid();
+    return { path: data.path, options: data.options, refreshed: true, plannedEffects: effects };
+}
+function terminalError(envelope, requestId) { const error = record(envelope.error); if (envelope.requestId === requestId && envelope.ok === false && typeof error.code === "string" && typeof error.message === "string")
+    throw new StructuredToolError(error.code, error.message, strings(error.nextActions), recordOrUndefined(error.details), error.transient === true, typeof error.retryAfterMs === "number" ? error.retryAfterMs : undefined); throw invalid(); }
+function effectsOf(value) { if (!Array.isArray(value))
+    return undefined; const result = []; for (const raw of value) {
+    const effect = record(raw);
+    if (effect.type !== "asset.import" || typeof effect.path !== "string" || (effect.sideEffects !== undefined && typeof effect.sideEffects !== "string"))
+        return undefined;
+    result.push({ type: "asset.import", path: effect.path, ...(typeof effect.sideEffects === "string" ? { sideEffects: effect.sideEffects } : {}) });
+} return result; }
+function options(request) { const values = []; if (request.forceUpdate)
+    values.push("ForceUpdate"); if (request.importRecursive)
+    values.push("ImportRecursive"); return values.length === 0 ? "Default" : values.join(", "); }
+function timeout() { return new StructuredToolError("E_EXECUTION_TIMEOUT", "asset.refresh did not return a terminal result before the request deadline.", ["Inspect editor.state before deciding whether to submit a new request."]); }
+function invalid() { return new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "asset.refresh did not return a stable terminal readback.", ["Inspect UnityCliBridge.log before retrying."]); }
+function record(value) { return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
+function recordOrUndefined(value) { const result = record(value); return Object.keys(result).length > 0 ? result : undefined; }
+function strings(value) { return Array.isArray(value) ? value.filter((item) => typeof item === "string") : []; }
+function childId(root, suffix) { return root.length + suffix.length <= 200 ? root + suffix : `${root.slice(0, 160)}_${createHash("sha256").update(root).digest("hex").slice(0, 24)}${suffix}`; }
+function delay(ms) { return new Promise((resolve) => setTimeout(resolve, ms)); }
+//# sourceMappingURL=refresh.js.map

package/dist/tools/asset/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../../src/tools/asset/refresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAoB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcnD,eAAe,UAAU,CAAqE;IAC5F,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,uGAAuG;IAChH,WAAW,EAAE,qTAAqT;IAClU,KAAK,EAAE,OAAO;IACd,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,aAAa;IAC9B,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,QAAQ;IACjB,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,8DAA8D,EAAE,WAAW,CAAC,EAAE,CAAC;IAC7L,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;QACjE,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,mBAAmB,CAAC,+BAA+B,EAAE,4GAA4G,EAAE,CAAC,yDAAyD,CAAC,CAAC,CAAC;QACrP,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACxK,MAAM,QAAQ,GAAG,OAAO,CAAC,kBAAkB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QACpG,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,EAAE,QAAQ,CAAC,CAAC;QACtH,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,oDAAoD,EAAE,CAAC,yCAAyC,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClN,4BAA4B,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe;YAAE,MAAM,IAAI,mBAAmB,CAAC,2BAA2B,EAAE,2DAA2D,EAAE,CAAC,6DAA6D,CAAC,CAAC,CAAC;QACrP,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;YAAE,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,EAAE,oDAAoD,EAAE,CAAC,oDAAoD,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACzN,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,MAAM;YAAE,MAAM,IAAI,mBAAmB,CAAC,6BAA6B,EAAE,2DAA2D,EAAE,CAAC,8CAA8C,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,CAAC;QACtR,MAAM,KAAK,GAAgB,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC7F,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzG,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvG,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,8BAA8B,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;YAAE,MAAM,OAAO,EAAE,CAAC;QACnG,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;QAChM,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,iBAAiB;YAAE,MAAM,OAAO,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAAE,MAAM,OAAO,EAAE,CAAC;YAC5C,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC;gBAAC,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAAE,+BAA+B,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YACnN,MAAM,CAAC;gBAAC,MAAM,OAAO,EAAE,CAAC;YAAC,CAAC;QAC5B,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC,CAAC;AAEH,KAAK,UAAU,MAAM,CAAC,SAAiB,EAAE,OAAe,EAAE,KAAkB,EAAE,KAAkB,EAAE,OAAY,EAAE,UAAe;IAC7H,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC7M,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;IACnJ,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AACD,SAAS,QAAQ,CAAC,IAAiB,EAAE,SAAiB;IACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAAC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,EAAE,KAAK,IAAI;QAAE,MAAM,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnJ,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAAC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnF,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS;QAAE,MAAM,OAAO,EAAE,CAAC;IAC/N,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;AAC9F,CAAC;AACD,SAAS,aAAa,CAAC,QAAqB,EAAE,SAAiB,IAAW,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;IAAE,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC;AACne,SAAS,SAAS,CAAC,KAAc,IAAsC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,SAAS,CAAC,CAAC,MAAM,MAAM,GAAyB,EAAE,CAAC,CAAC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;IAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAAC,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAAC,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AACjiB,SAAS,OAAO,CAAC,OAA4B,IAAY,MAAM,MAAM,GAAa,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,WAAW;IAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,eAAe;IAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrQ,SAAS,OAAO,KAA0B,OAAO,IAAI,mBAAmB,CAAC,qBAAqB,EAAE,6EAA6E,EAAE,CAAC,uEAAuE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5P,SAAS,OAAO,KAA0B,OAAO,IAAI,mBAAmB,CAAC,iCAAiC,EAAE,0DAA0D,EAAE,CAAC,6CAA6C,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3N,SAAS,MAAM,CAAC,KAAc,IAAiB,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChJ,SAAS,iBAAiB,CAAC,KAAc,IAA6B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACjK,SAAS,OAAO,CAAC,KAAc,IAAc,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnJ,SAAS,OAAO,CAAC,IAAY,EAAE,MAAc,IAAY,OAAO,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;AACxN,SAAS,KAAK,CAAC,EAAU,IAAmB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/tools/build/run.d.ts

@@ -0,0 +1,45 @@
+declare const BUILD_TARGETS: readonly ["StandaloneWindows64", "StandaloneWindows", "StandaloneOSX", "StandaloneLinux64", "WebGL", "iOS", "Android"];
+type BuildTarget = typeof BUILD_TARGETS[number];
+export interface BuildRunRequest {
+    target?: BuildTarget;
+    output?: string;
+    targets?: BuildTarget[];
+    options?: string[];
+}
+export interface BuildArtifact {
+    outputPath: string;
+    exists: boolean;
+    hash: string | null;
+    treeHash: string | null;
+    fileCount: number;
+    size: number;
+}
+export interface BuildRunTargetResult {
+    target: BuildTarget;
+    result: "Succeeded" | "Failed" | "Cancelled" | "Unknown";
+    outputPath: string;
+    totalSize: number;
+    totalErrors: number;
+    totalWarnings: number;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    messages: Array<{
+        type: string;
+        message: string;
+    }>;
+    artifact: BuildArtifact;
+}
+export interface BuildRunResult {
+    targets: BuildRunTargetResult[];
+}
+export interface BuildRunDryRunResult {
+    dryRun: true;
+    plannedEffects: Array<{
+        type: "build-player";
+        target: BuildTarget;
+        outputPath: string;
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<BuildRunRequest, BuildRunResult | BuildRunDryRunResult>;
+export default _default;

package/dist/tools/build/run.js

@@ -0,0 +1,115 @@
+import { executeBridgePayload } from "../../bridge/index.js";
+import { withTransitionBinding } from "../../bridge/types.js";
+import { defineTool } from "../define.js";
+import { waitForEditorTransitionEnd } from "../editor/readiness.js";
+import { rejectUnavailableEditorState } from "../editor/state.js";
+import { blockerNextActions, blockerTimeoutMessage, blockersFromDetails, StructuredToolError } from "../errors.js";
+const BUILD_TARGETS = ["StandaloneWindows64", "StandaloneWindows", "StandaloneOSX", "StandaloneLinux64", "WebGL", "iOS", "Android"];
+const windowsBuildExample = { target: "StandaloneWindows64", output: "Builds/App.exe" };
+export default defineTool({
+    name: "build.run", summary: "Build player targets in the open Unity Editor and return verified artifacts.",
+    description: "Builds requested player targets serially in the selected live Unity Editor. Each target returns its BuildReport terminal summary and a fresh output artifact readback; this synchronous Editor operation cannot be cancelled after it starts.",
+    group: "build", target: "editor", destructiveHint: true, supportsDryRun: true, timeoutMs: 600_000, sideEffects: ["build-output-write", "asset-import", "compile"], playModeSupport: "editor-only", handler: "hybrid", supportStatus: "live-bridge",
+    examples: [{ description: "Build a Windows player in the open Editor.", argv: ["tools", "run", "build.run", "--input", JSON.stringify(windowsBuildExample)], input: windowsBuildExample }],
+    async execute(request, context) {
+        const targets = normalizeTargets(request);
+        const outputs = targets.map((target) => outputForTarget(request.output, target, targets.length > 1));
+        if (new Set(outputs.map(pathKey)).size !== outputs.length) {
+            throw new StructuredToolError("E_SCHEMA_INVALID", "Build targets resolve to conflicting output paths.", ["Use distinct project-relative outputs, or include {target} for multiple targets."]);
+        }
+        if (context.execution.dryRun)
+            return { dryRun: true, plannedEffects: targets.map((target, index) => ({ type: "build-player", target, outputPath: outputs[index] })) };
+        const deadline = context.absoluteDeadlineMs ?? Date.now() + (context.execution.timeoutMs ?? 30_000);
+        const state = await waitForEditorTransitionEnd(context, `${context.requestId}_build_state`, deadline);
+        if (state.status === "blocked")
+            throw new StructuredToolError("E_UNITY_BLOCKED", "Unity Editor is blocked and cannot start a player build.", ["Resolve the Editor blocker, then retry."], { blockers: state.blockers });
+        rejectUnavailableEditorState(state, "build.run");
+        if (!state.session.known || !state.session.editorSessionId)
+            throw new StructuredToolError("E_EDITOR_SESSION_REPLACED", "build.run could not bind one verified Editor session.", ["Inspect editor.state and retry after the session is stable."]);
+        if (state.status !== "ready")
+            throw new StructuredToolError("E_UNITY_TRANSITIONING", "build.run requires a stable Editor generation.", ["Wait for editor.state to become ready, then retry."], undefined, true, 250);
+        if (state.state.playMode.value !== "edit")
+            throw new StructuredToolError("E_TOOL_PLAYMODE_UNAVAILABLE", "build.run is editor-only and cannot run in Play Mode.", ["Exit Play Mode before running build.run."], { toolName: "build.run", playModeSupport: "editor-only" }, false, 0);
+        let canonicalTerminalReceived = false;
+        try {
+            const result = await executeBridgePayload(context.requestId, "internal.build.run.start", { targets: targets.map((target, index) => ({ target, outputPath: outputs[index], options: request.options ?? [] })), expectedEditorSessionId: state.session.editorSessionId }, { ...(context.flags ?? {}), instance: state.identity.instanceId }, { dataDir: context.dataDir, rootAdmission: context.rootAdmission, bridgeExecute: context.bridgeExecute }, undefined, withTransitionBinding({ mode: "execute", mutation: true, absoluteDeadlineMs: deadline }));
+            if (!result.ok)
+                throw StructuredToolError.from(result.error ?? { code: "BRIDGE_CONNECTION_FAILED", message: "Live build bridge failed." });
+            const start = record(result.data);
+            if (start.terminal !== true)
+                throw new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "build.run start did not return a terminal root envelope.", ["Inspect UnityCliBridge.log before retrying."]);
+            const envelope = record(start.rootEnvelope);
+            if (envelope.requestId !== context.requestId || typeof envelope.ok !== "boolean")
+                throw new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "build.run returned an invalid root envelope.", ["Inspect UnityCliBridge.log before retrying."]);
+            canonicalTerminalReceived = true;
+            if (envelope.ok !== true) {
+                const error = record(envelope.error);
+                const details = error.details && typeof error.details === "object" && !Array.isArray(error.details) ? record(error.details) : undefined;
+                throw new StructuredToolError(typeof error.code === "string" ? error.code : "E_BUILD_FAILED", typeof error.message === "string" ? error.message : "Build failed without a structured terminal.", Array.isArray(error.nextActions) ? error.nextActions.filter((x) => typeof x === "string") : [], details);
+            }
+            const data = record(envelope.data);
+            const verified = verifyTargets(data.targets, targets);
+            if (!verified)
+                throw new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "build.run did not return terminal BuildReport artifact proof.", ["Inspect UnityCliBridge.log before retrying."]);
+            return { targets: verified };
+        }
+        catch (error) {
+            if (canonicalTerminalReceived || (error instanceof StructuredToolError && isPreEffectBuildError(error.code)))
+                throw error;
+            throw buildTimeout(error);
+        }
+    }
+});
+function normalizeTargets(request) {
+    if (request.target !== undefined && request.targets !== undefined)
+        throw new StructuredToolError("E_SCHEMA_INVALID", "Use either target or targets, not both.", ["Pass one target or a unique targets array."]);
+    const targets = request.targets ?? [request.target ?? "StandaloneWindows64"];
+    if (!targets.length || targets.some((target) => !BUILD_TARGETS.includes(target)))
+        throw new StructuredToolError("E_SCHEMA_INVALID", `targets must contain only: ${BUILD_TARGETS.join(", ")}.`, ["Use tools describe build.run for supported targets."]);
+    if (new Set(targets).size !== targets.length)
+        throw new StructuredToolError("E_SCHEMA_INVALID", "targets must not contain duplicates.", ["Pass each BuildTarget once."]);
+    return targets;
+}
+function outputForTarget(output, target, multiple) {
+    const result = !output ? `Builds/${target}/Player` : !multiple ? output : output.includes("{target}") ? output.replace(/\{target\}/g, target) : `${output.replace(/[\\/]$/, "")}/${target}`;
+    if (!relativeProjectPath(result))
+        throw new StructuredToolError("E_SCHEMA_INVALID", "Build output must be project-relative.", ["Use a path such as Builds/App.exe."]);
+    return result.replace(/\\/g, "/");
+}
+function pathKey(path) { return process.platform === "win32" ? path.toLowerCase() : path; }
+function relativeProjectPath(path) { return path.length > 0 && !/^(?:[A-Za-z]:[\\/]|\\\\|\/)/.test(path) && !path.split(/[\\/]+/).includes(".."); }
+function record(value) { return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
+function verifyTargets(value, expectedTargets) {
+    if (!Array.isArray(value) || value.length !== expectedTargets.length)
+        return undefined;
+    const targets = [];
+    for (let index = 0; index < value.length; index += 1) {
+        const item = record(value[index]);
+        const artifact = record(item.artifact);
+        const hash = artifact.hash;
+        const treeHash = artifact.treeHash;
+        const fileCount = nonnegativeInteger(artifact.fileCount);
+        const size = nonnegativeInteger(artifact.size);
+        const durationMs = nonnegativeInteger(item.durationMs);
+        const validArtifact = typeof artifact.outputPath === "string" && artifact.outputPath === item.outputPath && relativeProjectPath(artifact.outputPath) && typeof item.outputPath === "string" && relativeProjectPath(item.outputPath) && typeof artifact.exists === "boolean" && fileCount !== undefined && size !== undefined && (hash === null || typeof hash === "string") && (treeHash === null || typeof treeHash === "string");
+        const validMessages = Array.isArray(item.messages) && item.messages.length <= 100 && item.messages.every((value) => { const message = record(value); return typeof message.type === "string" && typeof message.message === "string" && message.message.length > 0; });
+        const successfulProof = item.result !== "Succeeded" || (artifact.exists === true && fileCount !== undefined && fileCount > 0 && size !== undefined && size > 0 && (isSha256(hash) || isSha256(treeHash)));
+        if (item.target !== expectedTargets[index] || !["Succeeded", "Failed", "Cancelled", "Unknown"].includes(item.result) || nonnegativeInteger(item.totalSize) === undefined || nonnegativeInteger(item.totalErrors) === undefined || nonnegativeInteger(item.totalWarnings) === undefined || !timestamp(item.startedAt) || !timestamp(item.finishedAt) || durationMs === undefined || !validMessages || !validArtifact || !successfulProof)
+            return undefined;
+        targets.push(item);
+    }
+    return targets;
+}
+function isSha256(value) { return typeof value === "string" && /^[a-f0-9]{64}$/i.test(value); }
+function timestamp(value) { return typeof value === "string" && Number.isFinite(Date.parse(value)); }
+function nonnegativeInteger(value) { return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined; }
+function buildTimeout(error) {
+    const cause = error instanceof StructuredToolError ? error : undefined;
+    const blockers = blockersFromDetails(cause?.details);
+    return new StructuredToolError("E_EXECUTION_TIMEOUT", blockerTimeoutMessage("build.run", blockers), blockers ? blockerNextActions() : ["Inspect the build output and editor.state before retrying."], {
+        causeCode: cause?.code ?? "BRIDGE_CONNECTION_FAILED",
+        ...(blockers ? { blockers } : {}),
+    }, false, 0);
+}
+function isPreEffectBuildError(code) { return new Set(["E_SCHEMA_INVALID", "E_EDITOR_SESSION_REPLACED", "E_BUILD_SCENES_EMPTY", "E_TOOL_PLAYMODE_UNAVAILABLE", "E_UNITY_BLOCKED", "E_UNITY_TRANSITIONING", "E_UNITY_UNRESPONSIVE", "E_INSTANCE_NOT_RUNNING", "E_INSTANCE_UNVERIFIABLE", "E_INSTANCE_CONFLICT"]).has(code); }
+//# sourceMappingURL=run.js.map

package/dist/tools/build/run.js.map

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

package/dist/tools/catalog.d.ts

@@ -0,0 +1,33 @@
+import { type ProjectToolRuntime } from "../project-tool-discovery.js";
+import type { CliResult } from "../types.js";
+import { type ToolMetadata } from "./metadata/index.js";
+export type ToolCatalogRuntime = ProjectToolRuntime & {
+    dataDir?: string;
+};
+export type ToolCatalogResult = {
+    ok: true;
+    tools: ToolMetadata[];
+} | (CliResult & {
+    ok: false;
+});
+/** 统一状态观察与弹窗恢复必须在Live catalog被transition或modal阻断时仍进入原dispatcher。 */
+export declare function resolveCatalogIndependentOperabilityTool(name: string): ToolMetadata | undefined;
+/** 只允许exact operability调用及其describe学习入口使用本地descriptor。 */
+export declare function resolveCatalogIndependentInvocationTool(name: string, describedName?: string): ToolMetadata | undefined;
+/** package snapshot 中的 C# built-in/Extension descriptor，仅供生成、契约和离线审计使用。 */
+export declare function staticBridgeToolMetadata(): ToolMetadata[];
+/**
+ * 读取当前实例的唯一完整 Tool catalog。
+ * project-tool.list 返回全部注册能力；runtime-tool.list 只补充同一注册在当前 PlayMode 下的 availability。
+ */
+export declare function loadToolCatalog(flags: Record<string, string | boolean>, runtime: ToolCatalogRuntime, requestId: string): Promise<ToolCatalogResult>;
+/** 按名称解析Tool；只有exact operability能力能在transition/modal下使用frozen本地descriptor。 */
+export declare function resolveCatalogTool(name: string, flags: Record<string, string | boolean>, runtime: ToolCatalogRuntime, requestId: string): Promise<{
+    ok: true;
+    tool?: ToolMetadata;
+} | (CliResult & {
+    ok: false;
+})>;
+export declare function uniqueByName(tools: ToolMetadata[]): ToolMetadata[];
+/** 输出调用所需的精简 descriptor；完整结果 schema 只保留在内部 metadata。 */
+export declare function publicToolDescriptor(tool: ToolMetadata): Record<string, unknown>;

package/dist/tools/catalog.js

@@ -0,0 +1,202 @@
+import { discoverProjectTools, discoverRuntimeTools, projectDescriptorToToolMetadata } from "../project-tool-discovery.js";
+import { staticCapabilityCatalog } from "../static-capability-catalog.js";
+import { failure } from "../output.js";
+import { GENERATED_TOOL_COMPLETION_CONTRACTS } from "./.generated-completion-registry.js";
+import { builtinToolMetadata, findToolByName, toolContractProfile } from "./metadata/index.js";
+const OFFICIAL_ATTRIBUTE_PREFIX = "UnityPipeline_";
+const OFFICIAL_ATTRIBUTE_GROUP = "UnityPipeline";
+const CATALOG_INDEPENDENT_OPERABILITY_TOOLS = new Set(["editor.state", "editor.dialogs", "editor.dialog.click"]);
+/** 统一状态观察与弹窗恢复必须在Live catalog被transition或modal阻断时仍进入原dispatcher。 */
+export function resolveCatalogIndependentOperabilityTool(name) {
+    if (!CATALOG_INDEPENDENT_OPERABILITY_TOOLS.has(name))
+        return undefined;
+    const tool = findToolByName(name);
+    return tool?.handler === "offline" ? tool : undefined;
+}
+/** 只允许exact operability调用及其describe学习入口使用本地descriptor。 */
+export function resolveCatalogIndependentInvocationTool(name, describedName) {
+    const operabilityTool = resolveCatalogIndependentOperabilityTool(name);
+    if (operabilityTool)
+        return operabilityTool;
+    if (name !== "tools.describe" || !describedName || !resolveCatalogIndependentOperabilityTool(describedName))
+        return undefined;
+    const describeTool = findToolByName("tools.describe");
+    return describeTool?.handler === "offline" ? describeTool : undefined;
+}
+/** package snapshot 中的 C# built-in/Extension descriptor，仅供生成、契约和离线审计使用。 */
+export function staticBridgeToolMetadata() {
+    const bridgeContracts = new Map(GENERATED_TOOL_COMPLETION_CONTRACTS
+        .filter((contract) => contract.descriptorOwner === "built-in" || contract.descriptorOwner.startsWith("extension:"))
+        .map((contract) => [contract.toolName, contract]));
+    return staticCapabilityCatalog().tools.filter((descriptor) => bridgeContracts.has(String(descriptor.name ?? ""))).map((descriptor) => {
+        const name = String(descriptor.name ?? "");
+        const tool = projectDescriptorToToolMetadata({ ...descriptor, contractProfile: "native", completionContract: bridgeContracts.get(name) });
+        if (!tool)
+            throw new Error(`Malformed static Tool descriptor: ${String(descriptor.name ?? "unknown")}`);
+        return tool;
+    });
+}
+/**
+ * 读取当前实例的唯一完整 Tool catalog。
+ * project-tool.list 返回全部注册能力；runtime-tool.list 只补充同一注册在当前 PlayMode 下的 availability。
+ */
+export async function loadToolCatalog(flags, runtime, requestId) {
+    const editorAdmission = runtime.rootAdmissions?.editor ?? (runtime.rootAdmission?.target === "editor" ? runtime.rootAdmission : undefined);
+    const runtimeAdmission = runtime.rootAdmissions?.runtime ?? (runtime.rootAdmission?.target === "runtime" ? runtime.rootAdmission : undefined);
+    const editorRuntime = { ...runtime, rootAdmission: editorAdmission };
+    const runtimeTargetRuntime = { ...runtime, rootAdmission: runtimeAdmission };
+    const editorRequestId = editorRuntime.rootAdmission?.requestId ?? `${requestId}_editor_catalog`;
+    const runtimeRequestId = runtimeTargetRuntime.rootAdmission?.requestId ?? `${requestId}_runtime_catalog`;
+    const editor = await discoverProjectTools(flags, editorRuntime, editorRequestId, { requireBridge: true });
+    if (editor.ok === false && editor.error?.code !== "E_INSTANCE_NOT_RUNNING")
+        return editor;
+    const runtimeCatalog = await discoverRuntimeTools(flags, runtimeTargetRuntime, runtimeRequestId, { requireBridge: true });
+    if (runtimeCatalog.ok === false && runtimeCatalog.error?.code !== "E_RUNTIME_NOT_RUNNING")
+        return runtimeCatalog;
+    if (editor.ok === false && runtimeCatalog.ok === false)
+        return editor;
+    // 一个 target 离线不应隐藏另一个 target 的 catalog；descriptor 仍只有 live owner，不建立静态副本。
+    return mergeLiveToolCatalog(requestId, builtinToolMetadata(), editor.ok ? editor.tools : [], runtimeCatalog.ok ? runtimeCatalog.tools : []);
+}
+/** 按名称解析Tool；只有exact operability能力能在transition/modal下使用frozen本地descriptor。 */
+export async function resolveCatalogTool(name, flags, runtime, requestId) {
+    const operabilityTool = resolveCatalogIndependentOperabilityTool(name);
+    if (operabilityTool)
+        return { ok: true, tool: operabilityTool };
+    const catalog = await loadToolCatalog(flags, runtime, requestId);
+    return catalog.ok ? { ok: true, tool: catalog.tools.find((tool) => tool.name === name) } : catalog;
+}
+/**
+ * package 本地 Tool 与 live Tool 必须名称唯一；runtime 列表只能覆盖同一 live registration 的动态 availability。
+ * 未经证明的同名覆盖会让来源影响路由，因此必须 fail closed。
+ */
+function mergeLiveToolCatalog(requestId, localTools, editorTools, runtimeTools) {
+    const tools = new Map();
+    const liveNames = new Set();
+    for (const tool of [...localTools, ...editorTools, ...runtimeTools]) {
+        const namespaceViolation = officialAttributeNamespaceViolation(tool);
+        if (namespaceViolation)
+            return toolCatalogConflict(requestId, tool.name, namespaceViolation);
+    }
+    for (const tool of localTools)
+        tools.set(tool.name, tool);
+    for (const tool of editorTools) {
+        if (tools.has(tool.name))
+            return toolCatalogConflict(requestId, tool.name, "package-local and live registrations use the same name");
+        tools.set(tool.name, tool);
+        liveNames.add(tool.name);
+    }
+    for (const runtimeTool of runtimeTools) {
+        const current = tools.get(runtimeTool.name);
+        if (!current) {
+            tools.set(runtimeTool.name, runtimeTool);
+            liveNames.add(runtimeTool.name);
+            continue;
+        }
+        if (!liveNames.has(runtimeTool.name) || !sameLiveRegistration(current, runtimeTool)) {
+            return toolCatalogConflict(requestId, runtimeTool.name, "runtime registration does not match the instance Tool registry");
+        }
+        if (current.target === "runtime") {
+            tools.set(runtimeTool.name, {
+                ...current,
+                available: runtimeTool.available,
+                ...(runtimeTool.unavailableReason ? { unavailableReason: runtimeTool.unavailableReason } : {}),
+            });
+        }
+    }
+    return { ok: true, tools: [...tools.values()].sort((left, right) => left.name.localeCompare(right.name)) };
+}
+/** 保留namespace与contract profile必须双向一致，禁止native或伪attribute descriptor借名路由。 */
+function officialAttributeNamespaceViolation(tool) {
+    const officialAttribute = toolContractProfile(tool) === "official-attribute";
+    const usesPrefix = tool.name.startsWith(OFFICIAL_ATTRIBUTE_PREFIX);
+    const usesGroup = tool.group === OFFICIAL_ATTRIBUTE_GROUP;
+    if (officialAttribute && (!usesPrefix || !usesGroup))
+        return "official-attribute registration must use the UnityPipeline_ prefix and UnityPipeline group";
+    if (!officialAttribute && (usesPrefix || usesGroup))
+        return "native registration cannot use the reserved UnityPipeline_ prefix or UnityPipeline group";
+    return undefined;
+}
+/** runtime availability 必须来自同一份 live descriptor，不能借同名切换 owner。 */
+function sameLiveRegistration(left, right) {
+    if (left.group !== right.group || left.target !== right.target || toolContractProfile(left) !== toolContractProfile(right))
+        return false;
+    if (left.liveDescriptorFingerprint || right.liveDescriptorFingerprint) {
+        return left.liveDescriptorFingerprint === right.liveDescriptorFingerprint;
+    }
+    return JSON.stringify(left.inputSchema) === JSON.stringify(right.inputSchema)
+        && JSON.stringify(left.outputSchema) === JSON.stringify(right.outputSchema);
+}
+/** 返回稳定的 catalog ownership 冲突，不允许静默覆盖。 */
+function toolCatalogConflict(requestId, name, reason) {
+    return failure(requestId, "E_TOOL_SCHEMA_CONFLICT", `Tool catalog conflict for ${name}: ${reason}.`, [
+        "Fix the duplicate Tool registration in the selected Unity project, then retry discovery."
+    ], { toolName: name, reason });
+}
+export function uniqueByName(tools) {
+    const result = new Map();
+    for (const tool of tools)
+        result.set(tool.name, tool);
+    return [...result.values()];
+}
+/** 输出调用所需的精简 descriptor；完整结果 schema 只保留在内部 metadata。 */
+export function publicToolDescriptor(tool) {
+    if (!tool.outputSchema)
+        throw new Error(`Tool ${tool.name} is missing outputSchema.`);
+    const available = tool.available ?? true;
+    if (!available && !tool.unavailableReason)
+        throw new Error(`Unavailable Tool ${tool.name} is missing unavailableReason.`);
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        destructiveHint: tool.destructiveHint,
+        ...(tool.sideEffects?.length ? { sideEffects: tool.sideEffects } : {}),
+        playModeSupport: tool.playModeSupport ?? "supported",
+        supportsDryRun: tool.supportsDryRun ?? false,
+        ...(tool.examples?.length ? { examples: tool.examples.map((example) => publicToolExample(tool.name, example)) } : {}),
+        target: tool.target ?? "editor",
+        ...(!available ? { available: false, unavailableReason: tool.unavailableReason } : {}),
+        ...(tool.requiresPackages?.length ? { requiresPackages: tool.requiresPackages } : {})
+    };
+}
+/** 将内部 argv authoring 形态投影为无 CLI 语法重复的业务示例。 */
+function publicToolExample(toolName, example) {
+    const execution = publicExampleExecution(toolName, example);
+    return {
+        description: example.description,
+        input: publicExampleInput(toolName, example),
+        ...(execution ? { execution } : {})
+    };
+}
+/** 优先使用 typed input；旧 authoring 仅有 argv 时解析同一个 --input JSON。 */
+function publicExampleInput(toolName, example) {
+    if (example.input !== undefined)
+        return example.input;
+    const inputIndex = example.argv.indexOf("--input");
+    if (inputIndex < 0)
+        return {};
+    try {
+        const input = JSON.parse(example.argv[inputIndex + 1] ?? "");
+        if (!input || typeof input !== "object" || Array.isArray(input))
+            throw new Error("input must be an object");
+        return input;
+    }
+    catch (error) {
+        throw new Error(`Tool ${toolName} has an invalid example input: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/** 从 authoring metadata 或 argv 提取 dry-run/timeout 控制，不混入业务 input。 */
+function publicExampleExecution(toolName, example) {
+    const dryRun = example.execution?.dryRun === true || example.argv.includes("--dry-run");
+    const timeoutIndex = example.argv.indexOf("--timeout-ms");
+    const attachedTimeout = example.argv.find((token) => token.startsWith("--timeout-ms="))?.slice("--timeout-ms=".length);
+    const timeoutRaw = example.execution?.timeoutMs ?? (timeoutIndex >= 0 ? Number(example.argv[timeoutIndex + 1]) : attachedTimeout === undefined ? undefined : Number(attachedTimeout));
+    if (timeoutRaw !== undefined && (!Number.isFinite(timeoutRaw) || timeoutRaw <= 0)) {
+        throw new Error(`Tool ${toolName} has an invalid example timeoutMs.`);
+    }
+    if (!dryRun && timeoutRaw === undefined)
+        return undefined;
+    return { ...(dryRun ? { dryRun: true } : {}), ...(timeoutRaw !== undefined ? { timeoutMs: timeoutRaw } : {}) };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/tools/catalog.js.map

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

package/dist/tools/code/exec.d.ts

@@ -0,0 +1,53 @@
+import type { AnyJson } from "../../schema/any-json.js";
+import type { CompletionProbe, CompletionProbeReadback } from "../completion-probe.js";
+export interface CodeExecRequest {
+    file?: string;
+    stdin?: boolean;
+    code?: string;
+    refs?: string[];
+    define?: string[];
+    args?: CodeExecJsonObject;
+    completionProbe?: CompletionProbe;
+}
+export interface CodeExecJsonObject {
+    [key: string]: AnyJson;
+}
+export interface CodeExecDiagnostic {
+    severity: string;
+    id: string;
+    message: string;
+    file: string;
+    line: number;
+    column: number;
+    span: AnyJson;
+}
+export interface CodeExecResult {
+    compile: {
+        diagnostics: CodeExecDiagnostic[];
+    };
+    runtime: {
+        returnValue: AnyJson;
+        stdout: string;
+        stderr: string;
+        stdoutTruncated: boolean;
+        stderrTruncated: boolean;
+    };
+    completion: CompletionProbeReadback | null;
+}
+export interface CodeExecDryRunResult {
+    dryRun: true;
+    preview: {
+        sourceKind: string;
+        sourcePath?: string;
+        sourceSha256: string;
+        sourceSizeBytes: number;
+        timeoutMs: number;
+        args: CodeExecJsonObject;
+    };
+    plannedEffects: Array<{
+        type: "code.exec";
+        sideEffects: string;
+    }>;
+}
+declare const _default: import("../define.js").ToolDefinition<CodeExecRequest, CodeExecResult | CodeExecDryRunResult>;
+export default _default;