@terreno/mcp 0.21.0

package/dist/local/projectRoot.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolves the consumer monorepo root (bootstrap layout with backend/ + frontend/)
+ * or the nearest package root. Override with `TERRENO_PROJECT_ROOT`.
+ */
+export declare const resolveTerrenoProjectRoot: (startDir?: string) => string;
+//# sourceMappingURL=projectRoot.d.ts.map

package/dist/local/projectRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRoot.d.ts","sourceRoot":"","sources":["../../src/local/projectRoot.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,iBAAwB,KAAG,MAmBpE,CAAC"}

package/dist/local/projectRoot.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+const isTerrenoLayoutRoot = (dir) => {
+    const pkgPath = join(dir, "package.json");
+    if (!existsSync(pkgPath)) {
+        return false;
+    }
+    const hasBackend = existsSync(join(dir, "backend", "package.json"));
+    const hasFrontend = existsSync(join(dir, "frontend", "package.json"));
+    if (hasBackend && hasFrontend) {
+        return true;
+    }
+    try {
+        const raw = readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(raw);
+        if (Array.isArray(pkg.workspaces) && pkg.workspaces.length > 0) {
+            return hasBackend || hasFrontend;
+        }
+    }
+    catch {
+        return false;
+    }
+    return false;
+};
+/**
+ * Resolves the consumer monorepo root (bootstrap layout with backend/ + frontend/)
+ * or the nearest package root. Override with `TERRENO_PROJECT_ROOT`.
+ */
+export const resolveTerrenoProjectRoot = (startDir = process.cwd()) => {
+    const override = process.env.TERRENO_PROJECT_ROOT?.trim();
+    if (override) {
+        return resolve(override);
+    }
+    let current = resolve(startDir);
+    for (let i = 0; i < 20; i += 1) {
+        if (isTerrenoLayoutRoot(current)) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return resolve(startDir);
+};
+//# sourceMappingURL=projectRoot.js.map

package/dist/local/projectRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRoot.js","sourceRoot":"","sources":["../../src/local/projectRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AACjD,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AAEjD,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAW,EAAE;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;IACtE,IAAI,UAAU,IAAI,WAAW,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;QACtD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,UAAU,IAAI,WAAW,CAAC;QACnC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,EAAU,EAAE;IAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/local/tools/applicationInfo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parses root `package.json` and `bun.lock` workspace entries for key dependency versions.
+ * Call at the start of a session so the agent can write version-correct code (Boost pattern).
+ */
+export declare const applicationInfo: () => string;
+//# sourceMappingURL=applicationInfo.d.ts.map

package/dist/local/tools/applicationInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applicationInfo.d.ts","sourceRoot":"","sources":["../../../src/local/tools/applicationInfo.ts"],"names":[],"mappings":"AA2CA;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,MA6DlC,CAAC"}

package/dist/local/tools/applicationInfo.js

@@ -0,0 +1,90 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveTerrenoProjectRoot } from "../projectRoot.js";
+const readJson = (path) => {
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+};
+const collectTerrenoVersions = (pkg) => {
+    const out = {};
+    if (!pkg) {
+        return out;
+    }
+    const merge = (deps) => {
+        if (!deps) {
+            return;
+        }
+        for (const [name, version] of Object.entries(deps)) {
+            if (name.startsWith("@terreno/")) {
+                out[name] = version;
+            }
+        }
+    };
+    merge(pkg.dependencies);
+    merge(pkg.devDependencies);
+    return out;
+};
+/**
+ * Parses root `package.json` and `bun.lock` workspace entries for key dependency versions.
+ * Call at the start of a session so the agent can write version-correct code (Boost pattern).
+ */
+export const applicationInfo = () => {
+    const root = resolveTerrenoProjectRoot();
+    const rootPkg = readJson(join(root, "package.json"));
+    const lockPath = join(root, "bun.lock");
+    const lockExists = existsSync(lockPath);
+    const backendPkg = readJson(join(root, "backend", "package.json"));
+    const frontendPkg = readJson(join(root, "frontend", "package.json"));
+    const lines = [];
+    lines.push(`# Application info`);
+    lines.push("");
+    lines.push(`- **projectRoot**: \`${root}\``);
+    lines.push(`- **root package**: ${rootPkg?.name ?? "(none)"} @ ${rootPkg?.version ?? "?"}`);
+    lines.push(`- **bun.lock present**: ${lockExists ? "yes" : "no"}`);
+    lines.push("");
+    const terrenoRoot = collectTerrenoVersions(rootPkg);
+    if (Object.keys(terrenoRoot).length > 0) {
+        lines.push("## @terreno/* (root package.json)");
+        for (const [k, v] of Object.entries(terrenoRoot)) {
+            lines.push(`- ${k}: ${v}`);
+        }
+        lines.push("");
+    }
+    const pick = (label, pkg) => {
+        if (!pkg) {
+            return;
+        }
+        lines.push(`## ${label}`);
+        lines.push(`- **name**: ${pkg.name ?? "?"}`);
+        lines.push(`- **version**: ${pkg.version ?? "?"}`);
+        const t = collectTerrenoVersions(pkg);
+        for (const [k, v] of Object.entries(t)) {
+            lines.push(`- ${k}: ${v}`);
+        }
+        const keys = ["expo", "react", "react-native", "mongoose", "bun", "@types/bun"];
+        for (const key of keys) {
+            const v = pkg.dependencies?.[key] ??
+                pkg.devDependencies?.[key] ??
+                pkg.dependencies?.[`${key}`];
+            if (v) {
+                lines.push(`- **${key}**: ${v}`);
+            }
+        }
+        lines.push("");
+    };
+    pick("Backend workspace", backendPkg);
+    pick("Frontend workspace", frontendPkg);
+    if (lockExists) {
+        lines.push("## Lockfile");
+        lines.push("Workspace package versions are recorded under `workspaces` in `bun.lock`. Prefer installed semver over `latest` in generated code.");
+    }
+    return lines.join("\n");
+};
+//# sourceMappingURL=applicationInfo.js.map

