@alpsckr/unitycli 0.4.0

package/dist/tools/runtime/ui/capture-element.d.ts

@@ -0,0 +1,31 @@
+export interface RuntimeCaptureElementRequest {
+    selector: string;
+    panel?: string;
+}
+export interface RuntimeCaptureElementInfo {
+    name: string;
+    type: string;
+    width: number;
+    height: number;
+}
+export interface RuntimeCaptureArtifact {
+    path: string;
+    size: number;
+    sha256: string;
+    mimeType: "image/png";
+}
+export interface RuntimeCaptureElementResult {
+    runtimeSessionId: string;
+    dryRun: boolean;
+    captured: boolean;
+    panel: string;
+    selector: string;
+    element: RuntimeCaptureElementInfo;
+    artifact?: RuntimeCaptureArtifact;
+    plannedEffects: Array<{
+        type: "runtime-element-capture";
+        artifactName: "runtime-element.png";
+    }>;
+}
+declare const _default: import("../../define.js").ToolDefinition<RuntimeCaptureElementRequest, RuntimeCaptureElementResult>;
+export default _default;

package/dist/tools/runtime/ui/capture-element.js

@@ -0,0 +1,17 @@
+import { defineTool } from "../../define.js";
+export default defineTool({
+    name: "runtime.ui.capture-element",
+    summary: "Capture one bounded UI Toolkit element from a development Player.",
+    description: "Resolve one bounded selector in one live runtime UIDocument panel and write a PNG to the request artifact directory. The Tool is catalog-visible on supported projects but executes only on Unity 6000.7 or newer; it never returns base64 or accepts an output path.",
+    group: "runtime",
+    handler: "bridge-runtime",
+    target: "runtime",
+    destructiveHint: false,
+    sideEffects: ["artifact-write"],
+    supportsDryRun: true,
+    playModeSupport: "runtime-only",
+    timeoutMs: 15_000,
+    examples: [{ description: "Capture the uniquely named runtime status label.", argv: ["tools", "run", "runtime.ui.capture-element", "--input", "{\"selector\":\"#status-label\"}"], input: { selector: "#status-label" } }],
+    execute() { throw new Error("runtime.ui.capture-element must execute through the bridge-runtime dispatcher"); },
+});
+//# sourceMappingURL=capture-element.js.map

package/dist/tools/runtime/ui/capture-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-element.js","sourceRoot":"","sources":["../../../../src/tools/runtime/ui/capture-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgB7C,eAAe,UAAU,CAA4D;IACnF,IAAI,EAAE,4BAA4B;IAClC,OAAO,EAAE,mEAAmE;IAC5E,WAAW,EAAE,uQAAuQ;IACpR,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,CAAC,gBAAgB,CAAC;IAC/B,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,cAAc;IAC/B,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,4BAA4B,EAAE,SAAS,EAAE,kCAAkC,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,CAAC;IAC1N,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC,CAAC,CAAC;CAChH,CAAC,CAAC"}

package/dist/tools/test/cancel.d.ts

@@ -0,0 +1,19 @@
+export interface TestCancelRequest {
+}
+export interface TestCancelPlannedEffect {
+    type: "test-run-cancel";
+    rootRequestId: string;
+    runId: string;
+}
+export interface TestCancelResult {
+    cancelled: boolean;
+    dryRun: boolean;
+    rootRequestId: string;
+    runId: string;
+    platform: "EditMode" | "PlayMode";
+    activeRunIds: string[];
+    editorSessionId: string;
+    plannedEffects: TestCancelPlannedEffect[];
+}
+declare const _default: import("../define.js").ToolDefinition<TestCancelRequest, TestCancelResult>;
+export default _default;

package/dist/tools/test/cancel.js

