@sxl-studio/bridge 1.7.2 → 1.8.0

package/dist/workflow-planner.js

@@ -0,0 +1,464 @@
+import { ALL_AGENT_RECIPES, routeAgentIntent, } from "./agent-recipes.js";
+import { buildCapabilityMatrix } from "./tools/capability-matrix.js";
+const RECIPE_BY_ID = new Map(ALL_AGENT_RECIPES.map((recipe) => [recipe.id, recipe]));
+const DISCOVERY_TOOLS = new Set([
+    "get_plugin_status",
+    "get_bridge_runtime_summary",
+    "get_capability_matrix",
+    "list_tools",
+    "route_intent",
+    "get_design_context",
+    "get_metadata",
+    "get_screenshot",
+    "get_variable_defs",
+    "get_libraries",
+    "search_design_system",
+    "figma_rest_diagnose",
+    "figma_rest_search_design_system",
+    "search_enabled_library_assets",
+    "inspect_enabled_libraries",
+    "list_enabled_library_variables",
+    "inspect_design_system",
+    "find_components",
+    "get_variables",
+    "get_local_styles",
+    "list_token_files",
+    "get_tokens_config",
+    "list_compositions",
+    "audit_variable_coverage",
+    "find_variable_coverage_misses",
+    "audit_style_coverage",
+    "find_style_coverage_misses",
+    "audit_composition_drift",
+]);
+const SCREEN_VALIDATED_WRITE_TOOLS = new Set([
+    "build_screen",
+    "update_screen",
+    "build_mockup",
+]);
+const SCREEN_OR_MOCKUP_TOOLS = new Set([
+    "build_screen",
+    "update_screen",
+    "build_mockup",
+    "apply_mockup_dataset",
+]);
+const DESIGN_SYSTEM_DISCOVERY_TOOLS = new Set([
+    "inspect_design_system",
+    "find_components",
+    "get_libraries",
+    "search_design_system",
+]);
+function getRecipeSchemaResources(recipe) {
+    return "schemaResources" in recipe ? recipe.schemaResources : [];
+}
+function recipeToRoute(recipe, request) {
+    const recipeText = JSON.stringify(recipe);
+    return {
+        recipeId: recipe.id,
+        title: recipe.title,
+        score: 1,
+        matchedPhrases: [],
+        preferredTools: recipe.preferredTools,
+        schemaResources: getRecipeSchemaResources(recipe),
+        dryRunFirst: /dryRun/i.test(recipeText),
+        doneCriteria: String(recipe.doneCriteria),
+    };
+}
+function resolveRoute(request, recipeId) {
+    if (recipeId) {
+        const recipe = RECIPE_BY_ID.get(recipeId);
+        if (!recipe) {
+            throw new Error(`Unknown SXL recipe id "${recipeId}"`);
+        }
+        return recipeToRoute(recipe, request);
+    }
+    const routed = routeAgentIntent(request, { limit: 1 });
+    const first = routed.routes[0];
+    if (first)
+        return first;
+    const fallback = RECIPE_BY_ID.get("sxl-use");
+    if (!fallback) {
+        throw new Error("No SXL fallback recipe registered");
+    }
+    return recipeToRoute(fallback, request);
+}
+function matrixByTool() {
+    const matrix = buildCapabilityMatrix();
+    return new Map(matrix.tools.map((tool) => [tool.name, tool]));
+}
+function addStep(steps, step) {
+    steps.push({ id: `step-${String(steps.length + 1).padStart(2, "0")}`, ...step });
+}
+function toolPhase(tool) {
+    if (tool.requiresDesignMode)
+        return "commit";
+    if (tool.dryRunSupported)
+        return "preview";
+    if (DISCOVERY_TOOLS.has(tool.name))
+        return "discover";
+    if (tool.name.startsWith("find_") || tool.name.startsWith("audit_") || tool.name.startsWith("analyze_")) {
+        return "discover";
+    }
+    return "discover";
+}
+function expandPreferredToolsWithPreflights(toolNames, tools) {
+    const expanded = [];
+    const added = new Set();
+    const visiting = new Set();
+    const visit = (toolName) => {
+        if (added.has(toolName))
+            return;
+        if (visiting.has(toolName))
+            return;
+        visiting.add(toolName);
+        const tool = tools.get(toolName);
+        for (const preflightName of tool?.preferredAfter ?? []) {
+            visit(preflightName);
+        }
+        visiting.delete(toolName);
+        if (!added.has(toolName)) {
+            added.add(toolName);
+            expanded.push(toolName);
+        }
+    };
+    for (const toolName of toolNames) {
+        visit(toolName);
+    }
+    return expanded;
+}
+export function planWorkflow(args) {
+    const request = args.request.trim();
+    if (!request) {
+        throw new Error("plan_workflow requires a non-empty request");
+    }
+    const route = resolveRoute(request, args.recipeId);
+    const tools = matrixByTool();
+    const findings = [];
+    const steps = [];
+    const schemaResources = route.schemaResources;
+    const recipeUri = `sxl://agent/recipes/${route.recipeId}`;
+    addStep(steps, {
+        kind: "tool",
+        phase: "route",
+        title: "Route natural-language request",
+        toolName: "route_intent",
+        required: args.recipeId ? false : true,
+        reason: args.recipeId
+            ? "Recipe id was provided explicitly; route_intent is optional for traceability."
+            : "Pick the SXL recipe before composing payloads or writing to Figma.",
+    });
+    addStep(steps, {
+        kind: "resource",
+        phase: "context",
+        title: "Read selected recipe",
+        resourceUri: recipeUri,
+        required: true,
+        reason: "Use the recipe as the task-specific operating procedure.",
+    });
+    for (const resourceUri of schemaResources) {
+        addStep(steps, {
+            kind: "resource",
+            phase: "context",
+            title: "Read payload schema",
+            resourceUri,
+            required: true,
+            reason: "Build payloads against the versioned Bridge contract before calling tools.",
+        });
+    }
+    if (route.recipeId === "figma-mcp-companion") {
+        addStep(steps, {
+            kind: "gate",
+            phase: "verify",
+            title: "Use official Figma MCP companion",
+            required: true,
+            reason: "The selected scope is remote-only/non-Design for Bridge. Use official Figma MCP tools for the requested operation and keep Bridge for SXL/active-file context.",
+        });
+    }
+    const preferredTools = expandPreferredToolsWithPreflights(route.preferredTools, tools);
+    const writeTools = preferredTools
+        .map((name) => tools.get(name))
+        .filter((tool) => Boolean(tool?.requiresDesignMode));
+    const firstPreferredWriteIndex = preferredTools.findIndex((name) => tools.get(name)?.requiresDesignMode === true);
+    const preferredStatusIndex = preferredTools.indexOf("get_plugin_status");
+    const shouldAddStatusContext = writeTools.length > 0 &&
+        (preferredStatusIndex < 0 || (firstPreferredWriteIndex >= 0 && preferredStatusIndex > firstPreferredWriteIndex));
+    if (shouldAddStatusContext) {
+        const statusTool = tools.get("get_plugin_status");
+        addStep(steps, {
+            kind: "tool",
+            phase: "context",
+            title: "Check plugin mode",
+            toolName: "get_plugin_status",
+            required: true,
+            requiresDesignMode: false,
+            execution: statusTool?.execution,
+            pluginCommandTypes: statusTool?.pluginCommandTypes,
+            reason: "Confirm writesAllowed/editorType before any canvas-mutating step.",
+        });
+    }
+    for (const toolName of preferredTools) {
+        if (shouldAddStatusContext && toolName === "get_plugin_status")
+            continue;
+        const tool = tools.get(toolName);
+        if (!tool) {
+            findings.push({
+                severity: "warning",
+                code: "TOOL_NOT_IN_CATALOGUE",
+                message: `Preferred tool "${toolName}" is not in the Bridge catalogue.`,
+                toolName,
+            });
+            continue;
+        }
+        if (tool.requiresDesignMode && tool.dryRunSupported) {
+            addStep(steps, {
+                kind: "tool",
+                phase: "preview",
+                title: `Preview ${tool.name}`,
+                toolName: tool.name,
+                dryRun: true,
+                required: true,
+                requiresDesignMode: tool.requiresDesignMode,
+                execution: tool.execution,
+                pluginCommandTypes: tool.pluginCommandTypes,
+                schemaResources,
+                reason: "Dry-run preview before mutating the Figma canvas.",
+            });
+            addStep(steps, {
+                kind: "gate",
+                phase: "approval",
+                title: `Approve ${tool.name}`,
+                required: true,
+                requiresApproval: true,
+                reason: "Proceed only after the dry-run/result is clean or explicitly approved.",
+            });
+            addStep(steps, {
+                kind: "tool",
+                phase: "commit",
+                title: `Commit ${tool.name}`,
+                toolName: tool.name,
+                dryRun: false,
+                required: true,
+                requiresApproval: true,
+                requiresDesignMode: true,
+                execution: tool.execution,
+                pluginCommandTypes: tool.pluginCommandTypes,
+                schemaResources,
+                reason: "Perform the requested write after preview/approval.",
+            });
+            continue;
+        }
+        if (tool.requiresDesignMode) {
+            addStep(steps, {
+                kind: "gate",
+                phase: "approval",
+                title: `Approve ${tool.name}`,
+                required: true,
+                requiresApproval: true,
+                reason: "This write tool has no dry-run surface; require explicit approval before execution.",
+            });
+        }
+        addStep(steps, {
+            kind: "tool",
+            phase: toolPhase(tool),
+            title: tool.requiresDesignMode ? `Run ${tool.name}` : `Read ${tool.name}`,
+            toolName: tool.name,
+            required: true,
+            requiresApproval: tool.requiresDesignMode,
+            requiresDesignMode: tool.requiresDesignMode,
+            execution: tool.execution,
+            pluginCommandTypes: tool.pluginCommandTypes,
+            schemaResources,
+            reason: tool.summary,
+        });
+    }
+    if (route.dryRunFirst && !steps.some((step) => step.kind === "tool" && step.dryRun === true)) {
+        findings.push({
+            severity: "warning",
+            code: "DRY_RUN_ROUTE_WITHOUT_DRY_RUN_TOOL",
+            message: "Selected recipe mentions dryRun, but no preferred dry-run-capable write tool was found.",
+        });
+    }
+    return {
+        ok: true,
+        request,
+        route,
+        recipeUri,
+        schemaResources,
+        dryRunFirst: route.dryRunFirst,
+        steps,
+        findings,
+        doneCriteria: route.doneCriteria,
+    };
+}
+function normalizeProposedTools(args) {
+    if (args.proposedSteps?.length)
+        return args.proposedSteps;
+    return (args.proposedTools ?? []).map((toolName) => ({ toolName }));
+}
+export function previewWorkflow(args) {
+    const plan = planWorkflow({ request: args.request, recipeId: args.recipeId });
+    const tools = matrixByTool();
+    const proposed = normalizeProposedTools(args);
+    const proposedNames = proposed.map((step) => step.toolName);
+    const findings = [...plan.findings];
+    for (const step of proposed) {
+        if (!tools.has(step.toolName)) {
+            findings.push({
+                severity: "error",
+                code: "UNKNOWN_TOOL",
+                message: `Proposed tool "${step.toolName}" is not registered in Bridge catalogue.`,
+                toolName: step.toolName,
+            });
+        }
+    }
+    const proposedWriteTools = proposed
+        .map((step) => tools.get(step.toolName))
+        .filter((tool) => Boolean(tool?.requiresDesignMode));
+    if (proposedWriteTools.length > 0 && !proposedNames.includes("get_plugin_status")) {
+        findings.push({
+            severity: "warning",
+            code: "MISSING_STATUS_CHECK",
+            message: "A workflow with write tools should call get_plugin_status before mutating Figma.",
+        });
+    }
+    const firstMutatingWriteIndex = proposed.findIndex((step) => {
+        const tool = tools.get(step.toolName);
+        return Boolean(tool?.requiresDesignMode) && step.dryRun !== true;
+    });
+    const statusIndexes = proposed
+        .map((step, stepIndex) => step.toolName === "get_plugin_status" ? stepIndex : -1)
+        .filter((stepIndex) => stepIndex >= 0);
+    if (firstMutatingWriteIndex >= 0 &&
+        statusIndexes.length > 0 &&
+        !statusIndexes.some((stepIndex) => stepIndex < firstMutatingWriteIndex)) {
+        findings.push({
+            severity: "warning",
+            code: "STATUS_CHECK_ORDER",
+            message: "get_plugin_status should run before the first mutating Figma write.",
+        });
+    }
+    const firstScreenOrMockupIndex = proposed.findIndex((step) => SCREEN_OR_MOCKUP_TOOLS.has(step.toolName));
+    const discoveryIndexes = proposed
+        .map((step, stepIndex) => DESIGN_SYSTEM_DISCOVERY_TOOLS.has(step.toolName) ? stepIndex : -1)
+        .filter((stepIndex) => stepIndex >= 0);
+    if (firstScreenOrMockupIndex >= 0 && discoveryIndexes.length === 0) {
+        findings.push({
+            severity: "warning",
+            code: "MISSING_DESIGN_SYSTEM_DISCOVERY",
+            message: "Screen/mockup workflows should inspect the design system or find components before writing.",
+        });
+    }
+    if (firstScreenOrMockupIndex >= 0 &&
+        discoveryIndexes.length > 0 &&
+        !discoveryIndexes.some((stepIndex) => stepIndex < firstScreenOrMockupIndex)) {
+        findings.push({
+            severity: "warning",
+            code: "DESIGN_SYSTEM_DISCOVERY_ORDER",
+            message: "Screen/mockup workflows should inspect the design system or find components before the first screen/mockup step.",
+        });
+    }
+    const dryRunWarningKeys = new Set();
+    for (const [stepIndex, step] of proposed.entries()) {
+        const tool = tools.get(step.toolName);
+        if (!tool?.requiresDesignMode || !tool.dryRunSupported || step.dryRun === true)
+            continue;
+        const hasPriorPreview = proposed.some((candidate, candidateIndex) => candidateIndex < stepIndex &&
+            candidate.toolName === tool.name &&
+            candidate.dryRun === true);
+        const acceptsScreenValidator = SCREEN_VALIDATED_WRITE_TOOLS.has(tool.name);
+        const hasPriorValidator = acceptsScreenValidator &&
+            proposed.some((candidate, candidateIndex) => candidateIndex < stepIndex &&
+                candidate.toolName === "validate_screen_spec");
+        if (hasPriorPreview || hasPriorValidator)
+            continue;
+        const hasLaterPreview = proposed.some((candidate, candidateIndex) => candidateIndex > stepIndex &&
+            candidate.toolName === tool.name &&
+            candidate.dryRun === true);
+        const hasLaterValidator = acceptsScreenValidator &&
+            proposed.some((candidate, candidateIndex) => candidateIndex > stepIndex &&
+                candidate.toolName === "validate_screen_spec");
+        const code = hasLaterPreview || hasLaterValidator ? "DRY_RUN_AFTER_COMMIT" : "MISSING_DRY_RUN";
+        const warningKey = `${code}:${tool.name}`;
+        if (dryRunWarningKeys.has(warningKey))
+            continue;
+        dryRunWarningKeys.add(warningKey);
+        if (code === "DRY_RUN_AFTER_COMMIT") {
+            findings.push({
+                severity: "warning",
+                code,
+                message: `Write tool "${tool.name}" has a dry-run/validation step, but it appears after the commit. Move preview before the write.`,
+                toolName: tool.name,
+            });
+        }
+        else {
+            findings.push({
+                severity: "warning",
+                code,
+                message: `Write tool "${tool.name}" supports dryRun; preview it before commit.`,
+                toolName: tool.name,
+            });
+        }
+    }
+    for (const [stepIndex, step] of proposed.entries()) {
+        const tool = tools.get(step.toolName);
+        const preflightTools = tool?.preferredAfter ?? [];
+        if (preflightTools.length === 0)
+            continue;
+        const missingPreflight = [];
+        const misplacedPreflight = [];
+        for (const preflightName of preflightTools) {
+            const matchingIndexes = proposed
+                .map((candidate, candidateIndex) => candidate.toolName === preflightName ? candidateIndex : -1)
+                .filter((candidateIndex) => candidateIndex >= 0);
+            if (matchingIndexes.length === 0) {
+                missingPreflight.push(preflightName);
+                continue;
+            }
+            if (!matchingIndexes.some((candidateIndex) => candidateIndex < stepIndex)) {
+                misplacedPreflight.push(preflightName);
+            }
+        }
+        if (missingPreflight.length > 0) {
+            findings.push({
+                severity: "warning",
+                code: "MISSING_PREFLIGHT_TOOL",
+                message: `Tool "${step.toolName}" should be preceded by: ${missingPreflight.join(", ")}.`,
+                toolName: step.toolName,
+            });
+        }
+        if (misplacedPreflight.length > 0) {
+            findings.push({
+                severity: "warning",
+                code: "PREFLIGHT_TOOL_ORDER",
+                message: `Tool "${step.toolName}" should be preceded by: ${misplacedPreflight.join(", ")}. The preflight exists in the proposed sequence, but not before the target tool.`,
+                toolName: step.toolName,
+            });
+        }
+    }
+    if (plan.route.recipeId === "figma-mcp-companion" &&
+        proposedWriteTools.length > 0) {
+        findings.push({
+            severity: "warning",
+            code: "COMPANION_SCOPE_HAS_BRIDGE_WRITES",
+            message: "This route is official Figma MCP companion scope; avoid Bridge write tools unless the user explicitly narrowed the task back to SXL/active-file Design work.",
+        });
+    }
+    const preferred = new Set(plan.route.preferredTools);
+    const missingPreferred = Array.from(preferred).filter((name) => !proposedNames.includes(name));
+    if (proposed.length > 0 && missingPreferred.length > 0) {
+        findings.push({
+            severity: "info",
+            code: "PREFERRED_TOOLS_NOT_PROPOSED",
+            message: `Recipe preferred tools not present in proposed sequence: ${missingPreferred.join(", ")}`,
+        });
+    }
+    const acceptable = !findings.some((finding) => finding.severity === "error");
+    return {
+        ok: true,
+        plan,
+        proposedTools: proposedNames,
+        acceptable,
+        findings,
+    };
+}
+//# sourceMappingURL=workflow-planner.js.map