package/dist/local/tools/applicationInfo.js.map

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

package/dist/local/tools/databaseQuery.d.ts

@@ -0,0 +1,12 @@
+/** Exported for unit tests; local `database_query` rejects filters that include these operators. */
+export declare const databaseQueryFilterUsesForbiddenOperators: (filter: unknown) => boolean;
+export interface DatabaseQueryArgs {
+    collection: string;
+    operation: string;
+    filter?: unknown;
+    pipeline?: unknown[];
+    field?: string;
+    limit?: number;
+}
+export declare const databaseQuery: (args: DatabaseQueryArgs) => Promise<string>;
+//# sourceMappingURL=databaseQuery.d.ts.map

package/dist/local/tools/databaseQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseQuery.d.ts","sourceRoot":"","sources":["../../../src/local/tools/databaseQuery.ts"],"names":[],"mappings":"AA6EA,oGAAoG;AACpG,eAAO,MAAM,yCAAyC,GAAI,QAAQ,OAAO,KAAG,OAE3E,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,aAAa,GAAU,MAAM,iBAAiB,KAAG,OAAO,CAAC,MAAM,CA2F3E,CAAC"}

package/dist/local/tools/databaseQuery.js

@@ -0,0 +1,148 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveTerrenoProjectRoot } from "../projectRoot.js";
+const readEnvValue = (envPath, key) => {
+    if (!existsSync(envPath)) {
+        return undefined;
+    }
+    const text = readFileSync(envPath, "utf-8");
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        const eq = trimmed.indexOf("=");
+        if (eq === -1) {
+            continue;
+        }
+        const k = trimmed.slice(0, eq).trim();
+        if (k !== key) {
+            continue;
+        }
+        let v = trimmed.slice(eq + 1).trim();
+        if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+            v = v.slice(1, -1);
+        }
+        return v;
+    }
+    return undefined;
+};
+const FORBIDDEN_AGG_KEYS = new Set(["$out", "$merge", "$function"]);
+/** Operators that must not appear anywhere in a `find`-style filter document. */
+const FORBIDDEN_FILTER_KEYS = new Set(["$where", "$function", "$accumulator"]);
+const QUERY_MAX_TIME_MS = 10_000;
+const aggregateContainsForbidden = (value) => {
+    if (value === null || typeof value !== "object") {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return value.some(aggregateContainsForbidden);
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (FORBIDDEN_AGG_KEYS.has(key)) {
+            return true;
+        }
+        if (aggregateContainsForbidden(child)) {
+            return true;
+        }
+    }
+    return false;
+};
+const filterContainsForbidden = (value) => {
+    if (value === null || typeof value !== "object") {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return value.some(filterContainsForbidden);
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (FORBIDDEN_FILTER_KEYS.has(key)) {
+            return true;
+        }
+        if (filterContainsForbidden(child)) {
+            return true;
+        }
+    }
+    return false;
+};
+const ALLOWED = new Set(["find", "aggregate", "countDocuments", "distinct"]);
+/** Exported for unit tests; local `database_query` rejects filters that include these operators. */
+export const databaseQueryFilterUsesForbiddenOperators = (filter) => {
+    return filterContainsForbidden(filter ?? {});
+};
+export const databaseQuery = async (args) => {
+    const op = args.operation.trim();
+    if (!ALLOWED.has(op)) {
+        return `Unsupported operation "${op}". Allowed: ${[...ALLOWED].join(", ")}.`;
+    }
+    if (op === "find" || op === "countDocuments" || op === "distinct") {
+        if (filterContainsForbidden(args.filter ?? {})) {
+            return "Filter rejected: `$where`, `$function`, and `$accumulator` are not allowed.";
+        }
+    }
+    if (op === "distinct") {
+        const field = typeof args.field === "string" ? args.field : "";
+        if (!field) {
+            return "`field` is required for distinct.";
+        }
+    }
+    if (op === "aggregate") {
+        const pipeline = args.pipeline ?? [];
+        if (!Array.isArray(pipeline)) {
+            return "`pipeline` must be an array of aggregation stages.";
+        }
+        if (aggregateContainsForbidden(pipeline)) {
+            return "Pipeline rejected: `$out`, `$merge`, and `$function` are not allowed.";
+        }
+    }
+    const root = resolveTerrenoProjectRoot();
+    const envPath = join(root, "backend", ".env");
+    const mongoUri = process.env.MONGO_URI?.trim() ||
+        readEnvValue(envPath, "MONGO_URI") ||
+        readEnvValue(envPath, "MONGODB_URI");
+    if (!mongoUri) {
+        return "No Mongo URI found. Set `MONGO_URI` in `backend/.env` or export `MONGO_URI`.";
+    }
+    const mongoose = await import("mongoose");
+    try {
+        if (mongoose.connection.readyState !== 1) {
+            await mongoose.connect(mongoUri);
+        }
+        const db = mongoose.connection.db;
+        if (!db) {
+            return "Connected to Mongo but `connection.db` is not available.";
+        }
+        const coll = db.collection(args.collection);
+        const cap = Math.min(Math.max(args.limit ?? 50, 1), 200);
+        if (op === "find") {
+            const filter = (args.filter ?? {});
+            const rows = await coll.find(filter, { maxTimeMS: QUERY_MAX_TIME_MS }).limit(cap).toArray();
+            return JSON.stringify({ collection: args.collection, count: rows.length, rows }, null, 2);
+        }
+        if (op === "aggregate") {
+            const pipeline = args.pipeline ?? [];
+            const rows = await coll
+                .aggregate(pipeline, { allowDiskUse: false, maxTimeMS: QUERY_MAX_TIME_MS })
+                .limit(cap)
+                .toArray();
+            return JSON.stringify({ collection: args.collection, count: rows.length, rows }, null, 2);
+        }
+        if (op === "countDocuments") {
+            const filter = (args.filter ?? {});
+            const count = await coll.countDocuments(filter, { maxTimeMS: QUERY_MAX_TIME_MS });
+            return JSON.stringify({ collection: args.collection, count }, null, 2);
+        }
+        if (op === "distinct") {
+            const field = typeof args.field === "string" ? args.field : "";
+            const filter = (args.filter ?? {});
+            const values = await coll.distinct(field, filter, { maxTimeMS: QUERY_MAX_TIME_MS });
+            const trimmed = values.slice(0, cap);
+            return JSON.stringify({ collection: args.collection, field, truncated: values.length > cap, values: trimmed }, null, 2);
+        }
+        return "Unreachable";
+    }
+    finally {
+        await mongoose.disconnect().catch(() => undefined);
+    }
+};
+//# sourceMappingURL=databaseQuery.js.map

