kaax-mcp 0.1.4 → 0.1.6

package/dist/analysis-files.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Analysis-file helpers — surface every downloadable artefact attached to
+ * a Kaax analysis (reports zip, density maps, line maps, the KML of the
+ * field that produced it) and stream them to disk. The MCP receives these
+ * URLs as part of the regular `POST /api/v0/analyses` response; we just
+ * pull them out by type and download with the existing safe-URL helper.
+ *
+ * Security: every URL goes through `assertSafeHttpUrl` (http(s) only,
+ * no shell metacharacters), filenames pass through `safeFileName` so a
+ * compromised server cannot make the MCP write outside the user's
+ * chosen directory.
+ */
+import type { AnalysisRecord } from "./types.js";
+/** What a single downloadable file looks like to the caller. */
+export interface AvailableFile {
+    /** Logical key the user references: "resending.allReports", "kml", … */
+    key: string;
+    /** Short label for prompts — what KIND of file this is. */
+    label: string;
+    /** Remote URL or `inline` if the content is embedded in the analysis doc. */
+    url?: string;
+    /** Filename hint we want to use locally. */
+    fileName: string;
+    /** Approximate file type so the user / agent knows what to expect. */
+    kind: "zip" | "kml" | "image" | "shapefile" | "other";
+}
+/** Categorises every downloadable artefact attached to one analysis. */
+export declare function listAvailableFiles(record: AnalysisRecord): AvailableFile[];
+/** Result entry per file the downloader processed. */
+export interface DownloadedFile {
+    key: string;
+    outputPath: string;
+    bytesWritten: number;
+    /**
+     * For ZIPs we also extract — `extractedTo` lists the entries written
+     * to the sibling directory `<name>_extracted/`.
+     */
+    extractedTo?: string;
+    extractedFiles?: string[];
+}
+/**
+ * Downloads each requested file from a Kaax analysis to a local directory.
+ * If a file is a ZIP we also unzip it next to the archive so the agent
+ * can immediately reference the contained SHP/KML/PDFs without a second
+ * tool call.
+ *
+ * - `record`     – the analysis returned by `client.listAnalyses(...)`
+ * - `outputDir`  – directory to write into (created if absent)
+ * - `keys`       – optional whitelist of file keys (from listAvailableFiles)
+ */
+export declare function downloadAnalysisFiles(record: AnalysisRecord, outputDir: string, keys?: string[]): Promise<DownloadedFile[]>;

package/dist/analysis-files.js