package/dist/workflow-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-planner.js","sourceRoot":"","sources":["../src/workflow-planner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAA6B,MAAM,8BAA8B,CAAC;AAoDhG,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CACvD,CAAC;AAEF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,mBAAmB;IACnB,4BAA4B;IAC5B,uBAAuB;IACvB,YAAY;IACZ,cAAc;IACd,oBAAoB;IACpB,cAAc;IACd,gBAAgB;IAChB,mBAAmB;IACnB,eAAe;IACf,sBAAsB;IACtB,qBAAqB;IACrB,iCAAiC;IACjC,+BAA+B;IAC/B,2BAA2B;IAC3B,gCAAgC;IAChC,uBAAuB;IACvB,iBAAiB;IACjB,eAAe;IACf,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,yBAAyB;IACzB,+BAA+B;IAC/B,sBAAsB;IACtB,4BAA4B;IAC5B,yBAAyB;CAC1B,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC;IAC3C,cAAc;IACd,eAAe;IACf,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,cAAc;IACd,eAAe;IACf,cAAc;IACd,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC;IAC5C,uBAAuB;IACvB,iBAAiB;IACjB,eAAe;IACf,sBAAsB;CACvB,CAAC,CAAC;AAEH,SAAS,wBAAwB,CAAC,MAAmB;IACnD,OAAO,iBAAiB,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,aAAa,CAAC,MAAmB,EAAE,OAAe;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,CAAC;QACR,cAAc,EAAE,EAAE;QAClB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,eAAe,EAAE,wBAAwB,CAAC,MAAM,CAAC;QACjD,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;QACvC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,QAAiB;IACtD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,OAAO,CACd,KAAyB,EACzB,IAAkC;IAElC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,SAAS,CAAC,IAA0B;IAC3C,IAAI,IAAI,CAAC,kBAAkB;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,IAAI,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IACtD,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACxG,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,kCAAkC,CACzC,SAA4B,EAC5B,KAAwC;IAExC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAQ,EAAE;QACvC,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QAChC,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QACnC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,KAAK,MAAM,aAAa,IAAI,IAAI,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC;YACvD,KAAK,CAAC,aAAa,CAAC,CAAC;QACvB,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAG5B;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9C,MAAM,SAAS,GAAG,uBAAuB,KAAK,CAAC,QAAQ,EAAE,CAAC;IAE1D,OAAO,CAAC,KAAK,EAAE;QACb,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,gCAAgC;QACvC,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACtC,MAAM,EAAE,IAAI,CAAC,QAAQ;YACnB,CAAC,CAAC,+EAA+E;YACjF,CAAC,CAAC,oEAAoE;KACzE,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,EAAE;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,0DAA0D;KACnE,CAAC,CAAC;IAEH,KAAK,MAAM,WAAW,IAAI,eAAe,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,qBAAqB;YAC5B,WAAW;YACX,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,4EAA4E;SACrF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,KAAK,qBAAqB,EAAE,CAAC;QAC7C,OAAO,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,kCAAkC;YACzC,QAAQ,EAAE,IAAI;YACd,MAAM,EACJ,gKAAgK;SACnK,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,kCAAkC,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,cAAc;SAC9B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC9B,MAAM,CAAC,CAAC,IAAI,EAAgC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACrF,MAAM,wBAAwB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC,CAAC;IAClH,MAAM,oBAAoB,GAAG,cAAc,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzE,MAAM,sBAAsB,GAC1B,UAAU,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,oBAAoB,GAAG,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,IAAI,oBAAoB,GAAG,wBAAwB,CAAC,CAAC,CAAC;IAEnH,IAAI,sBAAsB,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,mBAAmB;YAC1B,QAAQ,EAAE,mBAAmB;YAC7B,QAAQ,EAAE,IAAI;YACd,kBAAkB,EAAE,KAAK;YACzB,SAAS,EAAE,UAAU,EAAE,SAAS;YAChC,kBAAkB,EAAE,UAAU,EAAE,kBAAkB;YAClD,MAAM,EAAE,mEAAmE;SAC5E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,IAAI,sBAAsB,IAAI,QAAQ,KAAK,mBAAmB;YAAE,SAAS;QAEzE,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,mBAAmB,QAAQ,mCAAmC;gBACvE,QAAQ;aACT,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACpD,OAAO,CAAC,KAAK,EAAE;gBACb,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;gBAC7B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,IAAI;gBACd,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;gBAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;gBAC3C,eAAe;gBACf,MAAM,EAAE,mDAAmD;aAC5D,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,EAAE;gBACb,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,UAAU;gBACjB,KAAK,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;gBAC7B,QAAQ,EAAE,IAAI;gBACd,gBAAgB,EAAE,IAAI;gBACtB,MAAM,EAAE,wEAAwE;aACjF,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,EAAE;gBACb,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,UAAU,IAAI,CAAC,IAAI,EAAE;gBAC5B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,IAAI;gBACd,gBAAgB,EAAE,IAAI;gBACtB,kBAAkB,EAAE,IAAI;gBACxB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;gBAC3C,eAAe;gBACf,MAAM,EAAE,qDAAqD;aAC9D,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,EAAE;gBACb,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,UAAU;gBACjB,KAAK,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;gBAC7B,QAAQ,EAAE,IAAI;gBACd,gBAAgB,EAAE,IAAI;gBACtB,MAAM,EAAE,qFAAqF;aAC9F,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;YACtB,KAAK,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE;YACzE,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI;YACd,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;YACzC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,eAAe;YACf,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7F,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,oCAAoC;YAC1C,OAAO,EAAE,yFAAyF;SACnG,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO;QACP,KAAK;QACL,SAAS;QACT,eAAe;QACf,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK;QACL,QAAQ;QACR,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,IAG/B;IACC,IAAI,IAAI,CAAC,aAAa,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC,aAAa,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAsB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEvD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,kBAAkB,IAAI,CAAC,QAAQ,0CAA0C;gBAClF,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAG,QAAQ;SAChC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,IAAI,EAAgC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAErF,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClF,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,kFAAkF;SAC5F,CAAC,CAAC;IACL,CAAC;IAED,MAAM,uBAAuB,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IACnE,CAAC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,QAAQ;SAC3B,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAChF,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAEzC,IACE,uBAAuB,IAAI,CAAC;QAC5B,aAAa,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,GAAG,uBAAuB,CAAC,EACvE,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,qEAAqE;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,wBAAwB,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzG,MAAM,gBAAgB,GAAG,QAAQ;SAC9B,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,6BAA6B,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3F,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAEzC,IAAI,wBAAwB,IAAI,CAAC,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,iCAAiC;YACvC,OAAO,EAAE,6FAA6F;SACvG,CAAC,CAAC;IACL,CAAC;IAED,IACE,wBAAwB,IAAI,CAAC;QAC7B,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAC3B,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,GAAG,wBAAwB,CAAC,EAC3E,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,kHAAkH;SAC5H,CAAC,CAAC;IACL,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,kBAAkB,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,SAAS;QAEzF,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CACnC,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CAC5B,cAAc,GAAG,SAAS;YAC1B,SAAS,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI;YAChC,SAAS,CAAC,MAAM,KAAK,IAAI,CAC5B,CAAC;QACF,MAAM,sBAAsB,GAAG,4BAA4B,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,MAAM,iBAAiB,GACrB,sBAAsB;YACtB,QAAQ,CAAC,IAAI,CACX,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CAC5B,cAAc,GAAG,SAAS;gBAC1B,SAAS,CAAC,QAAQ,KAAK,sBAAsB,CAChD,CAAC;QAEJ,IAAI,eAAe,IAAI,iBAAiB;YAAE,SAAS;QAEnD,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CACnC,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CAC5B,cAAc,GAAG,SAAS;YAC1B,SAAS,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI;YAChC,SAAS,CAAC,MAAM,KAAK,IAAI,CAC5B,CAAC;QACF,MAAM,iBAAiB,GACrB,sBAAsB;YACtB,QAAQ,CAAC,IAAI,CACX,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CAC5B,cAAc,GAAG,SAAS;gBAC1B,SAAS,CAAC,QAAQ,KAAK,sBAAsB,CAChD,CAAC;QACJ,MAAM,IAAI,GAAG,eAAe,IAAI,iBAAiB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAC/F,MAAM,UAAU,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAChD,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElC,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,IAAI;gBACJ,OAAO,EAAE,eAAe,IAAI,CAAC,IAAI,kGAAkG;gBACnI,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,IAAI;gBACJ,OAAO,EAAE,eAAe,IAAI,CAAC,IAAI,8CAA8C;gBAC/E,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,cAAc,GAAG,IAAI,EAAE,cAAc,IAAI,EAAE,CAAC;QAClD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC1C,MAAM,gBAAgB,GAAa,EAAE,CAAC;QACtC,MAAM,kBAAkB,GAAa,EAAE,CAAC;QAExC,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;YAC3C,MAAM,eAAe,GAAG,QAAQ;iBAC7B,GAAG,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC9F,MAAM,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC;YAEnD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;gBAC1E,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,SAAS,IAAI,CAAC,QAAQ,4BAA4B,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACzF,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,SAAS,IAAI,CAAC,QAAQ,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,kFAAkF;gBAC1K,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IACE,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,qBAAqB;QAC7C,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAC7B,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,mCAAmC;YACzC,OAAO,EACL,8JAA8J;SACjK,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,4DAA4D,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACnG,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAE7E,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,aAAa,EAAE,aAAa;QAC5B,UAAU;QACV,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/workspace-blob-store.d.ts

