@alpsckr/unitycli 0.4.3 → 0.4.4

package/dist/tools/tools/describe.js

@@ -1,35 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,16 +0,0 @@
-import { type DiscoveryPageInfo, type DiscoveryPageRequest } from "./pagination.js";
-export interface ToolsGroupListRequest extends DiscoveryPageRequest {
-    group: string;
-}
-export interface ToolsGroupListItem {
-    name: string;
-    summary: string;
-    available?: false;
-}
-export interface ToolsGroupListResult {
-    summary: string;
-    pageInfo: DiscoveryPageInfo;
-    tools: ToolsGroupListItem[];
-}
-declare const _default: import("../define.js").ToolDefinition<ToolsGroupListRequest, ToolsGroupListResult>;
-export default _default;

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

@@ -1,38 +0,0 @@
-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";
-import { paginateDiscovery } from "./pagination.js";
-export default defineTool({
-    name: "tools.group-list",
-    summary: "List one tool group's routing summaries and availability in bounded cursor pages.",
-    description: "List Tools in one group from the connected Unity instance catalog, sorted by exact Tool name. pageSize/cursor bound each page; use pageInfo.nextCursor unchanged to continue. Each tools[].name is the exact invocation name, group is only a filter and must never be prepended, and available appears only when false.",
-    group: "tools",
-    handler: "offline",
-    supportStatus: "cli-only",
-    destructiveHint: false,
-    sideEffects: [],
-    playModeSupport: "supported",
-    examples: [{ description: "List the first camera Tool page", argv: ["tools", "run", "tools.group-list", "--input", "{\"group\":\"camera\",\"pageSize\":20}"] }],
-    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 matches = catalog.tools.filter((tool) => tool.group === request.group).sort((left, right) => left.name.localeCompare(right.name));
-        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 page = paginateDiscovery(matches, request, "tools.group-list");
-        const availabilityFlags = await extensionAvailabilityFlags(flags, context);
-        const tools = await Promise.all(page.items.map(async (tool) => {
-            const availability = await checkToolExtensionAvailability(tool, availabilityFlags);
-            const available = availability.available && (tool.available ?? true);
-            return { name: tool.name, summary: tool.summary, ...(!available ? { available: false } : {}) };
-        }));
-        return { summary: groupSummary(request.group), pageInfo: page.pageInfo, tools };
-    },
-});
-//# sourceMappingURL=group-list.js.map

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

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

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

@@ -1,13 +0,0 @@
-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

@@ -1,34 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}

package/dist/tools/tools/pagination.d.ts

@@ -1,17 +0,0 @@
-export declare const DEFAULT_DISCOVERY_PAGE_SIZE = 20;
-export declare const MAX_DISCOVERY_PAGE_SIZE = 100;
-export interface DiscoveryPageRequest {
-    pageSize?: number;
-    cursor?: number;
-}
-export interface DiscoveryPageInfo {
-    cursor: number;
-    pageSize: number;
-    total: number;
-    nextCursor?: number;
-}
-/** 对稳定排序后的 discovery 结果应用统一数字 cursor 分页。 */
-export declare function paginateDiscovery<T>(items: T[], request: DiscoveryPageRequest, operation: string): {
-    items: T[];
-    pageInfo: DiscoveryPageInfo;
-};

package/dist/tools/tools/pagination.js

@@ -1,28 +0,0 @@
-import { StructuredToolError } from "../errors.js";
-export const DEFAULT_DISCOVERY_PAGE_SIZE = 20;
-export const MAX_DISCOVERY_PAGE_SIZE = 100;
-/** 对稳定排序后的 discovery 结果应用统一数字 cursor 分页。 */
-export function paginateDiscovery(items, request, operation) {
-    const pageSize = request.pageSize ?? DEFAULT_DISCOVERY_PAGE_SIZE;
-    const cursor = request.cursor ?? 0;
-    if (!Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > MAX_DISCOVERY_PAGE_SIZE) {
-        throw pageError(operation, "pageSize", `[1,${MAX_DISCOVERY_PAGE_SIZE}] integer`, request.pageSize);
-    }
-    if (!Number.isSafeInteger(cursor) || cursor < 0) {
-        throw pageError(operation, "cursor", "non-negative integer", request.cursor);
-    }
-    const end = Math.min(items.length, cursor + pageSize);
-    return {
-        items: cursor < items.length ? items.slice(cursor, end) : [],
-        pageInfo: {
-            cursor,
-            pageSize,
-            total: items.length,
-            ...(end < items.length ? { nextCursor: end } : {}),
-        },
-    };
-}
-function pageError(operation, field, expected, actual) {
-    return new StructuredToolError("E_SCHEMA_INVALID", `${operation} ${field} must be a ${expected}.`, [`Pass a valid ${field}; use the returned pageInfo.nextCursor unchanged to continue.`], { path: `$.${field}`, expected, actual: actual ?? null });
-}
-//# sourceMappingURL=pagination.js.map