@@ -0,0 +1,178 @@
+/**
+ * Analysis-file helpers — surface every downloadable artefact attached to
+ * a Kaax analysis (reports zip, density maps, line maps, the KML of the
+ * field that produced it) and stream them to disk. The MCP receives these
+ * URLs as part of the regular `POST /api/v0/analyses` response; we just
+ * pull them out by type and download with the existing safe-URL helper.
+ *
+ * Security: every URL goes through `assertSafeHttpUrl` (http(s) only,
+ * no shell metacharacters), filenames pass through `safeFileName` so a
+ * compromised server cannot make the MCP write outside the user's
+ * chosen directory.
+ */
+import AdmZip from "adm-zip";
+import { writeFile } from "fs/promises";
+import { join } from "path";
+import { downloadFile, safeFileName } from "./platform.js";
+/** Categorises every downloadable artefact attached to one analysis. */
+export function listAvailableFiles(record) {
+    const out = [];
+    const recordAny = record;
+    const reports = recordAny.reports ?? {};
+    // The full-bundle ZIPs (most useful — they contain SHP + KML + PDFs).
+    if (reports.resending?.allReports) {
+        out.push({
+            key: "resending.allReports",
+            label: "Replanting full report (zip with SHP + PDF)",
+            url: reports.resending.allReports,
+            fileName: "resending_reports.zip",
+            kind: "zip",
+        });
+    }
+    if (reports.counting?.allReports) {
+        out.push({
+            key: "counting.allReports",
+            label: "Counting full report (zip with SHP + PDF)",
+            url: reports.counting.allReports,
+            fileName: "counting_reports.zip",
+            kind: "zip",
+        });
+    }
+    if (reports.path?.allReports) {
+        out.push({
+            key: "path.allReports",
+            label: "Path full report (zip)",
+            url: reports.path.allReports,
+            fileName: "path_reports.zip",
+            kind: "zip",
+        });
+    }
+    // Individual raster maps.
+    if (reports.resending?.densityMap) {
+        out.push({
+            key: "resending.densityMap",
+            label: "Replanting density map",
+            url: reports.resending.densityMap,
+            fileName: "resending_density.png",
+            kind: "image",
+        });
+    }
+    if (reports.resending?.resendingLineMap) {
+        out.push({
+            key: "resending.lineMap",
+            label: "Replanting line map",
+            url: reports.resending.resendingLineMap,
+            fileName: "resending_lines.png",
+            kind: "image",
+        });
+    }
+    if (reports.counting?.densityMap) {
+        out.push({
+            key: "counting.densityMap",
+            label: "Counting density map",
+            url: reports.counting.densityMap,
+            fileName: "counting_density.png",
+            kind: "image",
+        });
+    }
+    if (reports.counting?.sizeDistributionMap) {
+        out.push({
+            key: "counting.sizeMap",
+            label: "Counting size-distribution map",
+            url: reports.counting.sizeDistributionMap,
+            fileName: "counting_size.png",
+            kind: "image",
+        });
+    }
+    if (reports.path?.densityMap) {
+        out.push({
+            key: "path.densityMap",
+            label: "Path density map",
+            url: reports.path.densityMap,
+            fileName: "path_density.png",
+            kind: "image",
+        });
+    }
+    if (reports.path?.pathDistributionMap) {
+        out.push({
+            key: "path.distributionMap",
+            label: "Path distribution map",
+            url: reports.path.pathDistributionMap,
+            fileName: "path_distribution.png",
+            kind: "image",
+        });
+    }
+    // KML — embedded inline as text rather than a remote URL.
+    if (typeof record.kml === "string" && record.kml.length > 0) {
+        out.push({
+            key: "kml",
+            label: "Field boundary (KML — inline, written from the analysis doc)",
+            fileName: "field.kml",
+            kind: "kml",
+        });
+    }
+    return out;
+}
+/**
+ * Downloads each requested file from a Kaax analysis to a local directory.
+ * If a file is a ZIP we also unzip it next to the archive so the agent
+ * can immediately reference the contained SHP/KML/PDFs without a second
+ * tool call.
+ *
+ * - `record`     – the analysis returned by `client.listAnalyses(...)`
+ * - `outputDir`  – directory to write into (created if absent)
+ * - `keys`       – optional whitelist of file keys (from listAvailableFiles)
+ */
+export async function downloadAnalysisFiles(record, outputDir, keys) {
+    const all = listAvailableFiles(record);
+    const wanted = keys && keys.length > 0 ? all.filter((f) => keys.includes(f.key)) : all;
+    const results = [];
+    for (const f of wanted) {
+        const localName = safeFileName(f.fileName);
+        const destPath = join(outputDir, localName);
+        if (f.kind === "kml") {
+            // KML lives inline in the analysis doc; just write it.
+            const body = record.kml;
+            if (!body)
+                continue;
+            await writeFile(destPath, body, "utf8");
+            results.push({
+                key: f.key,
+                outputPath: destPath,
+                bytesWritten: Buffer.byteLength(body, "utf8"),
+            });
+            continue;
+        }
+        if (!f.url)
+            continue;
+        // Streamed download (size-bounded via 5-min timeout in downloadFile).
+        const dl = await downloadFile(f.url, destPath);
+        const entry = {
+            key: f.key,
+            outputPath: dl.outputPath,
+            bytesWritten: dl.bytesWritten,
+        };
+        // Best-effort unzip for full-report archives.
+        if (f.kind === "zip") {
+            try {
+                const extractDir = destPath.replace(/\.zip$/i, "_extracted");
+                const zip = new AdmZip(dl.outputPath);
+                zip.extractAllTo(extractDir, /* overwrite */ true);
+                const entries = zip
+                    .getEntries()
+                    .filter((e) => !e.isDirectory)
+                    .map((e) => join(extractDir, e.entryName));
+                entry.extractedTo = extractDir;
+                entry.extractedFiles = entries;
+            }
+            catch (err) {
+                // Non-fatal — the user still has the zip on disk and can extract
+                // by hand if our extractor chokes on a quirky archive.
+                process.stderr.write(`[kaax-mcp] zip extract failed for ${dl.outputPath}: ${err.message}\n`);
+            }
+        }
+        results.push(entry);
+    }
+    return results;
+}
+//# sourceMappingURL=analysis-files.js.map

package/dist/analysis-files.js.map

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

package/dist/gis-io.d.ts