@@ -0,0 +1,94 @@
+import { createHash } from "node:crypto";
+import { executeBridgePayload } from "../../bridge/index.js";
+import { withTransitionBinding } from "../../bridge/types.js";
+import { defineTool } from "../define.js";
+import { readEditorState, rejectUnavailableEditorState } from "../editor/state.js";
+import { StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "test.cancel",
+    summary: "Cancel only the exact active test.run operation and prove its Unity Test Runner GUID is inactive.",
+    description: "Targets only the test.run coordinator-owned operation in the selected Editor session. Before cancellation, the coordinator requires one running TestJobData GUID that exactly matches the tracked root. It invokes OnRunCancel only on that TestJobData editModeRunner, then returns after the same GUID disappears from active Unity Test Framework runs. It never sends Escape, exits arbitrary Play Mode, or controls an unowned Test Runner operation.",
+    group: "test",
+    target: "editor",
+    destructiveHint: false,
+    supportsDryRun: true,
+    timeoutMs: 60_000,
+    playModeSupport: "supported",
+    sideEffects: ["test-run-cancel"],
+    handler: "hybrid",
+    supportStatus: "live-bridge",
+    examples: [
+        { description: "Cancel the exact tracked test.run operation.", argv: ["tools", "run", "test.cancel"] },
+        { description: "Preview the exact run identity without cancelling it.", argv: ["tools", "run", "test.cancel", "--dry-run"] },
+    ],
+    async execute(_request, context) {
+        const deadline = context.absoluteDeadlineMs ?? Date.now() + (context.execution.timeoutMs ?? 60_000);
+        const state = await readEditorState({ requestId: childId(context.requestId, "_cancel_state"), flags: context.flags, dataDir: context.dataDir, rootAdmission: context.rootAdmission, bridgeExecute: context.bridgeExecute, absoluteDeadlineMs: deadline });
+        if (state.status === "blocked")
+            throw new StructuredToolError("E_UNITY_BLOCKED", "Unity Editor is blocked and cannot cancel tests through the main thread.", ["Resolve the Editor blocker, then retry."], { blockers: state.blockers });
+        rejectUnavailableEditorState(state, "test.cancel");
+        if (!state.session.known || !state.session.editorSessionId)
+            throw new StructuredToolError("E_EDITOR_SESSION_REPLACED", "test.cancel could not bind one verified Editor session.", ["Inspect editor.state before retrying."]);
+        const flags = { ...(context.flags ?? {}), instance: state.identity.instanceId };
+        const observe = withTransitionBinding({ mode: "read", mutation: false, absoluteDeadlineMs: deadline });
+        const execute = withTransitionBinding({ mode: "execute", mutation: true, absoluteDeadlineMs: deadline });
+        if (context.execution.dryRun) {
+            const response = await call(context.requestId, "internal.test.run.cancel.plan", { expectedEditorSessionId: state.session.editorSessionId }, flags, context, observe);
+            return result(record(response.data), true);
+        }
+        let accepted = false;
+        try {
+            const started = record((await call(context.requestId, "internal.test.run.cancel", { expectedEditorSessionId: state.session.editorSessionId }, flags, context, execute)).data);
+            if (started.terminal === true)
+                return result(record(started.result), false);
+            const rootRequestDigest = string(started.rootRequestDigest);
+            if (started.terminal !== false || started.accepted !== true || !string(started.runId) || !string(started.rootRequestId) || !rootRequestDigest || !sha256(rootRequestDigest))
+                throw invalid();
+            accepted = true;
+            for (;;) {
+                if (Date.now() >= deadline)
+                    throw timeout("E_EXECUTION_TIMEOUT");
+                const status = record((await call(childId(context.requestId, "_cancel_status"), "internal.test.run.cancel.status", { cancelRequestId: context.requestId, rootRequestDigest }, flags, context, observe)).data);
+                if (status.terminal === true)
+                    return result(record(status.result), false);
+                if (status.terminal !== false || status.accepted !== true || status.runId !== started.runId || status.rootRequestId !== started.rootRequestId)
+                    throw invalid();
+                await delay(100);
+            }
+        }
+        catch (error) {
+            if (!accepted || error instanceof StructuredToolError && error.code === "E_EXECUTION_TIMEOUT")
+                throw error;
+            throw timeout(error instanceof StructuredToolError ? error.code : "BRIDGE_CONNECTION_FAILED");
+        }
+    },
+});
+async function call(requestId, command, input, flags, context, invocation) {
+    const response = await executeBridgePayload(requestId, command, input, flags, { dataDir: context.dataDir, rootAdmission: context.rootAdmission, bridgeExecute: context.bridgeExecute }, undefined, invocation);
+    if (!response.ok)
+        throw StructuredToolError.from(response.error ?? { code: "BRIDGE_CONNECTION_FAILED", message: "Live test cancellation bridge failed." });
+    return response;
+}
+function result(value, dryRun) {
+    const runId = string(value.runId);
+    const rootRequestId = string(value.rootRequestId);
+    const session = string(value.editorSessionId);
+    const active = Array.isArray(value.activeRunIds) ? value.activeRunIds.filter((item) => typeof item === "string") : undefined;
+    const effects = Array.isArray(value.plannedEffects) ? value.plannedEffects : undefined;
+    const platform = value.platform;
+    if (!runId || !guid(runId) || !rootRequestId || !session || !active || active.length !== value.activeRunIds.length || !effects || effects.length !== 1 || platform !== "EditMode" && platform !== "PlayMode" || value.dryRun !== dryRun || value.cancelled !== !dryRun)
+        throw invalid();
+    const effect = record(effects[0]);
+    if (effect.type !== "test-run-cancel" || effect.runId !== runId || effect.rootRequestId !== rootRequestId || !dryRun && active.includes(runId))
+        throw invalid();
+    return value;
+}
+function invalid() { return new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "test.cancel did not return an exact inactive Test Runner GUID proof.", ["Inspect UnityCliBridge.log before retrying."]); }
+function timeout(causeCode) { return new StructuredToolError("E_EXECUTION_TIMEOUT", "test.cancel did not reach a proven terminal before the deadline.", ["Inspect test.run and editor.state before deciding whether to retry."], { causeCode }, false, 0); }
+function record(value) { return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
+function string(value) { return typeof value === "string" && value.length > 0 ? value : undefined; }
+function guid(value) { return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value); }
+function sha256(value) { return /^[0-9a-f]{64}$/.test(value); }
+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=cancel.js.map

