@difflab/pi 0.1.0-rc.202609140747.4d45e72.2 → 1.0.0

package/dist/tools/index.js

@@ -1,6 +1,33 @@
-// src/tools/setup.ts
+// src/tools/reload.ts
 import { defineTool } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
+import { z } from "zod";
+var reloadParametersSchema = z.object({});
+var reloadParameters = z.toJSONSchema(reloadParametersSchema, { io: "input" });
+function createDiffpiReloadTool(pi) {
+  return defineTool({
+    name: "diffpi_reload",
+    label: "diffpi reload",
+    description: "Reload pi extensions, skills, prompts, themes, and context files after setup changes.",
+    promptSnippet: "Reload pi after diffpi_setup installs or updates pi resources",
+    promptGuidelines: [
+      "Call diffpi_reload after diffpi_setup reports that pi resources changed.",
+      "Do not call diffpi_reload after a read-only diffpi_validate run."
+    ],
+    parameters: reloadParameters,
+    executionMode: "sequential",
+    execute() {
+      pi.sendUserMessage("/diffpi-reload", { deliverAs: "followUp", expandPromptTemplates: true });
+      return Promise.resolve({
+        content: [{ type: "text", text: "Queued /diffpi-reload as a follow-up command." }],
+        details: {}
+      });
+    }
+  });
+}
+
+// src/tools/setup.ts
+import { defineTool as defineTool2 } from "@earendil-works/pi-coding-agent";
+import { z as z2 } from "zod";
 
 // src/setup.ts
 import { homedir as homedir4 } from "node:os";
