@ranimontagna/agent-toolkit 0.1.30 → 0.2.0

package/dist/src/tool-lock.d.ts

@@ -1,4 +1,21 @@
 export type RuntimeCliLockName = "claude" | "codex" | "opencode" | "gemini";
+export declare const agentSkillBundleIds: readonly ["improve", "frontend-skills", "planning-skills", "agent-browser"];
+export type AgentSkillBundleId = (typeof agentSkillBundleIds)[number];
+export type AgentSkillRepository = {
+    source: "github";
+    repository: string;
+    ref: string;
+};
+export type AgentSkillEntry = {
+    repository: string;
+    skill: string;
+    path?: string;
+};
+export type AgentSkillBundle = {
+    label: string;
+    description: string;
+    skills: AgentSkillEntry[];
+};
 export type ToolLock = {
     version: 1;
     tools: {
@@ -25,64 +42,20 @@ export type ToolLock = {
             package: string;
             version: string;
         };
-        improve: {
-            source: "github";
-            repository: string;
-            ref: string;
-            skill: string;
+        agentBrowser: {
+            source: "npm";
+            package: string;
+            version: string;
         };
-        frontendSkills: {
+        agentSkills: {
             source: "skills-cli";
             skillsCli: {
                 source: "npm";
                 package: string;
                 version: string;
             };
-            impeccable: {
-                source: "github";
-                repository: string;
-                ref: string;
-                skill: string;
-            };
-            webDesignGuidelines: {
-                source: "github";
-                repository: string;
-                ref: string;
-                skill: string;
-            };
-            reactDoctor: {
-                source: "github";
-                repository: string;
-                ref: string;
-                skill: string;
-            };
-        };
-        planningSkills: {
-            source: "skills-cli";
-            grillMe: {
-                source: "github";
-                repository: string;
-                ref: string;
-                skill: string;
-            };
-            grilling: {
-                source: "github";
-                repository: string;
-                ref: string;
-                skill: string;
-            };
-            grillWithDocs: {
-                source: "github";
-                repository: string;
-                ref: string;
-                skill: string;
-            };
-            domainModeling: {
-                source: "github";
-                repository: string;
-                ref: string;
-                skill: string;
-            };
+            repositories: Record<string, AgentSkillRepository>;
+            bundles: Record<AgentSkillBundleId, AgentSkillBundle>;
         };
     };
     runtimeClis: Record<RuntimeCliLockName, {

package/dist/src/tool-lock.js

@@ -1,6 +1,12 @@
 import fs from "node:fs";
 import path from "node:path";
 import { REPO_ROOT } from "./context.js";
+export const agentSkillBundleIds = [
+    "improve",
+    "frontend-skills",
+    "planning-skills",
+    "agent-browser",
+];
 const exactVersionPattern = /^[0-9]+(?:\.[0-9]+){1,3}(?:[-+][0-9A-Za-z.-]+)?$/;
 const sha256Pattern = /^[a-f0-9]{64}$/i;
 const fullGitShaPattern = /^[a-f0-9]{40}$/i;
@@ -89,6 +95,72 @@ function assertSha256(value, label) {
         throw new Error(`Invalid tools.lock.json: ${label} must be a SHA-256 hash.`);
     }
 }
+const catalogKeyPattern = /^[A-Za-z][A-Za-z0-9]*$/;
+const skillNamePattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function assertSafeRelativePath(value, label) {
+    assertString(value, label);
+    const normalized = value.replace(/\\/g, "/");
+    if (path.posix.isAbsolute(normalized) ||
+        path.win32.isAbsolute(value) ||
+        normalized.split("/").includes("..")) {
+        throw new Error(`Invalid tools.lock.json: ${label} must be a safe relative path.`);
+    }
+}
+function validateAgentSkillsCatalog(catalog) {
+    if (!catalog ||
+        typeof catalog !== "object" ||
+        !catalog.skillsCli ||
+        typeof catalog.repositories !== "object" ||
+        !catalog.repositories ||
+        typeof catalog.bundles !== "object" ||
+        !catalog.bundles) {
+        throw new Error("Invalid tools.lock.json: tools.agentSkills must define skillsCli, repositories, and bundles.");
+    }
+    if (catalog.source !== "skills-cli" || catalog.skillsCli.source !== "npm") {
+        throw new Error("Invalid tools.lock.json: tools.agentSkills must use skills-cli with an npm CLI source.");
+    }
+    assertString(catalog.skillsCli.package, "tools.agentSkills.skillsCli.package");
+    assertExactVersion(catalog.skillsCli.version, "tools.agentSkills.skillsCli.version");
+    if (Object.keys(catalog.repositories).length === 0) {
+        throw new Error("Invalid tools.lock.json: tools.agentSkills.repositories must not be empty.");
+    }
+    for (const [repositoryId, repository] of Object.entries(catalog.repositories)) {
+        if (!catalogKeyPattern.test(repositoryId)) {
+            throw new Error(`Invalid tools.lock.json: tools.agentSkills.repositories key ${repositoryId} is invalid.`);
+        }
+        if (repository.source !== "github") {
+            throw new Error(`Invalid tools.lock.json: tools.agentSkills.repositories.${repositoryId}.source must be github.`);
+        }
+        assertString(repository.repository, `tools.agentSkills.repositories.${repositoryId}.repository`);
+        assertGitSha(repository.ref, `tools.agentSkills.repositories.${repositoryId}.ref`);
+    }
+    const expectedBundles = new Set(agentSkillBundleIds);
+    for (const bundleId of Object.keys(catalog.bundles)) {
+        if (!expectedBundles.has(bundleId)) {
+            throw new Error(`Invalid tools.lock.json: unsupported Agent Skill bundle ${bundleId}.`);
+        }
+    }
+    for (const bundleId of agentSkillBundleIds) {
+        const bundle = catalog.bundles[bundleId];
+        if (!bundle || bundle.skills.length === 0) {
+            throw new Error(`Invalid tools.lock.json: tools.agentSkills.bundles.${bundleId} must contain skills.`);
+        }
+        assertString(bundle.label, `tools.agentSkills.bundles.${bundleId}.label`);
+        assertString(bundle.description, `tools.agentSkills.bundles.${bundleId}.description`);
+        for (const [index, skill] of bundle.skills.entries()) {
+            const skillLabel = `tools.agentSkills.bundles.${bundleId}.skills.${index}`;
+            if (!catalog.repositories[skill.repository]) {
+                throw new Error(`Invalid tools.lock.json: ${skillLabel}.repository references unknown repository ${skill.repository}.`);
+            }
+            if (!skillNamePattern.test(skill.skill)) {
+                throw new Error(`Invalid tools.lock.json: ${skillLabel}.skill is invalid.`);
+            }
+            if (skill.path !== undefined) {
+                assertSafeRelativePath(skill.path, `${skillLabel}.path`);
+            }
+        }
+    }
+}
 function validateToolLock(lock) {
     if (lock.version !== 1) {
         throw new Error("Invalid tools.lock.json: version must be 1.");
@@ -107,38 +179,9 @@ function validateToolLock(lock) {
     assertExactVersion(lock.tools.graphify.version, "tools.graphify.version");
     assertString(lock.tools.gsd.package, "tools.gsd.package");
     assertExactVersion(lock.tools.gsd.version, "tools.gsd.version");
-    assertString(lock.tools.improve.repository, "tools.improve.repository");
-    assertGitSha(lock.tools.improve.ref, "tools.improve.ref");
-    assertString(lock.tools.improve.skill, "tools.improve.skill");
-    assertString(lock.tools.frontendSkills.skillsCli.package, "tools.frontendSkills.skillsCli.package");
-    assertExactVersion(lock.tools.frontendSkills.skillsCli.version, "tools.frontendSkills.skillsCli.version");
-    for (const skillName of [
-        "impeccable",
-        "webDesignGuidelines",
-        "reactDoctor",
-    ]) {
-        const skill = lock.tools.frontendSkills[skillName];
-        if (!skill) {
-            throw new Error(`Invalid tools.lock.json: tools.frontendSkills.${skillName} must be defined.`);
-        }
-        assertString(skill.repository, `tools.frontendSkills.${skillName}.repository`);
-        assertGitSha(skill.ref, `tools.frontendSkills.${skillName}.ref`);
-        assertString(skill.skill, `tools.frontendSkills.${skillName}.skill`);
-    }
-    for (const skillName of [
-        "grillMe",
-        "grilling",
-        "grillWithDocs",
-        "domainModeling",
-    ]) {
-        const skill = lock.tools.planningSkills[skillName];
-        if (!skill) {
-            throw new Error(`Invalid tools.lock.json: tools.planningSkills.${skillName} must be defined.`);
-        }
-        assertString(skill.repository, `tools.planningSkills.${skillName}.repository`);
-        assertGitSha(skill.ref, `tools.planningSkills.${skillName}.ref`);
-        assertString(skill.skill, `tools.planningSkills.${skillName}.skill`);
-    }
+    validateAgentSkillsCatalog(lock.tools.agentSkills);
+    assertString(lock.tools.agentBrowser.package, "tools.agentBrowser.package");
+    assertExactVersion(lock.tools.agentBrowser.version, "tools.agentBrowser.version");
     for (const runtime of ["claude", "codex", "opencode", "gemini"]) {
         assertString(lock.runtimeClis[runtime].package, `runtimeClis.${runtime}.package`);
         assertExactVersion(lock.runtimeClis[runtime].version, `runtimeClis.${runtime}.version`);

package/dist/src/tool-lock.js.map

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

package/dist/src/usage.js

@@ -13,6 +13,7 @@ Tools:
   --graphify-only       Install only Graphify
   --gsd-only            Install only GSD
   --improve-only        Install only shadcn Improve
+  --agent-browser-only  Install only Agent Browser
   --frontend-skills-only Install only third-party frontend skills
   --planning-skills-only Install only third-party planning skills
   --skills-only         Install only Custom Skills
@@ -22,6 +23,7 @@ Tools:
   --no-graphify         Skip Graphify
   --no-gsd              Skip GSD
   --no-improve          Skip shadcn Improve
+  --no-agent-browser    Skip Agent Browser
   --no-frontend-skills  Skip third-party frontend skills
   --no-planning-skills  Skip third-party planning skills
   --no-skills           Skip Custom Skills
@@ -71,6 +73,7 @@ Environment:
   GRAPHIFY_PACKAGE      Python package used to install Graphify
   GRAPHIFY_INSTALLER    uv or pipx
   GSD_PACKAGE           GSD package source
+  AGENT_BROWSER_PACKAGE Agent Browser package source
   SKILLS_CLI_PACKAGE    npm package used for third-party skill installs
   GSD_SCOPE             global or local
   TOOLS_LOCK_PATH       External tool provenance lock path (requires --allow-mutable-sources)

package/dist/src/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK;IACnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAuFsD,CAAC;AAChE,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK;IACnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DA0FsD,CAAC;AAChE,CAAC"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@ranimontagna/agent-toolkit",
-  "version": "0.1.30",
+  "version": "0.2.0",
   "description": "Personal AI agent toolkit installer for Claude Code, Codex CLI, OpenCode, Gemini CLI, Antigravity and graph-aware workflows.",
   "type": "module",
   "engines": {
-    "node": ">=18"
+    "node": ">=24"
   },
   "packageManager": "pnpm@11.8.0",
   "bin": {
@@ -26,8 +26,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "check": "pnpm run lint && pnpm run typecheck && pnpm run test:unit && pnpm run build && find dist/bin dist/src -name '*.js' -print0 | xargs -0 -n1 node --check && bash -n setup-agent-toolkit.sh && pnpm run test:integration",
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.json",
+    "check": "pnpm run lint && pnpm run typecheck && pnpm run test:unit && pnpm run build && find dist/bin dist/src -name '*.js' -print0 | xargs -0 -n1 node --check && bash -n setup-agent-toolkit.sh && bash -n scripts/publish-npm-with-retry.sh && bash -n tests/publish-npm-with-retry.test.sh && pnpm run test:integration",
     "format": "biome format --write .",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
@@ -38,7 +38,7 @@
     "security": "pnpm run security:audit",
     "security:audit": "pnpm audit --audit-level=moderate",
     "test": "pnpm run test:unit && pnpm run test:integration",
-    "test:integration": "pnpm run build && bash tests/test-agent-toolkit.sh",
+    "test:integration": "pnpm run build && bash tests/test-agent-toolkit.sh && bash tests/publish-npm-with-retry.test.sh",
     "test:unit": "vitest run",
     "typecheck": "tsc -p tsconfig.test.json --noEmit"
   },

package/setup-agent-toolkit.sh

@@ -4,11 +4,17 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 if ! command -v node >/dev/null 2>&1; then
-  echo "Node.js 22+ is required to run Agent Toolkit." >&2
+  echo "Node.js 24+ is required to run Agent Toolkit." >&2
   echo "Install Node.js, then run this command again." >&2
   exit 1
 fi
 
+NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]')"
+if [[ ! "$NODE_MAJOR" =~ ^[0-9]+$ ]] || (( NODE_MAJOR < 24 )); then
+  echo "Node.js 24+ is required to run Agent Toolkit. Current: $(node --version)" >&2
+  exit 1
+fi
+
 CLI_ENTRYPOINT="$SCRIPT_DIR/dist/bin/agent-toolkit.js"
 
 if [[ ! -f "$CLI_ENTRYPOINT" ]]; then

package/tools.lock.json

@@ -38,63 +38,118 @@
       "package": "@opengsd/gsd-core",
       "version": "1.6.1"
     },
-    "improve": {
-      "source": "github",
-      "repository": "shadcn/improve",
-      "ref": "03369ee6d7cafbfcecc4346539b05b3dc0a603bb",
-      "skill": "improve"
+    "agentBrowser": {
+      "source": "npm",
+      "package": "agent-browser",
+      "version": "0.31.1"
     },
-    "frontendSkills": {
+    "agentSkills": {
       "source": "skills-cli",
       "skillsCli": {
         "source": "npm",
         "package": "skills",
         "version": "1.5.13"
       },
-      "impeccable": {
-        "source": "github",
-        "repository": "pbakaus/impeccable",
-        "ref": "3590bf9e37c84ecbc92f9c205ce1aebf2185a971",
-        "skill": "impeccable"
-      },
-      "webDesignGuidelines": {
-        "source": "github",
-        "repository": "vercel-labs/agent-skills",
-        "ref": "f8a72b9603728bb92a217a879b7e62e43ad76c81",
-        "skill": "web-design-guidelines"
-      },
-      "reactDoctor": {
-        "source": "github",
-        "repository": "millionco/react-doctor",
-        "ref": "aa519e5f5505105ef8c00e1b1972c98514f7577a",
-        "skill": "react-doctor"
-      }
-    },
-    "planningSkills": {
-      "source": "skills-cli",
-      "grillMe": {
-        "source": "github",
-        "repository": "mattpocock/skills",
-        "ref": "391a2701dd948f94f56a39f7533f8eea9a859c87",
-        "skill": "grill-me"
-      },
-      "grilling": {
-        "source": "github",
-        "repository": "mattpocock/skills",
-        "ref": "391a2701dd948f94f56a39f7533f8eea9a859c87",
-        "skill": "grilling"
-      },
-      "grillWithDocs": {
-        "source": "github",
-        "repository": "mattpocock/skills",
-        "ref": "391a2701dd948f94f56a39f7533f8eea9a859c87",
-        "skill": "grill-with-docs"
+      "repositories": {
+        "shadcnImprove": {
+          "source": "github",
+          "repository": "shadcn/improve",
+          "ref": "03369ee6d7cafbfcecc4346539b05b3dc0a603bb"
+        },
+        "agentBrowser": {
+          "source": "github",
+          "repository": "vercel-labs/agent-browser",
+          "ref": "afae698a51242166170b6fe4809dd57fe9f75798"
+        },
+        "impeccable": {
+          "source": "github",
+          "repository": "pbakaus/impeccable",
+          "ref": "3590bf9e37c84ecbc92f9c205ce1aebf2185a971"
+        },
+        "webDesignGuidelines": {
+          "source": "github",
+          "repository": "vercel-labs/agent-skills",
+          "ref": "f8a72b9603728bb92a217a879b7e62e43ad76c81"
+        },
+        "reactDoctor": {
+          "source": "github",
+          "repository": "millionco/react-doctor",
+          "ref": "aa519e5f5505105ef8c00e1b1972c98514f7577a"
+        },
+        "remotionBestPractices": {
+          "source": "github",
+          "repository": "remotion-dev/skills",
+          "ref": "8b1d51ade295b2d9bd22a8f07047d13c0740f275"
+        },
+        "mattPocockSkills": {
+          "source": "github",
+          "repository": "mattpocock/skills",
+          "ref": "391a2701dd948f94f56a39f7533f8eea9a859c87"
+        }
       },
-      "domainModeling": {
-        "source": "github",
-        "repository": "mattpocock/skills",
-        "ref": "391a2701dd948f94f56a39f7533f8eea9a859c87",
-        "skill": "domain-modeling"
+      "bundles": {
+        "improve": {
+          "label": "Improve",
+          "description": "shadcn advisor skill for auditing codebases and writing execution plans",
+          "skills": [
+            {
+              "repository": "shadcnImprove",
+              "skill": "improve",
+              "path": "skills/improve"
+            }
+          ]
+        },
+        "frontend-skills": {
+          "label": "Frontend Skills",
+          "description": "Third-party frontend skills installed via Agent Skills CLI",
+          "skills": [
+            { "repository": "impeccable", "skill": "impeccable" },
+            {
+              "repository": "webDesignGuidelines",
+              "skill": "web-design-guidelines"
+            },
+            { "repository": "reactDoctor", "skill": "react-doctor" },
+            {
+              "repository": "remotionBestPractices",
+              "skill": "remotion-best-practices"
+            }
+          ]
+        },
+        "planning-skills": {
+          "label": "Planning Skills",
+          "description": "Third-party planning and architecture skills installed via Agent Skills CLI",
+          "skills": [
+            { "repository": "mattPocockSkills", "skill": "grill-me" },
+            { "repository": "mattPocockSkills", "skill": "grilling" },
+            {
+              "repository": "mattPocockSkills",
+              "skill": "grill-with-docs"
+            },
+            {
+              "repository": "mattPocockSkills",
+              "skill": "domain-modeling"
+            },
+            {
+              "repository": "mattPocockSkills",
+              "skill": "codebase-design"
+            },
+            {
+              "repository": "mattPocockSkills",
+              "skill": "improve-codebase-architecture"
+            }
+          ]
+        },
+        "agent-browser": {
+          "label": "Agent Browser",
+          "description": "Pinned browser automation skill installed via Agent Skills CLI",
+          "skills": [
+            {
+              "repository": "agentBrowser",
+              "skill": "agent-browser",
+              "path": "skills/agent-browser"
+            }
+          ]
+        }
       }
     }
   },

package/dist/src/installers/frontend-skills.d.ts

@@ -1,8 +0,0 @@
-export type SkillsCliSource = {
-    label: string;
-    repository: string;
-    ref: string;
-    skill: string;
-};
-export declare function installSkillsCliSources(stepLabel: string, description: string, sources: SkillsCliSource[]): boolean;
-export declare function installFrontendSkills(): boolean;

package/dist/src/installers/frontend-skills.js

@@ -1,93 +0,0 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { err, info, ok, step } from "../logger.js";
-import { selectedSkillsAgentArgs } from "../runtimes.js";
-import { state } from "../state.js";
-import { capture, requireCommand, requireNode, run } from "../system.js";
-function cloneLockedSource(source, parentDir) {
-    const repoUrl = `https://github.com/${source.repository}.git`;
-    const sourceDir = path.join(parentDir, source.skill);
-    info(`Cloning ${source.label} at ${source.ref}...`);
-    if (!run("git", [
-        "clone",
-        "--filter=blob:none",
-        "--no-checkout",
-        repoUrl,
-        sourceDir,
-    ]).ok) {
-        throw new Error(`Failed to clone ${source.repository}.`);
-    }
-    if (!run("git", [
-        "-C",
-        sourceDir,
-        "fetch",
-        "--depth",
-        "1",
-        "origin",
-        source.ref,
-    ]).ok) {
-        throw new Error(`Failed to fetch ${source.repository}@${source.ref}.`);
-    }
-    if (!run("git", ["-C", sourceDir, "checkout", "--detach", "FETCH_HEAD"]).ok) {
-        throw new Error(`Failed to checkout ${source.repository}@${source.ref}.`);
-    }
-    // FETCH_HEAD is whatever the remote decided to serve; confirm it is the
-    // pinned commit before trusting the checked-out content.
-    const head = capture("git", ["-C", sourceDir, "rev-parse", "HEAD"])
-        .stdout.trim()
-        .toLowerCase();
-    if (head !== source.ref.toLowerCase()) {
-        throw new Error(`Fetched commit for ${source.repository} does not match pinned ref: expected ${source.ref}, got ${head || "unknown"}.`);
-    }
-    return sourceDir;
-}
-function installSource(source, sourceDir) {
-    const args = [
-        "-y",
-        state.frontendSkillsCliPackage,
-        "add",
-        sourceDir,
-        "--skill",
-        source.skill,
-        ...selectedSkillsAgentArgs(),
-        ...(state.gsdScope === "global" ? ["--global"] : []),
-        "-y",
-        "--copy",
-    ];
-    info(`Installing ${source.label} through Agent Skills CLI...`);
-    const result = run("npx", args);
-    if (result.ok) {
-        ok(`${source.label} skill installed`);
-        return true;
-    }
-    err(`${source.label} skill install failed`);
-    return false;
-}
-export function installSkillsCliSources(stepLabel, description, sources) {
-    step(stepLabel);
-    console.log(`   ${description}`);
-    requireNode(18);
-    requireCommand("git");
-    requireCommand("npx");
-    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "agent-toolkit-skills-"));
-    try {
-        for (const source of sources) {
-            const sourceDir = cloneLockedSource(source, tempDir);
-            if (!installSource(source, sourceDir))
-                return false;
-        }
-    }
-    catch (error) {
-        err(error instanceof Error ? error.message : String(error));
-        return false;
-    }
-    finally {
-        fs.rmSync(tempDir, { recursive: true, force: true });
-    }
-    return true;
-}
-export function installFrontendSkills() {
-    return installSkillsCliSources("Frontend Skills", "Third-party frontend skills installed via Agent Skills CLI", state.frontendSkillSources);
-}
-//# sourceMappingURL=frontend-skills.js.map

package/dist/src/installers/frontend-skills.js.map

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

package/dist/src/installers/improve.d.ts

@@ -1 +0,0 @@
-export declare function installImprove(): boolean;