@@ -0,0 +1,57 @@
+/**
+ * GIS file I/O — read/write Shapefile, KML and GeoJSON locally.
+ *
+ * All in-memory representations use **GeoJSON** so every GIS operation
+ * downstream (turf, shp-write, KML serialisation) speaks the same dialect.
+ *
+ * Coordinate reference: everything stays in WGS84 / EPSG:4326. Kaax does
+ * not support other CRS, and turf operations assume lon/lat input. If a
+ * Shapefile carries a sibling .prj that is not WGS84 we log a warning
+ * but read the coordinates as-is — re-projecting in pure JS without a
+ * proj4 dependency would be a footgun.
+ */
+import type { FeatureCollection, Geometry } from "geojson";
+export type AnyFeatureCollection = FeatureCollection<Geometry, Record<string, unknown>>;
+/**
+ * Read every feature from a `.shp` (+ sibling `.dbf` for attributes) into
+ * an in-memory GeoJSON FeatureCollection. The `.shp` extension is added
+ * automatically if the caller passes the base name.
+ */
+export declare function readShapefile(shpPath: string): Promise<AnyFeatureCollection>;
+/**
+ * Write a FeatureCollection to disk as a Shapefile **bundle**.
+ *
+ * shp-write packages SHP + SHX + DBF + PRJ into one ZIP, which is the
+ * portable shape ESRI ships and what every QGIS / ArcGIS user expects.
+ * If you need the bare `.shp` next to other tools, unzip it after.
+ *
+ * The output path is treated as the base name — we append `.zip` ourselves
+ * so callers can't accidentally clobber a SHP alongside the archive.
+ */
+export declare function writeShapefileZip(fc: AnyFeatureCollection, outputBasePath: string): Promise<string>;
+/** Read a `.geojson` / `.json` file into a FeatureCollection. */
+export declare function readGeoJSON(path: string): Promise<AnyFeatureCollection>;
+/** Write a FeatureCollection to a `.geojson` file (pretty-printed). */
+export declare function writeGeoJSON(fc: AnyFeatureCollection, outputPath: string): Promise<string>;
+/**
+ * Write a FeatureCollection as KML 2.2. Supports Point, MultiPoint,
+ * LineString, MultiLineString, Polygon and MultiPolygon. Any feature
+ * properties become `<ExtendedData>` so the data round-trips through
+ * QGIS / Google Earth without loss.
+ */
+export declare function writeKML(fc: AnyFeatureCollection, outputPath: string, options?: {
+    documentName?: string;
+}): Promise<string>;
+/** Detect format from extension. Returns `"unknown"` if we don't handle it. */
+export declare function detectFormat(path: string): "shp" | "kml" | "geojson" | "unknown";
+/**
+ * Read any supported GIS file into a FeatureCollection. Used by tools so
+ * the user can pass `.shp`, `.kml` or `.geojson` interchangeably.
+ */
+export declare function readAny(path: string): Promise<AnyFeatureCollection>;
+/**
+ * Resolve an output path, defaulting to alongside the input file with a
+ * suffix and the requested extension. Keeps the tool surface tidy when
+ * the caller didn't specify an explicit destination.
+ */
+export declare function defaultOutputPath(inputPath: string, suffix: string, ext: string): string;

package/dist/gis-io.js