package/dist/tools/test/cancel.js.map

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

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

@@ -0,0 +1,39 @@
+export interface TestRunRequest {
+    platform?: "EditMode" | "PlayMode";
+    testNames?: string[];
+    groupNames?: string[];
+    categoryNames?: string[];
+    assemblyNames?: string[];
+    xml?: boolean;
+}
+export interface TestFailure {
+    fullName: string;
+    message: string;
+    stackTrace: string;
+    duration: number;
+}
+export interface TestXmlArtifact {
+    path: string;
+    kind: "nunit-xml";
+    hash: string;
+    size: number;
+}
+export interface TestRunSummary {
+    platform: "EditMode" | "PlayMode";
+    status: "passed" | "failed";
+    testCount: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    inconclusive: number;
+    duration: number;
+    startedAt: string;
+    finishedAt: string;
+}
+export interface TestRunResult {
+    summary: TestRunSummary;
+    failures: TestFailure[];
+    xml?: TestXmlArtifact;
+}
+declare const _default: import("../define.js").ToolDefinition<TestRunRequest, TestRunResult>;
+export default _default;

package/dist/tools/test/run.js

@@ -0,0 +1,101 @@
+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 { blockerNextActions, blockerTimeoutMessage, blockersFromDetails, StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "test.run", summary: "Run tests in the open Unity Editor and return the final test result.",
+    description: "Runs EditMode or PlayMode tests through the open Unity Editor Test Runner. The same requestId resumes a completed callback terminal after a lost response; a running test run is never replayed.",
+    group: "test", target: "editor", destructiveHint: false, timeoutMs: 600_000, sideEffects: ["session-affecting"], playModeSupport: "session-affecting", handler: "hybrid", supportStatus: "live-bridge",
+    examples: [{ description: "Run EditMode tests in the open Editor.", argv: ["tools", "run", "test.run", "--input", "{\"platform\":\"EditMode\"}"] }],
+    async execute(request, context) {
+        const deadline = context.absoluteDeadlineMs ?? Date.now() + (context.execution.timeoutMs ?? 30_000);
+        const state = await waitForEditorTransitionEnd(context, childId(context.requestId, "_test_state"), deadline);
+        if (state.status === "blocked")
+            throw new StructuredToolError("E_UNITY_BLOCKED", "Unity Editor is blocked and cannot start tests.", ["Resolve the Editor blocker, then retry."], { blockers: state.blockers });
+        rejectUnavailableEditorState(state, "test.run");
+        if (!state.session.known || !state.session.editorSessionId)
+            throw new StructuredToolError("E_EDITOR_SESSION_REPLACED", "test.run could not bind one verified Editor session.", ["Inspect editor.state and retry after the session is stable."]);
+        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 accepted = false;
+        let terminalReceived = false;
+        try {
+            let root = record((await call(context.requestId, "internal.test.run.start", { ...request, platform: request.platform ?? "EditMode", expectedEditorSessionId: state.session.editorSessionId }, flags, context, execute)).data);
+            accepted = root.accepted === true || root.terminal === true;
+            const rootRequestDigest = root.terminal === true ? undefined : string(root.rootRequestDigest);
+            if (root.terminal !== true && !sha(rootRequestDigest))
+                throw invalid();
+            while (root.terminal !== true) {
+                if (root.terminal !== false || root.accepted !== true)
+                    throw invalid();
+                if (Date.now() >= deadline)
+                    throw executionTimeout("E_EXECUTION_TIMEOUT");
+                await delay(100);
+                root = record((await call(childId(context.requestId, "_test_status"), "internal.test.run.status", { rootRequestId: context.requestId, rootRequestDigest }, flags, context, observe)).data);
+            }
+            terminalReceived = true;
+            return terminal(root, context.requestId);
+        }
+        catch (error) {
+            if (terminalReceived || !accepted || (error instanceof StructuredToolError && error.code === "E_EXECUTION_TIMEOUT"))
+                throw error;
+            throw executionTimeoutFrom(error);
+        }
+    }
+});
+async function call(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 test bridge failed." }); return result; }
+function terminal(root, requestId) {
+    const envelope = record(root.rootEnvelope);
+    if (envelope.requestId !== requestId || typeof envelope.ok !== "boolean")
+        throw invalid();
+    if (envelope.ok !== true) {
+        const error = record(envelope.error);
+        const details = recordOrUndefined(error.details);
+        if ((error.code === "E_TESTS_FAILED" || error.code === "E_TESTS_NOT_FOUND" || error.code === "E_TEST_ARTIFACT_WRITE_FAILED") && !testResult(details, true))
+            throw invalid();
+        throw new StructuredToolError(string(error.code) ?? "E_EXECUTION_TIMEOUT", string(error.message) ?? "Test run failed without a structured terminal.", strings(error.nextActions), details, typeof error.transient === "boolean" ? error.transient : undefined, integer(error.retryAfterMs) ? error.retryAfterMs : undefined);
+    }
+    const result = testResult(record(envelope.data), false);
+    if (!result || result.summary.status !== "passed")
+        throw invalid();
+    return result;
+}
+function testResult(value, allowFailed) {
+    if (!value)
+        return undefined;
+    const summary = record(value.summary);
+    const failures = Array.isArray(value.failures) ? value.failures : undefined;
+    if (!validSummary(summary) || (!allowFailed && summary.status !== "passed") || !failures || !failures.every(validFailure))
+        return undefined;
+    const result = { summary: summary, failures: failures };
+    if (value.xml !== undefined) {
+        const xml = record(value.xml);
+        if (xml.kind !== "nunit-xml" || !string(xml.path) || !sha(xml.hash) || !integer(xml.size) || xml.size === 0)
+            return undefined;
+        result.xml = xml;
+    }
+    return result;
+}
+function validSummary(x) { return (x.platform === "EditMode" || x.platform === "PlayMode") && (x.status === "passed" || x.status === "failed") && ["testCount", "passed", "failed", "skipped", "inconclusive"].every(k => integer(x[k])) && typeof x.duration === "number" && x.duration >= 0 && timestamp(x.startedAt) && timestamp(x.finishedAt); }
+function validFailure(x) { const r = record(x); return !!string(r.fullName) && typeof r.message === "string" && typeof r.stackTrace === "string" && typeof r.duration === "number" && r.duration >= 0; }
+function invalid() { return new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "test.run did not return a RunFinished terminal result.", ["Inspect UnityCliBridge.log before retrying."]); }
+function executionTimeout(causeCode, details) {
+    const blockers = blockersFromDetails(details);
+    return new StructuredToolError("E_EXECUTION_TIMEOUT", blockerTimeoutMessage("test.run", blockers), blockers ? blockerNextActions() : ["Inspect editor.state before retrying."], { causeCode, ...(blockers ? { blockers } : {}) }, false, 0);
+}
+function executionTimeoutFrom(error) { const cause = error instanceof StructuredToolError ? error : undefined; return executionTimeout(cause?.code ?? "BRIDGE_CONNECTION_FAILED", cause?.details); }
+function record(value) { return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
+function recordOrUndefined(value) { const r = record(value); return Object.keys(r).length ? r : undefined; }
+function string(value) { return typeof value === "string" ? value : undefined; }
+function strings(value) { return Array.isArray(value) ? value.filter((x) => typeof x === "string") : []; }
+function integer(value) { return typeof value === "number" && Number.isSafeInteger(value) && value >= 0; }
+function sha(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 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=run.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/tools/test/run.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,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAQnH,eAAe,UAAU,CAAgC;IACvD,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,sEAAsE;IACjG,WAAW,EAAE,kMAAkM;IAC/M,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,mBAAmB,CAAC,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa;IACtM,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,wCAAwC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,6BAA6B,CAAC,EAAE,CAAC;IACnJ,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,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,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC7G,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,iDAAiD,EAAE,CAAC,yCAAyC,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/M,4BAA4B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe;YAAE,MAAM,IAAI,mBAAmB,CAAC,2BAA2B,EAAE,sDAAsD,EAAE,CAAC,6DAA6D,CAAC,CAAC,CAAC;QAChP,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,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,yBAAyB,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,UAAU,EAAE,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9N,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;YAC5D,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9F,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC;gBAAE,MAAM,OAAO,EAAE,CAAC;YACvE,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;oBAAE,MAAM,OAAO,EAAE,CAAC;gBACvE,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;oBAAE,MAAM,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;gBAC1E,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjB,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,0BAA0B,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7L,CAAC;YACD,gBAAgB,GAAG,IAAI,CAAC;YACxB,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,gBAAgB,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC;gBAAE,MAAM,KAAK,CAAC;YACjI,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AACH,KAAK,UAAU,IAAI,CAAC,SAAiB,EAAE,OAAe,EAAE,KAA8B,EAAE,KAAkB,EAAE,OAAY,EAAE,UAAe,IAAI,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,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;IAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AACtf,SAAS,QAAQ,CAAC,IAA6B,EAAE,SAAiB;IAChE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,SAAS;QAAE,MAAM,OAAO,EAAE,CAAC;IAC1F,IAAI,QAAQ,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,8BAA8B,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC;YAAE,MAAM,OAAO,EAAE,CAAC;QAC5K,MAAM,IAAI,mBAAmB,CAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,qBAAqB,EAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,gDAAgD,EACzE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,EACnC,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAClE,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAsB,CAAC,CAAC,CAAC,SAAS,CACvE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ;QAAE,MAAM,OAAO,EAAE,CAAC;IACnE,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,SAAS,UAAU,CAAC,KAA0C,EAAE,WAAoB;IAClF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5I,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,OAAoC,EAAE,QAAQ,EAAE,QAAyB,EAAE,CAAC;IACrH,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9H,MAAM,CAAC,GAAG,GAAG,GAAiC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,SAAS,YAAY,CAAC,CAA0B,IAAa,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AACvX,SAAS,YAAY,CAAC,CAAU,IAAa,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;AAC1N,SAAS,OAAO,KAAK,OAAO,IAAI,mBAAmB,CAAC,iCAAiC,EAAE,wDAAwD,EAAE,CAAC,6CAA6C,CAAC,CAAC,CAAC,CAAC,CAAC;AACpM,SAAS,gBAAgB,CAAC,SAAiB,EAAE,OAAiC;IAC5E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,mBAAmB,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,uCAAuC,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC9O,CAAC;AACD,SAAS,oBAAoB,CAAC,KAAc,IAAI,MAAM,KAAK,GAAG,KAAK,YAAY,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,gBAAgB,CAAC,KAAK,EAAE,IAAI,IAAI,0BAA0B,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7M,SAAS,MAAM,CAAC,KAAc,IAA6B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACxK,SAAS,iBAAiB,CAAC,KAAc,IAAyC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1J,SAAS,MAAM,CAAC,KAAc,IAAwB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC7G,SAAS,OAAO,CAAC,KAAc,IAAc,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1I,SAAS,OAAO,CAAC,KAAc,IAAqB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;AACpI,SAAS,GAAG,CAAC,KAAc,IAAqB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpH,SAAS,SAAS,CAAC,KAAc,IAAa,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvH,SAAS,OAAO,CAAC,IAAY,EAAE,MAAc,IAAI,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;AAChN,SAAS,KAAK,CAAC,EAAU,IAAI,OAAO,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/tools/tools/describe.d.ts

@@ -0,0 +1,27 @@
+import type { AnyJson } from "../../schema/any-json.js";
+export interface ToolsDescribeRequest {
+    name: string;
+}
+export interface ToolsDescribeResult {
+    name: string;
+    description: string;
+    inputSchema: Record<string, AnyJson>;
+    destructiveHint: boolean;
+    sideEffects?: string[];
+    playModeSupport: string;
+    supportsDryRun: boolean;
+    examples?: Array<{
+        description: string;
+        input: Record<string, AnyJson>;
+        execution?: {
+            dryRun?: boolean;
+            timeoutMs?: number;
+        };
+    }>;
+    target: string;
+    available?: false;
+    unavailableReason?: string;
+    requiresPackages?: string[];
+}
+declare const _default: import("../define.js").ToolDefinition<ToolsDescribeRequest, ToolsDescribeResult>;
+export default _default;

package/dist/tools/tools/describe.js

@@ -0,0 +1,35 @@
+import { checkToolExtensionAvailability, extensionAvailabilityFlags } from "../../extension-availability.js";
+import { publicToolDescriptor, resolveCatalogTool } from "../catalog.js";
+import { defineTool } from "../define.js";
+import { StructuredToolError } from "../errors.js";
+export default defineTool({
+    name: "tools.describe",
+    summary: "Show one tool's input schema, examples, side effects, target, and availability.",
+    description: "Return one compact invocation descriptor from the connected Unity instance catalog: input schema, structured examples, effects, target, and current unavailability when applicable. Internal routing and result schemas stay private.",
+    group: "tools",
+    handler: "offline",
+    supportStatus: "cli-only",
+    destructiveHint: false,
+    sideEffects: [],
+    playModeSupport: "supported",
+    examples: [{ description: "Describe a tool's invocation contract", argv: ["tools", "run", "tools.describe", "--input", "{\"name\":\"asset.search\"}"] }],
+    async execute(request, context) {
+        if (!request.name)
+            throw new StructuredToolError("TOOLS_DESCRIBE_NAME_REQUIRED", "Pass a tool name: unitycli tools describe <tool>.", ["Run unitycli tools group to see tool groups."]);
+        const flags = context.flags ?? {};
+        const resolved = await resolveCatalogTool(request.name, flags, context, `${context.requestId}_describe_execution`);
+        if (resolved.ok === false)
+            throw StructuredToolError.from(resolved.error ?? { code: "TOOL_DISCOVERY_FAILED", message: "Tool discovery failed." });
+        if (!resolved.tool)
+            throw new StructuredToolError("E_TOOL_NOT_FOUND_FOR_TARGET", `Tool not found for target: ${request.name}.`, ["Run unitycli tools group to see tool groups.", "Run unitycli tools search <k1|k2|...> to find related tools."]);
+        const currentTool = resolved.tool;
+        const data = publicToolDescriptor(currentTool);
+        const availability = await checkToolExtensionAvailability(currentTool, await extensionAvailabilityFlags(flags, context));
+        if (!availability.available) {
+            data.available = false;
+            data.unavailableReason = `${availability.errorCode}: ${availability.message}`;
+        }
+        return data;
+    }
+});
+//# sourceMappingURL=describe.js.map

package/dist/tools/tools/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../src/tools/tools/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7G,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAWnD,eAAe,UAAU,CAA4C;IACnE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,iFAAiF;IAC1F,WAAW,EAAE,uOAAuO;IACpP,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,EAAE;IACf,eAAe,EAAE,WAAW;IAC5B,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,6BAA6B,CAAC,EAAE,CAAC;IACxJ,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,MAAM,IAAI,mBAAmB,CAAC,8BAA8B,EAAE,mDAAmD,EAAE,CAAC,8CAA8C,CAAC,CAAC,CAAC;QACxL,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,qBAAqB,CAAC,CAAC;QACnH,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK;YAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;QAClJ,IAAI,CAAC,QAAQ,CAAC,IAAI;YAAE,MAAM,IAAI,mBAAmB,CAAC,6BAA6B,EAAE,8BAA8B,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC,8CAA8C,EAAE,8DAA8D,CAAC,CAAC,CAAC;QAClP,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;QAClC,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,CAAmC,CAAC;QACjF,MAAM,YAAY,GAAG,MAAM,8BAA8B,CAAC,WAAW,EAAE,MAAM,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACzH,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,iBAAiB,GAAG,GAAG,YAAY,CAAC,SAAS,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;QAChF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/tools/group-list.d.ts

@@ -0,0 +1,20 @@
+export interface ToolsGroupListRequest {
+    group: string;
+}
+export interface ToolsGroupListItem {
+    name: string;
+    summary: string;
+    available: boolean;
+}
+export interface ToolsGroupListResult {
+    group: string;
+    summary: string;
+    count: number;
+    nameSemantics: {
+        exact: true;
+        groupPrefix: false;
+    };
+    tools: ToolsGroupListItem[];
+}
+declare const _default: import("../define.js").ToolDefinition<ToolsGroupListRequest, ToolsGroupListResult>;
+export default _default;

package/dist/tools/tools/group-list.js

@@ -0,0 +1,39 @@
+import { checkToolExtensionAvailability, extensionAvailabilityFlags } from "../../extension-availability.js";
+import { loadToolCatalog } from "../catalog.js";
+import { defineTool } from "../define.js";
+import { StructuredToolError } from "../errors.js";
+import { groupSummary } from "./group-summaries.js";
+export default defineTool({
+    name: "tools.group-list",
+    summary: "List direct tools in a specific group with routing summaries and current availability.",
+    description: "List every Tool in one group from the connected Unity instance catalog. Each tools[].name is the exact invocation name; group is only a filter and must never be prepended.",
+    group: "tools",
+    handler: "offline",
+    supportStatus: "cli-only",
+    destructiveHint: false,
+    sideEffects: [],
+    playModeSupport: "supported",
+    examples: [{ description: "List tools in the camera group", argv: ["tools", "run", "tools.group-list", "--input", "{\"group\":\"camera\"}"] }],
+    async execute(request, context) {
+        if (!request.group)
+            throw new StructuredToolError("TOOLS_GROUP_LIST_NAME_REQUIRED", "Pass a group name: unitycli tools group list <group>.", ["Run unitycli tools group to see all tool groups."]);
+        const flags = context.flags ?? {};
+        const catalog = await loadToolCatalog(flags, context, `${context.requestId}_group_list_execution`);
+        if (catalog.ok === false)
+            throw StructuredToolError.from(catalog.error ?? { code: "TOOL_DISCOVERY_FAILED", message: "Tool discovery failed." });
+        const availabilityFlags = await extensionAvailabilityFlags(flags, context);
+        const matches = catalog.tools.filter((tool) => tool.group === request.group);
+        if (matches.length === 0)
+            throw new StructuredToolError("E_TOOL_GROUP_NOT_FOUND", `Tool group not found: ${request.group}.`, ["Run unitycli tools group to see all tool groups."]);
+        const tools = await Promise.all(matches.map(async (tool) => {
+            const availability = await checkToolExtensionAvailability(tool, availabilityFlags);
+            return {
+                name: tool.name,
+                summary: tool.summary,
+                available: availability.available && (tool.available ?? true)
+            };
+        }));
+        return { group: request.group, summary: groupSummary(request.group), count: tools.length, nameSemantics: { exact: true, groupPrefix: false }, tools };
+    }
+});
+//# sourceMappingURL=group-list.js.map

package/dist/tools/tools/group-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-list.js","sourceRoot":"","sources":["../../../src/tools/tools/group-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMpD,eAAe,UAAU,CAA8C;IACrE,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,wFAAwF;IACjG,WAAW,EAAE,6KAA6K;IAC1L,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,EAAE;IACf,eAAe,EAAE,WAAW;IAC5B,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,wBAAwB,CAAC,EAAE,CAAC;IAC9I,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,MAAM,IAAI,mBAAmB,CAAC,gCAAgC,EAAE,uDAAuD,EAAE,CAAC,kDAAkD,CAAC,CAAC,CAAC;QACnM,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,uBAAuB,CAAC,CAAC;QACnG,IAAI,OAAO,CAAC,EAAE,KAAK,KAAK;YAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;QAChJ,MAAM,iBAAiB,GAAG,MAAM,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,EAAE,yBAAyB,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,kDAAkD,CAAC,CAAC,CAAC;QACnL,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACzD,MAAM,YAAY,GAAG,MAAM,8BAA8B,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YACnF,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;aAC9D,CAAC;QACJ,CAAC,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC;IACxJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/tools/group-summaries.d.ts

@@ -0,0 +1,3 @@
+export declare const GROUP_SUMMARIES: Record<string, string>;
+/** 返回组的 route summary；未登记组回退到组名兜底，避免空泛 capability 文案。 */
+export declare function groupSummary(name: string): string;

package/dist/tools/tools/group-summaries.js

@@ -0,0 +1,52 @@
+// 每个公开 Tool group 的路由级一句话摘要，供 tools.group 与 tools.group-list 复用。
+// 覆盖当前全部公开组；新增组未登记时回退到组名兜底，避免空泛 capability 文案。
+export const GROUP_SUMMARIES = {
+    animation: "Animator state, parameters, and animation clip playback, editing, and creation.",
+    asset: "Unity asset discovery, import, editing, and refresh operations.",
+    build: "Live Unity build execution with terminal BuildReport and artifact proof.",
+    camera: "Camera creation, discovery, lens settings, targeting, and view capture.",
+    cinemachine: "Cinemachine virtual camera, brain, aim, body, blend, noise, and extension configuration.",
+    code: "C# code execution with explicit safety controls.",
+    component: "Add, get, list, modify, remove, and set components on scene objects.",
+    console: "Read and clear captured Unity console log output.",
+    controller: "Animator controller layers, states, transitions, blend trees, and parameters.",
+    diagnose: "CLI, target, and Bridge capability diagnostics.",
+    docs: "Offline documentation lookup and search.",
+    editor: "Unity Editor refresh, diagnostics, and session controls.",
+    extension: "Inspect installed UnityCLI extensions and their contributed tools.",
+    go: "Create, find, inspect, parent, and transform scene GameObjects.",
+    graphics: "Rendering, lighting, skybox, quality, stats, baking, and volume settings.",
+    hdrp: "High Definition Render Pipeline settings and volume effect overrides.",
+    instances: "List connected Unity Editor and runtime instances.",
+    material: "Create, inspect, assign, and edit material properties on assets and renderers.",
+    navmesh: "NavMesh bake settings, baking, and baked data clearing.",
+    object: "Read and modify serialized object data on assets and scene objects.",
+    occlusion: "Clear baked occlusion culling data.",
+    package: "Unity package inspection and package management.",
+    physics: "Physics queries, simulation, collision matrix, materials, and rigidbody settings.",
+    prefab: "Prefab creation, instantiation, editing, overrides, stages, and unpacking.",
+    probuilder: "ProBuilder shape, mesh, face, edge, and repair operations.",
+    profiler: "Profiler capture, analysis, memory, frame debugger, and performance stats.",
+    project: "Project settings, layers, tags, audio, input, time, and player settings.",
+    reflect: "Offline C# and Unity type reflection search.",
+    reflection: "Invoke and discover C# methods and type schemas via runtime reflection.",
+    runtime: "Development Player state, console, capture, timing, and input operations.",
+    scene: "Scene hierarchy, load, save, validation, and view operations.",
+    screenshot: "Capture game view, scene view, and isolated object screenshots.",
+    "scriptable-object": "Create, inspect, and modify ScriptableObject assets.",
+    shader: "Create, read, update, delete, and inspect shader assets.",
+    test: "Unity test execution and result collection.",
+    tests: "List Unity test runner tests and their results.",
+    texture: "Create, modify, import, generate, and inspect textures and sprites.",
+    timeline: "Create and edit Timeline assets, tracks, and clips.",
+    tools: "Tool catalog grouping, search, describe, and execution.",
+    ui: "UI Toolkit documents, panels, styles, and visual element creation and inspection.",
+    urp: "Universal Render Pipeline settings, renderer features, and volume effects.",
+    vfx: "Visual Effect Graph control, effects, particles, and templates.",
+    UnityPipeline: "Official com.unity.pipeline commands projected from UnityCLI attributes.",
+};
+/** 返回组的 route summary；未登记组回退到组名兜底，避免空泛 capability 文案。 */
+export function groupSummary(name) {
+    return GROUP_SUMMARIES[name] ?? `${name} operations.`;
+}
+//# sourceMappingURL=group-summaries.js.map

package/dist/tools/tools/group-summaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-summaries.js","sourceRoot":"","sources":["../../../src/tools/tools/group-summaries.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,+CAA+C;AAE/C,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,SAAS,EAAE,iFAAiF;IAC5F,KAAK,EAAE,iEAAiE;IACxE,KAAK,EAAE,0EAA0E;IACjF,MAAM,EAAE,yEAAyE;IACjF,WAAW,EAAE,0FAA0F;IACvG,IAAI,EAAE,kDAAkD;IACxD,SAAS,EAAE,sEAAsE;IACjF,OAAO,EAAE,mDAAmD;IAC5D,UAAU,EAAE,+EAA+E;IAC3F,QAAQ,EAAE,iDAAiD;IAC3D,IAAI,EAAE,0CAA0C;IAChD,MAAM,EAAE,0DAA0D;IAClE,SAAS,EAAE,oEAAoE;IAC/E,EAAE,EAAE,iEAAiE;IACrE,QAAQ,EAAE,2EAA2E;IACrF,IAAI,EAAE,uEAAuE;IAC7E,SAAS,EAAE,oDAAoD;IAC/D,QAAQ,EAAE,gFAAgF;IAC1F,OAAO,EAAE,yDAAyD;IAClE,MAAM,EAAE,qEAAqE;IAC7E,SAAS,EAAE,qCAAqC;IAChD,OAAO,EAAE,kDAAkD;IAC3D,OAAO,EAAE,mFAAmF;IAC5F,MAAM,EAAE,4EAA4E;IACpF,UAAU,EAAE,4DAA4D;IACxE,QAAQ,EAAE,4EAA4E;IACtF,OAAO,EAAE,0EAA0E;IACnF,OAAO,EAAE,8CAA8C;IACvD,UAAU,EAAE,yEAAyE;IACrF,OAAO,EAAE,2EAA2E;IACpF,KAAK,EAAE,+DAA+D;IACtE,UAAU,EAAE,iEAAiE;IAC7E,mBAAmB,EAAE,sDAAsD;IAC3E,MAAM,EAAE,0DAA0D;IAClE,IAAI,EAAE,6CAA6C;IACnD,KAAK,EAAE,iDAAiD;IACxD,OAAO,EAAE,qEAAqE;IAC9E,QAAQ,EAAE,qDAAqD;IAC/D,KAAK,EAAE,yDAAyD;IAChE,EAAE,EAAE,mFAAmF;IACvF,GAAG,EAAE,4EAA4E;IACjF,GAAG,EAAE,iEAAiE;IACtE,aAAa,EAAE,0EAA0E;CAC1F,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC;AACxD,CAAC"}

package/dist/tools/tools/group.d.ts

@@ -0,0 +1,13 @@
+export interface ToolsGroupRequest {
+}
+export interface ToolsGroupItem {
+    name: string;
+    summary: string;
+    toolCount: number;
+}
+export interface ToolsGroupResult {
+    count: number;
+    groups: ToolsGroupItem[];
+}
+declare const _default: import("../define.js").ToolDefinition<ToolsGroupRequest, ToolsGroupResult>;
+export default _default;

package/dist/tools/tools/group.js

@@ -0,0 +1,34 @@
+import { loadToolCatalog } from "../catalog.js";
+import { defineTool } from "../define.js";
+import { StructuredToolError } from "../errors.js";
+import { groupSummary } from "./group-summaries.js";
+function discoveryError(result) {
+    throw StructuredToolError.from(result.error ?? { code: "TOOL_DISCOVERY_FAILED", message: "Tool discovery failed." });
+}
+export default defineTool({
+    name: "tools.group",
+    summary: "List the available tool groups with counts.",
+    description: "List every Tool group owned by the connected Unity instance, including package-local CLI capabilities.",
+    group: "tools",
+    handler: "offline",
+    supportStatus: "cli-only",
+    destructiveHint: false,
+    sideEffects: [],
+    playModeSupport: "supported",
+    examples: [{ description: "List all tool groups", argv: ["tools", "run", "tools.group", "--input", "{}"] }],
+    async execute(request, context) {
+        const catalog = await loadToolCatalog(context.flags ?? {}, context, `${context.requestId}_group_execution`);
+        if (catalog.ok === false)
+            discoveryError(catalog);
+        const groups = new Map();
+        for (const tool of catalog.tools)
+            groups.set(tool.group, (groups.get(tool.group) ?? 0) + 1);
+        const items = [...groups].sort(([a], [b]) => a.localeCompare(b)).map(([name, toolCount]) => ({
+            name,
+            summary: groupSummary(name),
+            toolCount
+        }));
+        return { count: items.length, groups: items };
+    }
+});
+//# sourceMappingURL=group.js.map

package/dist/tools/tools/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/tools/tools/group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMpD,SAAS,cAAc,CAAC,MAA4I;IAClK,MAAM,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;AACvH,CAAC;AAED,eAAe,UAAU,CAAsC;IAC7D,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,6CAA6C;IACtD,WAAW,EAAE,wGAAwG;IACrH,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,EAAE;IACf,eAAe,EAAE,WAAW;IAC5B,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;IAC3G,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,kBAAkB,CAAC,CAAC;QAC5G,IAAI,OAAO,CAAC,EAAE,KAAK,KAAK;YAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3F,IAAI;YACJ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC;YAC3B,SAAS;SACV,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChD,CAAC;CACF,CAAC,CAAC"}