package/dist/local/tools/databaseQuery.js.map

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

package/dist/local/tools/databaseSchema.d.ts

@@ -0,0 +1,7 @@
+interface DatabaseSchemaArgs {
+    collectionFilter?: string;
+    summary?: boolean;
+}
+export declare const databaseSchema: (args: DatabaseSchemaArgs) => Promise<string>;
+export {};
+//# sourceMappingURL=databaseSchema.d.ts.map

package/dist/local/tools/databaseSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseSchema.d.ts","sourceRoot":"","sources":["../../../src/local/tools/databaseSchema.ts"],"names":[],"mappings":"AAKA,UAAU,kBAAkB;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA2CD,eAAO,MAAM,cAAc,GAAU,MAAM,kBAAkB,KAAG,OAAO,CAAC,MAAM,CAiE7E,CAAC"}

package/dist/local/tools/databaseSchema.js

@@ -0,0 +1,103 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveTerrenoProjectRoot } from "../projectRoot.js";
+const readEnvValue = (envPath, key) => {
+    if (!existsSync(envPath)) {
+        return undefined;
+    }
+    const text = readFileSync(envPath, "utf-8");
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        const eq = trimmed.indexOf("=");
+        if (eq === -1) {
+            continue;
+        }
+        const k = trimmed.slice(0, eq).trim();
+        if (k !== key) {
+            continue;
+        }
+        let v = trimmed.slice(eq + 1).trim();
+        if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+            v = v.slice(1, -1);
+        }
+        return v;
+    }
+    return undefined;
+};
+const parseModelFiles = (modelsDir) => {
+    if (!existsSync(modelsDir)) {
+        return [];
+    }
+    const names = readdirSync(modelsDir).filter((f) => f.endsWith(".ts") && f !== "index.ts");
+    const summaries = [];
+    for (const name of names) {
+        const content = readFileSync(join(modelsDir, name), "utf-8");
+        const lines = content.split("\n").slice(0, 80);
+        summaries.push(`### ${name}\n\`\`\`typescript\n${lines.join("\n")}\n\`\`\``);
+    }
+    return summaries;
+};
+export const databaseSchema = async (args) => {
+    const root = resolveTerrenoProjectRoot();
+    const envPath = join(root, "backend", ".env");
+    const mongoUri = process.env.MONGO_URI?.trim() ||
+        readEnvValue(envPath, "MONGO_URI") ||
+        readEnvValue(envPath, "MONGODB_URI");
+    if (!mongoUri) {
+        return "No Mongo URI found. Set `MONGO_URI` in `backend/.env` or export `MONGO_URI`, or set `TERRENO_PROJECT_ROOT` to your app root.";
+    }
+    const mongoose = await import("mongoose");
+    try {
+        if (mongoose.connection.readyState !== 1) {
+            await mongoose.connect(mongoUri);
+        }
+        const db = mongoose.connection.db;
+        if (!db) {
+            return "Connected to Mongo but `connection.db` is not available.";
+        }
+        const filter = args.collectionFilter?.toLowerCase().trim();
+        const names = (await db.listCollections().toArray())
+            .map((c) => c.name)
+            .filter((n) => !filter || n.toLowerCase().includes(filter));
+        const lines = ["# Database schema", ""];
+        const modelsDir = join(root, "backend", "src", "models");
+        lines.push("## Declared models (static scan of `backend/src/models/*.ts`)");
+        lines.push("");
+        const modelBlocks = parseModelFiles(modelsDir);
+        if (modelBlocks.length === 0) {
+            lines.push("_(No model files found.)_");
+        }
+        else if (args.summary) {
+            lines.push(`Found ${modelBlocks.length} model file(s). Re-run with \`summary: false\` for excerpts.`);
+        }
+        else {
+            lines.push(...modelBlocks);
+        }
+        lines.push("");
+        lines.push("## Live MongoDB");
+        lines.push("");
+        for (const name of names.sort()) {
+            const coll = db.collection(name);
+            const indexes = await coll.indexes();
+            let count = 0;
+            try {
+                count = await coll.estimatedDocumentCount();
+            }
+            catch {
+                count = -1;
+            }
+            lines.push(`### ${name}`);
+            lines.push(`- **estimatedCount**: ${count}`);
+            lines.push(`- **indexes**: \`${JSON.stringify(indexes)}\``);
+            lines.push("");
+        }
+        return lines.join("\n");
+    }
+    finally {
+        await mongoose.disconnect().catch(() => undefined);
+    }
+};
+//# sourceMappingURL=databaseSchema.js.map

