@sxl-studio/bridge 1.7.2 → 1.7.3

package/dist/tools/catalogue-bootstrap.js

@@ -6,14 +6,28 @@
  * each tool registration file having to call `catalogueTool` inline. Adding a
  * new tool? Register it here and in the corresponding tools/*.ts module.
  */
-import { catalogueTool } from "./registry.js";
+import { BRIDGE_COMMAND_TIMEOUT_MS } from "../command-queue.js";
+import { catalogueTool, getBridgeToolCatalogue } from "./registry.js";
 function add(entry) {
+    const commandType = entry.commandType ?? entry.name;
+    const execution = entry.execution ?? "plugin";
+    const pluginCommandTypes = entry.pluginCommandTypes ?? (execution === "bridge-local" ? [] : [commandType]);
     catalogueTool({
         name: entry.name,
         category: entry.category,
         summary: entry.summary,
         requiresDesignMode: entry.requiresDesignMode ?? false,
         requiresComposition: entry.requiresComposition ?? false,
+        commandType,
+        execution,
+        pluginCommandTypes,
+        timeoutMs: entry.timeoutMs ?? BRIDGE_COMMAND_TIMEOUT_MS[commandType] ?? 3_600_000,
+        aliases: entry.aliases,
+        naturalLanguageIntents: entry.naturalLanguageIntents,
+        dryRunSupported: entry.dryRunSupported,
+        returnsLargeData: entry.returnsLargeData,
+        preferredBefore: entry.preferredBefore,
+        preferredAfter: entry.preferredAfter,
     });
 }
 function category(cat, entries) {
@@ -40,7 +54,26 @@ export function bootstrapBridgeToolCatalogue() {
         { name: "save_tokens_config", category: "tokens", summary: "Overwrite config.json." },
         { name: "get_applied_tokens", category: "tokens", summary: "Applied tokens + composition binding on a node." },
         { name: "apply_token_doc_spec", category: "tokens", summary: "Doc Spec v1: bind token paths to TEXT layers by name (same as build_token_documentation).", requiresDesignMode: true },
-        { name: "export_variables", category: "tokens", summary: "Run variables export (requires Design mode).", requiresDesignMode: true },
+        {
+            name: "preview_export_variables",
+            category: "tokens",
+            summary: "READ-ONLY preflight for export_variables: normalize exact settings payload, effective plugin-safe defaults, risks, and destructive confirmation requirement.",
+            execution: "bridge-local",
+            pluginCommandTypes: [],
+            dryRunSupported: true,
+            aliases: ["preview token export", "preflight export variables", "проверить экспорт переменных"],
+            naturalLanguageIntents: ["Preview SXL token export settings before writing Variables and Styles to Figma."],
+            preferredBefore: ["export_variables"],
+        },
+        {
+            name: "export_variables",
+            category: "tokens",
+            summary: "Run variables/styles export with plugin-safe defaults unless flags are explicitly provided.",
+            requiresDesignMode: true,
+            preferredAfter: ["preview_export_variables"],
+            aliases: ["export tokens", "export variables", "sync variables", "экспортировать переменные"],
+            naturalLanguageIntents: ["Export SXL token files to Figma Variables and Styles."],
+        },
         { name: "reset_diff", category: "tokens", summary: "Reset all Diff-IDs." },
         { name: "reset_diff_collection", category: "tokens", summary: "Reset Diff-IDs for a collection." },
         { name: "reset_diff_file", category: "tokens", summary: "Reset Diff-IDs for a file." },
@@ -62,6 +95,35 @@ export function bootstrapBridgeToolCatalogue() {
     ]);
     category("variables", [
         { name: "get_variables", category: "variables", summary: "List local variable collections and variables." },
+        {
+            name: "get_variable_defs",
+            category: "variables",
+            summary: "Bridge orchestration for official-MCP-style variable/style definitions: selection-compatible applied token context plus local, enabled-library, or REST variable definition modes.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: [
+                "get_selection_summary",
+                "get_selection_variable_defs",
+                "get_applied_tokens",
+                "get_variables",
+                "get_local_styles",
+                "inspect_enabled_libraries",
+                "list_enabled_library_variables",
+            ],
+            returnsLargeData: true,
+            aliases: [
+                "variable definitions",
+                "variables used in selection",
+                "token definitions",
+                "переменные выделения",
+                "токены выделения",
+            ],
+            naturalLanguageIntents: [
+                "Return variables and styles used by the active Figma selection before generating code or documentation.",
+                "Read local, enabled-library, or known-file REST variable definitions when the user asks for token names and values.",
+            ],
+            preferredBefore: ["get_design_context", "audit_variable_coverage", "audit_style_coverage"],
+            preferredAfter: ["get_plugin_status", "get_metadata", "figma_rest_diagnose"],
+        },
         { name: "create_variable_collection", category: "variables", summary: "Create a new variable collection.", requiresDesignMode: true },
         { name: "create_variable", category: "variables", summary: "Create a new variable inside a collection.", requiresDesignMode: true },
         { name: "bind_variable", category: "variables", summary: "Bind a variable to a node property.", requiresDesignMode: true },
@@ -75,6 +137,10 @@ export function bootstrapBridgeToolCatalogue() {
         { name: "set_variable_mode_value", category: "variables", summary: "Set variable value for a mode.", requiresDesignMode: true },
         { name: "set_variable_scopes", category: "variables", summary: "Set variable scopes.", requiresDesignMode: true },
         { name: "set_variable_code_syntax", category: "variables", summary: "Set variable codeSyntax per platform.", requiresDesignMode: true },
+        { name: "batch_create_variables", category: "variables", summary: "Create many variables in one collection with per-item errors.", requiresDesignMode: true },
+        { name: "batch_set_variable_values", category: "variables", summary: "Set many variable mode values in one round-trip.", requiresDesignMode: true },
+        { name: "batch_delete_variables", category: "variables", summary: "Delete many variables with per-item errors.", requiresDesignMode: true },
+        { name: "batch_bind_variables", category: "variables", summary: "Bind many nodes/properties to variables in one round-trip.", requiresDesignMode: true },
     ]);
     category("styles", [
         { name: "get_local_styles", category: "styles", summary: "List local paint/text/effect styles." },
@@ -96,11 +162,71 @@ export function bootstrapBridgeToolCatalogue() {
         { name: "get_node_info", category: "canvas", summary: "Basic info about one node." },
         { name: "get_node_tree", category: "canvas", summary: "Full scene subtree." },
         { name: "get_page_structure", category: "canvas", summary: "Summary of current page structure." },
+        {
+            name: "get_design_context",
+            category: "canvas",
+            summary: "Bridge design-context orchestration: active-file SXL codegen/composition context, metadata, native variable/style definitions, optional screenshot, and optional Code Connect suggestions.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: [
+                "get_selection_summary",
+                "get_node_tree",
+                "get_page_structure",
+                "get_codegen",
+                "export_composition_json",
+                "get_selection_variable_defs",
+                "export_as_svg",
+                "find_components",
+            ],
+            returnsLargeData: true,
+            aliases: [
+                "design context",
+                "figma context",
+                "selection context",
+                "контекст дизайна",
+                "контекст выделения",
+            ],
+            naturalLanguageIntents: [
+                "Collect structured design context for the active Figma selection before implementing it in code.",
+                "Bundle SXL codegen, composition JSON, metadata, variables/styles, and screenshot context into one agent-readable payload.",
+            ],
+            preferredBefore: ["get_codegen", "export_composition_json", "get_variable_defs", "get_screenshot"],
+            preferredAfter: ["get_plugin_status", "get_metadata"],
+        },
+        {
+            name: "get_metadata",
+            category: "canvas",
+            summary: "Bridge metadata orchestration: active-file selection/page/node tree metadata through plugin or file/node metadata through Figma REST.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["get_selection_summary", "get_page_structure", "get_node_tree", "get_pages"],
+            returnsLargeData: true,
+            aliases: ["figma metadata", "file metadata", "node metadata", "метаданные фигмы"],
+            naturalLanguageIntents: [
+                "Read active-file selection, page structure, or node tree metadata through Remote Connect.",
+                "Read hosted Figma file metadata or specific node metadata through REST when fileKey/url is available.",
+            ],
+            preferredBefore: ["get_design_context", "get_screenshot", "find_nodes"],
+            preferredAfter: ["get_plugin_status", "figma_rest_diagnose"],
+        },
         { name: "read_node_properties", category: "canvas", summary: "Read canonical node properties." },
         { name: "find_nodes", category: "canvas", summary: "Find nodes by predicate." },
         { name: "list_components", category: "canvas", summary: "List local components." },
         { name: "list_available_fonts", category: "canvas", summary: "Available fonts (+ project text styles hint)." },
         { name: "export_as_svg", category: "canvas", summary: "Export node(s) as SVG." },
+        {
+            name: "get_screenshot",
+            category: "canvas",
+            summary: "Bridge screenshot/render orchestration: plugin inline SVG for active-file nodes or Figma REST image URLs for fileKey/nodeIds.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["get_selection_summary", "export_as_svg"],
+            returnsLargeData: true,
+            aliases: ["render node image", "screenshot figma node", "export screenshot", "сделай скриншот ноды"],
+            naturalLanguageIntents: [
+                "Render one or more active-file nodes as inline SVG through Remote Connect.",
+                "Return Figma REST image URLs for known fileKey/nodeIds without requiring the plugin session.",
+            ],
+            preferredAfter: ["get_selection_summary", "figma_rest_diagnose"],
+            preferredBefore: ["get_design_context", "export_as_svg"],
+        },
         { name: "notify", category: "canvas", summary: "Figma toast notification." },
         { name: "create_frame", category: "canvas", summary: "Create a frame.", requiresDesignMode: true },
         { name: "create_rectangle", category: "canvas", summary: "Create a rectangle.", requiresDesignMode: true },
@@ -139,12 +265,191 @@ export function bootstrapBridgeToolCatalogue() {
         { name: "flatten_nodes", category: "canvas", summary: "Flatten nodes.", requiresDesignMode: true },
         { name: "apply_documentation_payload", category: "canvas", summary: "Apply SXL documentation payload.", requiresDesignMode: true },
     ]);
+    category("figma-rest", [
+        {
+            name: "figma_rest_diagnose",
+            category: "figma-rest",
+            summary: "Figma REST companion preflight: token, auth mode, endpoint, scope, plan, and permission diagnostics without exposing secrets.",
+            execution: "bridge-local",
+            aliases: ["figma rest doctor", "rest preflight", "diagnose figma token", "проверить figma token"],
+            naturalLanguageIntents: ["Check whether Bridge can use Figma REST for whoami, file/team libraries, images, nodes, or variables before a workflow."],
+            preferredBefore: ["figma_rest_whoami", "figma_rest_search_design_system", "figma_rest_get_file_nodes"],
+        },
+        {
+            name: "figma_rest_whoami",
+            category: "figma-rest",
+            summary: "Figma REST companion: authenticated user for configured token.",
+            execution: "bridge-local",
+            aliases: ["whoami", "figma me", "authenticated figma user"],
+            naturalLanguageIntents: ["Check which Figma REST user/token Bridge is using."],
+        },
+        {
+            name: "figma_rest_get_file_metadata",
+            category: "figma-rest",
+            summary: "Figma REST companion: file metadata from /v1/files/:key/meta.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_get_file",
+            category: "figma-rest",
+            summary: "Figma REST companion: file JSON from /v1/files/:key; prefer depth/ids.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+            aliases: ["rest get file", "figma file json"],
+            naturalLanguageIntents: ["Read a Figma file through REST when the plugin is not open or cross-file context is needed."],
+        },
+        {
+            name: "figma_rest_get_file_nodes",
+            category: "figma-rest",
+            summary: "Figma REST companion: specific nodes from /v1/files/:key/nodes.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_get_images",
+            category: "figma-rest",
+            summary: "Figma REST companion: render node image URLs from /v1/images/:key.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_get_image_fills",
+            category: "figma-rest",
+            summary: "Figma REST companion: image fill download URLs from /v1/files/:key/images.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_get_file_components",
+            category: "figma-rest",
+            summary: "Figma REST companion: published components in a file library.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+            aliases: ["file library components"],
+            naturalLanguageIntents: ["List published components from a known Figma library file."],
+        },
+        {
+            name: "figma_rest_get_file_component_sets",
+            category: "figma-rest",
+            summary: "Figma REST companion: published component sets in a file library.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_get_file_styles",
+            category: "figma-rest",
+            summary: "Figma REST companion: published styles in a file library.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_get_team_components",
+            category: "figma-rest",
+            summary: "Figma REST companion: published components in a team library.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+            aliases: ["team library components"],
+            naturalLanguageIntents: ["List published components from a known Figma team library."],
+        },
+        {
+            name: "figma_rest_get_team_component_sets",
+            category: "figma-rest",
+            summary: "Figma REST companion: published component sets in a team library.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+            aliases: ["team library component sets"],
+            naturalLanguageIntents: ["List published component sets from a known Figma team library."],
+        },
+        {
+            name: "figma_rest_get_team_styles",
+            category: "figma-rest",
+            summary: "Figma REST companion: published styles in a team library.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_get_variables_local",
+            category: "figma-rest",
+            summary: "Figma REST companion: local and remote variables used in a file.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+            aliases: ["rest variables local"],
+            naturalLanguageIntents: ["Fetch Figma variables through REST for cross-file or no-plugin workflows."],
+        },
+        {
+            name: "figma_rest_get_variables_published",
+            category: "figma-rest",
+            summary: "Figma REST companion: variables published from a file.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+        },
+        {
+            name: "figma_rest_search_design_system",
+            category: "figma-rest",
+            summary: "Figma REST companion: search known file/team library components, styles, and variables.",
+            execution: "bridge-local",
+            returnsLargeData: true,
+            aliases: ["rest search design system", "search known figma library"],
+            naturalLanguageIntents: ["Search a known file/team Figma library when official MCP search_design_system is not available."],
+            preferredBefore: ["inspect_design_system", "find_components"],
+        },
+    ]);
     category("data", [
-        { name: "apply_mapping", category: "data", summary: "Apply a mapping to a node.", requiresDesignMode: true },
-        { name: "apply_all_mappings", category: "data", summary: "Apply all mappings.", requiresDesignMode: true },
+        { name: "list_datasets", category: "data", summary: "List SXL datasets.", returnsLargeData: true },
+        { name: "get_dataset", category: "data", summary: "Get one SXL dataset.", returnsLargeData: true },
+        { name: "save_dataset", category: "data", summary: "Create/update one SXL dataset.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "delete_dataset", category: "data", summary: "Delete one SXL dataset.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "list_assets", category: "data", summary: "List SXL local assets.", returnsLargeData: true },
+        { name: "get_asset", category: "data", summary: "Get one SXL asset; optional content.", returnsLargeData: true },
+        { name: "save_asset", category: "data", summary: "Create/update one SXL asset.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "delete_asset", category: "data", summary: "Delete one SXL asset.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "list_mappings", category: "data", summary: "List SXL mappings.", returnsLargeData: true },
+        { name: "get_mapping", category: "data", summary: "Get one SXL mapping.", returnsLargeData: true },
+        { name: "save_mapping", category: "data", summary: "Create/update one SXL mapping.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "delete_mapping", category: "data", summary: "Delete one SXL mapping.", requiresDesignMode: true, dryRunSupported: true },
+        {
+            name: "export_database_payload",
+            category: "data",
+            summary: "Bridge orchestration: export portable SXL datasets/assets/mappings payload via existing CRUD commands.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["list_datasets", "get_dataset", "list_assets", "get_asset", "list_mappings", "get_mapping"],
+            returnsLargeData: true,
+            aliases: ["backup database", "export data payload", "выгрузи базу данных"],
+            naturalLanguageIntents: ["Back up or transfer SXL Studio database datasets, assets, and mappings from the open file."],
+            preferredBefore: ["import_database_payload"],
+        },
+        {
+            name: "import_database_payload",
+            category: "data",
+            summary: "Bridge orchestration: dry-run-first import/upsert of portable SXL database payloads.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["list_datasets", "list_assets", "list_mappings", "save_dataset", "save_asset", "save_mapping"],
+            requiresDesignMode: true,
+            dryRunSupported: true,
+            returnsLargeData: true,
+            aliases: ["restore database", "import data payload", "загрузи базу данных"],
+            naturalLanguageIntents: ["Restore, clone, or move SXL Studio datasets, local assets, and mappings into the open file."],
+            preferredBefore: ["list_datasets", "list_assets", "list_mappings"],
+            preferredAfter: ["export_database_payload"],
+        },
+        { name: "apply_mapping", category: "data", summary: "Apply a mapping to explicit targetNodeIds or the current Figma selection. Dry-run preview supported.", requiresDesignMode: true, dryRunSupported: true, preferredBefore: ["get_mapping", "count_apply_targets"] },
+        { name: "apply_all_mappings", category: "data", summary: "Apply all mappings within a scope or explicit targetNodeIds. Dry-run preview supported.", requiresDesignMode: true, dryRunSupported: true, preferredBefore: ["list_mappings", "count_apply_targets"] },
         { name: "count_apply_targets", category: "data", summary: "Count mapping targets." },
-        { name: "generate_instances", category: "data", summary: "Generate instances from mapping.", requiresDesignMode: true },
+        { name: "generate_instances", category: "data", summary: "Generate instances from mapping into explicit targetNodeIds or the current selection. Dry-run preview supported.", requiresDesignMode: true, dryRunSupported: true, preferredBefore: ["get_mapping", "get_dataset"] },
         { name: "apply_image", category: "data", summary: "Apply an image asset.", requiresDesignMode: true },
+        {
+            name: "upload_assets",
+            category: "data",
+            summary: "Bridge asset uploader: validate/fetch PNG, JPG/JPEG, GIF, or WebP assets up to 10MB and apply them as image fills via set_image_fill. Dry-run preview supported.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["set_image_fill"],
+            requiresDesignMode: true,
+            dryRunSupported: true,
+            aliases: ["upload images", "insert images", "asset upload", "загрузи изображения"],
+            naturalLanguageIntents: ["Upload image assets from URLs/base64 into the current Figma Design file as fills or new image rectangles."],
+            preferredBefore: ["get_bridge_runtime_summary"],
+        },
         { name: "rebind_instance", category: "data", summary: "Rebind an instance to a new main.", requiresDesignMode: true },
         { name: "codeconnect_get_binding", category: "data", summary: "Get Code Connect binding for node." },
         { name: "codeconnect_save_binding", category: "data", summary: "Save Code Connect binding." },
@@ -153,6 +458,174 @@ export function bootstrapBridgeToolCatalogue() {
         { name: "codeconnect_get_global_settings", category: "data", summary: "Global Code Connect settings." },
         { name: "codeconnect_save_global_settings", category: "data", summary: "Save global Code Connect settings." },
         { name: "codeconnect_get_node_ui_status", category: "data", summary: "Code Connect node UI status." },
+        {
+            name: "get_context_for_code_connect",
+            category: "data",
+            summary: "Bridge Code Connect context orchestration: selection status, existing SXL bindings, registry/settings, codegen/composition context, component discovery, and local source suggestions for template/binding generation.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: [
+                "get_selection_summary",
+                "codeconnect_get_global_settings",
+                "codeconnect_get_registry",
+                "codeconnect_get_selection_status",
+                "get_node_tree",
+                "get_codegen",
+                "export_composition_json",
+                "codeconnect_get_binding",
+                "codeconnect_get_node_ui_status",
+                "find_components",
+            ],
+            returnsLargeData: true,
+            aliases: [
+                "code connect context",
+                "context for code connect",
+                "контекст code connect",
+                "собери контекст для code connect",
+            ],
+            naturalLanguageIntents: [
+                "Collect active-file component context and local code candidates before creating a Code Connect template or binding.",
+                "Prepare registry, existing binding, component props, codegen, and source-file suggestions for Code Connect mapping.",
+            ],
+            preferredBefore: ["codeconnect_save_binding"],
+            preferredAfter: ["codeconnect_get_global_settings", "codeconnect_get_registry", "get_selection_summary", "get_design_context"],
+        },
+        {
+            name: "get_code_connect_suggestions",
+            category: "data",
+            summary: "Bridge-local Code Connect suggestion engine: scan local code and rank full CodeConnectBinding candidates for selected Figma nodes before saving.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["get_selection_summary"],
+            returnsLargeData: true,
+            aliases: [
+                "code connect suggestions",
+                "suggest code binding",
+                "найди code connect binding",
+                "предложи связь компонента с кодом",
+            ],
+            naturalLanguageIntents: [
+                "Suggest Code Connect bindings from selected Figma component names and local source files.",
+                "Find likely source files for Figma components before calling codeconnect_save_binding.",
+            ],
+            preferredBefore: ["codeconnect_save_binding"],
+            preferredAfter: ["codeconnect_get_global_settings", "codeconnect_get_registry", "get_selection_summary"],
+        },
+        {
+            name: "generate_code_connect_template",
+            category: "data",
+            summary: "Bridge-local .figma.ts Code Connect template generator from a full SXL CodeConnectBinding or local suggestions. Dry-run preview by default; writes only with writeFile=true.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["get_selection_summary"],
+            dryRunSupported: true,
+            aliases: [
+                "generate code connect template",
+                "create figma ts template",
+                "создай code connect template",
+                "сгенерируй figma.ts",
+            ],
+            naturalLanguageIntents: [
+                "Generate a reviewable .figma.ts Code Connect template from selected Figma component context and local source files.",
+                "Create a Code Connect template file after reviewing get_context_for_code_connect suggestions.",
+            ],
+            preferredBefore: ["codeconnect_save_binding"],
+            preferredAfter: ["get_context_for_code_connect", "get_code_connect_suggestions", "codeconnect_get_registry"],
+        },
+        {
+            name: "inspect_enabled_libraries",
+            category: "data",
+            summary: "READ-ONLY: inspect team libraries already enabled for the current Figma file (variable collections and runtime-optional component/style descriptors).",
+            pluginCommandTypes: ["inspect_enabled_libraries"],
+            returnsLargeData: true,
+            aliases: [
+                "enabled libraries",
+                "available libraries",
+                "team library catalog",
+                "покажи подключенные библиотеки",
+            ],
+            naturalLanguageIntents: [
+                "List libraries already enabled in the active Figma file before searching known file/team REST sources or official MCP libraries.",
+                "Discover enabled library variable collections, styles, and components available to the plugin runtime.",
+            ],
+            preferredBefore: ["list_enabled_library_variables", "inspect_design_system", "figma_rest_search_design_system"],
+            preferredAfter: ["get_plugin_status"],
+        },
+        {
+            name: "list_enabled_library_variables",
+            category: "data",
+            summary: "READ-ONLY: list variables from enabled team-library variable collections; requires an explicit collection/library filter or includeAllCollections=true.",
+            pluginCommandTypes: ["list_enabled_library_variables"],
+            returnsLargeData: true,
+            aliases: [
+                "enabled library variables",
+                "team library variables",
+                "variables in connected libraries",
+                "переменные подключенной библиотеки",
+            ],
+            naturalLanguageIntents: [
+                "Read variable definitions from a team-library collection already enabled for the current file.",
+                "Inspect library variables by collection key, collection name, library name, or explicit include-all scan.",
+            ],
+            preferredAfter: ["inspect_enabled_libraries"],
+        },
+        {
+            name: "search_enabled_library_assets",
+            category: "data",
+            summary: "Bridge orchestration: search components, styles, variable collections, and variables in libraries already enabled for the current Figma file.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["inspect_enabled_libraries", "list_enabled_library_variables"],
+            returnsLargeData: true,
+            aliases: [
+                "search enabled libraries",
+                "search active file libraries",
+                "find library assets",
+                "найди в подключенных библиотеках",
+            ],
+            naturalLanguageIntents: [
+                "Search components, styles, variables, and variable collections in libraries already enabled in the open Figma file.",
+                "Find design-system assets available to the plugin before falling back to known REST libraries or official Figma MCP arbitrary library search.",
+            ],
+            preferredBefore: ["figma_rest_search_design_system", "inspect_design_system", "build_screen"],
+            preferredAfter: ["get_plugin_status"],
+        },
+        {
+            name: "get_libraries",
+            category: "data",
+            summary: "Figma MCP-compatible library discovery: active-file enabled libraries through Remote Connect plus known file/team libraries through Figma REST.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["inspect_enabled_libraries", "list_enabled_library_variables"],
+            returnsLargeData: true,
+            aliases: [
+                "figma mcp get_libraries",
+                "available design libraries",
+                "подключенные библиотеки figma",
+                "библиотеки дизайн системы",
+            ],
+            naturalLanguageIntents: [
+                "List libraries available to Bridge before building a screen from design-system assets.",
+                "Use the Figma MCP-compatible get_libraries flow without a separate official MCP server.",
+            ],
+            preferredBefore: ["search_design_system", "inspect_design_system", "build_screen"],
+            preferredAfter: ["get_plugin_status", "figma_rest_diagnose"],
+        },
+        {
+            name: "search_design_system",
+            category: "data",
+            summary: "Figma MCP-compatible design-system search across active-file components, enabled libraries, and known file/team REST libraries.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["find_components", "inspect_enabled_libraries", "list_enabled_library_variables"],
+            returnsLargeData: true,
+            aliases: [
+                "figma mcp search_design_system",
+                "search design system",
+                "найди в дизайн системе",
+                "поиск компонентов и токенов",
+            ],
+            naturalLanguageIntents: [
+                "Search for reusable components, component sets, styles, variables, and variable collections before creating new Figma layers.",
+                "Use the Figma MCP-compatible search_design_system flow with Bridge/SXL sources.",
+            ],
+            preferredBefore: ["build_screen", "create_component_instance", "import_variable_spec", "import_style_spec"],
+            preferredAfter: ["get_libraries", "inspect_design_system", "figma_rest_diagnose"],
+        },
     ]);
     category("git", [
         { name: "git_pull", category: "git", summary: "Pull from active Git connection." },
@@ -160,50 +633,212 @@ export function bootstrapBridgeToolCatalogue() {
         { name: "git_push", category: "git", summary: "Push to active Git connection." },
     ]);
     category("variables-orchestration", [
-        { name: "import_variable_spec", category: "variables-orchestration", summary: "Idempotent bulk-create / update of Variables from a declarative spec (collections + modes + variables + aliases).", requiresDesignMode: true },
+        { name: "import_variable_spec", category: "variables-orchestration", summary: "Idempotent bulk-create / update of Variables from a declarative spec (collections + modes + variables + aliases).", requiresDesignMode: true, dryRunSupported: true },
         { name: "analyze_variable_order", category: "variables-orchestration", summary: "READ-ONLY: recommend a new order for variables in a collection (alphabetical / byPath / explicit)." },
         { name: "dedupe_variables", category: "variables-orchestration", summary: "Find / merge duplicate Variables (byName | byDefaultModeValue). Dry-run by default; canvas write only when apply: true.", requiresDesignMode: true },
-        { name: "rebind_variable_aliases", category: "variables-orchestration", summary: "Bulk rewrite alias targets across modes ({ fromVariableId, toVariableId }[]).", requiresDesignMode: true },
-        { name: "apply_coverage_suggestions", category: "variables-orchestration", summary: "Apply audit_variable_coverage suggestions as setBoundVariableFor* writes. Dry-run by default.", requiresDesignMode: true },
+        { name: "rebind_variable_aliases", category: "variables-orchestration", summary: "Bulk rewrite alias targets across modes ({ fromVariableId, toVariableId }[]).", requiresDesignMode: true, dryRunSupported: true },
+        { name: "apply_coverage_suggestions", category: "variables-orchestration", summary: "Apply audit_variable_coverage suggestions as setBoundVariableFor* writes. Dry-run by default.", requiresDesignMode: true, dryRunSupported: true },
     ]);
     category("styles-orchestration", [
-        { name: "import_style_spec", category: "styles-orchestration", summary: "Idempotent bulk-create / update of local Paint / Text / Effect styles from a declarative spec. Dry-run preview supported.", requiresDesignMode: true },
+        { name: "import_style_spec", category: "styles-orchestration", summary: "Idempotent bulk-create / update of local Paint / Text / Effect styles from a declarative spec. Dry-run preview supported.", requiresDesignMode: true, dryRunSupported: true },
         { name: "dedupe_styles", category: "styles-orchestration", summary: "Find / merge duplicate styles (byName | bySignature). Dry-run by default; canvas write only when apply: true.", requiresDesignMode: true },
-        { name: "rebind_style_consumers", category: "styles-orchestration", summary: "Bulk rewrite styleId on every consumer node ({ fromStyleId, toStyleId }[]). Dry-run aware.", requiresDesignMode: true },
+        { name: "rebind_style_consumers", category: "styles-orchestration", summary: "Bulk rewrite styleId on every consumer node ({ fromStyleId, toStyleId }[]). Dry-run aware.", requiresDesignMode: true, dryRunSupported: true },
         { name: "audit_style_drift", category: "styles-orchestration", summary: "READ-ONLY: detect drift between local Paint styles and same-named Variables / explicit expectations." },
-        { name: "apply_style_coverage_suggestions", category: "styles-orchestration", summary: "Apply audit_style_coverage suggestions as setStyleId writes. Dry-run by default.", requiresDesignMode: true },
+        { name: "apply_style_coverage_suggestions", category: "styles-orchestration", summary: "Apply audit_style_coverage suggestions as setStyleId writes. Dry-run by default.", requiresDesignMode: true, dryRunSupported: true },
     ]);
     category("mockup", [
-        { name: "find_components", category: "mockup", summary: "READ-ONLY: paginated catalogue of local + (opt) library components used in this file (id, key, name, parent set, defaultVariantId, propertyDefinitions)." },
-        { name: "build_mockup", category: "mockup", summary: "Assemble an auto-layout mockup from a declarative item tree (instance + section + spacer + text). Supports property / text / fill-binding overrides. Dry-run preview supported.", requiresDesignMode: true },
-        { name: "apply_mockup_dataset", category: "mockup", summary: "Clone a template scene node once per dataset row and apply row-specific overrides (properties, text, fill bindings). Dry-run preview supported.", requiresDesignMode: true },
+        {
+            name: "inspect_design_system",
+            category: "mockup",
+            summary: "READ-ONLY: aggregate components, variables, styles, token config, and composition index for design agents.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["find_components", "get_variables", "get_local_styles", "get_tokens_config", "list_compositions"],
+            returnsLargeData: true,
+            preferredBefore: ["build_screen", "build_mockup"],
+        },
+        {
+            name: "validate_screen_spec",
+            category: "mockup",
+            summary: "READ-ONLY: validate Design DSL v1 screen spec before writing to Figma.",
+            execution: "bridge-local",
+            dryRunSupported: true,
+            preferredBefore: ["build_screen", "update_screen"],
+        },
+        { name: "build_screen", category: "mockup", summary: "Build a screen using Design DSL v1; Bridge wrapper over build_mockup with agent-friendly naming.", commandType: "build_mockup", requiresDesignMode: true, dryRunSupported: true, preferredBefore: ["inspect_design_system", "validate_screen_spec"] },
+        { name: "update_screen", category: "mockup", summary: "Update an existing screen/frame using Design DSL v1 without recreating the whole file.", requiresDesignMode: true, dryRunSupported: true, preferredBefore: ["inspect_design_system", "validate_screen_spec"] },
+        { name: "find_components", category: "mockup", summary: "READ-ONLY: paginated catalogue of local + (opt) library components used in this file (id, key, name, parent set, defaultVariantId, propertyDefinitions).", returnsLargeData: true },
+        { name: "build_mockup", category: "mockup", summary: "Assemble an auto-layout mockup from a declarative item tree (instance + section + spacer + text). Supports property / text / fill-binding overrides. Dry-run preview supported.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "apply_mockup_dataset", category: "mockup", summary: "Clone a template scene node once per dataset row and apply row-specific overrides (properties, text, fill bindings). Dry-run preview supported.", requiresDesignMode: true, dryRunSupported: true },
     ]);
     category("compositions-orchestration", [
-        { name: "bulk_generate_compositions", category: "compositions-orchestration", summary: "Bulk generate / apply many composition files in one call. Filters by fileIds | names | prefix; per-item error isolation; dry-run preview supported.", requiresDesignMode: true, requiresComposition: true },
+        { name: "bulk_generate_compositions", category: "compositions-orchestration", summary: "Bulk generate / apply many composition files in one call. Filters by fileIds | names | prefix; per-item error isolation; dry-run preview supported.", requiresDesignMode: true, requiresComposition: true, dryRunSupported: true },
         { name: "audit_composition_drift", category: "compositions-orchestration", summary: "READ-ONLY drift detector between composition files and the Figma components they tracked (linked | unlinked | drift | missing).", requiresComposition: true },
     ]);
     category("audit", [
         { name: "analyze_variable_usage", category: "audit", summary: "Summarise where a variable is used (counts, byProperty, aliasChain). Read-only." },
-        { name: "find_variable_usages", category: "audit", summary: "Paginated detail list of nodes using a variable." },
+        { name: "find_variable_usages", category: "audit", summary: "Paginated detail list of nodes using a variable.", returnsLargeData: true },
         { name: "render_variable_usage_page", category: "audit", summary: "Clone every usage of a variable into a fresh page.", requiresDesignMode: true },
         { name: "audit_variable_coverage", category: "audit", summary: "Find raw values that should be variables (summary + topOffenders)." },
-        { name: "find_variable_coverage_misses", category: "audit", summary: "Paginated detail for audit_variable_coverage." },
+        { name: "find_variable_coverage_misses", category: "audit", summary: "Paginated detail for audit_variable_coverage.", returnsLargeData: true },
         { name: "audit_style_coverage", category: "audit", summary: "Find raw values that should be styles (summary)." },
-        { name: "find_style_coverage_misses", category: "audit", summary: "Paginated detail for audit_style_coverage." },
-        { name: "find_unused_variables", category: "audit", summary: "List local variables that nothing references." },
-        { name: "find_unused_styles", category: "audit", summary: "List local Paint / Text / Effect styles that nothing references." },
+        { name: "find_style_coverage_misses", category: "audit", summary: "Paginated detail for audit_style_coverage.", returnsLargeData: true },
+        { name: "find_unused_variables", category: "audit", summary: "List local variables that nothing references.", returnsLargeData: true },
+        { name: "find_unused_styles", category: "audit", summary: "List local Paint / Text / Effect styles that nothing references.", returnsLargeData: true },
+        { name: "analyze_component_usage", category: "audit", summary: "Summarise local/remote component instance usage by component selector.", returnsLargeData: false },
+        { name: "find_component_usages", category: "audit", summary: "Paginated list of component instances matching a component selector.", returnsLargeData: true },
+        { name: "analyze_component_prop_usage", category: "audit", summary: "Summarise instance component property usage by property/value filters.", returnsLargeData: false },
+        { name: "find_component_prop_usages", category: "audit", summary: "Paginated component property usage records.", returnsLargeData: true },
     ]);
     category("orchestration", [
-        { name: "index_icons_for_export", category: "orchestration", summary: "Read-only icon index: COMPONENT + COMPONENT_SET variants with page/section metadata for export pipelines." },
-        { name: "generate_code_from_url", category: "orchestration", summary: "Parse Figma URL → run get_codegen on target node.", requiresComposition: true },
-        { name: "compose_from_url", category: "orchestration", summary: "Parse Figma URL → export_composition_json → save as composition file → optional generate.", requiresComposition: true },
-        { name: "document_component", category: "orchestration", summary: "Generate SXL documentation payload for a component and apply it.", requiresDesignMode: true, requiresComposition: true },
-        { name: "build_token_documentation", category: "orchestration", summary: "Doc Spec v1: resolve token paths and fill doc template TEXT by layer name.", requiresDesignMode: true },
-        { name: "apply_doc_spec", category: "orchestration", summary: "Doc Spec v2 (canonical): apply a list of documentation sections to a Figma frame.", requiresDesignMode: true },
-        { name: "bind_variable_palette", category: "orchestration", summary: "Doc Builder: render Figma variable collection as cards by cloning a swatch template.", requiresDesignMode: true },
-        { name: "build_component_doc", category: "orchestration", summary: "Doc Builder: title + variants matrix + props table for a component / component set.", requiresDesignMode: true },
-        { name: "build_doc_flow", category: "orchestration", summary: "Doc Builder: render multi-page flow / scenario in an auto-layout container.", requiresDesignMode: true },
-        { name: "list_tools", category: "orchestration", summary: "List all Bridge MCP tools with metadata." },
+        {
+            name: "index_icons_for_export",
+            category: "orchestration",
+            summary: "Read-only icon index: COMPONENT + COMPONENT_SET variants with page/section metadata for export pipelines.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["get_pages", "get_node_tree"],
+        },
+        {
+            name: "generate_code_from_url",
+            category: "orchestration",
+            summary: "Parse Figma URL → run get_codegen on target node.",
+            commandType: "get_codegen",
+            execution: "bridge-orchestration",
+            requiresComposition: true,
+        },
+        {
+            name: "compose_from_url",
+            category: "orchestration",
+            summary: "Parse Figma URL → export_composition_json → save as composition file → optional generate.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["export_composition_json", "create_token_file", "generate_composition"],
+            requiresComposition: true,
+        },
+        {
+            name: "document_component",
+            category: "orchestration",
+            summary: "Generate SXL documentation payload for a component and apply it.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["get_codegen", "apply_documentation_payload"],
+            requiresDesignMode: true,
+            requiresComposition: true,
+        },
+        { name: "build_token_documentation", category: "orchestration", summary: "Doc Spec v1: resolve token paths and fill doc template TEXT by layer name.", commandType: "apply_token_doc_spec", requiresDesignMode: true, dryRunSupported: true },
+        { name: "apply_doc_spec", category: "orchestration", summary: "Doc Spec v2 (canonical): apply a list of documentation sections to a Figma frame.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "bind_variable_palette", category: "orchestration", summary: "Doc Builder: render Figma variable collection as cards by cloning a swatch template.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "build_component_doc", category: "orchestration", summary: "Doc Builder: title + variants matrix + props table for a component / component set.", requiresDesignMode: true, dryRunSupported: true },
+        { name: "build_doc_flow", category: "orchestration", summary: "Doc Builder: render multi-page flow / scenario in an auto-layout container.", requiresDesignMode: true, dryRunSupported: true },
+        {
+            name: "build_scenario_from_md",
+            category: "orchestration",
+            summary: "Parse markdown scenario into build_doc_flow pages. Dry-run preview supported.",
+            execution: "bridge-orchestration",
+            pluginCommandTypes: ["build_doc_flow"],
+            requiresDesignMode: true,
+            dryRunSupported: true,
+        },
+        { name: "get_capability_matrix", category: "orchestration", summary: "Machine-readable Bridge capability matrix: catalogue metadata + command type + timeout.", execution: "bridge-local" },
+        {
+            name: "get_contract_audit",
+            category: "orchestration",
+            summary: "Bridge-local release contract audit: catalogue mapping, meta tools, recipes, schema entrypoints, workflow gates, and findings.",
+            execution: "bridge-local",
+            aliases: ["contract audit", "release audit", "проверка контрактов"],
+            naturalLanguageIntents: ["Verify Bridge contract health before release or before connecting an agent."],
+        },
+        {
+            name: "get_figma_mcp_parity",
+            category: "orchestration",
+            summary: "Bridge-local parity map: official Figma MCP tools → Bridge/SXL equivalents, companion requirements, future/unsupported scope.",
+            execution: "bridge-local",
+            aliases: ["figma mcp parity", "mcp coverage", "паритет figma mcp"],
+            naturalLanguageIntents: ["Decide whether to use SXL Bridge or official Figma MCP for a requested Figma workflow."],
+        },
+        {
+            name: "get_figma_mcp_skills_parity",
+            category: "orchestration",
+            summary: "Bridge-local parity map: official Figma MCP skills → SXL Bridge recipes/resources, companion requirements, and agent-side implementation boundaries.",
+            execution: "bridge-local",
+            aliases: ["figma skills parity", "mcp skills coverage", "паритет figma skills"],
+            naturalLanguageIntents: ["Decide how an official Figma MCP skill maps to SXL Bridge recipes, resources, tools, or companion scope."],
+            preferredAfter: ["get_figma_mcp_parity"],
+        },
+        {
+            name: "get_performance_profile",
+            category: "orchestration",
+            summary: "Bridge-local performance profile: command budgets, large-data/dry-run policies, destructive-write warnings, and recent audit timings.",
+            execution: "bridge-local",
+            aliases: ["performance profile", "tool budgets", "профиль производительности", "проверка скорости"],
+            naturalLanguageIntents: ["Understand which Bridge commands are fast, large, long-running, dry-run-first, or risky before executing a workflow."],
+        },
+        {
+            name: "get_bridge_audit_log",
+            category: "orchestration",
+            summary: "Bridge-local sanitized command audit log from memory or persisted disk JSONL.",
+            execution: "bridge-local",
+            aliases: ["audit log", "bridge log", "журнал bridge", "лог команд"],
+            naturalLanguageIntents: ["Inspect recent Bridge command history, failures, timings, and payload keys without exposing payload values."],
+            returnsLargeData: true,
+            preferredAfter: ["get_performance_profile"],
+        },
+        {
+            name: "get_bridge_runtime_summary",
+            category: "orchestration",
+            summary: "Bridge-local runtime summary: plugin connection, queue pressure, recent events/audit failures, MCP URL, auth flag, and recommendations.",
+            execution: "bridge-local",
+            aliases: ["runtime summary", "bridge status summary", "оперативный статус", "сводка bridge"],
+            naturalLanguageIntents: ["Check whether Bridge is ready for a heavy workflow and what preflight steps are needed."],
+            preferredBefore: ["plan_workflow", "preview_workflow", "export_variables", "build_screen"],
+        },
+        {
+            name: "get_operator_runbook",
+            category: "orchestration",
+            summary: "Bridge-local start-here operator runbook: common workflows, safety rules, preferred tools, dry-run gates, and Figma MCP companion handoff.",
+            execution: "bridge-local",
+            aliases: ["operator runbook", "agent runbook", "start here", "гайд оператора", "инструкция агенту"],
+            naturalLanguageIntents: ["Choose the correct SXL Bridge workflow, resources, and dry-run gates for a broad Figma/SXL user request."],
+            preferredBefore: ["route_intent", "plan_workflow", "preview_workflow"],
+        },
+        {
+            name: "get_ultimate_readiness",
+            category: "orchestration",
+            summary: "Bridge-local requirement-by-requirement readiness audit for the Ultimate Bridge Toolkit plan.",
+            execution: "bridge-local",
+            aliases: ["ultimate readiness", "readiness audit", "итоговый аудит", "аудит готовности"],
+            naturalLanguageIntents: ["Verify whether Bridge satisfies the Ultimate Toolkit plan across SXL workflows, Figma MCP parity, production safety, docs/resources, and agent readiness."],
+            preferredAfter: ["get_contract_audit", "get_figma_mcp_parity", "get_figma_mcp_skills_parity", "get_performance_profile"],
+        },
+        { name: "list_tools", category: "orchestration", summary: "List all Bridge MCP tools with metadata.", execution: "bridge-local" },
+        {
+            name: "route_intent",
+            category: "orchestration",
+            summary: "Bridge-local natural-language router: user request → ranked SXL recipes, preferred tools, schema resources, and dry-run policy.",
+            execution: "bridge-local",
+            aliases: ["intent router", "natural language routing", "подбери команду"],
+            naturalLanguageIntents: ["Pick the correct Bridge recipe and tool chain from a broad RU/EN user request."],
+        },
+        {
+            name: "plan_workflow",
+            category: "orchestration",
+            summary: "Bridge-local workflow planner: request/recipe → resources, expected tools, dry-run gates, approval gates, done criteria.",
+            execution: "bridge-local",
+            aliases: ["workflow plan", "план workflow", "план действий"],
+            naturalLanguageIntents: ["Plan a multi-step SXL/Figma workflow before executing plugin commands."],
+            preferredBefore: ["preview_workflow"],
+        },
+        {
+            name: "preview_workflow",
+            category: "orchestration",
+            summary: "Bridge-local workflow validator: proposed tool sequence → findings for missing status/discovery/dry-run gates.",
+            execution: "bridge-local",
+            aliases: ["workflow preview", "validate workflow", "проверь план"],
+            naturalLanguageIntents: ["Validate an agent's proposed Bridge tool sequence before executing it."],
+            preferredAfter: ["plan_workflow"],
+        },
     ]);
 }
+export function ensureBridgeToolCatalogue() {
+    if (getBridgeToolCatalogue().length === 0) {
+        bootstrapBridgeToolCatalogue();
+    }
+}
 //# sourceMappingURL=catalogue-bootstrap.js.map