@@ -16,8 +43,8 @@ var mcp = {
   },
   async serversEnsure(servers, options = {}) {
     const path = options.path ?? mcp.globalConfigPath();
-    const currentText = await readOptional(path);
-    const current = parseConfig(currentText, path);
+    const currentText = await getOptionalFile(path);
+    const current = getParsedConfig(currentText, path);
     const nextServers = { ...current.mcpServers };
     for (const [name, entry] of Object.entries(servers)) {
       nextServers[name] = mergeEntry(nextServers[name], entry);
@@ -38,7 +65,7 @@ function mergeEntry(current, required) {
     merged.env = { ...current?.env, ...required.env };
   return merged;
 }
-function parseConfig(content, path) {
+function getParsedConfig(content, path) {
   if (!content?.trim())
     return { mcpServers: {} };
   try {
@@ -53,7 +80,7 @@ function parseConfig(content, path) {
     throw new Error(`Expected a valid pi-mcp-adapter configuration in ${path}.`);
   }
 }
-async function readOptional(path) {
+async function getOptionalFile(path) {
   try {
     return await readFile(path, "utf8");
   } catch (error) {
@@ -76,6 +103,7 @@ import { constants } from "node:fs";
 import { access } from "node:fs/promises";
 import { delimiter, join as join2 } from "node:path";
 import { spawn } from "node:child_process";
+var MAX_CAPTURED_OUTPUT_LENGTH = 65536;
 async function findExecutable(name) {
   if (name.includes("/")) {
     try {
@@ -124,10 +152,12 @@ async function runChecked(command, args, options = {}) {
 }
 function appendBounded(current, next) {
   const combined = current + next;
-  return combined.length <= 65536 ? combined : combined.slice(-65536);
+  return combined.length <= MAX_CAPTURED_OUTPUT_LENGTH ? combined : combined.slice(-MAX_CAPTURED_OUTPUT_LENGTH);
 }
 
 // src/mise.ts
+var MISE_HOOK_START = "# >>> @difflab/pi mise >>>";
+var MISE_HOOK_END = "# <<< @difflab/pi mise <<<";
 var mise = {
   async executableCheck(name = "mise") {
     return findExecutable(name);
@@ -148,8 +178,8 @@ var mise = {
   },
   async hookEnsure(executable, options = {}) {
     const homeDir = options.homeDir ?? homedir2();
-    const hook = shellHook(basename(options.shell ?? process.env.SHELL ?? ""), executable, homeDir);
-    const current = await readOptional2(hook.path);
+    const hook = getShellHook(basename(options.shell ?? process.env.SHELL ?? ""), executable, homeDir);
+    const current = await getOptionalFile2(hook.path);
     if (current.includes(MISE_HOOK_START))
       return { path: hook.path, changed: false, planned: false };
     if (options.dryRun)
@@ -161,16 +191,16 @@ var mise = {
     await writeFile2(hook.path, `${current}${separator}${hook.content}`, "utf8");
     return { path: hook.path, changed: true, planned: false };
   },
-  async toolCheckGlobal(executable, tool, minimumMajor = 0) {
+  async toolCheckGlobal(executable, tool, minimumVersion) {
     const result = await run(executable, ["ls", "--global", "--installed", tool, "--json"]);
-    return result.code === 0 && hasInstalledTool(result.stdout, minimumMajor);
+    return result.code === 0 && isToolInstalled(result.stdout, minimumVersion);
   },
   async toolInstallGlobal(executable, specification) {
     await runChecked(executable, ["use", "--global", specification]);
   },
   async toolCheckLocal(executable, tool, cwd = process.cwd()) {
     const result = await run(executable, ["ls", "--local", "--installed", tool, "--json"], { cwd });
-    return result.code === 0 && hasInstalledTool(result.stdout);
+    return result.code === 0 && isToolInstalled(result.stdout);
   },
   async toolInstallLocal(executable, specification, cwd = process.cwd()) {
     await runChecked(executable, ["use", "--path", cwd, specification], { cwd });
@@ -179,40 +209,76 @@ var mise = {
     await runChecked(executable, ["upgrade"], { cwd: homeDir });
   }
 };
-var MISE_HOOK_START = "# >>> @difflab/pi mise >>>";
-var MISE_HOOK_END = "# <<< @difflab/pi mise <<<";
-function shellHook(shell, executable, homeDir) {
-  const command = shellQuote(executable);
-  if (shell === "bash") {
-    return {
-      path: join3(homeDir, ".bashrc"),
-      content: `${MISE_HOOK_START}
-eval "$(${command} activate bash)"
-${MISE_HOOK_END}
-`
-    };
-  }
-  if (shell === "zsh") {
-    return {
-      path: join3(homeDir, ".zshrc"),
-      content: `${MISE_HOOK_START}
+function getShellHook(shell, executable, homeDir) {
+  const command = getShellQuoted(executable);
+  switch (shell.toLowerCase()) {
+    case "zsh":
+      return {
+        path: join3(homeDir, ".zshrc"),
+        content: `${MISE_HOOK_START}
 eval "$(${command} activate zsh)"
 ${MISE_HOOK_END}
 `
-    };
-  }
-  if (shell === "fish") {
-    return {
-      path: join3(homeDir, ".config", "fish", "config.fish"),
-      content: `${MISE_HOOK_START}
+      };
+    case "fish":
+      return {
+        path: join3(homeDir, ".config", "fish", "config.fish"),
+        content: `${MISE_HOOK_START}
 ${command} activate fish | source
 ${MISE_HOOK_END}
 `
-    };
+      };
+    case "nu":
+    case "nushell":
+      return {
+        path: join3(homeDir, ".config", "nushell", "config.nu"),
+        content: `${MISE_HOOK_START}
+let mise_bin = ${command}
+let mise_path = $nu.default-config-dir | path join mise.nu
+^$mise_bin activate nu | save $mise_path --force
+use ($nu.default-config-dir | path join mise.nu)
+${MISE_HOOK_END}
+`
+      };
+    case "xonsh":
+      return {
+        path: join3(homeDir, ".xonshrc"),
+        content: `${MISE_HOOK_START}
+execx($(${command} activate xonsh))
+${MISE_HOOK_END}
+`
+      };
+    case "elvish":
+      return {
+        path: join3(homeDir, ".config", "elvish", "rc.elv"),
+        content: `${MISE_HOOK_START}
+var mise: = (ns [&])
+eval (${command} activate elvish | slurp) &ns=$mise: &on-end={|ns| set mise: = $ns }
+mise:activate
+${MISE_HOOK_END}
+`
+      };
+    case "pwsh":
+    case "powershell":
+      return {
+        path: join3(homeDir, ".config", "powershell", "Microsoft.PowerShell_profile.ps1"),
+        content: `${MISE_HOOK_START}
+(& ${command} activate pwsh) | Out-String | Invoke-Expression
+${MISE_HOOK_END}
+`
+      };
+    case "bash":
+    default:
+      return {
+        path: join3(homeDir, ".bashrc"),
+        content: `${MISE_HOOK_START}
+eval "$(${command} activate bash)"
+${MISE_HOOK_END}
+`
+      };
   }
-  throw new Error(`Unsupported shell "${shell || "unknown"}". Supported shells: bash, zsh, fish.`);
 }
-function hasInstalledTool(output, minimumMajor = 0) {
+function isToolInstalled(output, minimumVersion) {
   try {
     const value = JSON.parse(output);
     if (!Array.isArray(value))
@@ -220,17 +286,28 @@ function hasInstalledTool(output, minimumMajor = 0) {
     return value.some((entry) => {
       if (!entry || typeof entry !== "object" || !("installed" in entry) || entry.installed !== true)
         return false;
-      if (minimumMajor === 0)
+      if (!minimumVersion)
         return true;
       if (!("version" in entry) || typeof entry.version !== "string")
         return false;
-      return Number.parseInt(entry.version, 10) >= minimumMajor;
+      return isVersionAtLeast(entry.version, minimumVersion);
     });
   } catch {
     return false;
   }
 }
-async function readOptional2(path) {
+function isVersionAtLeast(version, minimumVersion) {
+  const current = version.match(/^v?(\d+)\.(\d+)\.(\d+)/)?.slice(1).map(Number);
+  const minimum = minimumVersion.match(/^v?(\d+)\.(\d+)\.(\d+)/)?.slice(1).map(Number);
+  if (!current || !minimum)
+    return false;
+  for (let index = 0;index < minimum.length; index += 1) {
+    if (current[index] !== minimum[index])
+      return current[index] > minimum[index];
+  }
+  return true;
+}
+async function getOptionalFile2(path) {
   try {
     return await readFile2(path, "utf8");
   } catch (error) {
@@ -239,7 +316,7 @@ async function readOptional2(path) {
     throw error;
   }
 }
-function shellQuote(value) {
+function getShellQuoted(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
 
@@ -263,12 +340,12 @@ var pi = {
     await runChecked(executable, ["install", source]);
   },
   agentDir(homeDir = homedir3()) {
-    return resolveAgentDir(homeDir);
+    return getAgentDir(homeDir);
   },
-  async skillCheckGlobal(name, agentDir = resolveAgentDir(), sharedSkillsDir = join4(homedir3(), ".agents", "skills")) {
+  async skillCheckGlobal(name, agentDir = getAgentDir(), sharedSkillsDir = join4(homedir3(), ".agents", "skills")) {
     const roots = [join4(agentDir, "skills"), sharedSkillsDir];
     for (const root of roots) {
-      if (await readOptional3(join4(root, name, "SKILL.md")) !== undefined)
+      if (await getOptionalFile3(join4(root, name, "SKILL.md")) !== undefined)
         return true;
     }
     return false;
@@ -292,8 +369,8 @@ var pi = {
     ]);
   },
   async configEnsure(path, update, dryRun = false) {
-    const currentText = await readOptional3(path);
-    const current = parseObject(currentText, path);
+    const currentText = await getOptionalFile3(path);
+    const current = getParsedObject(currentText, path);
     const next = update(current);
     const changed = JSON.stringify(current) !== JSON.stringify(next);
     if (changed && !dryRun) {
@@ -304,10 +381,10 @@ var pi = {
     return { path, changed, existed: currentText !== undefined, planned: changed && dryRun };
   }
 };
-function resolveAgentDir(homeDir = homedir3()) {
+function getAgentDir(homeDir = homedir3()) {
   return process.env.PI_CODING_AGENT_DIR ?? (process.env.XDG_CONFIG_HOME ? join4(process.env.XDG_CONFIG_HOME, "pi") : join4(homeDir, ".pi", "agent"));
 }
-async function readOptional3(path) {
+async function getOptionalFile3(path) {
   try {
     return await readFile3(path, "utf8");
   } catch (error) {
@@ -316,7 +393,7 @@ async function readOptional3(path) {
     throw error;
   }
 }
-function parseObject(content, path) {
+function getParsedObject(content, path) {
   if (!content?.trim())
     return {};
   try {
@@ -328,44 +405,77 @@ function parseObject(content, path) {
 }
 
 // src/setup.ts
+var MISE_DEPENDENCIES = [
+  { name: "node", tool: "node", spec: "node@22", minimumVersion: "22.19.0" },
+  { name: "zellij", tool: "zellij", spec: "zellij@latest", minimumVersion: undefined },
+  { name: "helix", tool: "helix", spec: "helix@latest", minimumVersion: undefined },
+  {
+    name: "tuicr",
+    tool: "github:agavra/tuicr",
+    spec: "github:agavra/tuicr@latest",
+    minimumVersion: undefined
+  },
+  {
+    name: "context-mode",
+    tool: "npm:context-mode",
+    spec: "npm:context-mode@latest",
+    minimumVersion: undefined
+  }
+];
+var PI_PACKAGES = [
+  "npm:@tintinweb/pi-subagents",
+  "npm:pi-schedule-prompt",
+  "npm:@narumitw/pi-btw",
+  "npm:pi-web-access",
+  "npm:@gitawego/pi-lsp",
+  "npm:context-mode"
+];
+var PI_SKILL_SOURCES = [
+  { repository: "arabold/docs-mcp-server", skills: ["docs-manage", "docs-search", "fetch-url"] },
+  { repository: "AminBlg/SimpleEnglish", skills: ["simple-english"] }
+];
+var MCP_ADAPTER_PACKAGE = "npm:pi-mcp-adapter";
 async function ensureMise(options = {}) {
   const homeDir = options.homeDir ?? homedir4();
   const current = await mise.executableCheck() ?? await mise.executableCheck(join5(homeDir, ".local", "bin", "mise"));
   if (current)
-    return { executable: current, action: action("mise", "ready", current) };
-  progress(options, "Installing mise");
+    return { executable: current, action: createSetupAction("mise", "ready", current) };
+  reportProgress(options, "Installing mise");
   const executable = await mise.install({
     dryRun: options.dryRun,
     homeDir: options.homeDir,
     platform: options.platform
   });
-  return { executable, action: action("mise", options.dryRun ? "planned" : "installed", executable) };
+  return {
+    executable,
+    action: createSetupAction("mise", options.dryRun ? "planned" : "installed", executable)
+  };
 }
 async function ensureMiseHooks(miseExecutable, options = {}) {
   if (options.installMiseHook === false)
-    return action("mise shell hook", "skipped", "disabled");
+    return createSetupAction("mise shell hook", "skipped", "disabled");
   const result = await mise.hookEnsure(miseExecutable, {
     dryRun: options.dryRun,
     homeDir: options.homeDir,
     shell: options.shell
   });
   if (!result.changed)
-    return action("mise shell hook", "ready", result.path);
-  return action("mise shell hook", result.planned ? "planned" : "installed", result.path);
+    return createSetupAction("mise shell hook", "ready", result.path);
+  return createSetupAction("mise shell hook", result.planned ? "planned" : "installed", result.path);
 }
 async function ensureMiseDeps(miseExecutable, options = {}) {
   const canRunMise = Boolean(await mise.executableCheck(miseExecutable));
   const actions = [];
   for (const dependency of MISE_DEPENDENCIES) {
-    const installed = canRunMise && await mise.toolCheckGlobal(miseExecutable, dependency.tool, dependency.minimumMajor);
+    const installed = canRunMise && await mise.toolCheckGlobal(miseExecutable, dependency.tool, dependency.minimumVersion);
     if (installed) {
-      actions.push(action(dependency.name, "ready", dependency.spec));
+      actions.push(createSetupAction(dependency.name, "ready", dependency.spec));
       continue;
     }
-    progress(options, `Installing ${dependency.name} with mise`);
+    reportProgress(options, `Installing ${dependency.name} with mise`);
     if (!options.dryRun)
       await mise.toolInstallGlobal(miseExecutable, dependency.spec);
-    actions.push(action(dependency.name, options.dryRun ? "planned" : "installed", dependency.spec));
+    actions.push(createSetupAction(dependency.name, options.dryRun ? "planned" : "installed", dependency.spec));
   }
   return actions;
 }
@@ -373,12 +483,12 @@ async function ensurePiPlugins(options = {}) {
   const actions = await ensurePiPackages(PI_PACKAGES, options);
   const agentDir = options.agentDir ?? pi.agentDir(options.homeDir);
   const webSearch = await pi.configEnsure(join5(agentDir, "web-search.json"), (config) => ({ ...config, workflow: "auto-summary" }), options.dryRun);
-  actions.push(configAction("web search settings", webSearch));
+  actions.push(getConfigSetupAction("web search settings", webSearch));
   const lsp = await pi.configEnsure(join5(agentDir, "pi-lsp.json"), (config) => ({
     ...config,
-    progressive: { ...record(config.progressive), enabled: true, inject: "none" }
+    progressive: { ...getRecord(config.progressive), enabled: true, inject: "none" }
   }), options.dryRun);
-  actions.push(configAction("pi-lsp settings", lsp));
+  actions.push(getConfigSetupAction("pi-lsp settings", lsp));
   return actions;
 }
 async function ensurePiSkills(miseExecutable, options = {}) {
@@ -389,17 +499,17 @@ async function ensurePiSkills(miseExecutable, options = {}) {
     const missing = [];
     for (const name of source.skills) {
       if (await pi.skillCheckGlobal(name, agentDir, sharedSkillsDir))
-        actions.push(action(`pi skill ${name}`, "ready", source.repository));
+        actions.push(createSetupAction(`pi skill ${name}`, "ready", source.repository));
       else
         missing.push(name);
     }
     if (missing.length === 0)
       continue;
-    progress(options, `Installing skills from ${source.repository}`);
+    reportProgress(options, `Installing skills from ${source.repository}`);
     if (!options.dryRun)
       await pi.skillInstallGlobal(miseExecutable, source.repository, missing);
     for (const name of missing) {
-      actions.push(action(`pi skill ${name}`, options.dryRun ? "planned" : "installed", source.repository));
+      actions.push(createSetupAction(`pi skill ${name}`, options.dryRun ? "planned" : "installed", source.repository));
     }
   }
   return actions;
@@ -431,7 +541,7 @@ async function ensureMcpAdapters(miseExecutable, options = {}) {
     dryRun: options.dryRun,
     path: mcp.globalConfigPath(options.homeDir)
   });
-  actions.push(configAction("MCP configuration", result));
+  actions.push(getConfigSetupAction("MCP configuration", result));
   return actions;
 }
 async function setupPi(options = {}) {
@@ -447,27 +557,6 @@ async function setupPi(options = {}) {
     restartPi: actions.some((item) => (item.status === "installed" || item.status === "updated") && (item.name.startsWith("pi package ") || item.name.startsWith("pi skill ") || item.name === "MCP configuration" || item.name === "web search settings" || item.name === "pi-lsp settings"))
   };
 }
-var MISE_DEPENDENCIES = [
-  { name: "node", tool: "node", spec: "node@22", minimumMajor: 22 },
-  { name: "zellij", tool: "zellij", spec: "zellij@latest", minimumMajor: 0 },
-  { name: "helix", tool: "helix", spec: "helix@latest", minimumMajor: 0 },
-  { name: "tuicr", tool: "github:agavra/tuicr", spec: "github:agavra/tuicr@latest", minimumMajor: 0 },
-  { name: "context-mode", tool: "npm:context-mode", spec: "npm:context-mode@latest", minimumMajor: 0 }
-];
-var PI_PACKAGES = [
-  "npm:@tintinweb/pi-subagents",
-  "npm:pi-schedule-prompt",
-  "npm:@narumitw/pi-btw",
-  "npm:pi-web-access",
-  "npm:@gitawego/pi-lsp",
-  "npm:@juicesharp/rpiv-ask-user-question",
-  "npm:context-mode"
-];
-var PI_SKILL_SOURCES = [
-  { repository: "arabold/docs-mcp-server", skills: ["docs-manage", "docs-search", "fetch-url"] },
-  { repository: "AminBlg/SimpleEnglish", skills: ["simple-english"] }
-];
-var MCP_ADAPTER_PACKAGE = "npm:pi-mcp-adapter";
 async function ensurePiPackages(packages, options) {
   const executable = await pi.executableCheck();
   if (!executable && !options.dryRun)
@@ -476,65 +565,59 @@ async function ensurePiPackages(packages, options) {
   const actions = [];
   for (const source of packages) {
     if (pi.packageCheck(installed, source)) {
-      actions.push(action(`pi package ${source}`, "ready", source));
+      actions.push(createSetupAction(`pi package ${source}`, "ready", source));
       continue;
     }
-    progress(options, `Installing pi package ${source}`);
+    reportProgress(options, `Installing pi package ${source}`);
     if (!options.dryRun) {
       await pi.packageInstall(executable, source);
       installed += `
 ${source}`;
     }
-    actions.push(action(`pi package ${source}`, options.dryRun ? "planned" : "installed", source));
+    actions.push(createSetupAction(`pi package ${source}`, options.dryRun ? "planned" : "installed", source));
   }
   return actions;
 }
-function configAction(name, result) {
+function getConfigSetupAction(name, result) {
   if (!result.changed)
-    return action(name, "ready", result.path);
+    return createSetupAction(name, "ready", result.path);
   if (result.planned)
-    return action(name, "planned", result.path);
-  return action(name, result.existed ? "updated" : "installed", result.path);
+    return createSetupAction(name, "planned", result.path);
+  return createSetupAction(name, result.existed ? "updated" : "installed", result.path);
 }
-function action(name, status, detail) {
+function createSetupAction(name, status, detail) {
   return { name, status, detail };
 }
-function progress(options, message) {
+function reportProgress(options, message) {
   options.onProgress?.(message);
 }
-function record(value) {
+function getRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 
 // src/tools/setup.ts
-var parameters = Type.Object({
-  issueTracker: Type.Optional(Type.String({
-    description: "Issue tracker MCP server to configure. Use none unless the user explicitly selects Linear or Jira.",
-    enum: ["none", "linear", "jira"],
-    default: "none"
-  })),
-  installMiseHook: Type.Optional(Type.Boolean({
-    description: "Add the mise activation hook to the current shell configuration. Set false only when the user declines.",
-    default: true
-  }))
+var setupParametersSchema = z2.object({
+  issueTracker: z2.enum(["none", "linear", "jira"]).default("none").describe("Issue tracker MCP server to configure. Use none unless the user explicitly selects Linear or Jira.")
 });
-var diffpiSetupTool = defineTool({
+var setupParameters = z2.toJSONSchema(setupParametersSchema, { io: "input" });
+var diffpiSetupTool = defineTool2({
   name: "diffpi_setup",
   label: "diffpi setup",
   description: "Install or repair the @difflab/pi environment. This mutates user-level tool installations and configuration files.",
   promptSnippet: "Install or repair @difflab/pi only after the user approves the setup choices",
   promptGuidelines: [
-    "Call this tool only when the user explicitly asks to install, configure, or repair the environment.",
-    "Use ask_user_question for unspecified setup choices before calling this tool.",
-    'Use issueTracker="none" unless the user explicitly selects Linear or Jira.',
-    "Use diffpi_validate instead when the user asks only to inspect or verify setup."
+    "Call diffpi_setup only when the user explicitly asks to install, configure, or repair the environment.",
+    "Use ask_user_question for unspecified setup choices before calling diffpi_setup.",
+    'Call diffpi_setup with issueTracker="none" unless the user explicitly selects Linear or Jira.',
+    "Use diffpi_validate instead of diffpi_setup when the user asks only to inspect or verify setup."
   ],
-  parameters,
+  parameters: setupParameters,
   executionMode: "sequential",
-  async execute(_toolCallId, params, _signal, onUpdate) {
+  async execute(_toolCallId, input, _signal, onUpdate) {
+    const params = setupParametersSchema.parse(input);
     const result = await setupPi({
-      issueTracker: parseIssueTracker(params.issueTracker),
-      installMiseHook: params.installMiseHook ?? true,
+      issueTracker: params.issueTracker,
+      installMiseHook: true,
       onProgress(message) {
         onUpdate?.({ content: [{ type: "text", text: message }], details: {} });
       }
@@ -542,35 +625,29 @@ var diffpiSetupTool = defineTool({
     return formatResult(result, "Setup complete.");
   }
 });
-var diffpiValidateTool = defineTool({
+var diffpiValidateTool = defineTool2({
   name: "diffpi_validate",
   label: "diffpi validate",
   description: "Inspect the @difflab/pi environment without installing software or changing configuration files.",
   promptSnippet: "Validate @difflab/pi safely before setup or when the user asks for an environment check",
   promptGuidelines: [
-    "Prefer this tool before diffpi_setup when the requested action is unclear.",
-    "This tool is read-only. Do not describe planned actions as completed changes.",
-    'Use issueTracker="none" unless the user explicitly asks to validate Linear or Jira configuration.'
+    "Prefer diffpi_validate before diffpi_setup when the requested action is unclear.",
+    "diffpi_validate is read-only; do not describe its planned actions as completed changes.",
+    'Call diffpi_validate with issueTracker="none" unless the user asks to validate Linear or Jira configuration.'
   ],
-  parameters,
+  parameters: setupParameters,
   executionMode: "sequential",
-  async execute(_toolCallId, params) {
+  async execute(_toolCallId, input) {
+    const params = setupParametersSchema.parse(input);
     const result = await setupPi({
-      issueTracker: parseIssueTracker(params.issueTracker),
-      installMiseHook: params.installMiseHook ?? true,
+      issueTracker: params.issueTracker,
+      installMiseHook: true,
       dryRun: true
     });
     const incomplete = result.actions.some((item) => item.status === "planned");
     return formatResult(result, incomplete ? "Setup is incomplete." : "Setup is ready.");
   }
 });
-function parseIssueTracker(value) {
-  if (!value || value === "none")
-    return "none";
-  if (value === "linear" || value === "jira")
-    return value;
-  throw new Error(`Unknown issue tracker: ${value}`);
-}
 function formatResult(result, heading) {
   const changed = result.actions.some((item) => item.status === "installed" || item.status === "updated" || item.status === "planned");
   const lines = result.actions.map((item) => `${item.status.padEnd(9)} ${item.name}: ${item.detail}`);
@@ -586,9 +663,12 @@ ${lines.join(`
 }
 
 // src/tools/index.ts
-var piTools = [diffpiSetupTool, diffpiValidateTool];
+function createPiTools(pi) {
+  return [diffpiSetupTool, diffpiValidateTool, createDiffpiReloadTool(pi)];
+}
 export {
+  createDiffpiReloadTool,
+  createPiTools,
   diffpiSetupTool,
-  diffpiValidateTool,
-  piTools
+  diffpiValidateTool
 };

package/dist/tools/reload.d.ts

@@ -0,0 +1,3 @@
+import { type ExtensionAPI, type ToolDefinition } from '@earendil-works/pi-coding-agent';
+export declare function createDiffpiReloadTool(pi: Pick<ExtensionAPI, 'sendUserMessage'>): ToolDefinition;
+//# sourceMappingURL=reload.d.ts.map

package/dist/tools/reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.d.ts","sourceRoot":"","sources":["../../src/tools/reload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAUrG,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,GAAG,cAAc,CAoBhG"}

package/dist/tools/setup.d.ts

@@ -1,15 +1,4 @@
 import { type ToolDefinition } from '@earendil-works/pi-coding-agent';
-import { Type } from 'typebox';
-import { type SetupResult } from '../setup';
-declare const parameters: Type.TObject<{
-    issueTracker: Type.TOptional<Type.TString>;
-    installMiseHook: Type.TOptional<Type.TBoolean>;
-}>;
-export interface ToolDetails {
-    changed?: boolean;
-    result?: SetupResult;
-}
-export declare const diffpiSetupTool: ToolDefinition<typeof parameters, ToolDetails>;
-export declare const diffpiValidateTool: ToolDefinition<typeof parameters, ToolDetails>;
-export {};
+export declare const diffpiSetupTool: ToolDefinition;
+export declare const diffpiValidateTool: ToolDefinition;
 //# sourceMappingURL=setup.d.ts.map

package/dist/tools/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAErD,QAAA,MAAM,UAAU;;;EAed,CAAC;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,UAAU,EAAE,WAAW,CAyBzE,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,UAAU,EAAE,WAAW,CAqB5E,CAAC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAgBlF,eAAO,MAAM,eAAe,EAAE,cA0B5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,cAsB/B,CAAC"}