package/dist/local/tools/databaseSchema.js.map

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

package/dist/local/tools/readLogs.d.ts

@@ -0,0 +1,11 @@
+export interface ReadLogsArgs {
+    sources?: string[];
+    entries?: number;
+    level?: string;
+}
+export declare const readLogs: (args: ReadLogsArgs) => Promise<string>;
+export interface LastErrorArgs {
+    sources?: string[];
+}
+export declare const lastError: (args: LastErrorArgs) => Promise<string>;
+//# sourceMappingURL=readLogs.d.ts.map

package/dist/local/tools/readLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readLogs.d.ts","sourceRoot":"","sources":["../../../src/local/tools/readLogs.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,QAAQ,GAAU,MAAM,YAAY,KAAG,OAAO,CAAC,MAAM,CAmCjE,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,GAAU,MAAM,aAAa,KAAG,OAAO,CAAC,MAAM,CAoCnE,CAAC"}

package/dist/local/tools/readLogs.js

@@ -0,0 +1,96 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveTerrenoProjectRoot } from "../projectRoot.js";
+const parseJsonlFile = (path, source, maxLines) => {
+    if (!existsSync(path)) {
+        return [];
+    }
+    const text = readFileSync(path, "utf-8");
+    const lines = text.split("\n").filter(Boolean);
+    const slice = lines.slice(-maxLines);
+    const out = [];
+    for (const raw of slice) {
+        try {
+            const obj = JSON.parse(raw);
+            out.push({
+                level: typeof obj.level === "string" ? obj.level : undefined,
+                message: obj.message,
+                raw,
+                source,
+                timestamp: typeof obj.timestamp === "string" ? obj.timestamp : undefined,
+            });
+        }
+        catch {
+            out.push({ raw, source });
+        }
+    }
+    return out;
+};
+export const readLogs = async (args) => {
+    const root = resolveTerrenoProjectRoot();
+    const maxEntries = Math.min(Math.max(args.entries ?? 200, 1), 2000);
+    const want = (args.sources ?? ["backend", "browser", "metro", "app"]).map((s) => s.toLowerCase());
+    const levelFilter = args.level?.toLowerCase();
+    const backendPath = join(root, ".terreno", "logs", "app.log");
+    const browserPath = join(root, ".terreno", "logs", "browser.log");
+    const merged = [];
+    if (want.includes("backend")) {
+        merged.push(...parseJsonlFile(backendPath, "backend", maxEntries));
+    }
+    if (want.includes("browser")) {
+        merged.push(...parseJsonlFile(browserPath, "browser", maxEntries));
+    }
+    if (want.includes("metro")) {
+        merged.push({
+            raw: "Metro bundler events require an active `/events` WebSocket connection (not attached in v1). Start Metro and use Expo MCP or extend terreno-mcp-local.",
+            source: "metro",
+        });
+    }
+    if (want.includes("app")) {
+        merged.push({
+            raw: "Hermes console capture requires a CDP connection to Metro (not attached in v1). Use Expo MCP `collect_app_logs` or enable future CDP support in terreno-mcp-local.",
+            source: "app",
+        });
+    }
+    const filtered = levelFilter
+        ? merged.filter((e) => (e.level ?? "").toLowerCase() === levelFilter)
+        : merged;
+    return JSON.stringify({ entries: filtered.slice(-maxEntries) }, null, 2);
+};
+export const lastError = async (args) => {
+    const root = resolveTerrenoProjectRoot();
+    const want = (args.sources ?? ["backend", "browser"]).map((s) => s.toLowerCase());
+    const paths = [];
+    if (want.includes("backend")) {
+        paths.push({ path: join(root, ".terreno", "logs", "app.log"), source: "backend" });
+    }
+    if (want.includes("browser")) {
+        paths.push({ path: join(root, ".terreno", "logs", "browser.log"), source: "browser" });
+    }
+    let last;
+    for (const { path, source } of paths) {
+        if (!existsSync(path)) {
+            continue;
+        }
+        const lines = readFileSync(path, "utf-8").split("\n").filter(Boolean);
+        for (let i = lines.length - 1; i >= 0; i -= 1) {
+            const raw = lines[i] ?? "";
+            try {
+                const obj = JSON.parse(raw);
+                if ((obj.level ?? "").toLowerCase() === "error") {
+                    last = { level: "error", raw, source };
+                    break;
+                }
+            }
+            catch { }
+        }
+        if (last) {
+            break;
+        }
+    }
+    if (!last) {
+        return "No recent error-level JSONL entries in `.terreno/logs/app.log` or `.terreno/logs/browser.log`.";
+    }
+    return last.raw;
+};
+//# sourceMappingURL=readLogs.js.map

package/dist/local/tools/readLogs.js.map

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

package/dist/local/tools/runtime.d.ts

@@ -0,0 +1,13 @@
+export interface GetRtkStateArgs {
+    slice?: string;
+}
+export declare const getRtkState: (args: GetRtkStateArgs) => string;
+export interface EvaluateArgs {
+    code: string;
+}
+export declare const evaluate: (_args: EvaluateArgs) => string;
+export interface NavigateArgs {
+    path: string;
+}
+export declare const navigate: (_args: NavigateArgs) => string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/local/tools/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/local/tools/runtime.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,WAAW,GAAI,MAAM,eAAe,KAAG,MAwBnD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,YAAY,KAAG,MAK9C,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,YAAY,KAAG,MAE9C,CAAC"}