localwp-mcp 0.1.0

package/dist/permissions.js

@@ -0,0 +1,129 @@
+import { config } from "./config.js";
+const restrictedWpFlags = new Set(["--path", "--ssh", "--http"]);
+const wpCliAlwaysBlockedPrefixes = [
+    ["db", "query"],
+    ["eval"],
+    ["eval-file"],
+    ["package", "install"],
+    ["package", "uninstall"],
+    ["package", "update"],
+    ["shell"],
+];
+const wpCliSafePrefixes = [
+    ["cap", "list"],
+    ["cli", "check-update"],
+    ["cli", "cmd-dump"],
+    ["cli", "info"],
+    ["cli", "param-dump"],
+    ["cli", "version"],
+    ["comment", "get"],
+    ["comment", "list"],
+    ["config", "get"],
+    ["config", "has"],
+    ["config", "list"],
+    ["core", "check-update"],
+    ["core", "is-installed"],
+    ["core", "verify-checksums"],
+    ["core", "version"],
+    ["cron", "event", "list"],
+    ["cron", "test"],
+    ["db", "check"],
+    ["db", "columns"],
+    ["db", "prefix"],
+    ["db", "search"],
+    ["db", "size"],
+    ["db", "tables"],
+    ["embed", "fetch"],
+    ["language", "core", "list"],
+    ["language", "plugin", "list"],
+    ["language", "theme", "list"],
+    ["media", "get"],
+    ["media", "image-size"],
+    ["menu", "item", "list"],
+    ["menu", "list"],
+    ["network", "meta", "get"],
+    ["network", "meta", "list"],
+    ["option", "get"],
+    ["option", "list"],
+    ["package", "browse"],
+    ["package", "list"],
+    ["plugin", "get"],
+    ["plugin", "is-active"],
+    ["plugin", "is-installed"],
+    ["plugin", "list"],
+    ["plugin", "path"],
+    ["plugin", "status"],
+    ["plugin", "verify-checksums"],
+    ["post", "get"],
+    ["post", "list"],
+    ["post", "url"],
+    ["profile", "hook"],
+    ["profile", "stage"],
+    ["rewrite", "list"],
+    ["role", "exists"],
+    ["role", "get"],
+    ["role", "list"],
+    ["site", "archive", "list"],
+    ["site", "empty", "list"],
+    ["site", "list"],
+    ["site", "meta", "get"],
+    ["site", "meta", "list"],
+    ["super-admin", "list"],
+    ["taxonomy", "get"],
+    ["taxonomy", "list"],
+    ["term", "get"],
+    ["term", "list"],
+    ["theme", "get"],
+    ["theme", "is-active"],
+    ["theme", "is-installed"],
+    ["theme", "list"],
+    ["theme", "path"],
+    ["theme", "status"],
+    ["transient", "get"],
+    ["transient", "type"],
+    ["user", "application-password", "list"],
+    ["user", "cap", "list"],
+    ["user", "get"],
+    ["user", "list"],
+    ["user", "meta", "get"],
+    ["user", "meta", "list"],
+    ["user", "session", "list"],
+    ["widget", "list"],
+    ["widget", "type", "list"],
+];
+export function assertAllowedWpFlags(args) {
+    for (const arg of args) {
+        const flag = arg.split("=")[0];
+        if (restrictedWpFlags.has(flag)) {
+            throw new Error(`The '${flag}' flag is not allowed here because the MCP selects the Local site for you.`);
+        }
+    }
+}
+export function assertWpCliPermissions(args) {
+    return assertWpCliPermissionsForProfile(config.profile, args);
+}
+export function assertWpCliPermissionsForProfile(profile, args) {
+    if (matchesAnyPrefix(args, wpCliAlwaysBlockedPrefixes)) {
+        throw new Error("This WP-CLI command is blocked in this MCP because it behaves like arbitrary code execution or unrestricted SQL.");
+    }
+    if (profile === "full-access") {
+        return;
+    }
+    if (startsWithCommand(args, ["search-replace"]) &&
+        args.includes("--dry-run")) {
+        return;
+    }
+    if (!matchesAnyPrefix(args, wpCliSafePrefixes)) {
+        throw new Error("This WP-CLI command is not allowed in the 'safe' profile. Switch to LOCALWP_MCP_PROFILE=full-access for broad WP-CLI access.");
+    }
+}
+function matchesAnyPrefix(args, prefixes) {
+    return prefixes.some((prefix) => startsWithCommand(args, prefix));
+}
+function startsWithCommand(args, prefix) {
+    if (prefix.length > args.length) {
+        return false;
+    }
+    return prefix.every((token, index) => args[index] === token);
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

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

package/dist/platform-paths.d.ts

@@ -0,0 +1,10 @@
+export declare function dedupePaths(paths: string[]): string[];
+export declare function getDefaultLocalAppSupportDir(platform: NodeJS.Platform, homeDir: string, env: NodeJS.ProcessEnv): string;
+export declare function getDefaultLocalExtraResourcesDirs(platform: NodeJS.Platform, homeDir: string, env: NodeJS.ProcessEnv): string[];
+export declare function getDefaultLocalLightningServiceDirs(localAppSupportDir: string, extraResourcesDirs: string[]): string[];
+export declare function getLegacySiteBinariesDirs(platform: NodeJS.Platform, extraResourcesDirs: string[]): string[];
+export declare function getWpCliPharCandidates(platform: NodeJS.Platform, extraResourcesDirs: string[]): string[];
+export declare function getWpCliConfigCandidates(extraResourcesDirs: string[]): string[];
+export declare function getHelperBinDirCandidates(platform: NodeJS.Platform, extraResourcesDirs: string[]): string[];
+export declare function getPlatformBinDirCandidates(platform: NodeJS.Platform, arch: string): string[];
+export declare function getExecutableCandidates(binaryName: string, platform: NodeJS.Platform): string[];

package/dist/platform-paths.js

@@ -0,0 +1,95 @@
+import path from "path";
+export function dedupePaths(paths) {
+    return [...new Set(paths.filter(Boolean))];
+}
+function getPathApi(platform) {
+    return platform === "win32" ? path.win32 : path.posix;
+}
+export function getDefaultLocalAppSupportDir(platform, homeDir, env) {
+    const pathApi = getPathApi(platform);
+    if (platform === "win32") {
+        return pathApi.join(env.APPDATA || pathApi.join(homeDir, "AppData", "Roaming"), "Local");
+    }
+    if (platform === "linux") {
+        return pathApi.join(env.XDG_CONFIG_HOME || pathApi.join(homeDir, ".config"), "Local");
+    }
+    return pathApi.join(homeDir, "Library", "Application Support", "Local");
+}
+export function getDefaultLocalExtraResourcesDirs(platform, homeDir, env) {
+    const pathApi = getPathApi(platform);
+    if (platform === "win32") {
+        return dedupePaths([
+            pathApi.join(env.LOCALAPPDATA || pathApi.join(homeDir, "AppData", "Local"), "Programs", "Local", "resources", "extraResources"),
+            pathApi.join(env["ProgramFiles(x86)"] || "C:\\Program Files (x86)", "Local", "resources", "extraResources"),
+            pathApi.join(env.ProgramFiles || "C:\\Program Files", "Local", "resources", "extraResources"),
+        ]);
+    }
+    if (platform === "linux") {
+        return ["/opt/Local/resources/extraResources"];
+    }
+    return ["/Applications/Local.app/Contents/Resources/extraResources"];
+}
+export function getDefaultLocalLightningServiceDirs(localAppSupportDir, extraResourcesDirs) {
+    return dedupePaths([
+        path.join(localAppSupportDir, "lightning-services"),
+        ...extraResourcesDirs.map((directory) => {
+            const pathApi = directory.includes("\\") ? path.win32 : path.posix;
+            return pathApi.join(directory, "lightning-services");
+        }),
+    ]);
+}
+function joinPlatformPath(basePath, ...parts) {
+    const pathApi = basePath.includes("\\") ? path.win32 : path.posix;
+    return pathApi.join(basePath, ...parts);
+}
+export function getLegacySiteBinariesDirs(platform, extraResourcesDirs) {
+    const directoryName = platform === "win32"
+        ? "site-binaries-win32"
+        : platform === "linux"
+            ? "site-binaries-linux"
+            : "site-binaries";
+    return dedupePaths(extraResourcesDirs.map((directory) => joinPlatformPath(directory, directoryName)));
+}
+export function getWpCliPharCandidates(platform, extraResourcesDirs) {
+    const legacySiteBinariesDirs = getLegacySiteBinariesDirs(platform, extraResourcesDirs);
+    return dedupePaths([
+        ...extraResourcesDirs.map((directory) => joinPlatformPath(directory, "bin", "wp-cli", "wp-cli.phar")),
+        ...legacySiteBinariesDirs.map((directory) => platform === "darwin"
+            ? joinPlatformPath(directory, "wp-cli", "wp-cli.phar")
+            : joinPlatformPath(directory, "wp-cli.phar")),
+    ]);
+}
+export function getWpCliConfigCandidates(extraResourcesDirs) {
+    return dedupePaths(extraResourcesDirs.map((directory) => joinPlatformPath(directory, "bin", "wp-cli", "config.yaml")));
+}
+export function getHelperBinDirCandidates(platform, extraResourcesDirs) {
+    const platformSpecificHelperDirs = platform === "win32"
+        ? [
+            ["bin", "composer", "win32"],
+            ["bin", "wp-cli", "win32"],
+        ]
+        : [
+            ["bin", "composer", "posix"],
+            ["bin", "wp-cli", "posix"],
+        ];
+    return dedupePaths(extraResourcesDirs.flatMap((directory) => [
+        joinPlatformPath(directory, "bin"),
+        ...platformSpecificHelperDirs.map((parts) => joinPlatformPath(directory, ...parts)),
+    ]));
+}
+export function getPlatformBinDirCandidates(platform, arch) {
+    if (platform === "win32") {
+        return arch === "x64" ? ["win64", "win32"] : ["win32", "win64"];
+    }
+    if (platform === "linux") {
+        return arch === "arm64" ? ["linux-arm64", "linux"] : ["linux", "linux-arm64"];
+    }
+    return arch === "arm64" ? ["darwin-arm64", "darwin"] : ["darwin", "darwin-arm64"];
+}
+export function getExecutableCandidates(binaryName, platform) {
+    if (platform === "win32") {
+        return [`${binaryName}.exe`, binaryName];
+    }
+    return [binaryName];
+}
+//# sourceMappingURL=platform-paths.js.map

package/dist/platform-paths.js.map

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

package/dist/process-utils.d.ts

@@ -0,0 +1,13 @@
+import type { SpawnResult } from "./types.js";
+export declare function assertReadable(filePath: string, message: string): Promise<void>;
+export declare function ensureReadableDirectory(directoryPath: string, message: string): Promise<void>;
+export declare function ensureExecutable(filePath: string, message: string): Promise<void>;
+export declare function isReadablePath(filePath: string): Promise<boolean>;
+export declare function isExecutablePath(filePath: string): Promise<boolean>;
+export declare function filterReadableDirectories(paths: string[]): Promise<string[]>;
+export declare function findFirstReadablePath(paths: string[]): Promise<string | null>;
+export declare function spawnCommand(command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    stdinFilePath?: string;
+}): Promise<SpawnResult>;