@@ -7,6 +7,12 @@ export declare function isValidBlobKey(key: string): boolean;
 export declare function getWorkspaceBlobRootDir(): string;
 export declare function assertValidWorkspaceId(workspaceId: string): string;
 export declare function assertValidBlobKey(key: string): string;
+/**
+ * Absolute path to a workspace's blob directory (`<root>/<workspaceId>`). Validates the id so a
+ * caller can never traverse outside the cache root. Used by `/api/workspace-path` and `/api/reveal`
+ * to show / open where Local Storage physically lives.
+ */
+export declare function getWorkspaceDirPath(rootDir: string, workspaceId: string): string;
 export declare function putWorkspaceBlob(rootDir: string, workspaceId: string, blobKey: string, bodyUtf8: string): Promise<void>;
 export declare function getWorkspaceBlob(rootDir: string, workspaceId: string, blobKey: string): Promise<string | null>;
 export declare function deleteWorkspaceBlob(rootDir: string, workspaceId: string, blobKey: string): Promise<boolean>;

package/dist/workspace-blob-store.js

@@ -43,6 +43,15 @@ export function assertValidBlobKey(key) {
     }
     return key;
 }
+/**
+ * Absolute path to a workspace's blob directory (`<root>/<workspaceId>`). Validates the id so a
+ * caller can never traverse outside the cache root. Used by `/api/workspace-path` and `/api/reveal`
+ * to show / open where Local Storage physically lives.
+ */
+export function getWorkspaceDirPath(rootDir, workspaceId) {
+    const wid = assertValidWorkspaceId(workspaceId);
+    return path.join(rootDir, wid);
+}
 function blobFilePath(rootDir, workspaceId, blobKey) {
     const wid = assertValidWorkspaceId(workspaceId);
     const k = assertValidBlobKey(blobKey);

package/dist/workspace-blob-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-blob-store.js","sourceRoot":"","sources":["../src/workspace-blob-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAEvC,mFAAmF;AACnF,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAEvC,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,OAAO,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,4DAA4D;AAErG,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,WAAmB,EAAE,OAAe;IACzE,MAAM,GAAG,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7F,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,WAAmB,EACnB,OAAe,EACf,QAAgB;IAEhB,IAAI,QAAQ,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IACzD,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,WAAmB,EACnB,OAAe;IAEf,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAA0B,CAAC;QACvC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,WAAmB,EACnB,OAAe;IAEf,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAA0B,CAAC;QACvC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACxC,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"workspace-blob-store.js","sourceRoot":"","sources":["../src/workspace-blob-store.ts"],"names":[],"mappings":"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"}

package/dist/workspace-path-http.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HTTP handlers for the Git Local Storage location surface:
+ *   GET  /api/workspace-path  — where the disk blob cache lives (root + optional per-workspace dir)
+ *   POST /api/reveal          — open that folder in the OS file manager (Finder / Explorer / xdg)
+ *
+ * These never touch blob contents and never require an active plugin WebSocket session. For safety
+ * the reveal target is always derived **server-side** from the validated workspaceId — the client
+ * cannot pass an arbitrary filesystem path, so there is no traversal / open-anything risk.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+/**
+ * The OS-specific "open this folder" command. Pure + exported for unit tests. Args are passed as an
+ * argv array (never through a shell) so the directory string can't be interpreted as a command.
+ */
+export declare function revealCommandFor(platform: NodeJS.Platform, dir: string): {
+    cmd: string;
+    args: string[];
+};
+/** Server-derived reveal target: the per-workspace dir when a valid id is given, else the cache root. */
+export declare function resolveRevealDir(rootDir: string, workspaceId: string | null | undefined): string;
+/**
+ * @returns true if this handler consumed the request.
+ */
+export declare function tryHandleWorkspacePathApi(req: IncomingMessage, res: ServerResponse, reqUrl: string): Promise<boolean>;