package/dist/tools/tools/pagination.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/tools/tools/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAc3C,4CAA4C;AAC5C,MAAM,UAAU,iBAAiB,CAAI,KAAU,EAAE,OAA6B,EAAE,SAAiB;IAC/F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,2BAA2B,CAAC;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,uBAAuB,EAAE,CAAC;QAC1F,MAAM,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrG,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACtD,OAAO;QACL,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;QAC5D,QAAQ,EAAE;YACR,MAAM;YACN,QAAQ;YACR,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,KAAa,EAAE,QAAgB,EAAE,MAAe;IACpF,OAAO,IAAI,mBAAmB,CAC5B,kBAAkB,EAClB,GAAG,SAAS,IAAI,KAAK,cAAc,QAAQ,GAAG,EAC9C,CAAC,gBAAgB,KAAK,+DAA+D,CAAC,EACtF,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CACzD,CAAC;AACJ,CAAC"}

package/dist/tools/tools/search.d.ts

@@ -1,15 +0,0 @@
-import { type DiscoveryPageInfo, type DiscoveryPageRequest } from "./pagination.js";
-export interface ToolsSearchRequest extends DiscoveryPageRequest {
-    keyword: string;
-}
-export interface ToolsSearchItem {
-    name: string;
-    summary: string;
-    group: string;
-}
-export interface ToolsSearchResult {
-    pageInfo: DiscoveryPageInfo;
-    tools: ToolsSearchItem[];
-}
-declare const _default: import("../define.js").ToolDefinition<ToolsSearchRequest, ToolsSearchResult>;
-export default _default;

package/dist/tools/tools/search.js

@@ -1,42 +0,0 @@
-import { loadToolCatalog } from "../catalog.js";
-import { defineTool } from "../define.js";
-import { StructuredToolError } from "../errors.js";
-import { paginateDiscovery } from "./pagination.js";
-export default defineTool({
-    name: "tools.search",
-    summary: "Search tool routing metadata with `|`-separated OR keywords and bounded cursor pages.",
-    description: "Search the complete Tool catalog owned by the connected Unity instance. keyword is split on `|`; a Tool matches when any token appears in its name, summary, description, or group (case-insensitive, OR semantics). Results are sorted by exact Tool name and paged with pageSize/cursor; use pageInfo.nextCursor unchanged to continue. Results contain routing summaries only - use tools describe for schema, availability, and full details.",
-    group: "tools",
-    handler: "offline",
-    supportStatus: "cli-only",
-    destructiveHint: false,
-    sideEffects: [],
-    playModeSupport: "supported",
-    examples: [
-        { description: "Search for hierarchy tools", argv: ["tools", "run", "tools.search", "--input", "{\"keyword\":\"hierarchy\"}"] },
-        { description: "Search several capability areas in one bounded page", argv: ["tools", "run", "tools.search", "--input", "{\"keyword\":\"editor|console|screenshot\",\"pageSize\":20}"] },
-    ],
-    async execute(request, context) {
-        const tokens = (request.keyword ?? "")
-            .split("|")
-            .map((token) => token.trim().toLowerCase())
-            .filter((token) => token.length > 0);
-        if (tokens.length === 0) {
-            throw new StructuredToolError("TOOLS_SEARCH_KEYWORD_REQUIRED", "Pass one or more `|`-separated keywords: unitycli tools search <k1|k2|...>.", ["Run unitycli tools group to see tool groups."]);
-        }
-        const flags = context.flags ?? {};
-        const catalog = await loadToolCatalog(flags, context, `${context.requestId}_search_execution`);
-        if (catalog.ok === false) {
-            throw StructuredToolError.from(catalog.error ?? { code: "TOOL_DISCOVERY_FAILED", message: "Tool discovery failed." });
-        }
-        const matches = catalog.tools
-            .filter((tool) => tokens.some((token) => [tool.name, tool.summary, tool.description, tool.group].some((value) => value.toLowerCase().includes(token))))
-            .sort((left, right) => left.name.localeCompare(right.name));
-        const page = paginateDiscovery(matches, request, "tools.search");
-        return {
-            pageInfo: page.pageInfo,
-            tools: page.items.map((tool) => ({ name: tool.name, summary: tool.summary, group: tool.group })),
-        };
-    },
-});
-//# sourceMappingURL=search.js.map