package/dist/process-utils.js

@@ -0,0 +1,128 @@
+import { spawn } from "child_process";
+import { constants as fsConstants, createReadStream } from "fs";
+import { access } from "fs/promises";
+import { config } from "./config.js";
+export async function assertReadable(filePath, message) {
+    if (!(await isReadablePath(filePath))) {
+        throw new Error(`${message}: ${filePath}`);
+    }
+}
+export async function ensureReadableDirectory(directoryPath, message) {
+    if (!(await isReadablePath(directoryPath))) {
+        throw new Error(`${message}: ${directoryPath}`);
+    }
+}
+export async function ensureExecutable(filePath, message) {
+    if (!(await isExecutablePath(filePath))) {
+        throw new Error(`${message}: ${filePath}`);
+    }
+}
+export async function isReadablePath(filePath) {
+    try {
+        await access(filePath, fsConstants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function isExecutablePath(filePath) {
+    try {
+        await access(filePath, process.platform === "win32" ? fsConstants.R_OK : fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function filterReadableDirectories(paths) {
+    const readableDirectories = [];
+    for (const candidate of paths) {
+        if (await isReadablePath(candidate)) {
+            readableDirectories.push(candidate);
+        }
+    }
+    return readableDirectories;
+}
+export async function findFirstReadablePath(paths) {
+    for (const candidate of paths) {
+        if (await isReadablePath(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+export function spawnCommand(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            ...options,
+            shell: false,
+            stdio: [options.stdinFilePath ? "pipe" : "ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        let settled = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        }, config.defaultTimeoutMs);
+        const stdoutStream = child.stdout;
+        const stderrStream = child.stderr;
+        const stdinStream = child.stdin;
+        if (!stdoutStream || !stderrStream) {
+            settled = true;
+            clearTimeout(timer);
+            reject(new Error(`Failed to capture stdio for '${command}'.`));
+            return;
+        }
+        stdoutStream.setEncoding("utf8");
+        stderrStream.setEncoding("utf8");
+        stdoutStream.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        stderrStream.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        if (options.stdinFilePath) {
+            const inputStream = createReadStream(options.stdinFilePath);
+            inputStream.on("error", (error) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                clearTimeout(timer);
+                reject(error);
+            });
+            if (!stdinStream) {
+                settled = true;
+                clearTimeout(timer);
+                reject(new Error(`Failed to open stdin for '${command}'.`));
+                return;
+            }
+            inputStream.pipe(stdinStream);
+        }
+        child.on("error", (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on("close", (exitCode) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            resolve({
+                stdout: stdout.trimEnd(),
+                stderr: stderr.trimEnd(),
+                exitCode: exitCode ?? 0,
+                timedOut,
+            });
+        });
+    });
+}
+//# sourceMappingURL=process-utils.js.map

package/dist/process-utils.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export function registerPrompts(server) {
+    server.registerPrompt("diagnose_local_site", {
+        title: "Diagnose Local Site",
+        description: "Guides an AI agent through diagnosing a LocalWP site using the MCP's doctor, logs, and inspection tools.",
+        argsSchema: {
+            siteName: z
+                .string()
+                .optional()
+                .describe("Optional Local site name, for example 'woo'."),
+        },
+    }, async ({ siteName }) => {
+        const target = siteName
+            ? `the Local site '${siteName}'`
+            : "the relevant Local site";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            `Diagnose ${target} using localwp-mcp.`,
+                            "Start with local_doctor and local_environment_check.",
+                            "Then inspect local_logs and, if needed, use execute_wp_cli, mysql_query, and mysql_schema to narrow down the issue.",
+                            "Summarize the root cause, supporting evidence, and the safest next actions.",
+                        ].join(" "),
+                    },
+                },
+            ],
+        };
+    });
+    server.registerPrompt("restore_local_site", {
+        title: "Restore Local Site",
+        description: "Guides an AI agent through restoring a LocalWP site from a SQL dump or a backup_site directory.",
+        argsSchema: {
+            siteName: z
+                .string()
+                .describe("Local site name to restore, for example 'woo'."),
+            sourcePath: z
+                .string()
+                .describe("Path to the .sql file or backup_site directory to restore."),
+        },
+    }, async ({ siteName, sourcePath }) => {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            `Restore the Local site '${siteName}' from '${sourcePath}'.`,
+                            "Use local_doctor first to confirm the site is healthy enough for restore work.",
+                            "Then use restore_backup with a pre-restore backup enabled.",
+                            "After the restore, verify the site with local_doctor, local_logs, execute_wp_cli, and a simple mysql_query.",
+                            "Report exactly what was restored, whether a restart is recommended, and any follow-up checks.",
+                        ].join(" "),
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,0GAA0G;QAC5G,UAAU,EAAE;YACV,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,8CAA8C,CAAC;SAC5D;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,QAAQ;YACrB,CAAC,CAAC,mBAAmB,QAAQ,GAAG;YAChC,CAAC,CAAC,yBAAyB,CAAC;QAE9B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,YAAY,MAAM,qBAAqB;4BACvC,sDAAsD;4BACtD,qHAAqH;4BACrH,6EAA6E;yBAC9E,CAAC,IAAI,CAAC,GAAG,CAAC;qBACZ;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,iGAAiG;QACnG,UAAU,EAAE;YACV,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CAAC,gDAAgD,CAAC;YAC7D,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,4DAA4D,CAAC;SAC1E;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QACjC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,2BAA2B,QAAQ,WAAW,UAAU,IAAI;4BAC5D,gFAAgF;4BAChF,4DAA4D;4BAC5D,6GAA6G;4BAC7G,+FAA+F;yBAChG,CAAC,IAAI,CAAC,GAAG,CAAC;qBACZ;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResources(server: McpServer): void;

package/dist/resources.js

@@ -0,0 +1,110 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { runEnvironmentCheck } from "./environment-check.js";
+import { loadLocalSites, summarizeSite } from "./local-sites.js";
+import { runLocalDoctor } from "./local-doctor.js";
+import { collectLocalLogs } from "./logs.js";
+const siteSummaryTemplate = new ResourceTemplate("localwp://sites/{siteName}/summary", {
+    list: async () => {
+        const sites = await loadLocalSites();
+        return {
+            resources: sites.map((site) => ({
+                uri: `localwp://sites/${encodeURIComponent(site.name)}/summary`,
+                name: `${site.name} summary`,
+            })),
+        };
+    },
+    complete: {
+        siteName: completeSiteNames,
+    },
+});
+const siteDoctorTemplate = new ResourceTemplate("localwp://sites/{siteName}/doctor", {
+    list: async () => {
+        const sites = await loadLocalSites();
+        return {
+            resources: sites.map((site) => ({
+                uri: `localwp://sites/${encodeURIComponent(site.name)}/doctor`,
+                name: `${site.name} doctor`,
+            })),
+        };
+    },
+    complete: {
+        siteName: completeSiteNames,
+    },
+});
+const siteLogsTemplate = new ResourceTemplate("localwp://sites/{siteName}/logs", {
+    list: async () => {
+        const sites = await loadLocalSites();
+        return {
+            resources: sites.map((site) => ({
+                uri: `localwp://sites/${encodeURIComponent(site.name)}/logs`,
+                name: `${site.name} logs`,
+            })),
+        };
+    },
+    complete: {
+        siteName: completeSiteNames,
+    },
+});
+export function registerResources(server) {
+    server.registerResource("local-sites-catalog", "localwp://sites", {
+        title: "Local Sites Catalog",
+        description: "JSON catalog of LocalWP sites discovered on this machine.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const sites = await loadLocalSites();
+        return createJsonResourceResult(uri.toString(), sites.map((site) => summarizeSite(site)));
+    });
+    server.registerResource("local-site-summary", siteSummaryTemplate, {
+        title: "Local Site Summary",
+        description: "Machine-readable Local site summary and runtime resolution details.",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const siteName = getTemplateVariable(variables.siteName);
+        const payload = await runEnvironmentCheck({ siteName }, { probeWpCli: false, probeMysql: false });
+        return createJsonResourceResult(uri.toString(), payload);
+    });
+    server.registerResource("local-site-doctor", siteDoctorTemplate, {
+        title: "Local Site Doctor",
+        description: "Health summary and next steps for one LocalWP site.",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const siteName = getTemplateVariable(variables.siteName);
+        const payload = await runLocalDoctor({ siteName });
+        return createJsonResourceResult(uri.toString(), payload);
+    });
+    server.registerResource("local-site-logs", siteLogsTemplate, {
+        title: "Local Site Logs",
+        description: "Recent site and Local app logs for one LocalWP site.",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const siteName = getTemplateVariable(variables.siteName);
+        const payload = await collectLocalLogs({ siteName }, { scope: "all", lines: 40 });
+        return createJsonResourceResult(uri.toString(), payload);
+    });
+}
+async function completeSiteNames(value) {
+    const sites = await loadLocalSites();
+    const query = value.trim().toLowerCase();
+    return sites
+        .map((site) => site.name)
+        .filter((siteName) => query ? siteName.toLowerCase().includes(query) : true)
+        .sort();
+}
+function createJsonResourceResult(uri, payload) {
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+function getTemplateVariable(value) {
+    if (Array.isArray(value)) {
+        return decodeURIComponent(value[0] || "");
+    }
+    return decodeURIComponent(value || "");
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/results.d.ts

@@ -0,0 +1,15 @@
+export declare function createJsonToolResult<T extends Record<string, unknown>>(payload: T): {
+    structuredContent: T;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function createErrorToolResult(error: unknown): {
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function formatError(error: unknown): string;

package/dist/results.js

@@ -0,0 +1,26 @@
+export function createJsonToolResult(payload) {
+    return {
+        structuredContent: payload,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+export function createErrorToolResult(error) {
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: formatError(error),
+            },
+        ],
+    };
+}
+export function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=results.js.map

package/dist/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../src/results.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAClC,OAAU;IAEV,OAAO;QACL,iBAAiB,EAAE,OAAO;QAC1B,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;aACzB;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}