@@ -0,0 +1,270 @@
+/**
+ * GIS file I/O — read/write Shapefile, KML and GeoJSON locally.
+ *
+ * All in-memory representations use **GeoJSON** so every GIS operation
+ * downstream (turf, shp-write, KML serialisation) speaks the same dialect.
+ *
+ * Coordinate reference: everything stays in WGS84 / EPSG:4326. Kaax does
+ * not support other CRS, and turf operations assume lon/lat input. If a
+ * Shapefile carries a sibling .prj that is not WGS84 we log a warning
+ * but read the coordinates as-is — re-projecting in pure JS without a
+ * proj4 dependency would be a footgun.
+ */
+import { open as openShapefile } from "shapefile";
+import shpwrite from "@mapbox/shp-write";
+import { create as xmlCreate } from "xmlbuilder2";
+import { existsSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import { basename, dirname, extname, join } from "path";
+// ─────────────────────────────────────────────────────────────────────────
+// Shapefile (read)
+// ─────────────────────────────────────────────────────────────────────────
+/**
+ * Read every feature from a `.shp` (+ sibling `.dbf` for attributes) into
+ * an in-memory GeoJSON FeatureCollection. The `.shp` extension is added
+ * automatically if the caller passes the base name.
+ */
+export async function readShapefile(shpPath) {
+    const finalPath = shpPath.toLowerCase().endsWith(".shp")
+        ? shpPath
+        : `${shpPath}.shp`;
+    if (!existsSync(finalPath)) {
+        throw new Error(`Shapefile not found: ${finalPath}`);
+    }
+    const dbfPath = finalPath.replace(/\.shp$/i, ".dbf");
+    const features = [];
+    // The shapefile package exposes an iterator on the returned source
+    // (`source.read()`), not a top-level `read(source)`. Different versions
+    // of @types/shapefile typed this differently; we cast to keep the call
+    // site portable.
+    const source = (await openShapefile(finalPath, existsSync(dbfPath) ? dbfPath : undefined, { encoding: "utf8" }));
+    try {
+        while (true) {
+            const next = await source.read();
+            if (next.done)
+                break;
+            const feat = next.value;
+            if (feat?.geometry)
+                features.push(feat);
+        }
+    }
+    finally {
+        if (typeof source.close === "function")
+            await source.close();
+    }
+    return {
+        type: "FeatureCollection",
+        features,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Shapefile (write)
+// ─────────────────────────────────────────────────────────────────────────
+/**
+ * Write a FeatureCollection to disk as a Shapefile **bundle**.
+ *
+ * shp-write packages SHP + SHX + DBF + PRJ into one ZIP, which is the
+ * portable shape ESRI ships and what every QGIS / ArcGIS user expects.
+ * If you need the bare `.shp` next to other tools, unzip it after.
+ *
+ * The output path is treated as the base name — we append `.zip` ourselves
+ * so callers can't accidentally clobber a SHP alongside the archive.
+ */
+export async function writeShapefileZip(fc, outputBasePath) {
+    const out = outputBasePath.toLowerCase().endsWith(".zip")
+        ? outputBasePath
+        : `${outputBasePath}.zip`;
+    // shp-write returns the ZIP as an ArrayBuffer / Uint8Array. Force Buffer
+    // for Node fs.
+    const ab = (await shpwrite.zip(fc));
+    const buf = Buffer.isBuffer(ab)
+        ? ab
+        : Buffer.from(ab instanceof ArrayBuffer ? ab : ab.buffer);
+    await writeFile(out, buf);
+    return out;
+}
+// ─────────────────────────────────────────────────────────────────────────
+// GeoJSON
+// ─────────────────────────────────────────────────────────────────────────
+/** Read a `.geojson` / `.json` file into a FeatureCollection. */
+export async function readGeoJSON(path) {
+    if (!existsSync(path))
+        throw new Error(`GeoJSON not found: ${path}`);
+    const raw = await readFile(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.type === "FeatureCollection") {
+        return parsed;
+    }
+    if (parsed.type === "Feature") {
+        return {
+            type: "FeatureCollection",
+            features: [parsed],
+        };
+    }
+    throw new Error(`Unexpected GeoJSON shape at ${path}: must be FeatureCollection or Feature`);
+}
+/** Write a FeatureCollection to a `.geojson` file (pretty-printed). */
+export async function writeGeoJSON(fc, outputPath) {
+    await writeFile(outputPath, JSON.stringify(fc, null, 2), "utf8");
+    return outputPath;
+}
+// ─────────────────────────────────────────────────────────────────────────
+// KML
+// ─────────────────────────────────────────────────────────────────────────
+/**
+ * Write a FeatureCollection as KML 2.2. Supports Point, MultiPoint,
+ * LineString, MultiLineString, Polygon and MultiPolygon. Any feature
+ * properties become `<ExtendedData>` so the data round-trips through
+ * QGIS / Google Earth without loss.
+ */
+export async function writeKML(fc, outputPath, options = {}) {
+    const docName = options.documentName ?? basename(outputPath, ".kml");
+    const root = xmlCreate({ version: "1.0", encoding: "UTF-8" })
+        .ele("kml", { xmlns: "http://www.opengis.net/kml/2.2" })
+        .ele("Document")
+        .ele("name")
+        .txt(docName)
+        .up();
+    for (const f of fc.features) {
+        const placemark = root.ele("Placemark");
+        const nameProp = (f.properties?.name ?? f.properties?.Name ?? "");
+        if (nameProp)
+            placemark.ele("name").txt(String(nameProp)).up();
+        // Attributes — preserve everything.
+        if (f.properties && Object.keys(f.properties).length > 0) {
+            const ext = placemark.ele("ExtendedData");
+            for (const [k, v] of Object.entries(f.properties)) {
+                if (v === undefined || v === null)
+                    continue;
+                ext.ele("Data", { name: k }).ele("value").txt(String(v)).up().up();
+            }
+        }
+        appendKmlGeometry(placemark, f.geometry);
+    }
+    const xml = root.end({ prettyPrint: true });
+    await writeFile(outputPath, xml, "utf8");
+    return outputPath;
+}
+function appendKmlGeometry(parent, geom) {
+    switch (geom.type) {
+        case "Point":
+            parent
+                .ele("Point")
+                .ele("coordinates")
+                .txt(geom.coordinates.slice(0, 2).join(","))
+                .up()
+                .up();
+            break;
+        case "MultiPoint": {
+            const multi = parent.ele("MultiGeometry");
+            for (const c of geom.coordinates) {
+                multi
+                    .ele("Point")
+                    .ele("coordinates")
+                    .txt(c.slice(0, 2).join(","))
+                    .up()
+                    .up();
+            }
+            break;
+        }
+        case "LineString":
+            parent
+                .ele("LineString")
+                .ele("coordinates")
+                .txt(geom.coordinates.map((c) => c.slice(0, 2).join(",")).join(" "))
+                .up()
+                .up();
+            break;
+        case "MultiLineString": {
+            const multi = parent.ele("MultiGeometry");
+            for (const ls of geom.coordinates) {
+                multi
+                    .ele("LineString")
+                    .ele("coordinates")
+                    .txt(ls.map((c) => c.slice(0, 2).join(",")).join(" "))
+                    .up()
+                    .up();
+            }
+            break;
+        }
+        case "Polygon":
+            appendPolygonKml(parent, geom.coordinates);
+            break;
+        case "MultiPolygon": {
+            const multi = parent.ele("MultiGeometry");
+            for (const poly of geom.coordinates) {
+                appendPolygonKml(multi, poly);
+            }
+            break;
+        }
+        default:
+            // Other geometry types (GeometryCollection) — skipped intentionally.
+            break;
+    }
+}
+function appendPolygonKml(parent, rings) {
+    const polyEl = parent.ele("Polygon");
+    const [outer, ...inner] = rings;
+    if (outer) {
+        polyEl
+            .ele("outerBoundaryIs")
+            .ele("LinearRing")
+            .ele("coordinates")
+            .txt(outer.map((c) => c.slice(0, 2).join(",")).join(" "))
+            .up()
+            .up()
+            .up();
+    }
+    for (const ring of inner) {
+        polyEl
+            .ele("innerBoundaryIs")
+            .ele("LinearRing")
+            .ele("coordinates")
+            .txt(ring.map((c) => c.slice(0, 2).join(",")).join(" "))
+            .up()
+            .up()
+            .up();
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Format dispatch
+// ─────────────────────────────────────────────────────────────────────────
+/** Detect format from extension. Returns `"unknown"` if we don't handle it. */
+export function detectFormat(path) {
+    const ext = extname(path).toLowerCase();
+    if (ext === ".shp" || ext === ".zip")
+        return "shp";
+    if (ext === ".kml")
+        return "kml";
+    if (ext === ".geojson" || ext === ".json")
+        return "geojson";
+    return "unknown";
+}
+/**
+ * Read any supported GIS file into a FeatureCollection. Used by tools so
+ * the user can pass `.shp`, `.kml` or `.geojson` interchangeably.
+ */
+export async function readAny(path) {
+    const fmt = detectFormat(path);
+    switch (fmt) {
+        case "shp":
+            return readShapefile(path);
+        case "kml":
+            throw new Error("KML read is not yet implemented in gis-io. For now, convert KML to GeoJSON externally or pass a shapefile / geojson.");
+        case "geojson":
+            return readGeoJSON(path);
+        default:
+            throw new Error(`Unsupported GIS format for ${path}. Supported: .shp, .geojson, .json.`);
+    }
+}
+/**
+ * Resolve an output path, defaulting to alongside the input file with a
+ * suffix and the requested extension. Keeps the tool surface tidy when
+ * the caller didn't specify an explicit destination.
+ */
+export function defaultOutputPath(inputPath, suffix, ext) {
+    const dir = dirname(inputPath);
+    const base = basename(inputPath, extname(inputPath));
+    return join(dir, `${base}${suffix}${ext.startsWith(".") ? ext : `.${ext}`}`);
+}
+//# sourceMappingURL=gis-io.js.map

package/dist/gis-io.js.map

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