package/dist/tools/tools/search.js.map

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

package/unitypkg/Editor/Tools/diagnose/preflight.cs

@@ -1,269 +0,0 @@
-#if UNITY_EDITOR
-using System;
-using System.Collections.Generic;
-using System.Globalization;
-using System.IO;
-using System.Linq;
-using System.Reflection;
-using System.Text;
-using UnityEditor;
-using UnityEngine;
-using UnityEngine.SceneManagement;
-
-namespace UnityCli
-{
-    public static partial class UnityCliBridge
-    {
-        /// <summary>
-        /// diagnose.preflight — 聚合 Unity Editor 健康诊断。
-        ///
-        /// 作为 UnityCliBridge 的嵌套类实现，聚合 Editor 状态、公开 Tool 计数、项目 Tool
-        /// fingerprint 与编译诊断。所有动态字段直接构造为 Dictionary/List 值树。
-        /// </summary>
-        public sealed class DiagnosePreflightTool : IUnityCliTool<DiagnosePreflightTool.Request, DiagnosePreflightTool.Result>
-        {
-            public sealed class Request
-            {
-                public string Command { get; set; }
-            }
-
-            public sealed class Result
-            {
-                public string TargetCommand { get; set; }
-                public ProjectInfo Project { get; set; }
-                [UnityCliAnyJson] public object Editor { get; set; }
-                public BridgeInfo Bridge { get; set; }
-                public CustomFingerprintInfo CustomTools { get; set; }
-                [UnityCliAnyJson] public List<object> Checks { get; set; }
-            }
-
-            public sealed class ProjectInfo
-            {
-                public string Path { get; set; }
-                public string UnityVersion { get; set; }
-                public string ActiveScene { get; set; }
-            }
-
-            public sealed class BridgeInfo
-            {
-                public bool Ready { get; set; }
-                public long ToolCount { get; set; }
-            }
-
-            public sealed class CustomFingerprintInfo
-            {
-                [UnityCliAnyJson] public object Fingerprint { get; set; }
-            }
-
-            public sealed class CompileStatusCheck
-            {
-                public string Name { get; set; }
-                public bool Ok { get; set; }
-                public bool Compiling { get; set; }
-                public bool ScanComplete { get; set; }
-                public bool HasCompileErrors { get; set; }
-                public long CompileErrorCount { get; set; }
-                public bool CompileErrorsTruncated { get; set; }
-                public List<string> CompileErrors { get; set; }
-                public List<string> NextActions { get; set; }
-            }
-
-            public ToolDescriptor Describe() => new()
-            {
-                Name = "diagnose.preflight",
-                Summary = "Run a live Unity Editor health check for project state, capability counts, custom fingerprints, and compile diagnostics.",
-                Description = "Reads current project and Editor busy state, public Tool counts, custom Tool fingerprint health, and recent compile diagnostics without exposing Bridge routes, ports, or logs.",
-                Group = "diagnose",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported",
-                DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
-                Examples = new[]
-                {
-                    new ToolExample { Description = "Run live preflight", Input = new Request { } },
-                    new ToolExample { Description = "Preflight before component work", Input = new Request { Command = "component.add" } }
-                }
-            };
-
-            public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-            {
-                // preflight 只读取已经发布的 registry 快照，不能为了诊断触发 discovery 或写入缓存。
-                var scene = SceneManager.GetActiveScene();
-                var checks = new List<object>
-                {
-                    MakeCheck("unityNotBusy", !(EditorApplication.isCompiling || EditorApplication.isUpdating || BuildPipeline.isBuildingPlayer)),
-                    MakeCheck("sceneLoaded", scene.isLoaded),
-                    MakeCheck("projectToolFingerprint", !ProjectTools.Values.Any(definition => definition.FingerprintStatus == "blocked")),
-                    BuildCompileStatus(ct)
-                };
-
-                return new System.Threading.Tasks.ValueTask<Result>(new Result
-                {
-                    TargetCommand = request.Command,
-                    Project = new ProjectInfo
-                    {
-                        Path = ProjectRoot(),
-                        UnityVersion = Application.unityVersion,
-                        ActiveScene = scene.path
-                    },
-                    Editor = new Dictionary<string, object>
-                    {
-                        { "busy", EditorApplication.isCompiling || EditorApplication.isUpdating || BuildPipeline.isBuildingPlayer },
-                        { "compiling", EditorApplication.isCompiling },
-                        { "updating", EditorApplication.isUpdating },
-                        { "building", BuildPipeline.isBuildingPlayer }
-                    },
-                    Bridge = new BridgeInfo
-                    {
-                        Ready = true,
-                        ToolCount = ProjectTools.Count
-                    },
-                    CustomTools = new CustomFingerprintInfo { Fingerprint = ProjectToolFingerprintSummary() },
-                    Checks = checks
-                });
-            }
-
-            // 构造 {name, ok} 检查项(运行时 Dictionary,UnityCliSerializer 序列化为对象)
-            private static Dictionary<string, object> MakeCheck(string name, bool ok)
-            {
-                return new Dictionary<string, object> { { "name", name }, { "ok", ok } };
-            }
-
-            // 编译状态检查:isCompiling + 近期编译错误(通过反射 LogEntries)。
-            // 扩展编译失败会让 Unity 持续无法完成编译、Bridge 报 E_UNITY_COMPILING,这里把状态和错误明示出来,
-            // 让 doctor 能定位是"扩展编译失败"而非"bridge 不可达"。
-            private static CompileStatusCheck BuildCompileStatus(System.Threading.CancellationToken ct)
-            {
-                const int maxScannedEntries = 5000;
-                const int maxScanMilliseconds = 50;
-                var scanTimer = System.Diagnostics.Stopwatch.StartNew();
-                var compiling = EditorApplication.isCompiling;
-                var hasCompileErrors = false;
-                var scanComplete = true;
-                long compileErrorCount = 0;
-                var compileErrorsTruncated = false;
-                var compileErrorChars = 0;
-                const int maxCompileErrorChars = 64 * 1024;
-                const int maxCompileErrorLineChars = 4096;
-                var errors = new List<string>();
-                try
-                {
-                    var logEntriesType = FindType("UnityEditor.LogEntries") ?? FindType("UnityEditorInternal.LogEntries");
-                    if (logEntriesType != null)
-                    {
-                        var flags = BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic;
-                        var start = logEntriesType.GetMethod("StartGettingEntries", flags);
-                        var end = logEntriesType.GetMethod("EndGettingEntries", flags);
-                        var count = logEntriesType.GetMethod("GetCount", flags);
-                        var getEntry = logEntriesType.GetMethod("GetEntryInternal", flags);
-                        var getLines = logEntriesType.GetMethod("GetLinesAndModeFromEntryInternal", flags)
-                            ?? logEntriesType.GetMethod("GetLinesAndModeInternal", flags);
-                        if ((start == null && count == null) || (getEntry == null && getLines == null)) scanComplete = false;
-                        var total = start != null
-                            ? Convert.ToInt32(start.Invoke(null, Type.EmptyTypes), CultureInfo.InvariantCulture)
-                            : count == null ? 0 : Convert.ToInt32(count.Invoke(null, Type.EmptyTypes), CultureInfo.InvariantCulture);
-                        try
-                        {
-                            var scannedEntries = 0;
-                            for (var i = total - 1; i >= 0; i--)
-                            {
-                                ct.ThrowIfCancellationRequested();
-                                if (scannedEntries >= maxScannedEntries || scanTimer.ElapsedMilliseconds >= maxScanMilliseconds)
-                                {
-                                    scanComplete = false;
-                                    compileErrorsTruncated = true;
-                                    break;
-                                }
-                                scannedEntries++;
-                                string line = null;
-                                var mode = 0;
-                                try
-                                {
-                                    if (getLines != null && getLines.GetParameters().Length == 4)
-                                    {
-                                        var args = new object[] { i, 1, 0, null };
-                                        getLines.Invoke(null, args);
-                                        mode = Convert.ToInt32(args[2], CultureInfo.InvariantCulture);
-                                        line = args[3] as string;
-                                    }
-                                    else if (getEntry != null && getEntry.GetParameters().Length == 4)
-                                    {
-                                        var args = new object[4] { i, null, null, null };
-                                        getEntry.Invoke(null, args);
-                                        line = args[1] as string;
-                                        mode = args[2] == null ? 0 : Convert.ToInt32(args[2], CultureInfo.InvariantCulture);
-                                    }
-                                    else if (getLines != null && getLines.GetParameters().Length == 2)
-                                    {
-                                        var args = new object[] { i, null };
-                                        getLines.Invoke(null, args);
-                                        line = args[1] as string;
-                                    }
-                                }
-                                catch { scanComplete = false; }
-                                if (string.IsNullOrEmpty(line)) { scanComplete = false; continue; }
-                                // 仅关注编译错误(CS####)。mode 位掩码中 bit1 为 error。
-                                var isCompileError = line.IndexOf("CS", StringComparison.OrdinalIgnoreCase) >= 0 && line.IndexOf("error", StringComparison.OrdinalIgnoreCase) >= 0;
-                                if (isCompileError || ((mode & 1) != 0 && line.IndexOf("Compile", StringComparison.OrdinalIgnoreCase) >= 0))
-                                {
-                                    hasCompileErrors = true;
-                                    compileErrorCount++;
-                                    var boundedLine = BoundedUtf8(line, maxCompileErrorLineChars);
-                                    var boundedBytes = Encoding.UTF8.GetByteCount(boundedLine);
-                                    if (errors.Count < 20 && compileErrorChars + boundedBytes <= maxCompileErrorChars)
-                                    {
-                                        errors.Add(boundedLine);
-                                        compileErrorChars += boundedBytes;
-                                        if (boundedLine.Length != line.Length) compileErrorsTruncated = true;
-                                    }
-                                    else compileErrorsTruncated = true;
-                                }
-                            }
-                        }
-                        finally
-                        {
-                            if (start != null && end != null) end.Invoke(null, Type.EmptyTypes);
-                        }
-                    }
-                    else scanComplete = false;
-                }
-                catch (OperationCanceledException) { throw; }
-                catch (Exception exception)
-                {
-                    scanComplete = false;
-                    var readFailure = "Failed to read compile errors: " + exception.GetType().Name;
-                    if (errors.Count < 20 && compileErrorChars + Encoding.UTF8.GetByteCount(readFailure) <= maxCompileErrorChars) errors.Insert(0, readFailure);
-                    else compileErrorsTruncated = true;
-                }
-                if (!scanComplete) compileErrorsTruncated = true;
-                var nextActions = new List<string>();
-                if (!scanComplete) nextActions.Add("Compile diagnostics could not be scanned completely; inspect Unity Console before treating preflight as healthy.");
-                if (hasCompileErrors) nextActions.Add("Review the listed compile errors (often from a broken extension under Packages/com.alpsckr.unitycli/Extensions). Fix or remove the offending extension, then let Unity recompile.");
-                if (compiling) nextActions.Add("Wait for Unity to finish compiling, then re-run doctor.");
-                if (hasCompileErrors && File.Exists(Path.Combine(ProjectRoot(), "Packages", "com.alpsckr.unitycli", "Extensions", "extension.json")))
-                {
-                    nextActions.Add("If an extension no longer compiles, remove it via unitycli extensions remove <id> --project <path>.");
-                }
-                return new CompileStatusCheck
-                {
-                    Name = "compileStatus",
-                    Ok = scanComplete && !compiling && !hasCompileErrors,
-                    Compiling = compiling,
-                    ScanComplete = scanComplete,
-                    HasCompileErrors = hasCompileErrors,
-                    CompileErrorCount = compileErrorCount,
-                    CompileErrorsTruncated = compileErrorsTruncated,
-                    CompileErrors = errors,
-                    NextActions = nextActions
-                };
-            }
-
-            private static string BoundedUtf8(string value, int maxBytes)
-            {
-                if (string.IsNullOrEmpty(value) || Encoding.UTF8.GetByteCount(value) <= maxBytes) return value ?? string.Empty;
-                var length = Math.Min(value.Length, maxBytes);
-                while (length > 0 && Encoding.UTF8.GetByteCount(value.Substring(0, length)) > maxBytes) length--;
-                if (length > 0 && char.IsHighSurrogate(value[length - 1])) length--;
-                return value.Substring(0, length);
-            }
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/editor/console.cs

@@ -1,26 +0,0 @@
-#if UNITY_EDITOR
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Reflection;
-using UnityEditor;
-using UnityEditor.Compilation;
-using UnityEngine;
-
-namespace UnityCli
-{
-    /// <summary>editor.console — 读取 Console 日志(只读)。</summary>
-    public class EditorConsoleTool : IUnityCliTool<EditorConsoleTool.Request, EditorConsoleTool.Result>
-    {
-        public sealed class Request { public string Type { get; set; } public int? Count { get; set; } }
-        public sealed class Result { public bool Cleared { get; set; } public List<ConsoleEntry> Items { get; set; } public PageInfo PageInfo { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "editor.console", Summary = "Read recent Unity Console log entries.", Description = "Read-only: returns recent Console entries filtered by type. Use console.clear to clear.", Group = "editor",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read console", Input = new Request { Count = 20 } } } };
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var count = Math.Max(1, Math.Min(r.Count ?? 50, 500));
-            var items = EditorToolSupport.ReadConsoleEntries(r.Type, null, count);
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { Cleared = false, Items = items, PageInfo = new PageInfo { PageSize = count, Cursor = 0, Total = items.Count } });
-        }
-    }
-}
-#endif