@sxl-studio/bridge 1.7.2 → 1.8.0

package/dist/agent-recipes.d.ts

@@ -21,6 +21,42 @@ export declare const RECIPE_INDEX: {
     readonly version: 1;
     readonly context: "Decision tree for any documentation / palette / scenario request that targets a Figma file managed by SXL Studio. Always read this resource first; it routes the agent to a specific recipe instead of running ad-hoc figma.* JS.";
     readonly userIntents: readonly [{
+        readonly recipeId: "sxl-use";
+        readonly userPhrases: readonly ["управляй фигмой через bridge", "figma-use", "use_figma", "use figma to update the current design file", "create or modify nodes in figma", "read selection and edit canvas", "назначь переменные объектам", "work with variables styles and components", "use figma rest api", "diagnose figma rest token", "whoami figma token", "search known figma library", "get_libraries", "search_design_system", "search design system library", "upload images to figma", "загрузи изображения в фигму"];
+    }, {
+        readonly recipeId: "sxl-implement-design";
+        readonly userPhrases: readonly ["figma-implement-design", "figma-swiftui", "implement this figma design in swiftui", "convert figma selection to swiftui", "implement this figma design in code", "turn figma selection into code", "convert figma selection to code", "реализуй выбранный макет в коде"];
+    }, {
+        readonly recipeId: "sxl-generate-design";
+        readonly userPhrases: readonly ["нарисуй экран в фигме", "figma-generate-design", "generate_figma_design", "code to canvas", "push app page into figma", "build a real UI screen in Figma", "собери макет из дизайн-системы", "update this screen without rebuilding everything", "validate screen spec before applying"];
+    }, {
+        readonly recipeId: "sxl-generate-library";
+        readonly userPhrases: readonly ["создай дизайн-систему в фигме", "figma-generate-library", "generate a figma design system library", "generate library in figma from codebase", "generate library variables styles components docs", "экспортируй переменные и стили", "пересобери компоненты из композиций", "build design system foundations", "figma-create-design-system-rules", "create design system rules for this project", "generate rules for translating figma designs into code"];
+    }, {
+        readonly recipeId: "sxl-code-connect";
+        readonly userPhrases: readonly ["настрой code connect", "figma-code-connect", "figma-code-connect-components", "get_context_for_code_connect", "send_code_connect_mappings", "save code connect binding", "свяжи figma компонент с storybook", "show code connect registry", "component docs url files storybook binding"];
+    }, {
+        readonly recipeId: "sxl-audit";
+        readonly userPhrases: readonly ["проведи аудит макетов", "analyze variables styles and component usage", "проверь пропсы компонентов", "найди компоненты с prop value", "audit coverage drift unused analytics"];
+    }, {
+        readonly recipeId: "sxl-doc-builder";
+        readonly userPhrases: readonly ["нарисуй документацию в фигме", "build documentation in Figma", "документация компонентов токенов флоу", "render markdown scenario as Figma flow", "apply doc spec"];
+    }, {
+        readonly recipeId: "sxl-data-apply-mapping";
+        readonly userPhrases: readonly ["примени маппинг", "примени mapping", "apply mapping to selection", "apply data mapping", "подставь данные по маппингу", "fill selected nodes from dataset"];
+    }, {
+        readonly recipeId: "sxl-data-apply-all";
+        readonly userPhrases: readonly ["примени все маппинги", "apply all mappings", "apply all data mappings", "подставь данные по всем маппингам", "apply mappings on page", "apply mappings to document"];
+    }, {
+        readonly recipeId: "sxl-data-generate-instances";
+        readonly userPhrases: readonly ["сгенерируй инстансы из датасета", "generate instances from dataset", "generate instances from mapping", "создай строки из датасета", "render rows from mapping data", "generate cards from dataset mapping"];
+    }, {
+        readonly recipeId: "sxl-database-transfer";
+        readonly userPhrases: readonly ["экспортируй базу sxl", "импортируй базу sxl", "backup sxl database", "restore sxl database", "export database payload", "import database payload", "перенеси datasets assets mappings"];
+    }, {
+        readonly recipeId: "figma-mcp-companion";
+        readonly userPhrases: readonly ["figma-create-new-file", "create_new_file", "create a new figma file", "new figma design file", "figma-generate-diagram", "generate_diagram", "create a figjam diagram", "figma-use-figjam", "figma-use-slides", "create figma slides"];
+    }, {
         readonly recipeId: "doc-tokens";
         readonly userPhrases: readonly ["задокументируй токены", "build a token doc", "table of token values", "fill template TEXT layers with token values", "tokenPath, layerName binding", "show DTCG paths in doc frame"];
     }, {
@@ -49,7 +85,7 @@ export declare const RECIPE_INDEX: {
         readonly userPhrases: readonly ["сколько раз используется accent.medium", "where is this variable used", "посчитай где используется переменная", "render a page with all usages of accent.medium", "найди все объекты с переменной", "show me everywhere this token appears", "выведи на страницу все места где встречается переменная"];
     }, {
         readonly recipeId: "audit-coverage";
-        readonly userPhrases: readonly ["проверь везде ли подкреплены переменные", "найди объекты без переменных", "audit raw values without variables", "review the file for missing bindings", "где hex заливки вместо токенов", "найди объекты с дефолтными цветами"];
+        readonly userPhrases: readonly ["проверь везде ли подкреплены переменные", "проверь на всех макетах установлены ли переменные и стили", "проверь на всех ли макетах и объектах установленные переменные", "проверь переменные и стили на макетах", "найди объекты без переменных", "check whether every screen object has variables and styles assigned", "check variable and style coverage across layouts", "audit raw values without variables", "review the file for missing bindings", "где hex заливки вместо токенов", "найди объекты с дефолтными цветами"];
     }, {
         readonly recipeId: "find-unused";
         readonly userPhrases: readonly ["какие переменные у меня не используются", "find unused variables", "which styles are dead", "почисть неиспользуемые токены", "найди мёртвые стили"];
@@ -151,6 +187,218 @@ export declare const RECIPE_INDEX: {
     readonly forbidden: readonly ["Calling use_figma with a hand-written figma.* script when an SXL Bridge tool covers the task.", "Shell payload assembly to /tmp/*.json + base64 loaders + node -e glue to invoke MCP.", "Hand-crafting composition / token / Doc Spec JSON when the plugin pipeline (export_composition_json / list_compositions / get_variables) is the source of truth.", "Skipping this index and jumping straight to a sub-recipe without confirming intent."];
     readonly doneCriteria: "Agent picked exactly one recipe, called only the tools it lists, and produced a verifiable result (doneWhen of that recipe).";
 };
+export declare const RECIPE_SXL_USE: {
+    readonly id: "sxl-use";
+    readonly title: "SXL Use — read/write the current Figma Design file through Bridge";
+    readonly version: 1;
+    readonly context: "Foundational SXL skill for canvas reads/writes, variables, styles, components, token workspace operations, status checks, and design-to-code context. Mirrors the role of figma-use for SXL Studio and supplies the active-file context needed by figma-implement-design-style workflows: prefer Bridge tools and plugin handlers over arbitrary use_figma scripts.";
+    readonly userPhrases: readonly ["управляй фигмой через bridge", "create or modify nodes in figma", "read selection and edit canvas", "назначь переменные объектам", "work with variables styles and components", "figma-implement-design", "implement this figma design in code", "turn figma selection into code", "diagnose figma rest token", "whoami figma token", "search known figma library", "get_libraries", "search_design_system", "search organization design library", "get variable definitions used in selection", "покажи переменные и стили выделения"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-use", "sxl-generate-design"];
+        readonly hint: "sxl-use handles low-level targeted reads/writes; sxl-generate-design assembles or updates full screens via Design DSL.";
+    }, {
+        readonly between: readonly ["sxl-use", "sxl-audit"];
+        readonly hint: "sxl-use writes after the target is known; sxl-audit discovers usage, coverage, drift, unused entries, or component prop statistics first.";
+    }];
+    readonly preferredTools: readonly ["get_bridge_runtime_summary", "get_plugin_status", "get_capability_matrix", "get_figma_mcp_skills_parity", "list_tools", "get_selection", "get_design_context", "get_metadata", "get_node_info", "get_node_tree", "get_screenshot", "get_variable_defs", "get_context_for_code_connect", "get_code_connect_suggestions", "get_libraries", "search_design_system", "get_variables", "get_local_styles", "search_enabled_library_assets", "inspect_enabled_libraries", "list_enabled_library_variables", "figma_rest_diagnose", "figma_rest_whoami", "figma_rest_get_file_nodes", "figma_rest_search_design_system", "upload_assets", "set_node_fill_variable", "batch_bind_variables"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/code-connect-context-v1"];
+    readonly forbidden: readonly ["Calling use_figma with a hand-written figma.* script when a Bridge tool exists.", "Writing canvas changes before checking get_plugin_status.writesAllowed.", "Fetching image URLs in an ad-hoc script or sending raw imageBytes arrays when upload_assets can validate and apply assets.", "Looping single-node writes for bulk variable binding when batch_bind_variables covers the request."];
+    readonly steps: readonly ["Call get_bridge_runtime_summary before heavy workflows to check plugin connection, queue pressure, recent failures, and auth status.", "Call get_plugin_status and inspect editorType / writesAllowed before any write.", "Call get_capability_matrix or list_tools if tool choice is uncertain; prefer tools with dryRunSupported for writes.", "For Figma MCP-style library discovery, prefer get_libraries and search_design_system; they combine active-file enabled libraries, local components, and known REST file/team libraries where configured.", "When the plugin is not open, cross-file context is needed, or the request targets a known file/team library outside the active file, call figma_rest_diagnose first; get_libraries/search_design_system can then use fileKey/url/teamId with a configured FIGMA_TOKEN / FIGMA_ACCESS_TOKEN.", "For image insertion in Figma Design, call upload_assets with dryRun=true first; it validates PNG/JPG/GIF/WebP assets up to 10MB and applies them through set_image_fill.", "Read the narrowest needed context: current selection, node tree, variables, or styles.", "For design implementation requests, call get_design_context plus get_variable_defs/get_screenshot/get_context_for_code_connect when components or code mappings matter; the agent then edits project code outside the plugin.", "For writes, use the thickest Bridge command that covers the task; fall back to direct canvas tools only for small targeted edits.", "After writes, inspect the changed node or rerun the relevant audit/read tool."];
+    readonly doneCriteria: "Agent completed the requested Figma operation through Bridge tools, respected Design/Dev mode constraints, and did not use arbitrary use_figma scripts.";
+};
+export declare const RECIPE_SXL_IMPLEMENT_DESIGN: {
+    readonly id: "sxl-implement-design";
+    readonly title: "SXL Implement Design — read Figma context for code implementation";
+    readonly version: 1;
+    readonly context: "Read-only Bridge workflow for Figma-to-code requests, including current official figma-swiftui and legacy/client figma-implement-design-style aliases. It gathers active-file design context, screenshots, variable/style definitions, SXL codegen/composition data, and Code Connect hints so the agent can edit the repository code outside Figma. It must not mutate the Figma canvas.";
+    readonly userPhrases: readonly ["figma-implement-design", "figma-swiftui", "implement this figma design in swiftui", "convert figma selection to swiftui", "implement this figma design in code", "turn figma selection into code", "convert figma selection to code", "реализуй выбранный макет в коде"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-implement-design", "sxl-use"];
+        readonly hint: "sxl-implement-design is read-only context for code implementation; sxl-use is broad active-file read/write control.";
+    }, {
+        readonly between: readonly ["sxl-implement-design", "sxl-generate-design"];
+        readonly hint: "sxl-implement-design turns Figma into repository code; sxl-generate-design builds Figma screens from a spec/code context.";
+    }];
+    readonly preferredTools: readonly ["get_bridge_runtime_summary", "get_figma_mcp_skills_parity", "get_design_context", "get_metadata", "get_screenshot", "get_variable_defs", "get_context_for_code_connect", "get_code_connect_suggestions", "get_codegen", "export_composition_json"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/code-connect-context-v1"];
+    readonly forbidden: readonly ["Mutating the Figma canvas for an implement-design request.", "Calling upload_assets, set_node_fill_variable, batch_bind_variables, build_screen, or export_variables.", "Treating SXL codegen as final project code without adapting it to repository components and conventions."];
+    readonly steps: readonly ["Call get_bridge_runtime_summary to confirm Bridge/plugin state and queue pressure.", "Call get_design_context for the selected frame/component; include screenshot/context options when useful.", "Call get_variable_defs and get_screenshot when visual/token fidelity matters.", "Call get_context_for_code_connect and get_code_connect_suggestions when component mappings or Storybook context matter.", "Use get_codegen/export_composition_json only as reference material; then edit repository code with normal project tooling."];
+    readonly doneCriteria: "Agent collected read-only Figma/SXL context and implemented or updated repository code without mutating the Figma file.";
+};
+export declare const RECIPE_SXL_GENERATE_DESIGN: {
+    readonly id: "sxl-generate-design";
+    readonly title: "SXL Generate Design — build or update real UI screens in Figma";
+    readonly version: 1;
+    readonly context: "Screen-building skill for real editable Figma Design files. Use inspect_design_system + validate_screen_spec + build_screen/update_screen first; direct canvas tools are fallback only.";
+    readonly userPhrases: readonly ["нарисуй экран в фигме", "build a real UI screen in Figma", "собери макет из дизайн-системы", "update this screen without rebuilding everything", "validate screen spec before applying"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-generate-design", "mockup-builder"];
+        readonly hint: "sxl-generate-design is the top-level screen skill; mockup-builder is the detailed recipe for the underlying build_mockup/build_screen DSL.";
+    }, {
+        readonly between: readonly ["sxl-generate-design", "sxl-doc-builder"];
+        readonly hint: "generate-design builds product UI screens; doc-builder builds documentation pages, palettes, component docs, and flows.";
+    }];
+    readonly preferredTools: readonly ["inspect_design_system", "validate_screen_spec", "build_screen", "update_screen", "find_components", "search_enabled_library_assets", "inspect_enabled_libraries", "get_variables", "audit_variable_coverage"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/design-dsl-v1"];
+    readonly forbidden: readonly ["Creating a screen by hand with many create_frame/create_text/create_component_instance calls when build_screen covers it.", "Guessing component names or component prop keys without inspect_design_system / find_components.", "Committing build_screen/update_screen without a dryRun or validate_screen_spec preview.", "Hardcoding hex colors when a local Figma Variable is available."];
+    readonly steps: readonly ["Run inspect_design_system with includeProperties and a narrow query/prefix when possible; use search_enabled_library_assets when the user expects components/styles/variables from libraries enabled in the current file.", "Draft a Design DSL v1 spec using real component ids/keys, human prop keys, text overrides, and variable fill bindings.", "Call validate_screen_spec or build_screen/update_screen with dryRun: true and fix any unresolved components/props.", "Commit build_screen or update_screen only after the dry-run plan is clean or approved.", "Run audit_variable_coverage on the resulting root/page when variable binding quality matters."];
+    readonly doneCriteria: "A real Figma screen was created or updated with existing components, auto layout, and variable/style bindings where available. The flow used dryRun before write.";
+};
+export declare const RECIPE_SXL_GENERATE_LIBRARY: {
+    readonly id: "sxl-generate-library";
+    readonly title: "SXL Generate Library — variables, styles, compositions, and docs";
+    readonly version: 1;
+    readonly context: "Design-system skill for SXL Studio. Covers safe export_variables modes, bulk variable/style specs, composition generation, drift checks, library documentation, and the SXL context needed by figma-create-design-system-rules-style agent workflows.";
+    readonly userPhrases: readonly ["создай дизайн-систему в фигме", "generate library variables styles components docs", "экспортируй переменные и стили", "пересобери компоненты из композиций", "build design system foundations", "figma-create-design-system-rules", "create design system rules for this project", "generate rules for translating figma designs into code"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-generate-library", "bulk-variables"];
+        readonly hint: "use bulk-variables for variable-only refactors; use sxl-generate-library when variables, styles, compositions, and docs are part of one system workflow.";
+    }, {
+        readonly between: readonly ["sxl-generate-library", "bulk-compositions"];
+        readonly hint: "bulk-compositions rebuilds existing composition files; sxl-generate-library orchestrates the broader library pipeline.";
+    }];
+    readonly preferredTools: readonly ["get_tokens_config", "get_figma_mcp_skills_parity", "search_enabled_library_assets", "inspect_enabled_libraries", "list_enabled_library_variables", "inspect_design_system", "get_context_for_code_connect", "get_code_connect_suggestions", "preview_export_variables", "export_variables", "import_variable_spec", "import_style_spec", "list_compositions", "bulk_generate_compositions", "audit_composition_drift", "build_component_doc"];
+    readonly forbidden: readonly ["Using destructive export options such as deleteOrphans, forceUpdateAll, or allowDestructiveReorder unless the user explicitly asked for them.", "Claiming export_variables applies codeSyntax/scopes by default; plugin safe default is applyCodeSyntaxAndScopes=false.", "Hand-crafting composition JSON instead of export_composition_json / compose_from_url / list_compositions.", "Bulk-generating compositions without dryRun first."];
+    readonly steps: readonly ["Read get_tokens_config and list_token_files/list_compositions to understand the workspace; use inspect_enabled_libraries/list_enabled_library_variables when reconciling enabled library definitions.", "For design-system-rules requests, call inspect_design_system and get_context_for_code_connect/get_code_connect_suggestions when code mappings matter; the agent writes the client-specific rule file in the repository, not through a plugin command.", "For token export, call preview_export_variables first; then call export_variables with only explicit settings and keep safe defaults unless requested.", "For large variable/style changes, use import_variable_spec/import_style_spec with dryRun first.", "Run audit_composition_drift before rebuilding existing components; use bulk_generate_compositions dryRun before commit.", "Build documentation with sxl-doc-builder recipes after foundations are generated."];
+    readonly doneCriteria: "Library foundations were exported/generated with non-destructive defaults, drift was inspected before rebuilds, and all bulk writes were previewed first.";
+};
+export declare const RECIPE_SXL_CODE_CONNECT: {
+    readonly id: "sxl-code-connect";
+    readonly title: "SXL Code Connect — bind Figma components to code, Storybook, and docs";
+    readonly version: 1;
+    readonly context: "Code Connect skill for SXL Studio. Manages full CodeConnectBinding payloads: docs URL, files, Storybook, component API, status, registry, and global settings.";
+    readonly userPhrases: readonly ["настрой code connect", "save code connect binding", "свяжи figma компонент с storybook", "show code connect registry", "component docs url files storybook binding"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-code-connect", "doc-component"];
+        readonly hint: "code-connect links Figma nodes to code/docs metadata; doc-component renders documentation on the Figma canvas.";
+    }];
+    readonly preferredTools: readonly ["codeconnect_get_global_settings", "codeconnect_save_global_settings", "codeconnect_get_registry", "codeconnect_get_selection_status", "get_context_for_code_connect", "get_code_connect_suggestions", "generate_code_connect_template", "codeconnect_get_binding", "codeconnect_save_binding", "codeconnect_get_node_ui_status"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/code-connect-context-v1", "sxl://agent/schemas/code-connect-template-v1"];
+    readonly forbidden: readonly ["Saving partial binding metadata that drops docsUrl/files/storybook/component API fields.", "Guessing node ids when selection status can identify the current component.", "Hand-writing filePath/importPath bindings before checking get_context_for_code_connect or get_code_connect_suggestions.", "Writing .figma.ts files without generate_code_connect_template dry-run preview.", "Treating Code Connect as composition JSON; keep bindings as metadata, not generated component structure."];
+    readonly steps: readonly ["Read codeconnect_get_global_settings and codeconnect_get_registry to understand existing defaults.", "Use codeconnect_get_selection_status or get_node_info to confirm target node ids.", "Call get_context_for_code_connect with explicit targets/componentNames or current selection; review existing binding, component props, codegen/composition context, and highest-confidence local code candidates.", "For template-file workflows, call generate_code_connect_template without writeFile first; only writeFile=true after reviewing output path/content.", "Save the chosen binding with full metadata: componentName, docs URL, files[], Storybook data, component API, and status where available.", "Verify with codeconnect_get_binding and codeconnect_get_node_ui_status."];
+    readonly doneCriteria: "Target Figma component has a full Code Connect binding and the registry/UI status reflect it.";
+};
+export declare const RECIPE_SXL_AUDIT: {
+    readonly id: "sxl-audit";
+    readonly title: "SXL Audit — variables, styles, components, props, drift, and unused entries";
+    readonly version: 1;
+    readonly context: "Audit skill for read-only analysis and dry-run-first remediation. Covers variable/style coverage, usage, unused entries, component usage, component prop usage, and composition/style drift.";
+    readonly userPhrases: readonly ["проведи аудит макетов", "analyze variables styles and component usage", "проверь пропсы компонентов", "найди компоненты с prop value", "audit coverage drift unused analytics"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-audit", "audit-coverage"];
+        readonly hint: "audit-coverage is the specialized recipe for missing variable/style bindings; sxl-audit is the broad audit router.";
+    }, {
+        readonly between: readonly ["sxl-audit", "composition-drift"];
+        readonly hint: "composition-drift is composition JSON vs Figma component; sxl-audit can route there when that is the user's unit.";
+    }];
+    readonly preferredTools: readonly ["audit_variable_coverage", "find_variable_coverage_misses", "audit_style_coverage", "find_style_coverage_misses", "analyze_component_usage", "find_component_usages", "analyze_component_prop_usage", "find_component_prop_usages", "find_unused_variables", "find_unused_styles", "audit_composition_drift"];
+    readonly forbidden: readonly ["Walking the entire document manually with use_figma for analytics already covered by Bridge audit tools.", "Requesting full detail lists before running summary tools.", "Applying audit suggestions without preview mode first and explicit user confirmation."];
+    readonly steps: readonly ["Choose the narrowest scope: selection, page, node, then file only when needed.", "Run summary tools first; use find_* paginated tools only for requested details.", "For component prop analytics, use analyze_component_prop_usage for counts and find_component_prop_usages for node ids.", "If the user asks to fix findings, switch to apply_coverage_suggestions / apply_style_coverage_suggestions / batch_bind_variables and preview before committing."];
+    readonly doneCriteria: "Agent returned a scoped audit report with counts and actionable findings; any remediation used preview mode before write.";
+};
+export declare const RECIPE_SXL_DOC_BUILDER: {
+    readonly id: "sxl-doc-builder";
+    readonly title: "SXL Doc Builder — render documentation in Figma";
+    readonly version: 1;
+    readonly context: "Documentation skill for Figma canvas output: token tables, variable palettes, component docs, doc flows, and markdown scenarios. Uses Bridge doc tools, never ad-hoc scripts.";
+    readonly userPhrases: readonly ["нарисуй документацию в фигме", "build documentation in Figma", "документация компонентов токенов флоу", "render markdown scenario as Figma flow", "apply doc spec"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-doc-builder", "doc-component"];
+        readonly hint: "doc-component is the specialized single-component recipe; sxl-doc-builder routes all documentation types.";
+    }, {
+        readonly between: readonly ["sxl-doc-builder", "scenario-from-markdown"];
+        readonly hint: "scenario-from-markdown wins when the user provides markdown H1/H2 scenario text with Figma URLs.";
+    }];
+    readonly preferredTools: readonly ["apply_doc_spec", "build_component_doc", "build_doc_flow", "bind_variable_palette", "build_scenario_from_md", "build_token_documentation"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/doc-spec-v2", "sxl://agent/schemas/token-doc-v1"];
+    readonly forbidden: readonly ["Creating throwaway JS scripts or /tmp payload loaders for documentation.", "Using use_figma to clone templates or enumerate variables when bind_variable_palette/apply_doc_spec exists.", "Hand-crafting composition JSON for docs; use export_composition_json or compose_from_url.", "Skipping dryRun on build_scenario_from_md or doc flows that support preview."];
+    readonly steps: readonly ["Route the request: token table, variable palette, component doc, flow, markdown scenario, or custom Doc Spec v2.", "Read the specialized recipe resource for that route before building payloads.", "Discover targetParentId/templateNodeId/layer names via template-discovery when templates are involved.", "Call the chosen doc tool with dryRun when supported, then commit.", "Inspect the created documentation root or report returned nodes."];
+    readonly doneCriteria: "Documentation was rendered in Figma through Bridge doc tools with real token/variable/component data and without ad-hoc scripts.";
+};
+export declare const RECIPE_SXL_DATA_APPLY_MAPPING: {
+    readonly id: "sxl-data-apply-mapping";
+    readonly title: "SXL Data — apply one mapping to explicit targets or current selection";
+    readonly version: 1;
+    readonly context: "Agent workflow for applying one SXL database mapping to explicit targetNodeIds or the current Figma selection. Agents must preview mapping fields, datasets, and target counts before writing.";
+    readonly userPhrases: readonly ["примени маппинг", "apply mapping to selection", "apply data mapping", "подставь данные по маппингу", "fill selected nodes from dataset"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-data-apply-mapping", "sxl-data-apply-all"];
+        readonly hint: "Use apply-mapping when the user names one mapping or selected target. Use apply-all only when the user says all mappings or whole scope.";
+    }, {
+        readonly between: readonly ["sxl-data-apply-mapping", "sxl-data-generate-instances"];
+        readonly hint: "Use apply-mapping to fill existing selected layers. Use generate-instances when the task needs new rows/cards/instances.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_mappings", "get_mapping", "count_apply_targets", "apply_mapping"];
+    readonly forbidden: readonly ["Calling apply_mapping without dryRun preview and explicit approval.", "Passing legacy targetNodes when targetNodeIds are available; use explicit node ids for deterministic agent control.", "Applying to page/document scope with apply_mapping; use apply_all_mappings for broad scope."];
+    readonly steps: readonly ["Check plugin status and writesAllowed.", "List mappings and read the selected mapping before applying.", "Run count_apply_targets for selection and apply_mapping with dryRun:true.", "Present mapping fields, dataset row hints, and target count.", "Commit apply_mapping only after approval, preferably with targetNodeIds when the intended roots are known."];
+    readonly doneCriteria: "One selected SXL mapping was previewed, approved, and applied to the intended explicit targetNodeIds or current Figma selection.";
+};
+export declare const RECIPE_SXL_DATA_APPLY_ALL: {
+    readonly id: "sxl-data-apply-all";
+    readonly title: "SXL Data — apply all mappings in a scope";
+    readonly version: 1;
+    readonly context: "Agent workflow for applying all SXL mappings to explicit targetNodeIds or a selection/page/document scope. This is a bulk write and must be dry-run previewed before commit.";
+    readonly userPhrases: readonly ["примени все маппинги", "apply all mappings", "apply all data mappings", "подставь данные по всем маппингам", "apply mappings on page", "apply mappings to document"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-data-apply-all", "sxl-data-apply-mapping"];
+        readonly hint: "Use apply-all only when the user explicitly asks for all mappings or a broad scope.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_mappings", "count_apply_targets", "apply_all_mappings"];
+    readonly forbidden: readonly ["Running apply_all_mappings without dryRun preview and explicit approval.", "Defaulting to document scope when the user did not ask for it; prefer selection/page unless specified.", "Deleting or changing mappings as part of apply; this workflow only fills data into existing nodes."];
+    readonly steps: readonly ["Check plugin status and writesAllowed.", "List mappings and choose explicit targetNodeIds when known, otherwise scope: selection, page, or document.", "Run count_apply_targets and apply_all_mappings with dryRun:true.", "Show mapping count, target count, and scope.", "Commit apply_all_mappings only after approval."];
+    readonly doneCriteria: "All requested mappings were previewed and applied only to the approved explicit target roots or Figma scope.";
+};
+export declare const RECIPE_SXL_DATA_GENERATE_INSTANCES: {
+    readonly id: "sxl-data-generate-instances";
+    readonly title: "SXL Data — generate instances from mapping rows";
+    readonly version: 1;
+    readonly context: "Agent workflow for generating repeated component instances/cards/rows from an SXL mapping and dataset. The selected Figma node is the template/container source.";
+    readonly userPhrases: readonly ["сгенерируй инстансы из датасета", "generate instances from dataset", "generate instances from mapping", "создай строки из датасета", "render rows from mapping data", "generate cards from dataset mapping"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-data-generate-instances", "mockup-builder"];
+        readonly hint: "Use generate-instances when a mapping already exists and the selected Figma template should be duplicated. Use mockup-builder for declarative Design DSL screens.";
+    }, {
+        readonly between: readonly ["sxl-data-generate-instances", "sxl-data-apply-mapping"];
+        readonly hint: "Use generate-instances to create new repeated nodes; use apply-mapping to fill existing selected nodes.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_mappings", "get_mapping", "generate_instances"];
+    readonly forbidden: readonly ["Calling generate_instances without dryRun preview and explicit approval.", "Generating rows without targetNodeIds when the intended template/container root is already known.", "Hand-duplicating components through low-level canvas tools when the existing SXL generation engine should be used."];
+    readonly steps: readonly ["Check plugin status and writesAllowed.", "List mappings and read the mapping/dataset relationship.", "Use explicit targetNodeIds for the template/container root when known; otherwise confirm the active Figma selection.", "Run generate_instances with dryRun:true to estimate rows and validate mapping fields.", "Show requested row count, estimated generated rows, and dataset row counts.", "Commit generate_instances only after approval, preferably with targetNodeIds for deterministic remote control."];
+    readonly doneCriteria: "Instances were generated through SXL's mapping engine after dry-run preview, with the approved row count and intended explicit targetNodeIds or confirmed active selection.";
+};
+export declare const RECIPE_SXL_DATABASE_TRANSFER: {
+    readonly id: "sxl-database-transfer";
+    readonly title: "SXL Database — portable datasets/assets/mappings payloads";
+    readonly version: 1;
+    readonly context: "Agent workflow for backing up, restoring, or moving SXL Studio database datasets, local assets, and mappings between files/workspaces using portable Bridge payloads.";
+    readonly userPhrases: readonly ["экспортируй базу sxl", "импортируй базу sxl", "backup sxl database", "restore sxl database", "export database payload", "import database payload", "перенеси datasets assets mappings"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-database-transfer", "sxl-data-apply-mapping"];
+        readonly hint: "Use database-transfer for moving/storing datasets/assets/mappings. Use data-apply when the goal is to fill nodes on canvas.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_datasets", "list_assets", "list_mappings", "export_database_payload", "import_database_payload"];
+    readonly forbidden: readonly ["Importing payloads without dryRun preview.", "Overwriting existing ids without confirmDestructive:true and a human-readable destructiveReason.", "Including asset content in export unless the user needs a full backup/restore payload."];
+    readonly steps: readonly ["Check plugin status and inspect existing datasets/assets/mappings.", "For backup/transfer, call export_database_payload; include asset content only when needed.", "For restore/import, call import_database_payload with dryRun:true first.", "Review counts, conflicts, and warnings.", "Commit import only after approval; existing id conflicts require destructive confirmation and reason."];
+    readonly doneCriteria: "SXL database payload was exported or imported through Bridge with dry-run conflict review and no accidental overwrites.";
+};
+export declare const RECIPE_FIGMA_MCP_COMPANION: {
+    readonly id: "figma-mcp-companion";
+    readonly title: "Official Figma MCP Companion — remote-only and non-Design scopes";
+    readonly version: 1;
+    readonly context: "Routing recipe for official Figma MCP features that Bridge should not fake through the local SXL plugin: new-file creation, FigJam/Slides, diagram generation, and hosted remote-only workflows. Bridge can explain parity and prepare local SXL context, but the agent must call official Figma MCP tools for these capabilities.";
+    readonly userPhrases: readonly ["figma-create-new-file", "create_new_file", "create a new figma file", "figma-generate-diagram", "generate_diagram", "create a figjam diagram", "figma-use-figjam", "figma-use-slides"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["figma-mcp-companion", "sxl-use"];
+        readonly hint: "Use sxl-use for the active Figma Design file, SXL plugin workflows, Figma Design asset upload, and get_libraries/search_design_system. Use companion when the request names remote-only official Figma MCP features, FigJam, Slides, or new-file creation.";
+    }, {
+        readonly between: readonly ["figma-mcp-companion", "sxl-generate-design"];
+        readonly hint: "Use sxl-generate-design when building into an existing Figma Design file through SXL Bridge. Use companion when the first step is creating a new Figma file or using official generate_figma_design in a supported hosted MCP client.";
+    }];
+    readonly preferredTools: readonly ["get_figma_mcp_parity", "get_bridge_runtime_summary", "figma_rest_diagnose"];
+    readonly forbidden: readonly ["Pretending Bridge can create new Figma files, FigJam boards, Slides decks, or Mermaid diagrams through the local plugin.", "Routing Figma Design get_libraries/search_design_system to companion without first checking Bridge get_libraries/search_design_system coverage.", "Replacing official Figma MCP FigJam/Slides workflows with Figma Design canvas commands."];
+    readonly steps: readonly ["Call get_figma_mcp_parity to identify the exact official Figma MCP companion tool and explain why Bridge is not primary for this request.", "If the request also needs SXL Studio state, call get_bridge_runtime_summary and relevant SXL reads after the official MCP step has produced/selected a Figma Design file.", "Use official Figma MCP tools for create_new_file, generate_diagram, FigJam, Slides, and remote-only generate_figma_design workflows."];
+    readonly doneCriteria: "Agent routed the user to official Figma MCP for remote-only/non-Design work and did not claim the local SXL plugin can perform unsupported operations.";
+};
 export declare const RECIPE_TEMPLATE_DISCOVERY: {
     readonly id: "template-discovery";
     readonly title: "Find the swatch / card template inside a content frame";
@@ -168,6 +416,7 @@ export declare const RECIPE_DOC_SPEC_V2: {
     readonly version: 1;
     readonly context: "Doc Spec v2 lets you compose a single apply_doc_spec call from a list of sections. Each section is independent: combine only what the user asked for. Read this resource before assembling a custom spec.";
     readonly preferredTools: readonly ["apply_doc_spec", "build_component_doc", "bind_variable_palette", "build_doc_flow"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/doc-spec-v2"];
     readonly sections: readonly [{
         readonly type: "title";
         readonly note: "Either creates a TEXT node or writes into an existing layerName.";
@@ -240,7 +489,7 @@ export declare const RECIPE_DOC_FLOW: {
     readonly userPhrases: readonly ["сделай flow по этим ссылкам", "build a screen flow doc", "story of pages from these urls", "scenario doc with multiple frames"];
     readonly preferredTools: readonly ["build_doc_flow", "compose_from_url", "duplicate_subtree", "apply_doc_spec"];
     readonly forbidden: readonly ["Calling use_figma to clone many frames into one container — use build_doc_flow.", "Skipping captions when the user provided a description per page — pass them via pages[].title / description."];
-    readonly steps: readonly ["Resolve each Figma URL to a node id (parseFigmaUrl handles `&node-id=` segments).", "Call build_doc_flow with pages[] (each with nodeId and optional title / description).", "If a page references a composition file rather than a node, call compose_from_url first to materialise it."];
+    readonly steps: readonly ["Resolve each Figma URL to a node id (parseFigmaUrl handles `&node-id=` segments).", "Call build_doc_flow with pages[] (each with nodeId or compositionFileId, plus optional title / description).", "When a page references an existing composition file, pass pages[].compositionFileId directly; Bridge/plugin will generate/apply it and render an instance or clone in the flow."];
     readonly doneCriteria: "All requested pages appear inside a single auto-layout container with optional captions; no use_figma script was used.";
 };
 export declare const RECIPE_COMPOSE_WITH_VARIABLES: {
@@ -307,16 +556,16 @@ export declare const RECIPE_AUDIT_COVERAGE: {
     readonly id: "audit-coverage";
     readonly title: "Audit nodes that lack a variable / style binding";
     readonly version: 1;
-    readonly userPhrases: readonly ["проверь везде ли подкреплены переменные", "найди объекты без переменных", "audit raw values without variables", "review the file for missing bindings", "где hex заливки вместо токенов"];
+    readonly userPhrases: readonly ["проверь везде ли подкреплены переменные", "проверь на всех макетах установлены ли переменные и стили", "проверь на всех ли макетах и объектах установленные переменные", "проверь переменные и стили на макетах", "найди объекты без переменных", "check whether every screen object has variables and styles assigned", "check variable and style coverage across layouts", "audit raw values without variables", "review the file for missing bindings", "где hex заливки вместо токенов"];
     readonly decideBetween: readonly [{
         readonly between: readonly ["audit-coverage", "find-unused"];
         readonly hint: "audit-coverage finds where to ADD bindings (raw values). find-unused finds variables/styles to DELETE.";
     }];
     readonly context: "audit_variable_coverage returns SUMMARY only (counts + topOffenders). When `suggest=true` (default) the plugin matches every raw value against existing local variables; the suggestion in topOffenders / details lets the agent propose batch_bind_variables payloads. Style coverage (audit_style_coverage) reports nodes where neither a styleId nor a variable is bound.";
-    readonly preferredTools: readonly ["audit_variable_coverage", "find_variable_coverage_misses", "audit_style_coverage", "find_style_coverage_misses", "batch_bind_variables"];
+    readonly preferredTools: readonly ["audit_variable_coverage", "find_variable_coverage_misses", "audit_style_coverage", "find_style_coverage_misses"];
     readonly forbidden: readonly ["Walking the document manually with use_figma — audit_* tools cover the case (chunked, alias-aware).", "Applying suggested bindings without user confirmation — coverage suggestions can be wrong on intentional raw values.", "Running on scope='file' first when 'page' is enough — start narrow, widen on demand."];
-    readonly steps: readonly ["Start narrow: audit_variable_coverage { scope: 'page' } — confirm magnitude.", "If acceptable, widen: scope: 'file'.", "For details / fix-up: find_variable_coverage_misses { limit, cursor } — assemble a batch_bind_variables payload from suggestion entries.", "For style coverage do the same with audit_style_coverage / find_style_coverage_misses."];
-    readonly doneCriteria: "Agent returned a summary (and optionally a batch_bind_variables proposal) without using use_figma. Coverage gaps are quantified per property and per page.";
+    readonly steps: readonly ["Start narrow: audit_variable_coverage { scope: 'page' } — confirm magnitude.", "If acceptable, widen: scope: 'file'.", "For details: find_variable_coverage_misses { limit, cursor } and find_style_coverage_misses { limit, cursor }.", "For style coverage do the same with audit_style_coverage / find_style_coverage_misses.", "If the user asks to fix the findings, switch to auto-bind-from-audit and run apply_coverage_suggestions / apply_style_coverage_suggestions in preview mode first."];
+    readonly doneCriteria: "Agent returned a read-only summary and optional paginated findings without using use_figma. Coverage gaps are quantified per property and per page; remediation is a separate dry-run-first workflow.";
 };
 export declare const RECIPE_BULK_VARIABLES: {
     readonly id: "bulk-variables";
@@ -416,11 +665,12 @@ export declare const RECIPE_MOCKUP_BUILDER: {
         readonly between: readonly ["mockup-builder", "doc-flow"];
         readonly hint: "mockup-builder = single auto-layout screen; doc-flow = multiple pages stacked side-by-side as a story.";
     }];
-    readonly context: "Phase D: thick orchestration over `figma.createInstance / setProperties / setBoundVariableForPaint / loadFontAsync`. Pipeline: (1) `find_components` to discover ids / keys + componentPropertyDefinitions; (2) `build_mockup` to assemble an auto-layout container from a declarative item tree (`instance | section | spacer | text`) with property / text / fill-binding overrides; (3) `apply_mockup_dataset` when the same template needs to be cloned per-row from a structured list.";
-    readonly preferredTools: readonly ["find_components", "build_mockup", "apply_mockup_dataset", "get_variables"];
-    readonly forbidden: readonly ["Calling use_figma to write a hand-rolled `figma.createInstance(...) / setProperties(...)` loop when build_mockup covers the assembly.", "Guessing component names instead of running find_components first — the user's file may have arbitrary local names.", "Skipping dryRun for build_mockup / apply_mockup_dataset — always preview the resolved plan before writing to canvas.", "Hand-coding fill colours when a Figma Variable is available — use fillBindings { variableId } so the mockup picks up theme switches automatically.", "Loading fonts manually — build_mockup loads fonts on demand with a safe Inter Regular fallback.", "Assuming property names like `size#123:0` — pass the human key (`size`); the plugin maps to the internal `name#defId` suffix via `componentProperties`."];
-    readonly steps: readonly ["Run find_components { query | prefix?, includeProperties: true, kind?: 'COMPONENT' | 'COMPONENT_SET', limit?: 50 } to enumerate available components. Cache the (id, name, propertyDefinitions, defaultVariantId) list.", "If the user wants library components, set includeRemoteInstances: true so library components instantiated in this file are included; otherwise stay local-only.", "Decide the layout: VERTICAL stack of sections, HORIZONTAL row of cards, or WRAP grid. Pick itemSpacing / padding to match the user's intent (e.g. 16px gutters).", "Build the items[] tree. Use `instance` for components (one of componentId | componentKey | componentName), `section` for nested auto-layout frames, `spacer` for explicit gaps, `text` for bare TEXT layers (TEXT styles can be applied via textStyleId).", "For property / text / fill overrides on instances: pass `properties` (human keys), `textOverrides[]` (layerName + value), `fillBindings[]` (variableId; optional layerName when only one child should receive the fill).", "Call build_mockup { ..., dryRun: true } first. The plugin returns a resolved plan with per-item ok/error. If any errors → fix the spec, do not commit.", "Re-call build_mockup without dryRun to write to canvas. Capture rootNodeId for downstream tools (e.g. document the mockup, run audit_variable_coverage on it).", "If the user wants N cards from a dataset, leave one template instance inside the mockup (kind: 'instance'), then call apply_mockup_dataset { templateNodeId, rows[], dryRun: true } → preview → commit. removeTemplate: true deletes the placeholder after cloning."];
-    readonly doneCriteria: "Agent produced one (or a sequence of) Phase D calls (find_components → build_mockup [dryRun → commit] → optional apply_mockup_dataset) that the plugin executed without use_figma. The user approved each diff before commit. The mockup uses real components by id/key (not duplicated geometry) and binds Figma Variables instead of raw hex when a variable is available.";
+    readonly context: "Phase D: thick orchestration over `figma.createInstance / setProperties / setBoundVariableForPaint / loadFontAsync`. Pipeline: (1) `inspect_design_system` to aggregate components, variables, styles, token config, and compositions; (2) optional `find_components` to narrow ids / keys + componentPropertyDefinitions; (3) `validate_screen_spec` or `build_screen { dryRun: true }` to preview; (4) `build_screen` / `update_screen` to assemble an auto-layout container from a declarative item tree (`instance | section | spacer | text`) with property / text / fill-binding overrides; (5) `apply_mockup_dataset` when the same template needs to be cloned per-row from a structured list.";
+    readonly preferredTools: readonly ["inspect_design_system", "validate_screen_spec", "build_screen", "update_screen", "find_components", "build_mockup", "apply_mockup_dataset", "get_variables"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/design-dsl-v1"];
+    readonly forbidden: readonly ["Calling use_figma to write a hand-rolled `figma.createInstance(...) / setProperties(...)` loop when build_screen/build_mockup covers the assembly.", "Guessing component names instead of running inspect_design_system or find_components first — the user's file may have arbitrary local names.", "Skipping dryRun for build_screen / update_screen / build_mockup / apply_mockup_dataset — always preview the resolved plan before writing to canvas.", "Hand-coding fill colours when a Figma Variable is available — use fillBindings { variableId } so the mockup picks up theme switches automatically.", "Loading fonts manually — build_mockup loads fonts on demand with a safe Inter Regular fallback.", "Assuming property names like `size#123:0` — pass the human key (`size`); the plugin maps to the internal `name#defId` suffix via `componentProperties`."];
+    readonly steps: readonly ["Run inspect_design_system { query | prefix?, includeProperties: true, includeRemoteInstances?: true } to aggregate components, variables, local styles, token config, and composition index.", "Run find_components { query | prefix?, includeProperties: true, kind?: 'COMPONENT' | 'COMPONENT_SET', limit?: 50 } when the aggregate response needs narrowing. Cache the (id, name, propertyDefinitions, defaultVariantId) list.", "If the user wants library components, set includeRemoteInstances: true so library components instantiated in this file are included; otherwise stay local-only.", "Decide the layout: VERTICAL stack of sections, HORIZONTAL row of cards, or WRAP grid. Pick itemSpacing / padding to match the user's intent (e.g. 16px gutters).", "Build the items[] tree. Use `instance` for components (one of componentId | componentKey | componentName), `section` for nested auto-layout frames, `spacer` for explicit gaps, `text` for bare TEXT layers (TEXT styles can be applied via textStyleId).", "For property / text / fill overrides on instances: pass `properties` (human keys), `textOverrides[]` (layerName + value), `fillBindings[]` (variableId; optional layerName when only one child should receive the fill).", "Call validate_screen_spec or build_screen { ..., dryRun: true } first. The plugin returns a resolved plan with per-item ok/error. If any errors → fix the spec, do not commit.", "Re-call build_screen without dryRun to write a new canvas root, or update_screen { targetRootId, ... } to modify an existing frame without recreating the whole screen. Capture rootNodeId for downstream tools (e.g. document the mockup, run audit_variable_coverage on it).", "If the user wants N cards from a dataset, leave one template instance inside the mockup (kind: 'instance'), then call apply_mockup_dataset { templateNodeId, rows[], dryRun: true } → preview → commit. removeTemplate: true deletes the placeholder after cloning."];
+    readonly doneCriteria: "Agent produced one (or a sequence of) Phase D calls (inspect_design_system → validate/build_screen [dryRun → commit] → optional apply_mockup_dataset) that the plugin executed without use_figma. The user approved each diff before commit. The mockup uses real components by id/key (not duplicated geometry) and binds Figma Variables instead of raw hex when a variable is available.";
 };
 export declare const RECIPE_BULK_COMPOSITIONS: {
     readonly id: "bulk-compositions";
@@ -470,3 +720,523 @@ export declare const RECIPE_COMPOSITION_DRIFT: {
     readonly steps: readonly ["Run audit_composition_drift with appropriate filters: `prefix: 'W'` for the whole DS, `names: [...]` for a curated list, no filters for the full workspace.", "Group findings by status (linked / unlinked / drift / missing) and surface counts to the user.", "For each `drift` / `missing` finding, surface: composition name, fileId, status, reason, expected vs actual variant count, tracked componentSetId.", "If user wants to fix drift: call bulk_generate_compositions { fileIds: [drift+missing fileIds], operation: 'generate', dryRun: true } first → preview → commit.", "For `unlinked` findings: ask whether to generate them as new components (bulk_generate_compositions { operation: 'auto' }) or leave them."];
     readonly doneCriteria: "Agent returned a deterministic drift report with per-composition status. No canvas writes happened during the audit. If the user approved a fix, a follow-up bulk_generate_compositions was issued with explicit dryRun preview.";
 };
+export declare const ALL_AGENT_RECIPES: readonly [{
+    readonly id: "sxl-use";
+    readonly title: "SXL Use — read/write the current Figma Design file through Bridge";
+    readonly version: 1;
+    readonly context: "Foundational SXL skill for canvas reads/writes, variables, styles, components, token workspace operations, status checks, and design-to-code context. Mirrors the role of figma-use for SXL Studio and supplies the active-file context needed by figma-implement-design-style workflows: prefer Bridge tools and plugin handlers over arbitrary use_figma scripts.";
+    readonly userPhrases: readonly ["управляй фигмой через bridge", "create or modify nodes in figma", "read selection and edit canvas", "назначь переменные объектам", "work with variables styles and components", "figma-implement-design", "implement this figma design in code", "turn figma selection into code", "diagnose figma rest token", "whoami figma token", "search known figma library", "get_libraries", "search_design_system", "search organization design library", "get variable definitions used in selection", "покажи переменные и стили выделения"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-use", "sxl-generate-design"];
+        readonly hint: "sxl-use handles low-level targeted reads/writes; sxl-generate-design assembles or updates full screens via Design DSL.";
+    }, {
+        readonly between: readonly ["sxl-use", "sxl-audit"];
+        readonly hint: "sxl-use writes after the target is known; sxl-audit discovers usage, coverage, drift, unused entries, or component prop statistics first.";
+    }];
+    readonly preferredTools: readonly ["get_bridge_runtime_summary", "get_plugin_status", "get_capability_matrix", "get_figma_mcp_skills_parity", "list_tools", "get_selection", "get_design_context", "get_metadata", "get_node_info", "get_node_tree", "get_screenshot", "get_variable_defs", "get_context_for_code_connect", "get_code_connect_suggestions", "get_libraries", "search_design_system", "get_variables", "get_local_styles", "search_enabled_library_assets", "inspect_enabled_libraries", "list_enabled_library_variables", "figma_rest_diagnose", "figma_rest_whoami", "figma_rest_get_file_nodes", "figma_rest_search_design_system", "upload_assets", "set_node_fill_variable", "batch_bind_variables"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/code-connect-context-v1"];
+    readonly forbidden: readonly ["Calling use_figma with a hand-written figma.* script when a Bridge tool exists.", "Writing canvas changes before checking get_plugin_status.writesAllowed.", "Fetching image URLs in an ad-hoc script or sending raw imageBytes arrays when upload_assets can validate and apply assets.", "Looping single-node writes for bulk variable binding when batch_bind_variables covers the request."];
+    readonly steps: readonly ["Call get_bridge_runtime_summary before heavy workflows to check plugin connection, queue pressure, recent failures, and auth status.", "Call get_plugin_status and inspect editorType / writesAllowed before any write.", "Call get_capability_matrix or list_tools if tool choice is uncertain; prefer tools with dryRunSupported for writes.", "For Figma MCP-style library discovery, prefer get_libraries and search_design_system; they combine active-file enabled libraries, local components, and known REST file/team libraries where configured.", "When the plugin is not open, cross-file context is needed, or the request targets a known file/team library outside the active file, call figma_rest_diagnose first; get_libraries/search_design_system can then use fileKey/url/teamId with a configured FIGMA_TOKEN / FIGMA_ACCESS_TOKEN.", "For image insertion in Figma Design, call upload_assets with dryRun=true first; it validates PNG/JPG/GIF/WebP assets up to 10MB and applies them through set_image_fill.", "Read the narrowest needed context: current selection, node tree, variables, or styles.", "For design implementation requests, call get_design_context plus get_variable_defs/get_screenshot/get_context_for_code_connect when components or code mappings matter; the agent then edits project code outside the plugin.", "For writes, use the thickest Bridge command that covers the task; fall back to direct canvas tools only for small targeted edits.", "After writes, inspect the changed node or rerun the relevant audit/read tool."];
+    readonly doneCriteria: "Agent completed the requested Figma operation through Bridge tools, respected Design/Dev mode constraints, and did not use arbitrary use_figma scripts.";
+}, {
+    readonly id: "sxl-implement-design";
+    readonly title: "SXL Implement Design — read Figma context for code implementation";
+    readonly version: 1;
+    readonly context: "Read-only Bridge workflow for Figma-to-code requests, including current official figma-swiftui and legacy/client figma-implement-design-style aliases. It gathers active-file design context, screenshots, variable/style definitions, SXL codegen/composition data, and Code Connect hints so the agent can edit the repository code outside Figma. It must not mutate the Figma canvas.";
+    readonly userPhrases: readonly ["figma-implement-design", "figma-swiftui", "implement this figma design in swiftui", "convert figma selection to swiftui", "implement this figma design in code", "turn figma selection into code", "convert figma selection to code", "реализуй выбранный макет в коде"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-implement-design", "sxl-use"];
+        readonly hint: "sxl-implement-design is read-only context for code implementation; sxl-use is broad active-file read/write control.";
+    }, {
+        readonly between: readonly ["sxl-implement-design", "sxl-generate-design"];
+        readonly hint: "sxl-implement-design turns Figma into repository code; sxl-generate-design builds Figma screens from a spec/code context.";
+    }];
+    readonly preferredTools: readonly ["get_bridge_runtime_summary", "get_figma_mcp_skills_parity", "get_design_context", "get_metadata", "get_screenshot", "get_variable_defs", "get_context_for_code_connect", "get_code_connect_suggestions", "get_codegen", "export_composition_json"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/code-connect-context-v1"];
+    readonly forbidden: readonly ["Mutating the Figma canvas for an implement-design request.", "Calling upload_assets, set_node_fill_variable, batch_bind_variables, build_screen, or export_variables.", "Treating SXL codegen as final project code without adapting it to repository components and conventions."];
+    readonly steps: readonly ["Call get_bridge_runtime_summary to confirm Bridge/plugin state and queue pressure.", "Call get_design_context for the selected frame/component; include screenshot/context options when useful.", "Call get_variable_defs and get_screenshot when visual/token fidelity matters.", "Call get_context_for_code_connect and get_code_connect_suggestions when component mappings or Storybook context matter.", "Use get_codegen/export_composition_json only as reference material; then edit repository code with normal project tooling."];
+    readonly doneCriteria: "Agent collected read-only Figma/SXL context and implemented or updated repository code without mutating the Figma file.";
+}, {
+    readonly id: "sxl-generate-design";
+    readonly title: "SXL Generate Design — build or update real UI screens in Figma";
+    readonly version: 1;
+    readonly context: "Screen-building skill for real editable Figma Design files. Use inspect_design_system + validate_screen_spec + build_screen/update_screen first; direct canvas tools are fallback only.";
+    readonly userPhrases: readonly ["нарисуй экран в фигме", "build a real UI screen in Figma", "собери макет из дизайн-системы", "update this screen without rebuilding everything", "validate screen spec before applying"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-generate-design", "mockup-builder"];
+        readonly hint: "sxl-generate-design is the top-level screen skill; mockup-builder is the detailed recipe for the underlying build_mockup/build_screen DSL.";
+    }, {
+        readonly between: readonly ["sxl-generate-design", "sxl-doc-builder"];
+        readonly hint: "generate-design builds product UI screens; doc-builder builds documentation pages, palettes, component docs, and flows.";
+    }];
+    readonly preferredTools: readonly ["inspect_design_system", "validate_screen_spec", "build_screen", "update_screen", "find_components", "search_enabled_library_assets", "inspect_enabled_libraries", "get_variables", "audit_variable_coverage"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/design-dsl-v1"];
+    readonly forbidden: readonly ["Creating a screen by hand with many create_frame/create_text/create_component_instance calls when build_screen covers it.", "Guessing component names or component prop keys without inspect_design_system / find_components.", "Committing build_screen/update_screen without a dryRun or validate_screen_spec preview.", "Hardcoding hex colors when a local Figma Variable is available."];
+    readonly steps: readonly ["Run inspect_design_system with includeProperties and a narrow query/prefix when possible; use search_enabled_library_assets when the user expects components/styles/variables from libraries enabled in the current file.", "Draft a Design DSL v1 spec using real component ids/keys, human prop keys, text overrides, and variable fill bindings.", "Call validate_screen_spec or build_screen/update_screen with dryRun: true and fix any unresolved components/props.", "Commit build_screen or update_screen only after the dry-run plan is clean or approved.", "Run audit_variable_coverage on the resulting root/page when variable binding quality matters."];
+    readonly doneCriteria: "A real Figma screen was created or updated with existing components, auto layout, and variable/style bindings where available. The flow used dryRun before write.";
+}, {
+    readonly id: "sxl-generate-library";
+    readonly title: "SXL Generate Library — variables, styles, compositions, and docs";
+    readonly version: 1;
+    readonly context: "Design-system skill for SXL Studio. Covers safe export_variables modes, bulk variable/style specs, composition generation, drift checks, library documentation, and the SXL context needed by figma-create-design-system-rules-style agent workflows.";
+    readonly userPhrases: readonly ["создай дизайн-систему в фигме", "generate library variables styles components docs", "экспортируй переменные и стили", "пересобери компоненты из композиций", "build design system foundations", "figma-create-design-system-rules", "create design system rules for this project", "generate rules for translating figma designs into code"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-generate-library", "bulk-variables"];
+        readonly hint: "use bulk-variables for variable-only refactors; use sxl-generate-library when variables, styles, compositions, and docs are part of one system workflow.";
+    }, {
+        readonly between: readonly ["sxl-generate-library", "bulk-compositions"];
+        readonly hint: "bulk-compositions rebuilds existing composition files; sxl-generate-library orchestrates the broader library pipeline.";
+    }];
+    readonly preferredTools: readonly ["get_tokens_config", "get_figma_mcp_skills_parity", "search_enabled_library_assets", "inspect_enabled_libraries", "list_enabled_library_variables", "inspect_design_system", "get_context_for_code_connect", "get_code_connect_suggestions", "preview_export_variables", "export_variables", "import_variable_spec", "import_style_spec", "list_compositions", "bulk_generate_compositions", "audit_composition_drift", "build_component_doc"];
+    readonly forbidden: readonly ["Using destructive export options such as deleteOrphans, forceUpdateAll, or allowDestructiveReorder unless the user explicitly asked for them.", "Claiming export_variables applies codeSyntax/scopes by default; plugin safe default is applyCodeSyntaxAndScopes=false.", "Hand-crafting composition JSON instead of export_composition_json / compose_from_url / list_compositions.", "Bulk-generating compositions without dryRun first."];
+    readonly steps: readonly ["Read get_tokens_config and list_token_files/list_compositions to understand the workspace; use inspect_enabled_libraries/list_enabled_library_variables when reconciling enabled library definitions.", "For design-system-rules requests, call inspect_design_system and get_context_for_code_connect/get_code_connect_suggestions when code mappings matter; the agent writes the client-specific rule file in the repository, not through a plugin command.", "For token export, call preview_export_variables first; then call export_variables with only explicit settings and keep safe defaults unless requested.", "For large variable/style changes, use import_variable_spec/import_style_spec with dryRun first.", "Run audit_composition_drift before rebuilding existing components; use bulk_generate_compositions dryRun before commit.", "Build documentation with sxl-doc-builder recipes after foundations are generated."];
+    readonly doneCriteria: "Library foundations were exported/generated with non-destructive defaults, drift was inspected before rebuilds, and all bulk writes were previewed first.";
+}, {
+    readonly id: "sxl-code-connect";
+    readonly title: "SXL Code Connect — bind Figma components to code, Storybook, and docs";
+    readonly version: 1;
+    readonly context: "Code Connect skill for SXL Studio. Manages full CodeConnectBinding payloads: docs URL, files, Storybook, component API, status, registry, and global settings.";
+    readonly userPhrases: readonly ["настрой code connect", "save code connect binding", "свяжи figma компонент с storybook", "show code connect registry", "component docs url files storybook binding"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-code-connect", "doc-component"];
+        readonly hint: "code-connect links Figma nodes to code/docs metadata; doc-component renders documentation on the Figma canvas.";
+    }];
+    readonly preferredTools: readonly ["codeconnect_get_global_settings", "codeconnect_save_global_settings", "codeconnect_get_registry", "codeconnect_get_selection_status", "get_context_for_code_connect", "get_code_connect_suggestions", "generate_code_connect_template", "codeconnect_get_binding", "codeconnect_save_binding", "codeconnect_get_node_ui_status"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/code-connect-context-v1", "sxl://agent/schemas/code-connect-template-v1"];
+    readonly forbidden: readonly ["Saving partial binding metadata that drops docsUrl/files/storybook/component API fields.", "Guessing node ids when selection status can identify the current component.", "Hand-writing filePath/importPath bindings before checking get_context_for_code_connect or get_code_connect_suggestions.", "Writing .figma.ts files without generate_code_connect_template dry-run preview.", "Treating Code Connect as composition JSON; keep bindings as metadata, not generated component structure."];
+    readonly steps: readonly ["Read codeconnect_get_global_settings and codeconnect_get_registry to understand existing defaults.", "Use codeconnect_get_selection_status or get_node_info to confirm target node ids.", "Call get_context_for_code_connect with explicit targets/componentNames or current selection; review existing binding, component props, codegen/composition context, and highest-confidence local code candidates.", "For template-file workflows, call generate_code_connect_template without writeFile first; only writeFile=true after reviewing output path/content.", "Save the chosen binding with full metadata: componentName, docs URL, files[], Storybook data, component API, and status where available.", "Verify with codeconnect_get_binding and codeconnect_get_node_ui_status."];
+    readonly doneCriteria: "Target Figma component has a full Code Connect binding and the registry/UI status reflect it.";
+}, {
+    readonly id: "sxl-audit";
+    readonly title: "SXL Audit — variables, styles, components, props, drift, and unused entries";
+    readonly version: 1;
+    readonly context: "Audit skill for read-only analysis and dry-run-first remediation. Covers variable/style coverage, usage, unused entries, component usage, component prop usage, and composition/style drift.";
+    readonly userPhrases: readonly ["проведи аудит макетов", "analyze variables styles and component usage", "проверь пропсы компонентов", "найди компоненты с prop value", "audit coverage drift unused analytics"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-audit", "audit-coverage"];
+        readonly hint: "audit-coverage is the specialized recipe for missing variable/style bindings; sxl-audit is the broad audit router.";
+    }, {
+        readonly between: readonly ["sxl-audit", "composition-drift"];
+        readonly hint: "composition-drift is composition JSON vs Figma component; sxl-audit can route there when that is the user's unit.";
+    }];
+    readonly preferredTools: readonly ["audit_variable_coverage", "find_variable_coverage_misses", "audit_style_coverage", "find_style_coverage_misses", "analyze_component_usage", "find_component_usages", "analyze_component_prop_usage", "find_component_prop_usages", "find_unused_variables", "find_unused_styles", "audit_composition_drift"];
+    readonly forbidden: readonly ["Walking the entire document manually with use_figma for analytics already covered by Bridge audit tools.", "Requesting full detail lists before running summary tools.", "Applying audit suggestions without preview mode first and explicit user confirmation."];
+    readonly steps: readonly ["Choose the narrowest scope: selection, page, node, then file only when needed.", "Run summary tools first; use find_* paginated tools only for requested details.", "For component prop analytics, use analyze_component_prop_usage for counts and find_component_prop_usages for node ids.", "If the user asks to fix findings, switch to apply_coverage_suggestions / apply_style_coverage_suggestions / batch_bind_variables and preview before committing."];
+    readonly doneCriteria: "Agent returned a scoped audit report with counts and actionable findings; any remediation used preview mode before write.";
+}, {
+    readonly id: "sxl-doc-builder";
+    readonly title: "SXL Doc Builder — render documentation in Figma";
+    readonly version: 1;
+    readonly context: "Documentation skill for Figma canvas output: token tables, variable palettes, component docs, doc flows, and markdown scenarios. Uses Bridge doc tools, never ad-hoc scripts.";
+    readonly userPhrases: readonly ["нарисуй документацию в фигме", "build documentation in Figma", "документация компонентов токенов флоу", "render markdown scenario as Figma flow", "apply doc spec"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-doc-builder", "doc-component"];
+        readonly hint: "doc-component is the specialized single-component recipe; sxl-doc-builder routes all documentation types.";
+    }, {
+        readonly between: readonly ["sxl-doc-builder", "scenario-from-markdown"];
+        readonly hint: "scenario-from-markdown wins when the user provides markdown H1/H2 scenario text with Figma URLs.";
+    }];
+    readonly preferredTools: readonly ["apply_doc_spec", "build_component_doc", "build_doc_flow", "bind_variable_palette", "build_scenario_from_md", "build_token_documentation"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/doc-spec-v2", "sxl://agent/schemas/token-doc-v1"];
+    readonly forbidden: readonly ["Creating throwaway JS scripts or /tmp payload loaders for documentation.", "Using use_figma to clone templates or enumerate variables when bind_variable_palette/apply_doc_spec exists.", "Hand-crafting composition JSON for docs; use export_composition_json or compose_from_url.", "Skipping dryRun on build_scenario_from_md or doc flows that support preview."];
+    readonly steps: readonly ["Route the request: token table, variable palette, component doc, flow, markdown scenario, or custom Doc Spec v2.", "Read the specialized recipe resource for that route before building payloads.", "Discover targetParentId/templateNodeId/layer names via template-discovery when templates are involved.", "Call the chosen doc tool with dryRun when supported, then commit.", "Inspect the created documentation root or report returned nodes."];
+    readonly doneCriteria: "Documentation was rendered in Figma through Bridge doc tools with real token/variable/component data and without ad-hoc scripts.";
+}, {
+    readonly id: "sxl-data-apply-mapping";
+    readonly title: "SXL Data — apply one mapping to explicit targets or current selection";
+    readonly version: 1;
+    readonly context: "Agent workflow for applying one SXL database mapping to explicit targetNodeIds or the current Figma selection. Agents must preview mapping fields, datasets, and target counts before writing.";
+    readonly userPhrases: readonly ["примени маппинг", "apply mapping to selection", "apply data mapping", "подставь данные по маппингу", "fill selected nodes from dataset"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-data-apply-mapping", "sxl-data-apply-all"];
+        readonly hint: "Use apply-mapping when the user names one mapping or selected target. Use apply-all only when the user says all mappings or whole scope.";
+    }, {
+        readonly between: readonly ["sxl-data-apply-mapping", "sxl-data-generate-instances"];
+        readonly hint: "Use apply-mapping to fill existing selected layers. Use generate-instances when the task needs new rows/cards/instances.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_mappings", "get_mapping", "count_apply_targets", "apply_mapping"];
+    readonly forbidden: readonly ["Calling apply_mapping without dryRun preview and explicit approval.", "Passing legacy targetNodes when targetNodeIds are available; use explicit node ids for deterministic agent control.", "Applying to page/document scope with apply_mapping; use apply_all_mappings for broad scope."];
+    readonly steps: readonly ["Check plugin status and writesAllowed.", "List mappings and read the selected mapping before applying.", "Run count_apply_targets for selection and apply_mapping with dryRun:true.", "Present mapping fields, dataset row hints, and target count.", "Commit apply_mapping only after approval, preferably with targetNodeIds when the intended roots are known."];
+    readonly doneCriteria: "One selected SXL mapping was previewed, approved, and applied to the intended explicit targetNodeIds or current Figma selection.";
+}, {
+    readonly id: "sxl-data-apply-all";
+    readonly title: "SXL Data — apply all mappings in a scope";
+    readonly version: 1;
+    readonly context: "Agent workflow for applying all SXL mappings to explicit targetNodeIds or a selection/page/document scope. This is a bulk write and must be dry-run previewed before commit.";
+    readonly userPhrases: readonly ["примени все маппинги", "apply all mappings", "apply all data mappings", "подставь данные по всем маппингам", "apply mappings on page", "apply mappings to document"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-data-apply-all", "sxl-data-apply-mapping"];
+        readonly hint: "Use apply-all only when the user explicitly asks for all mappings or a broad scope.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_mappings", "count_apply_targets", "apply_all_mappings"];
+    readonly forbidden: readonly ["Running apply_all_mappings without dryRun preview and explicit approval.", "Defaulting to document scope when the user did not ask for it; prefer selection/page unless specified.", "Deleting or changing mappings as part of apply; this workflow only fills data into existing nodes."];
+    readonly steps: readonly ["Check plugin status and writesAllowed.", "List mappings and choose explicit targetNodeIds when known, otherwise scope: selection, page, or document.", "Run count_apply_targets and apply_all_mappings with dryRun:true.", "Show mapping count, target count, and scope.", "Commit apply_all_mappings only after approval."];
+    readonly doneCriteria: "All requested mappings were previewed and applied only to the approved explicit target roots or Figma scope.";
+}, {
+    readonly id: "sxl-data-generate-instances";
+    readonly title: "SXL Data — generate instances from mapping rows";
+    readonly version: 1;
+    readonly context: "Agent workflow for generating repeated component instances/cards/rows from an SXL mapping and dataset. The selected Figma node is the template/container source.";
+    readonly userPhrases: readonly ["сгенерируй инстансы из датасета", "generate instances from dataset", "generate instances from mapping", "создай строки из датасета", "render rows from mapping data", "generate cards from dataset mapping"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-data-generate-instances", "mockup-builder"];
+        readonly hint: "Use generate-instances when a mapping already exists and the selected Figma template should be duplicated. Use mockup-builder for declarative Design DSL screens.";
+    }, {
+        readonly between: readonly ["sxl-data-generate-instances", "sxl-data-apply-mapping"];
+        readonly hint: "Use generate-instances to create new repeated nodes; use apply-mapping to fill existing selected nodes.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_mappings", "get_mapping", "generate_instances"];
+    readonly forbidden: readonly ["Calling generate_instances without dryRun preview and explicit approval.", "Generating rows without targetNodeIds when the intended template/container root is already known.", "Hand-duplicating components through low-level canvas tools when the existing SXL generation engine should be used."];
+    readonly steps: readonly ["Check plugin status and writesAllowed.", "List mappings and read the mapping/dataset relationship.", "Use explicit targetNodeIds for the template/container root when known; otherwise confirm the active Figma selection.", "Run generate_instances with dryRun:true to estimate rows and validate mapping fields.", "Show requested row count, estimated generated rows, and dataset row counts.", "Commit generate_instances only after approval, preferably with targetNodeIds for deterministic remote control."];
+    readonly doneCriteria: "Instances were generated through SXL's mapping engine after dry-run preview, with the approved row count and intended explicit targetNodeIds or confirmed active selection.";
+}, {
+    readonly id: "sxl-database-transfer";
+    readonly title: "SXL Database — portable datasets/assets/mappings payloads";
+    readonly version: 1;
+    readonly context: "Agent workflow for backing up, restoring, or moving SXL Studio database datasets, local assets, and mappings between files/workspaces using portable Bridge payloads.";
+    readonly userPhrases: readonly ["экспортируй базу sxl", "импортируй базу sxl", "backup sxl database", "restore sxl database", "export database payload", "import database payload", "перенеси datasets assets mappings"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["sxl-database-transfer", "sxl-data-apply-mapping"];
+        readonly hint: "Use database-transfer for moving/storing datasets/assets/mappings. Use data-apply when the goal is to fill nodes on canvas.";
+    }];
+    readonly preferredTools: readonly ["get_plugin_status", "list_datasets", "list_assets", "list_mappings", "export_database_payload", "import_database_payload"];
+    readonly forbidden: readonly ["Importing payloads without dryRun preview.", "Overwriting existing ids without confirmDestructive:true and a human-readable destructiveReason.", "Including asset content in export unless the user needs a full backup/restore payload."];
+    readonly steps: readonly ["Check plugin status and inspect existing datasets/assets/mappings.", "For backup/transfer, call export_database_payload; include asset content only when needed.", "For restore/import, call import_database_payload with dryRun:true first.", "Review counts, conflicts, and warnings.", "Commit import only after approval; existing id conflicts require destructive confirmation and reason."];
+    readonly doneCriteria: "SXL database payload was exported or imported through Bridge with dry-run conflict review and no accidental overwrites.";
+}, {
+    readonly id: "figma-mcp-companion";
+    readonly title: "Official Figma MCP Companion — remote-only and non-Design scopes";
+    readonly version: 1;
+    readonly context: "Routing recipe for official Figma MCP features that Bridge should not fake through the local SXL plugin: new-file creation, FigJam/Slides, diagram generation, and hosted remote-only workflows. Bridge can explain parity and prepare local SXL context, but the agent must call official Figma MCP tools for these capabilities.";
+    readonly userPhrases: readonly ["figma-create-new-file", "create_new_file", "create a new figma file", "figma-generate-diagram", "generate_diagram", "create a figjam diagram", "figma-use-figjam", "figma-use-slides"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["figma-mcp-companion", "sxl-use"];
+        readonly hint: "Use sxl-use for the active Figma Design file, SXL plugin workflows, Figma Design asset upload, and get_libraries/search_design_system. Use companion when the request names remote-only official Figma MCP features, FigJam, Slides, or new-file creation.";
+    }, {
+        readonly between: readonly ["figma-mcp-companion", "sxl-generate-design"];
+        readonly hint: "Use sxl-generate-design when building into an existing Figma Design file through SXL Bridge. Use companion when the first step is creating a new Figma file or using official generate_figma_design in a supported hosted MCP client.";
+    }];
+    readonly preferredTools: readonly ["get_figma_mcp_parity", "get_bridge_runtime_summary", "figma_rest_diagnose"];
+    readonly forbidden: readonly ["Pretending Bridge can create new Figma files, FigJam boards, Slides decks, or Mermaid diagrams through the local plugin.", "Routing Figma Design get_libraries/search_design_system to companion without first checking Bridge get_libraries/search_design_system coverage.", "Replacing official Figma MCP FigJam/Slides workflows with Figma Design canvas commands."];
+    readonly steps: readonly ["Call get_figma_mcp_parity to identify the exact official Figma MCP companion tool and explain why Bridge is not primary for this request.", "If the request also needs SXL Studio state, call get_bridge_runtime_summary and relevant SXL reads after the official MCP step has produced/selected a Figma Design file.", "Use official Figma MCP tools for create_new_file, generate_diagram, FigJam, Slides, and remote-only generate_figma_design workflows."];
+    readonly doneCriteria: "Agent routed the user to official Figma MCP for remote-only/non-Design work and did not claim the local SXL plugin can perform unsupported operations.";
+}, {
+    readonly id: "doc-tokens";
+    readonly title: "Token documentation (Doc Spec v1 / v2 tokenTable)";
+    readonly version: 2;
+    readonly userPhrases: readonly ["задокументируй токены", "fill doc template with token values", "table of DTCG paths and resolved values"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["doc-tokens", "variable-palette"];
+        readonly hint: "If the data source is local Figma variables (no DTCG file), switch to variable-palette.";
+    }];
+    readonly preferredTools: readonly ["list_token_files", "get_token_file_content", "build_token_documentation", "apply_token_doc_spec", "apply_doc_spec", "duplicate_subtree"];
+    readonly forbidden: readonly ["Hand-written DTCG / composition JSON as the source of truth — use plugin workspace files.", "Raw figma.* JS / use_figma scripts to traverse tokens — Bridge has list_token_files + get_token_file_content.", "Copy-pasting token values into the spec instead of letting the plugin resolve them."];
+    readonly steps: readonly ["Read sxl://tokens/config and sxl://tokens/files (or list_token_files) to locate token files.", "In Figma Design mode duplicate the doc template (or use an existing one) to obtain targetRootId.", "Build Doc Spec v1 (groups[].rows with layerName + tokenPath) — or v2 with a single tokenTable section if you also need title / description.", "Call build_token_documentation / apply_token_doc_spec (v1) or apply_doc_spec (v2) with { spec, targetRootId }.", "On unresolved paths re-check tokenPath spelling and confirm files are present in the workspace."];
+    readonly doneCriteria: "TEXT layers under targetRootId show resolved values; the response reports updated > 0 and no unresolved paths (unless dryRun).";
+}, {
+    readonly id: "doc-component";
+    readonly title: "Component documentation (title + variants + props + optional measure)";
+    readonly version: 2;
+    readonly userPhrases: readonly ["задокументируй компонент", "document this component", "WButton documentation frame", "build component doc"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["doc-component", "doc-spec-v2"];
+        readonly hint: "If you need anything beyond title/description/variants/props/measure (e.g. palette, tokenTable), pick doc-spec-v2 + apply_doc_spec.";
+    }];
+    readonly preferredTools: readonly ["build_component_doc", "apply_doc_spec", "export_composition_json", "get_codegen", "duplicate_subtree"];
+    readonly forbidden: readonly ["Synthesising composition JSON from get_node_tree — use export_composition_json / get_codegen.", "Calling use_figma to read componentPropertyDefinitions — the plugin already exposes it via build_component_doc.", "Mutating the component itself when documenting it — work on the doc frame, not the source."];
+    readonly steps: readonly ["Identify the component (componentNodeId). For a component set, pass the set id.", "Provide either targetRootId (existing doc frame) or targetParentId (createIfMissing=true).", "Call build_component_doc; toggle includeMeasure only if the user asked for size annotations.", "Refine specific sections (e.g. update description markdown) by re-running with new payload."];
+    readonly doneCriteria: "The doc frame contains a title, a variants matrix (when applicable), and a props table with all componentPropertyDefinitions.";
+    readonly phases: "Measuring/annotations: see Plugin/sxl/docs/23-doc-agent-phased-roadmap.md (Phase 3).";
+}, {
+    readonly id: "doc-composition";
+    readonly title: "Documentation from composition file";
+    readonly version: 2;
+    readonly userPhrases: readonly ["render this composition file as documentation", "доку по composition.json", "build a frame from a composition file"];
+    readonly preferredTools: readonly ["list_compositions", "export_composition_json", "generate_composition", "apply_composition", "compose_from_url"];
+    readonly forbidden: readonly ["Hand-assembling composition trees in JSON — the plugin pipeline is the single source of truth.", "Using use_figma to draw the composition manually."];
+    readonly steps: readonly ["Prefer compose_from_url for a Figma URL → export_composition_json → create_token_file → generate_composition.", "Apply with apply_composition / generate_composition; do not hand-construct nodes."];
+    readonly doneCriteria: "Composition file in workspace + generated component / instance on the canvas matching the source.";
+}, {
+    readonly id: "doc-flow";
+    readonly title: "Multi-page screen flow / scenario";
+    readonly version: 2;
+    readonly userPhrases: readonly ["сделай flow по этим ссылкам", "build a screen flow doc", "story of pages from these urls", "scenario doc with multiple frames"];
+    readonly preferredTools: readonly ["build_doc_flow", "compose_from_url", "duplicate_subtree", "apply_doc_spec"];
+    readonly forbidden: readonly ["Calling use_figma to clone many frames into one container — use build_doc_flow.", "Skipping captions when the user provided a description per page — pass them via pages[].title / description."];
+    readonly steps: readonly ["Resolve each Figma URL to a node id (parseFigmaUrl handles `&node-id=` segments).", "Call build_doc_flow with pages[] (each with nodeId or compositionFileId, plus optional title / description).", "When a page references an existing composition file, pass pages[].compositionFileId directly; Bridge/plugin will generate/apply it and render an instance or clone in the flow."];
+    readonly doneCriteria: "All requested pages appear inside a single auto-layout container with optional captions; no use_figma script was used.";
+}, {
+    readonly id: "variable-palette";
+    readonly title: "Color (or variable) cards from a Figma variable collection";
+    readonly version: 2;
+    readonly userPhrases: readonly ["добавь все цвета коллекции projects карточками", "render figma variable collection as cards", "swatches from local variable collection", "по коллекции переменных нарисуй палитру"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["variable-palette", "doc-tokens"];
+        readonly hint: "If user names a DTCG file or token path (`core.color.*`), switch to doc-tokens.";
+    }];
+    readonly context: "Example: fill a frame's content with one card per COLOR variable in the Projects collection, using an existing card component / instance as template.";
+    readonly preferredTools: readonly ["get_plugin_status", "get_variables", "get_node_tree", "find_nodes", "bind_variable_palette", "apply_doc_spec"];
+    readonly forbidden: readonly ["use_figma (official Figma MCP) with a custom JavaScript payload — SXL session cannot execute that in the plugin; bind_variable_palette covers the same flow.", "Shell payloads (/tmp/*.json, base64 loaders, copy-paste into tokens/system, node -e glue) to invoke MCP — pass JSON directly to bind_variable_palette.", "Pretending the task requires a 'Figma script' when get_variables + bind_variable_palette is enough."];
+    readonly steps: readonly ["get_plugin_status — confirm writesAllowed (Figma Design, not Dev Mode read-only).", "Use sxl://agent/recipes/template-discovery to locate templateNodeId + swatchLayerName under the user's content frame.", "Call bind_variable_palette with { templateNodeId, collectionName, variableType: 'COLOR', swatchLayerName, labelLayerName? }.", "Inspect the response: created should equal the variable count; bound should equal created (one fill bind per swatch)."];
+    readonly doneCriteria: "One card per target variable next to the template; each swatch is bound to its variable; no use_figma script was used.";
+}, {
+    readonly id: "doc-spec-v2";
+    readonly title: "Doc Spec v2 — sections vocabulary";
+    readonly version: 1;
+    readonly context: "Doc Spec v2 lets you compose a single apply_doc_spec call from a list of sections. Each section is independent: combine only what the user asked for. Read this resource before assembling a custom spec.";
+    readonly preferredTools: readonly ["apply_doc_spec", "build_component_doc", "bind_variable_palette", "build_doc_flow"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/doc-spec-v2"];
+    readonly sections: readonly [{
+        readonly type: "title";
+        readonly note: "Either creates a TEXT node or writes into an existing layerName.";
+    }, {
+        readonly type: "description";
+        readonly note: "Markdown subset → formatted runs. Use **bold**, *italic*, `code`, # headings.";
+    }, {
+        readonly type: "variants";
+        readonly note: "ComponentSet → matrix / grid / list of instances. Use groupBy for matrix rows.";
+    }, {
+        readonly type: "props";
+        readonly note: "componentPropertyDefinitions → table TEXT block. include filters which kinds.";
+    }, {
+        readonly type: "tokenTable";
+        readonly note: "v1 surface preserved: layerName + tokenPath. Picks values from DTCG workspace.";
+    }, {
+        readonly type: "palette";
+        readonly note: "Local Figma Variables → cards by cloning templateNodeId.";
+    }, {
+        readonly type: "measure";
+        readonly note: "Experimental: node.annotations = [...].";
+    }];
+    readonly forbidden: readonly ["Generating section types not in the schema (the validator rejects them).", "Using `palette.collectionName` for a DTCG file path — palette only inspects local Figma Variables.", "Putting v1 fields (`groups`, `version: \"1\"`) into a v2 spec — use apply_token_doc_spec for v1."];
+    readonly steps: readonly ["Decide which sections are needed (intent router → user request).", "Resolve targetRootId (existing frame) or targetParentId (with createIfMissing).", "Call apply_doc_spec with the assembled spec; rely on per-section reports for partial failures."];
+    readonly doneCriteria: "apply_doc_spec returns ok=true (or section-level report shows which section failed and why).";
+}, {
+    readonly id: "template-discovery";
+    readonly title: "Find the swatch / card template inside a content frame";
+    readonly version: 1;
+    readonly context: "Many doc tasks (variable-palette, doc-spec-v2.palette, doc-component.variants) need a templateNodeId — an existing scene node we can clone. This recipe shows how to locate it deterministically without scripts.";
+    readonly userPhrases: readonly ["find template card in content", "locate swatch template", "templateNodeId под content фрейма"];
+    readonly preferredTools: readonly ["get_node_tree", "find_nodes", "get_node_info", "read_node_properties"];
+    readonly forbidden: readonly ["Cloning the entire content frame instead of one card.", "Guessing node ids — always verify via get_node_tree / find_nodes.", "Falling back to use_figma to traverse the file: get_node_tree returns enough info for SXL templates."];
+    readonly steps: readonly ["From the user URL, parse node-id (`figma.com/design/.../?node-id=151-2` → `151:2`).", "Call get_node_tree with that nodeId and depth=4 to inspect the frame and its content.", "Pick the first child of the content layer (or one named 'card', 'swatch', 'token-card' — let the user confirm if ambiguous).", "Read swatch / label / value layer names with get_node_tree (depth=2 from the picked card) and pass them to bind_variable_palette / palette section."];
+    readonly doneCriteria: "templateNodeId + swatchLayerName (and optionally labelLayerName / valueLayerName) confirmed against the file before any clone.";
+}, {
+    readonly id: "compose-with-variables";
+    readonly title: "Export composition and generate component with Figma variable bindings";
+    readonly version: 1;
+    readonly userPhrases: readonly ["получи JSON компонента и сгенерируй его назначив переменные", "export composition and generate component with variables assigned", "сохрани компонент в репо и создай с привязкой переменных фигмы", "generate component from figma url with variable bindings", "создай компонент сет и привяжи переменные экспортированные из фигмы", "get code JSON and generate component assigning all variables"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["compose-with-variables", "doc-composition"];
+        readonly hint: "If the goal is documentation (render a frame, not generate a reusable component), use doc-composition.";
+    }];
+    readonly context: "Variable references inside a composition JSON are automatically applied during generate_composition — the plugin binds Figma local variables to nodes without extra steps. Use batch_bind_variables only for bindings NOT captured in the composition JSON.";
+    readonly preferredTools: readonly ["compose_from_url", "export_composition_json", "create_token_file", "generate_composition", "get_variables", "batch_bind_variables"];
+    readonly forbidden: readonly ["Hand-crafting composition JSON from get_node_tree — always use export_composition_json / get_codegen.", "Calling bind_variable N times in a loop — use batch_bind_variables for bulk wiring.", "Skipping get_plugin_status before canvas writes — confirm writesAllowed first."];
+    readonly steps: readonly ["Call compose_from_url { url, generate: true } — exports composition JSON, saves token file, generates Figma component. Variable references inside the JSON are auto-bound.", "If additional bindings are needed (not in composition JSON): call get_variables to list local variables, then batch_bind_variables with the required {nodeId, variableId, field} entries.", "Verify result with get_drift_status or get_selection_summary."];
+    readonly doneCriteria: "Composition token file exists in workspace; Figma component generated on canvas; variable bindings visible in Figma inspector.";
+}, {
+    readonly id: "scenario-from-markdown";
+    readonly title: "Multi-page scenario / flow from a markdown spec document";
+    readonly version: 1;
+    readonly userPhrases: readonly ["вот md файл сценария, создай flow в фигме", "build scenario from this markdown document", "у меня есть md с описанием флоу", "render this spec as a figma flow", "создай сценарий из md файла", "scenario document → figma pages", "make a user flow from this spec", "go through this markdown and create a figma scenario"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["scenario-from-markdown", "doc-flow"];
+        readonly hint: "If the user provides individual Figma URLs (not a markdown document), use doc-flow / build_doc_flow directly.";
+    }];
+    readonly context: "The markdown spec format: H1 = flow container title, H2 sections = pages, Figma URL per section = source node to clone, paragraph text = page caption. build_scenario_from_md parses this automatically.";
+    readonly preferredTools: readonly ["build_scenario_from_md", "build_doc_flow"];
+    readonly forbidden: readonly ["Hand-parsing Figma URLs from markdown and assembling pages[] manually — use build_scenario_from_md.", "Calling use_figma to create frames and place screenshots.", "Generating a node-by-node script when build_scenario_from_md covers the whole flow."];
+    readonly steps: readonly ["Run build_scenario_from_md { markdown, dryRun: true } — confirm the parsed pages list (title, nodeId, description) is correct.", "If nodeIds are missing: check that Figma URLs in the markdown include ?node-id= parameters.", "Run build_scenario_from_md with targetParentId (or targetRootId for an existing container) and dryRun: false."];
+    readonly doneCriteria: "All H2 pages from the markdown appear as frames inside a single auto-layout container; each page has the correct caption.";
+}, {
+    readonly id: "variable-usage";
+    readonly title: "Find usages of a Figma variable (count + visualize)";
+    readonly version: 1;
+    readonly userPhrases: readonly ["сколько раз используется accent.medium", "where is this variable used", "посчитай где используется переменная", "render a page with all usages of accent.medium", "найди все объекты с переменной", "выведи на страницу все места где встречается переменная"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["variable-usage", "audit-coverage"];
+        readonly hint: "If user wants to find missing bindings (no variable assigned) → audit-coverage. If user names a variable and asks 'where is it used' → variable-usage.";
+    }];
+    readonly context: "analyze_variable_usage returns a token-friendly summary (counts only). For the full node list, use find_variable_usages with cursor pagination. To visualize the result on the canvas, call render_variable_usage_page (creates a fresh page with cloned references). All three resolve transitive aliases — a variable that aliases the target counts as a usage and is included in target.aliasChain.";
+    readonly preferredTools: readonly ["get_variables", "analyze_variable_usage", "find_variable_usages", "render_variable_usage_page"];
+    readonly forbidden: readonly ["Writing a use_figma script that walks node.boundVariables manually — analyze_variable_usage already does it (with alias resolution).", "Calling find_variable_usages without limit/cursor for huge files — pagination keeps the agent fast and cheap.", "Cloning nodes by hand into a new page — use render_variable_usage_page (chunked + auto-layout)."];
+    readonly steps: readonly ["Identify the variable (variableId is best). If only a name, get_variables narrows it down.", "Call analyze_variable_usage { variable, scope: 'page'|'file' } first — small response, decides next step.", "If user wants details: find_variable_usages { variable, scope, limit }, optionally paginate via the returned cursor.", "If user wants visualization: render_variable_usage_page { variable, scope: 'file', maxClones }. Confirm writesAllowed first via get_plugin_status."];
+    readonly doneCriteria: "Agent returned a count + breakdown (analyze) or a paginated record list (find) or created a 'Usage: <variable>' page (render). Transitive aliases included in target.aliasChain.";
+}, {
+    readonly id: "audit-coverage";
+    readonly title: "Audit nodes that lack a variable / style binding";
+    readonly version: 1;
+    readonly userPhrases: readonly ["проверь везде ли подкреплены переменные", "проверь на всех макетах установлены ли переменные и стили", "проверь на всех ли макетах и объектах установленные переменные", "проверь переменные и стили на макетах", "найди объекты без переменных", "check whether every screen object has variables and styles assigned", "check variable and style coverage across layouts", "audit raw values without variables", "review the file for missing bindings", "где hex заливки вместо токенов"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["audit-coverage", "find-unused"];
+        readonly hint: "audit-coverage finds where to ADD bindings (raw values). find-unused finds variables/styles to DELETE.";
+    }];
+    readonly context: "audit_variable_coverage returns SUMMARY only (counts + topOffenders). When `suggest=true` (default) the plugin matches every raw value against existing local variables; the suggestion in topOffenders / details lets the agent propose batch_bind_variables payloads. Style coverage (audit_style_coverage) reports nodes where neither a styleId nor a variable is bound.";
+    readonly preferredTools: readonly ["audit_variable_coverage", "find_variable_coverage_misses", "audit_style_coverage", "find_style_coverage_misses"];
+    readonly forbidden: readonly ["Walking the document manually with use_figma — audit_* tools cover the case (chunked, alias-aware).", "Applying suggested bindings without user confirmation — coverage suggestions can be wrong on intentional raw values.", "Running on scope='file' first when 'page' is enough — start narrow, widen on demand."];
+    readonly steps: readonly ["Start narrow: audit_variable_coverage { scope: 'page' } — confirm magnitude.", "If acceptable, widen: scope: 'file'.", "For details: find_variable_coverage_misses { limit, cursor } and find_style_coverage_misses { limit, cursor }.", "For style coverage do the same with audit_style_coverage / find_style_coverage_misses.", "If the user asks to fix the findings, switch to auto-bind-from-audit and run apply_coverage_suggestions / apply_style_coverage_suggestions in preview mode first."];
+    readonly doneCriteria: "Agent returned a read-only summary and optional paginated findings without using use_figma. Coverage gaps are quantified per property and per page; remediation is a separate dry-run-first workflow.";
+}, {
+    readonly id: "find-unused";
+    readonly title: "Find unused local variables and styles";
+    readonly version: 1;
+    readonly userPhrases: readonly ["какие переменные у меня не используются", "find unused variables", "which styles are dead", "почисть неиспользуемые токены", "найди мёртвые стили"];
+    readonly context: "find_unused_variables walks the file once, building two reference sets: bindings on every node + alias targets in any variable mode. unused = local variables \\ referenced. find_unused_styles does the equivalent for paint/text/effect styles. Both are read-only.";
+    readonly preferredTools: readonly ["find_unused_variables", "find_unused_styles", "batch_delete_variables"];
+    readonly forbidden: readonly ["Deleting variables / styles without explicit user confirmation — false positives are possible (e.g. variables used only in published libraries).", "Running unused detection without explaining the scan boundary — it covers the current document only."];
+    readonly steps: readonly ["Run find_unused_variables / find_unused_styles — return the lists.", "Confirm with the user which entries to remove (group by collection / styleType for clarity).", "If approved: batch_delete_variables for variables; styles need manual removal (no batch tool yet)."];
+    readonly doneCriteria: "Agent returned a deterministic list of unused variables / styles. Deletions only happened after explicit confirmation.";
+}, {
+    readonly id: "bulk-variables";
+    readonly title: "Bulk create / dedupe / rebind / reorder Figma Variables";
+    readonly version: 1;
+    readonly userPhrases: readonly ["создай набор переменных по этому списку", "import these variables in bulk", "bulk create variables from spec", "обнови переменные пакетно", "перепривяжи алиасы переменных", "rebind aliases from old token to new", "найди дубликаты переменных и слей их", "dedupe variables across collections", "приведи коллекцию в алфавитный порядок", "reorder variables alphabetically"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["bulk-variables", "doc-tokens"];
+        readonly hint: "If the user wants to render existing token values as documentation, switch to doc-tokens.";
+    }, {
+        readonly between: readonly ["bulk-variables", "auto-bind-from-audit"];
+        readonly hint: "auto-bind-from-audit applies suggestions from audit_variable_coverage; bulk-variables operates on the variables themselves (CRUD + alias refactors).";
+    }];
+    readonly context: "Phase B 'thick' commands cover four recurring refactors: (1) declarative bulk import / update via import_variable_spec, (2) duplicate detection + merge via dedupe_variables, (3) alias rewrites across modes via rebind_variable_aliases, (4) read-only ordering analysis via analyze_variable_order. All write commands accept a dry-run mode that returns the exact plan without touching Figma — agents should ALWAYS preview first and surface the plan to the user before committing.";
+    readonly preferredTools: readonly ["get_variables", "import_variable_spec", "dedupe_variables", "rebind_variable_aliases", "analyze_variable_order", "batch_bind_variables"];
+    readonly forbidden: readonly ["Calling create_variable / set_variable_mode_value in a loop for 5+ items — use import_variable_spec.", "Hand-writing a rebinding loop with rename_variable + set_variable_mode_value — use rebind_variable_aliases.", "Treating analyze_variable_order as a write command — Figma Plugin API does not expose stable variable reordering, so this is diff-only.", "Skipping dryRun on dedupe / rebind / import — always preview before committing.", "Using use_figma scripts to traverse local variables — get_variables + Phase B tools cover the case."];
+    readonly steps: readonly ["Read the user's intent: bulk create vs dedupe vs rebind vs reorder. Each maps to one Phase B tool.", "For BULK CREATE / UPDATE: pass spec.collections[] to import_variable_spec with dryRun: true first. The response lists added / updated / skipped variables and unresolved aliases. Re-call without dryRun to commit.", "For DEDUPE: dedupe_variables { strategy: 'byName' | 'byDefaultModeValue' } — default is dry-run. Confirm the proposed survivor with the user, then re-call with apply: true.", "For ALIAS REBIND: rebind_variable_aliases { mappings: [{ fromVariableId, toVariableId }], dryRun: true } first. The response counts how many valuesByMode entries would change. Re-call with dryRun: false to commit.", "For ORDER: analyze_variable_order { collectionId, strategy } — read-only analysis. Return the moves[] to the user; manual reorder in the Variables panel is required."];
+    readonly doneCriteria: "Agent produced a single Phase B call (or two: dryRun preview + commit) that the plugin executed; the user has the diff before any write. No use_figma / batch loops were used.";
+}, {
+    readonly id: "auto-bind-from-audit";
+    readonly title: "Auto-apply audit_variable_coverage suggestions";
+    readonly version: 1;
+    readonly userPhrases: readonly ["примени предложенные переменные к аудиту", "apply variable coverage suggestions", "автопривяжи переменные где есть подсказки", "fix the audit by binding suggested variables", "convert audit suggestions into bindings"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["auto-bind-from-audit", "audit-coverage"];
+        readonly hint: "audit-coverage produces the diagnosis (no writes); auto-bind-from-audit applies the prescribed variable. Always run audit first, confirm, then auto-bind.";
+    }];
+    readonly context: "find_variable_coverage_misses returns suggestions per node + property: { nodeId, property, suggestion: { variableId, variableName } }. apply_coverage_suggestions translates that array into setBoundVariableForPaint / setBoundVariableForEffect / setBoundVariable writes. Default mode is dry-run — agent receives a preview the user can sign off on. Commit happens only when dryRun: false.";
+    readonly preferredTools: readonly ["audit_variable_coverage", "find_variable_coverage_misses", "apply_coverage_suggestions", "batch_bind_variables"];
+    readonly forbidden: readonly ["Applying suggestions blindly without showing them to the user — coverage suggestions can be wrong on intentional raw values.", "Calling bind_variable in a loop for each suggestion — apply_coverage_suggestions handles paths like fills[0].color / effects[2].color in one round-trip.", "Skipping the dry-run preview — apply_coverage_suggestions is destructive (it writes bindings on the canvas)."];
+    readonly steps: readonly ["Run find_variable_coverage_misses { scope: 'page' | 'file', limit, withSuggestion: true }. Filter entries that have a non-null suggestion.", "Build the suggestions[] array: { nodeId, property, variableId } per entry.", "Call apply_coverage_suggestions with dryRun: true (default). Surface the preview[] to the user.", "On confirmation, re-call apply_coverage_suggestions with dryRun: false to commit. Canvas write — Dev Mode is blocked."];
+    readonly doneCriteria: "Bindings prescribed by the audit are applied to the canvas; the response reports applied / failed counts. No use_figma scripts were used.";
+}, {
+    readonly id: "bulk-styles";
+    readonly title: "Bulk create / dedupe / rebind LOCAL Figma styles + apply coverage suggestions (Phase C)";
+    readonly version: 1;
+    readonly userPhrases: readonly ["создай набор стилей по этому списку", "import these paint / text / effect styles in bulk", "bulk create paint styles from spec", "обнови стили пакетно", "найди дубликаты стилей и слей их", "dedupe styles across the file", "перепривяжи стили со старого на новый", "rebind style consumers from one style to another", "примени предложенные стили к аудиту", "apply style coverage suggestions", "конвертируй raw paints в стили"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["bulk-styles", "bulk-variables"];
+        readonly hint: "bulk-styles wraps Figma local STYLES (fillStyleId / textStyleId / effectStyleId). For Figma VARIABLES (boundVariables / valuesByMode) use bulk-variables instead.";
+    }, {
+        readonly between: readonly ["bulk-styles", "audit-coverage"];
+        readonly hint: "audit-coverage only LISTS missing bindings. bulk-styles applies them (apply_style_coverage_suggestions) and refactors styles in bulk.";
+    }, {
+        readonly between: readonly ["bulk-styles", "style-drift"];
+        readonly hint: "style-drift verifies that styles match the source of truth (read-only). bulk-styles modifies styles or their consumers.";
+    }];
+    readonly context: "Phase C 'thick' commands cover four recurring style refactors: (1) declarative bulk import / update via import_style_spec (PaintStyle + TextStyle + EffectStyle), (2) duplicate detection + merge via dedupe_styles (byName | bySignature), (3) bulk styleId rewriting on consumer nodes via rebind_style_consumers, (4) converting find_style_coverage_misses into setStyleId* writes via apply_style_coverage_suggestions. All write commands accept dry-run / preview mode that returns the plan WITHOUT touching Figma — agent should ALWAYS preview first and surface the diff to the user before committing.";
+    readonly preferredTools: readonly ["get_local_styles", "import_style_spec", "dedupe_styles", "rebind_style_consumers", "find_style_coverage_misses", "apply_style_coverage_suggestions"];
+    readonly forbidden: readonly ["Calling create_paint_style / create_text_style / create_effect_style in a loop for 5+ items — use import_style_spec.", "Hand-writing a styleId rewriting loop with set_fill_style / set_stroke_style — use rebind_style_consumers.", "Skipping dryRun on dedupe_styles / rebind_style_consumers / apply_style_coverage_suggestions — always preview before committing.", "Using use_figma scripts to traverse local styles — get_local_styles + Phase C tools cover the case.", "Applying coverage suggestions blindly — coverage suggestions can be wrong on intentional raw values."];
+    readonly steps: readonly ["Read the user's intent: bulk create vs dedupe vs rebind consumers vs auto-bind from audit. Each maps to one Phase C tool.", "For BULK CREATE / UPDATE: build spec.{paintStyles, textStyles, effectStyles}[] and call import_style_spec with dryRun: true first. SOLID paints accept `color: '#rrggbb[aa]'` shortcut. Re-call without dryRun to commit.", "For DEDUPE: dedupe_styles { strategy: 'byName' | 'bySignature', styleType?: 'PAINT' | 'TEXT' | 'EFFECT' | 'ALL' } — default is dry-run. Confirm the proposed survivor (style with most consumers wins), then re-call with apply: true.", "For STYLE REBIND: rebind_style_consumers { mappings: [{ fromStyleId, toStyleId }], dryRun: true } first. The response counts (node, field) pairs that would change. Re-call with dryRun: false to commit.", "For AUTO-BIND FROM AUDIT: find_style_coverage_misses → assemble suggestions[{ nodeId, property, styleId }] → apply_style_coverage_suggestions { suggestions, dryRun: true }. Style assignments are PER-NODE (PaintStyle covers the whole fills[] array), so duplicates by (nodeId, field) land in skipped[]. Surface preview, then re-call with dryRun: false."];
+    readonly doneCriteria: "Agent produced a Phase C call (or two: dryRun preview + commit) that the plugin executed; the user approved the diff before any write. No use_figma / set_*_style loops were used.";
+}, {
+    readonly id: "style-drift";
+    readonly title: "Audit drift between local Paint styles and the source of truth (Phase C)";
+    readonly version: 1;
+    readonly userPhrases: readonly ["проверь дрейф стилей и переменных", "audit style drift vs variables", "стили рассинхронизированы с токенами", "find paint styles that drifted from variables", "сверь PaintStyle со списком ожидаемых цветов", "verify styles against expected colors"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["style-drift", "audit-coverage"];
+        readonly hint: "style-drift verifies EXISTING style values vs source of truth. audit-coverage finds nodes WITHOUT a style binding.";
+    }, {
+        readonly between: readonly ["style-drift", "bulk-styles"];
+        readonly hint: "style-drift is READ-ONLY (Dev Mode safe). When drift is found and the user wants to fix it, switch to bulk-styles → import_style_spec to overwrite the drifted style values.";
+    }];
+    readonly context: "audit_style_drift compares local PaintStyles to the source of truth in two modes: byName-vs-variables (auto-pairs styles with like-named local Variables) or explicit ({ styleId, expectedColor } expectations from a token snapshot). Returns findings[] (drift > tolerance) and skipped[] (styles that couldn't be compared — non-SOLID, non-COLOR variable, etc.). NO canvas writes — fully Dev-Mode-compatible.";
+    readonly preferredTools: readonly ["audit_style_drift", "get_variables", "import_style_spec"];
+    readonly forbidden: readonly ["Walking PaintStyles + Variables manually with use_figma — audit_style_drift covers it (alias-aware).", "Setting tolerance > 0 silently — when fuzzy matching is enabled, surface the value to the user.", "Treating findings[] as canonical: skipped[] entries (no matching variable, non-SOLID paint, etc.) often need a follow-up question."];
+    readonly steps: readonly ["Decide the comparison source: token-driven workflow → byName-vs-variables; token snapshot from the transformer → explicit.", "Call audit_style_drift { request: { mode: 'byName-vs-variables' } } (or explicit + expectations[]) with optional tolerance.", "Surface findings[] grouped by source. For each, show actualColor → expectedColor + delta. Surface skipped[] separately.", "If user wants to fix drift: build an import_style_spec.paintStyles[] payload that overrides the drifted values, dryRun first, then commit."];
+    readonly doneCriteria: "Agent produced a deterministic drift report. No canvas writes happened during the audit. If the user requested a fix, a follow-up import_style_spec was issued with explicit dryRun preview.";
+}, {
+    readonly id: "mockup-builder";
+    readonly title: "Assemble a mockup screen from existing design-system components (Phase D)";
+    readonly version: 1;
+    readonly userPhrases: readonly ["собери макет страницы из компонентов", "build a mockup from existing components", "сделай дашборд из карточек", "render a screen using design system components", "lay out cards in auto-layout", "сложи макет из WCard и WButton", "render a list of N cards from this dataset", "построй продуктовую страницу по описанию", "assemble a settings screen from existing components"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["mockup-builder", "doc-component"];
+        readonly hint: "mockup-builder ASSEMBLES a screen from many components; doc-component DOCUMENTS a single component (variants + props).";
+    }, {
+        readonly between: readonly ["mockup-builder", "compose-with-variables"];
+        readonly hint: "mockup-builder is the consumer (lays out instances); compose-with-variables is the producer (creates / refactors the component itself).";
+    }, {
+        readonly between: readonly ["mockup-builder", "doc-flow"];
+        readonly hint: "mockup-builder = single auto-layout screen; doc-flow = multiple pages stacked side-by-side as a story.";
+    }];
+    readonly context: "Phase D: thick orchestration over `figma.createInstance / setProperties / setBoundVariableForPaint / loadFontAsync`. Pipeline: (1) `inspect_design_system` to aggregate components, variables, styles, token config, and compositions; (2) optional `find_components` to narrow ids / keys + componentPropertyDefinitions; (3) `validate_screen_spec` or `build_screen { dryRun: true }` to preview; (4) `build_screen` / `update_screen` to assemble an auto-layout container from a declarative item tree (`instance | section | spacer | text`) with property / text / fill-binding overrides; (5) `apply_mockup_dataset` when the same template needs to be cloned per-row from a structured list.";
+    readonly preferredTools: readonly ["inspect_design_system", "validate_screen_spec", "build_screen", "update_screen", "find_components", "build_mockup", "apply_mockup_dataset", "get_variables"];
+    readonly schemaResources: readonly ["sxl://agent/schemas/design-dsl-v1"];
+    readonly forbidden: readonly ["Calling use_figma to write a hand-rolled `figma.createInstance(...) / setProperties(...)` loop when build_screen/build_mockup covers the assembly.", "Guessing component names instead of running inspect_design_system or find_components first — the user's file may have arbitrary local names.", "Skipping dryRun for build_screen / update_screen / build_mockup / apply_mockup_dataset — always preview the resolved plan before writing to canvas.", "Hand-coding fill colours when a Figma Variable is available — use fillBindings { variableId } so the mockup picks up theme switches automatically.", "Loading fonts manually — build_mockup loads fonts on demand with a safe Inter Regular fallback.", "Assuming property names like `size#123:0` — pass the human key (`size`); the plugin maps to the internal `name#defId` suffix via `componentProperties`."];
+    readonly steps: readonly ["Run inspect_design_system { query | prefix?, includeProperties: true, includeRemoteInstances?: true } to aggregate components, variables, local styles, token config, and composition index.", "Run find_components { query | prefix?, includeProperties: true, kind?: 'COMPONENT' | 'COMPONENT_SET', limit?: 50 } when the aggregate response needs narrowing. Cache the (id, name, propertyDefinitions, defaultVariantId) list.", "If the user wants library components, set includeRemoteInstances: true so library components instantiated in this file are included; otherwise stay local-only.", "Decide the layout: VERTICAL stack of sections, HORIZONTAL row of cards, or WRAP grid. Pick itemSpacing / padding to match the user's intent (e.g. 16px gutters).", "Build the items[] tree. Use `instance` for components (one of componentId | componentKey | componentName), `section` for nested auto-layout frames, `spacer` for explicit gaps, `text` for bare TEXT layers (TEXT styles can be applied via textStyleId).", "For property / text / fill overrides on instances: pass `properties` (human keys), `textOverrides[]` (layerName + value), `fillBindings[]` (variableId; optional layerName when only one child should receive the fill).", "Call validate_screen_spec or build_screen { ..., dryRun: true } first. The plugin returns a resolved plan with per-item ok/error. If any errors → fix the spec, do not commit.", "Re-call build_screen without dryRun to write a new canvas root, or update_screen { targetRootId, ... } to modify an existing frame without recreating the whole screen. Capture rootNodeId for downstream tools (e.g. document the mockup, run audit_variable_coverage on it).", "If the user wants N cards from a dataset, leave one template instance inside the mockup (kind: 'instance'), then call apply_mockup_dataset { templateNodeId, rows[], dryRun: true } → preview → commit. removeTemplate: true deletes the placeholder after cloning."];
+    readonly doneCriteria: "Agent produced one (or a sequence of) Phase D calls (inspect_design_system → validate/build_screen [dryRun → commit] → optional apply_mockup_dataset) that the plugin executed without use_figma. The user approved each diff before commit. The mockup uses real components by id/key (not duplicated geometry) and binds Figma Variables instead of raw hex when a variable is available.";
+}, {
+    readonly id: "bulk-compositions";
+    readonly title: "Bulk generate / apply many composition files in one call (Phase E)";
+    readonly version: 1;
+    readonly userPhrases: readonly ["сгенерируй все компоненты дизайн-системы", "regenerate every WAccordion / WButton / WInput from JSON", "пересобери компоненты по композициям", "apply all SXL compositions in this workspace", "обнови компоненты после правок в JSON", "rebuild every composition that drifted", "перегенерируй все компоненты после очистки файла", "fresh-bake the design system from compositions"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["bulk-compositions", "compose-with-variables"];
+        readonly use_bulk_compositions_when: "the composition JSON files already exist in the plugin workspace (`tokens/components/W*.json`) and you want to (re)build many components in one call";
+        readonly use_compose_with_variables_when: "the composition JSON does NOT exist yet — you start from a Figma URL, export composition JSON, and generate one component";
+    }, {
+        readonly between: readonly ["bulk-compositions", "composition-drift"];
+        readonly use_bulk_compositions_when: "the user wants to WRITE (generate / apply) compositions";
+        readonly use_composition_drift_when: "the user only wants to KNOW which compositions are out of sync (read-only)";
+    }, {
+        readonly between: readonly ["bulk-compositions", "doc-component"];
+        readonly use_bulk_compositions_when: "the goal is to (re)build the actual COMPONENT in Figma from composition JSON";
+        readonly use_doc_component_when: "the goal is to render a documentation FRAME for an existing component";
+    }];
+    readonly context: "Phase E thick orchestration around `handleGenerateComposition` / `handleApplyComposition`. Discovers every `$type:composition` file in the plugin workspace (same source as `list_compositions`), filters by `fileIds | names | prefix`, then runs the per-file pipeline with per-item error isolation (`continueOnError: true` by default). `operation: 'auto'` mirrors the manual UX (apply if a tracked component already exists, otherwise generate); `'generate'` forces a fresh ComponentSet rebuild; `'apply'` forces apply onto an existing component. `dryRun: true` returns the resolved plan WITHOUT touching the canvas — Dev Mode safe.";
+    readonly preferredTools: readonly ["list_compositions", "audit_composition_drift", "bulk_generate_compositions"];
+    readonly forbidden: readonly ["Calling generate_composition / apply_composition in a hand-written loop for 3+ files — use bulk_generate_compositions to keep per-item error isolation, progress events, and idempotency.", "Using bulk_generate_compositions with `operation: 'apply'` against compositions that have no diff-id tracking entry — the handler will fall back to `generate` per item; if the user explicitly asked for apply-only, run audit_composition_drift first to confirm tracking exists.", "Skipping dryRun when the user expects a preview — agent must surface the resolved plan (file count, expected variant counts, errors) before committing canvas writes.", "Operating on every composition without filters when the user only mentioned a single component family — pass `prefix: 'WAccordion'` / `names: [...]` to keep the run small and idempotent.", "Interpreting `success: true, variantsCreated: 0` as a failure — that's normal idempotent behaviour for `apply` when nothing changed."];
+    readonly steps: readonly ["Discover what's in the workspace: read `sxl://compositions/index` (or call list_compositions) to get the full set of composition files + names.", "(Optional) Run audit_composition_drift first when the user is unsure which components actually drifted. Use the report to build the `fileIds` filter for the next step.", "Pick filter scope: `fileIds: [...]` for surgical re-builds, `prefix: 'W'` for a whole DS family, `names: ['WButton', 'WInput']` for a curated list. Omit all filters only when the user explicitly asked to rebuild everything.", "Pick operation: `auto` (default — manual UX), `generate` (force rebuild — use after structural changes / corrupted tracking), `apply` (force apply onto existing — use only when tracking is healthy).", "Call bulk_generate_compositions { ..., dryRun: true } first. The plugin returns the resolved plan with per-item composition name + parse status. If any errors → fix the JSON / config, do not commit.", "Re-call without dryRun to commit. Capture summary { total, processed, created, updated, failed, elapsedMs } and surface it to the user.", "On per-item failures, the run continues by default. Group `items[].errors` by composition for the user; if `continueOnError: false` was set, only `items` up to the first failure are present."];
+    readonly doneCriteria: "Agent produced one or two bulk_generate_compositions calls (dryRun → commit) that touched only the requested compositions. Per-item errors were surfaced; failures did not silently rebuild the wrong components. No hand-written generate/apply loops were issued.";
+}, {
+    readonly id: "composition-drift";
+    readonly title: "Audit drift between composition JSON files and Figma components (Phase E)";
+    readonly version: 1;
+    readonly userPhrases: readonly ["проверь рассинхрон композиций и компонентов", "audit composition drift", "какие компоненты не соответствуют JSON", "find compositions that drifted from Figma", "сверь tokens/components с реальными ComponentSet", "verify SXL compositions still match the Figma design system", "какие компоненты потерялись", "show compositions whose tracked component was deleted"];
+    readonly decideBetween: readonly [{
+        readonly between: readonly ["composition-drift", "bulk-compositions"];
+        readonly use_composition_drift_when: "user wants the LIST of out-of-sync compositions (read-only — Dev Mode safe)";
+        readonly use_bulk_compositions_when: "user wants to FIX the drift (write — bulk_generate_compositions { fileIds: drifted, operation: 'generate' })";
+    }, {
+        readonly between: readonly ["composition-drift", "style-drift"];
+        readonly use_composition_drift_when: "the unit of comparison is a composition JSON ↔ Figma ComponentSet";
+        readonly use_style_drift_when: "the unit of comparison is a local PaintStyle ↔ Variable / token snapshot";
+    }, {
+        readonly between: readonly ["composition-drift", "find-unused"];
+        readonly use_composition_drift_when: "the goal is to verify EXISTING compositions still match the Figma scene";
+        readonly use_find_unused_when: "the goal is to clean up dangling local variables / styles (different unit)";
+    }];
+    readonly context: "audit_composition_drift compares every `$type:composition` file in the plugin workspace against the Figma component it tracked in `diff-id.compositions`. Per-composition status: `linked` (tracking entry valid + Figma node matches), `unlinked` (no tracking — never generated), `drift` (Figma node renamed / variant count mismatch / wrong type), `missing` (tracking points to a deleted node). Findings include human-readable `reason`. Fully Dev-Mode-compatible — never touches the canvas.";
+    readonly preferredTools: readonly ["audit_composition_drift", "list_compositions", "bulk_generate_compositions"];
+    readonly forbidden: readonly ["Walking diff-id.json + Figma scene tree manually with use_figma — audit_composition_drift covers it.", "Treating `unlinked` as drift — it just means the composition was never generated. Surface it as a separate bucket.", "Auto-fixing without confirmation — drift can mean the designer intentionally renamed the Figma component; ask before running bulk_generate_compositions."];
+    readonly steps: readonly ["Run audit_composition_drift with appropriate filters: `prefix: 'W'` for the whole DS, `names: [...]` for a curated list, no filters for the full workspace.", "Group findings by status (linked / unlinked / drift / missing) and surface counts to the user.", "For each `drift` / `missing` finding, surface: composition name, fileId, status, reason, expected vs actual variant count, tracked componentSetId.", "If user wants to fix drift: call bulk_generate_compositions { fileIds: [drift+missing fileIds], operation: 'generate', dryRun: true } first → preview → commit.", "For `unlinked` findings: ask whether to generate them as new components (bulk_generate_compositions { operation: 'auto' }) or leave them."];
+    readonly doneCriteria: "Agent returned a deterministic drift report with per-composition status. No canvas writes happened during the audit. If the user approved a fix, a follow-up bulk_generate_compositions was issued with explicit dryRun preview.";
+}];
+export type AgentIntentRoute = {
+    recipeId: string;
+    title: string;
+    score: number;
+    matchedPhrases: string[];
+    preferredTools: readonly string[];
+    schemaResources: readonly string[];
+    dryRunFirst: boolean;
+    doneCriteria: string;
+};
+export declare function routeAgentIntent(request: string, options?: {
+    limit?: number;
+}): {
+    ok: true;
+    request: string;
+    routes: AgentIntentRoute[];
+};