@geotechcli/core 0.2.0

package/dist/agents/data-tools.js

@@ -0,0 +1,309 @@
+import { toolRegistry } from './tools.js';
+import { parseAGS } from '../ingest/ags.js';
+import { parseCPT } from '../ingest/cpt.js';
+import { queryStandards } from '../standards/index.js';
+import { createProject, loadProject, listProjects, addSimulationResult, saveNamedDataset, saveDerivedParameter, addAssumption, addArtifact, } from '../storage/index.js';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+// ---------------------------------------------------------------------------
+// AGS Borehole Data Parser
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'parse_ags',
+    description: 'Parse an AGS 4.0 borehole data file (the standard electronic transfer format for geotechnical data). Extracts boreholes, geology layers, SPT results, and sample information. Use this when the user has .ags files from site investigation.',
+    parameters: {
+        type: 'object',
+        required: ['path'],
+        properties: {
+            path: { type: 'string', description: 'Path to the .ags file' },
+        },
+    },
+}, (args) => {
+    const filePath = resolve(String(args.path));
+    if (!existsSync(filePath)) {
+        return { success: false, data: null, summary: '', error: `File not found: ${filePath}` };
+    }
+    try {
+        const ags = parseAGS(filePath);
+        return {
+            success: true,
+            data: {
+                boreholes: ags.boreholes,
+                geology: ags.geology,
+                sptResults: ags.sptResults,
+                samples: ags.samples,
+                projectInfo: ags.projectInfo,
+                groupCount: ags.groups.size,
+            },
+            summary: `AGS parsed: ${ags.boreholes.length} boreholes, ${ags.geology.length} geology layers, ${ags.sptResults.length} SPT results, ${ags.groups.size} data groups`,
+        };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: `AGS parse error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+});
+// ---------------------------------------------------------------------------
+// CPT Data Parser with Robertson Classification
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'parse_cpt',
+    description: 'Parse a CPT (Cone Penetration Test) data file and apply Robertson SBTn classification. Returns corrected tip resistance (qt), soil behavior type index (Ic), and layer boundaries. CSV format expected with columns: depth, qc, fs, u2.',
+    parameters: {
+        type: 'object',
+        required: ['path'],
+        properties: {
+            path: { type: 'string', description: 'Path to CPT CSV data file' },
+            waterTableDepth: { type: 'number', description: 'Depth to water table in meters', default: 1.0 },
+            id: { type: 'string', description: 'CPT sounding ID' },
+        },
+    },
+}, (args) => {
+    const filePath = resolve(String(args.path));
+    if (!existsSync(filePath)) {
+        return { success: false, data: null, summary: '', error: `File not found: ${filePath}` };
+    }
+    try {
+        const cpt = parseCPT(filePath, {
+            id: args.id,
+            waterTableDepth: args.waterTableDepth,
+        });
+        return {
+            success: true,
+            data: cpt,
+            summary: `CPT ${cpt.id}: ${cpt.readings.length} readings to ${cpt.summary.maxDepth}m, avg qc=${cpt.summary.avgQc} MPa, dominant: ${cpt.summary.dominantSoilType}, ${cpt.summary.layerBoundaries.length} layer transitions`,
+        };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: `CPT parse error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+});
+// ---------------------------------------------------------------------------
+// Standards Database Query (RAG-like)
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'query_standards',
+    description: 'Search the geotechnical standards database for relevant provisions. Covers: Eurocode 7, ASTM (D2487, D1586, D5778, D4318), Bieniawski RMR, Barton Q-system, Boulanger & Idriss liquefaction, ITA TBM selection, Terzaghi settlement. Use this to cite standards, check design requirements, or verify calculation methods.',
+    parameters: {
+        type: 'object',
+        required: ['query'],
+        properties: {
+            query: { type: 'string', description: 'Search query (e.g. "bearing capacity eurocode", "liquefaction triggering", "RMR support recommendations")' },
+            maxResults: { type: 'number', description: 'Maximum results to return', default: 3 },
+        },
+    },
+}, (args) => {
+    const result = queryStandards(String(args.query), args.maxResults ?? 3);
+    if (result.matches.length === 0) {
+        return { success: true, data: result, summary: `No standards found matching "${args.query}". Try broader terms.` };
+    }
+    const summaryParts = result.matches.map((m) => `${m.standard} §${m.section}: ${m.title}`);
+    return {
+        success: true,
+        data: result,
+        summary: `Found ${result.matches.length} standard provisions: ${summaryParts.join(' | ')}`,
+    };
+});
+// ---------------------------------------------------------------------------
+// Project Management
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'project_create',
+    description: 'Create a new geotechCLI project to store soil profiles, simulation results, and notes persistently across sessions.',
+    parameters: {
+        type: 'object',
+        required: ['name'],
+        properties: {
+            name: { type: 'string', description: 'Project name' },
+            location: { type: 'string', description: 'Project location' },
+            description: { type: 'string', description: 'Brief description' },
+        },
+    },
+}, (args) => {
+    try {
+        const project = createProject(String(args.name), {
+            location: args.location,
+            description: args.description,
+        });
+        return { success: true, data: project.meta, summary: `Project "${project.meta.name}" created (id: ${project.meta.id})` };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: err instanceof Error ? err.message : String(err) };
+    }
+});
+toolRegistry.register({
+    name: 'project_load',
+    description: 'Load an existing project and retrieve its soil profiles, simulation history, and notes.',
+    parameters: {
+        type: 'object',
+        required: ['id'],
+        properties: {
+            id: { type: 'string', description: 'Project ID' },
+        },
+    },
+}, (args) => {
+    try {
+        const project = loadProject(String(args.id));
+        return {
+            success: true,
+            data: project,
+            summary: `Project "${project.meta.name}" loaded: ${project.soilProfiles.length} soil profiles, ${project.simulationResults.length} simulation results, ${project.assumptions.length} assumptions, ${Object.keys(project.namedDatasets).length} datasets`,
+        };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: err instanceof Error ? err.message : String(err) };
+    }
+});
+toolRegistry.register({
+    name: 'project_list',
+    description: 'List all geotechCLI projects stored on this machine.',
+    parameters: { type: 'object', properties: {} },
+}, () => {
+    const projects = listProjects();
+    if (projects.length === 0) {
+        return { success: true, data: [], summary: 'No projects found. Use project_create to start one.' };
+    }
+    return {
+        success: true,
+        data: projects,
+        summary: `${projects.length} projects: ${projects.map((p) => `${p.name} (${p.id})`).join(', ')}`,
+    };
+});
+toolRegistry.register({
+    name: 'project_save_dataset',
+    description: 'Save a structured named dataset into project memory so future agent runs can reuse it. Use for interpreted borehole logs, parameter tables, tabular summaries, or normalized intermediate data.',
+    parameters: {
+        type: 'object',
+        required: ['projectId', 'name', 'kind', 'data'],
+        properties: {
+            projectId: { type: 'string', description: 'Project ID' },
+            name: { type: 'string', description: 'Dataset name or key' },
+            kind: { type: 'string', description: 'Dataset kind, e.g. borehole-log, cpt-summary, assumptions-table' },
+            data: { type: 'object', description: 'Structured dataset content' },
+            source: { type: 'string', description: 'Where the dataset came from' },
+        },
+    },
+}, (args) => {
+    try {
+        saveNamedDataset(String(args.projectId), {
+            name: String(args.name),
+            kind: String(args.kind),
+            data: args.data ?? null,
+            source: args.source,
+        });
+        return { success: true, data: null, summary: `Dataset "${args.name}" saved to project ${args.projectId}` };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: err instanceof Error ? err.message : String(err) };
+    }
+});
+toolRegistry.register({
+    name: 'project_save_parameter',
+    description: 'Persist a derived parameter or key design assumption into project memory for reuse across sessions.',
+    parameters: {
+        type: 'object',
+        required: ['projectId', 'name', 'value'],
+        properties: {
+            projectId: { type: 'string', description: 'Project ID' },
+            name: { type: 'string', description: 'Parameter name' },
+            value: { description: 'Parameter value' },
+            source: { type: 'string', description: 'Source or rationale for the parameter' },
+        },
+    },
+}, (args) => {
+    try {
+        saveDerivedParameter(String(args.projectId), {
+            name: String(args.name),
+            value: args.value ?? null,
+            source: args.source,
+        });
+        return { success: true, data: null, summary: `Parameter "${args.name}" saved to project ${args.projectId}` };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: err instanceof Error ? err.message : String(err) };
+    }
+});
+toolRegistry.register({
+    name: 'project_add_assumption',
+    description: 'Record an engineering assumption in project memory, including its basis when known.',
+    parameters: {
+        type: 'object',
+        required: ['projectId', 'text'],
+        properties: {
+            projectId: { type: 'string', description: 'Project ID' },
+            text: { type: 'string', description: 'Assumption text' },
+            source: { type: 'string', description: 'Basis, source, or standard used' },
+        },
+    },
+}, (args) => {
+    try {
+        addAssumption(String(args.projectId), {
+            text: String(args.text),
+            source: args.source,
+        });
+        return { success: true, data: null, summary: `Assumption recorded in project ${args.projectId}` };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: err instanceof Error ? err.message : String(err) };
+    }
+});
+toolRegistry.register({
+    name: 'project_add_artifact',
+    description: 'Save a report, note, or generated artifact reference into project memory for later review.',
+    parameters: {
+        type: 'object',
+        required: ['projectId', 'kind', 'title'],
+        properties: {
+            projectId: { type: 'string', description: 'Project ID' },
+            kind: { type: 'string', description: 'Artifact kind, e.g. report, memo, output-file' },
+            title: { type: 'string', description: 'Human-readable artifact title' },
+            content: { type: 'string', description: 'Inline artifact content if stored directly' },
+            path: { type: 'string', description: 'Filesystem path if artifact was written to disk' },
+            mimeType: { type: 'string', description: 'Artifact MIME type' },
+            metadata: { type: 'object', description: 'Additional artifact metadata' },
+        },
+    },
+}, (args) => {
+    try {
+        addArtifact(String(args.projectId), {
+            kind: String(args.kind),
+            title: String(args.title),
+            content: args.content,
+            path: args.path,
+            mimeType: args.mimeType,
+            metadata: args.metadata ?? undefined,
+        });
+        return { success: true, data: null, summary: `Artifact "${args.title}" saved to project ${args.projectId}` };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: err instanceof Error ? err.message : String(err) };
+    }
+});
+toolRegistry.register({
+    name: 'project_save_result',
+    description: 'Save a calculation result to the current project for future reference. The agent should call this after completing analyses to build a persistent project history.',
+    parameters: {
+        type: 'object',
+        required: ['projectId', 'tool', 'summary'],
+        properties: {
+            projectId: { type: 'string', description: 'Project ID' },
+            tool: { type: 'string', description: 'Tool name that produced the result' },
+            args: { type: 'object', description: 'Arguments used' },
+            result: { type: 'object', description: 'Calculation result data' },
+            summary: { type: 'string', description: 'One-line summary of the result' },
+        },
+    },
+}, (args) => {
+    try {
+        addSimulationResult(String(args.projectId), {
+            tool: String(args.tool),
+            args: args.args ?? {},
+            result: args.result ?? null,
+            summary: String(args.summary),
+        });
+        return { success: true, data: null, summary: `Result saved to project ${args.projectId}` };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: err instanceof Error ? err.message : String(err) };
+    }
+});
+//# sourceMappingURL=data-tools.js.map

package/dist/agents/data-tools.js.map

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

package/dist/agents/filesystem-tools.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filesystem-tools.d.ts.map

package/dist/agents/filesystem-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-tools.d.ts","sourceRoot":"","sources":["../../src/agents/filesystem-tools.ts"],"names":[],"mappings":""}

package/dist/agents/filesystem-tools.js

@@ -0,0 +1,267 @@
+import { readFileSync, readdirSync, writeFileSync, existsSync, statSync } from 'node:fs';
+import { join, extname, basename } from 'node:path';
+import { toolRegistry } from './tools.js';
+import { validateReadPath, validateWritePath } from './sandbox.js';
+// ---------------------------------------------------------------------------
+// File reading (sandboxed)
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'read_file',
+    description: 'Read the contents of a file from disk. Supports text files: .csv, .json, .txt, .ags, .log, .md. Returns the file content as text. Files must be in the current working directory or workspace.',
+    parameters: {
+        type: 'object',
+        required: ['path'],
+        properties: {
+            path: { type: 'string', description: 'Absolute or relative file path' },
+            maxLines: { type: 'number', description: 'Maximum number of lines to read (default: 200)', default: 200 },
+        },
+    },
+}, (args) => {
+    const check = validateReadPath(String(args.path));
+    if (!check.safe) {
+        return { success: false, data: null, summary: '', error: check.error };
+    }
+    const filePath = check.resolved;
+    if (!existsSync(filePath)) {
+        return { success: false, data: null, summary: '', error: `File not found: ${filePath}` };
+    }
+    const stat = statSync(filePath);
+    if (stat.isDirectory()) {
+        return { success: false, data: null, summary: '', error: 'Path is a directory. Use list_directory instead.' };
+    }
+    const ext = extname(filePath).toLowerCase();
+    const allowedExts = ['.csv', '.json', '.txt', '.ags', '.log', '.md', '.toml', '.yaml', '.yml', '.xml', '.tsv', '.dat', '.gef'];
+    if (!allowedExts.includes(ext)) {
+        return { success: false, data: null, summary: '', error: `Unsupported file type: ${ext}. Supported: ${allowedExts.join(', ')}` };
+    }
+    if (stat.size > 5 * 1024 * 1024) {
+        return { success: false, data: null, summary: '', error: `File too large (${(stat.size / 1024 / 1024).toFixed(1)} MB). Max 5 MB.` };
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const maxLines = args.maxLines ?? 200;
+    const truncated = lines.length > maxLines;
+    const output = truncated ? lines.slice(0, maxLines).join('\n') : content;
+    return {
+        success: true,
+        data: { path: filePath, lines: lines.length, truncated, content: output },
+        summary: `Read ${filePath}: ${lines.length} lines, ${(stat.size / 1024).toFixed(1)} KB${truncated ? ` (showing first ${maxLines})` : ''}`,
+    };
+});
+// ---------------------------------------------------------------------------
+// Directory listing (sandboxed)
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'list_directory',
+    description: 'List files and subdirectories in a folder. Restricted to working directory and workspace.',
+    parameters: {
+        type: 'object',
+        required: ['path'],
+        properties: {
+            path: { type: 'string', description: 'Directory path' },
+            pattern: { type: 'string', description: 'Filter by extension, e.g. ".csv"' },
+        },
+    },
+}, (args) => {
+    const check = validateReadPath(String(args.path));
+    if (!check.safe)
+        return { success: false, data: null, summary: '', error: check.error };
+    const dirPath = check.resolved;
+    if (!existsSync(dirPath) || !statSync(dirPath).isDirectory()) {
+        return { success: false, data: null, summary: '', error: `Not a directory: ${dirPath}` };
+    }
+    const entries = readdirSync(dirPath, { withFileTypes: true });
+    const pattern = args.pattern ? String(args.pattern).toLowerCase() : null;
+    const files = entries
+        .map((entry) => {
+        const fullPath = join(dirPath, entry.name);
+        const isDir = entry.isDirectory();
+        let size = 0;
+        if (!isDir) {
+            try {
+                size = statSync(fullPath).size;
+            }
+            catch { /* skip */ }
+        }
+        return {
+            name: entry.name,
+            type: isDir ? 'directory' : extname(entry.name).toLowerCase() || 'file',
+            size: isDir ? null : size,
+            sizeHuman: isDir ? '-' : size > 1048576 ? `${(size / 1048576).toFixed(1)} MB` : `${(size / 1024).toFixed(1)} KB`,
+        };
+    })
+        .filter((f) => !pattern || f.type === pattern || f.type === 'directory')
+        .sort((a, b) => {
+        if (a.type === 'directory' && b.type !== 'directory')
+            return -1;
+        if (a.type !== 'directory' && b.type === 'directory')
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    const dirs = files.filter((f) => f.type === 'directory').length;
+    return {
+        success: true,
+        data: { path: dirPath, entries: files },
+        summary: `${dirPath}: ${files.length - dirs} files, ${dirs} directories${pattern ? ` (filtered: ${pattern})` : ''}`,
+    };
+});
+// ---------------------------------------------------------------------------
+// Parse CSV (sandboxed)
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'parse_csv',
+    description: 'Read and parse a CSV file into structured rows. Returns column names and row data.',
+    parameters: {
+        type: 'object',
+        required: ['path'],
+        properties: {
+            path: { type: 'string', description: 'Path to CSV file' },
+            delimiter: { type: 'string', description: 'Column delimiter', default: ',' },
+            maxRows: { type: 'number', description: 'Max rows to parse', default: 500 },
+        },
+    },
+}, (args) => {
+    const check = validateReadPath(String(args.path));
+    if (!check.safe)
+        return { success: false, data: null, summary: '', error: check.error };
+    const filePath = check.resolved;
+    if (!existsSync(filePath))
+        return { success: false, data: null, summary: '', error: `File not found: ${filePath}` };
+    const content = readFileSync(filePath, 'utf-8');
+    const delimiter = String(args.delimiter ?? ',');
+    const lines = content.trim().split('\n');
+    const maxRows = args.maxRows ?? 500;
+    if (lines.length === 0)
+        return { success: false, data: null, summary: '', error: 'Empty CSV file' };
+    const headers = lines[0].split(delimiter).map((h) => h.trim().replace(/^["']|["']$/g, ''));
+    const rows = [];
+    for (let i = 1; i < Math.min(lines.length, maxRows + 1); i++) {
+        const cols = lines[i].split(delimiter).map((c) => c.trim().replace(/^["']|["']$/g, ''));
+        const row = {};
+        headers.forEach((h, ci) => {
+            const val = cols[ci] ?? '';
+            const num = Number(val);
+            row[h] = val !== '' && !isNaN(num) ? num : val;
+        });
+        rows.push(row);
+    }
+    return {
+        success: true,
+        data: { path: filePath, headers, rowCount: rows.length, totalRows: lines.length - 1, rows },
+        summary: `Parsed ${basename(filePath)}: ${headers.length} columns (${headers.slice(0, 5).join(', ')}${headers.length > 5 ? '...' : ''}), ${rows.length} rows`,
+    };
+});
+// ---------------------------------------------------------------------------
+// Write file (sandboxed — CWD/workspace only)
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'write_file',
+    description: 'Save text content or JSON data to a file. Only writes to the current directory or workspace.',
+    parameters: {
+        type: 'object',
+        required: ['path', 'content'],
+        properties: {
+            path: { type: 'string', description: 'Output file path' },
+            content: { type: 'string', description: 'Content to write' },
+        },
+    },
+}, (args) => {
+    const check = validateWritePath(String(args.path));
+    if (!check.safe)
+        return { success: false, data: null, summary: '', error: check.error };
+    const filePath = check.resolved;
+    const content = String(args.content);
+    if (content.length > 10 * 1024 * 1024) {
+        return { success: false, data: null, summary: '', error: 'Content exceeds 10 MB write limit.' };
+    }
+    try {
+        writeFileSync(filePath, content, 'utf-8');
+        return {
+            success: true,
+            data: { path: filePath, size: content.length },
+            summary: `Written ${(content.length / 1024).toFixed(1)} KB to ${filePath}`,
+        };
+    }
+    catch (err) {
+        return { success: false, data: null, summary: '', error: `Write failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+});
+// ---------------------------------------------------------------------------
+// Scan project (sandboxed)
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'scan_project',
+    description: 'Scan a project directory and identify geotechnical data files.',
+    parameters: {
+        type: 'object',
+        required: ['path'],
+        properties: { path: { type: 'string', description: 'Project directory path' } },
+    },
+}, (args) => {
+    const check = validateReadPath(String(args.path));
+    if (!check.safe)
+        return { success: false, data: null, summary: '', error: check.error };
+    const dirPath = check.resolved;
+    if (!existsSync(dirPath) || !statSync(dirPath).isDirectory()) {
+        return { success: false, data: null, summary: '', error: `Directory not found: ${dirPath}` };
+    }
+    const categories = {
+        boreholeData: [], sptCptData: [], soilTestResults: [], sensorData: [],
+        gisFiles: [], cadFiles: [], plaxisModels: [], flacModels: [],
+        reports: [], images: [], other: [],
+    };
+    function scanDir(dir, depth = 0) {
+        if (depth > 3)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                scanDir(full, depth + 1);
+                continue;
+            }
+            const ext = extname(entry.name).toLowerCase();
+            const name = entry.name.toLowerCase();
+            const rel = full.replace(dirPath + '/', '');
+            if (ext === '.ags' || name.includes('borehole'))
+                categories.boreholeData.push(rel);
+            else if (name.includes('spt') || name.includes('cpt'))
+                categories.sptCptData.push(rel);
+            else if (name.includes('triaxial') || name.includes('consolidation') || name.includes('atterberg'))
+                categories.soilTestResults.push(rel);
+            else if (name.includes('piezometer') || name.includes('inclinometer') || name.includes('sensor'))
+                categories.sensorData.push(rel);
+            else if (['.geojson', '.shp', '.kml', '.kmz'].includes(ext))
+                categories.gisFiles.push(rel);
+            else if (['.dxf', '.dwg'].includes(ext))
+                categories.cadFiles.push(rel);
+            else if (['.plx', '.p2d', '.p3d'].includes(ext))
+                categories.plaxisModels.push(rel);
+            else if (['.sav', '.f3sav', '.fis'].includes(ext))
+                categories.flacModels.push(rel);
+            else if (['.pdf', '.docx', '.xlsx'].includes(ext))
+                categories.reports.push(rel);
+            else if (['.jpg', '.jpeg', '.png', '.tif'].includes(ext))
+                categories.images.push(rel);
+            else if (['.csv', '.json', '.txt', '.dat', '.tsv'].includes(ext))
+                categories.other.push(rel);
+        }
+    }
+    scanDir(dirPath);
+    const totalFiles = Object.values(categories).flat().length;
+    const nonEmpty = Object.entries(categories).filter(([, f]) => f.length > 0);
+    return {
+        success: true,
+        data: { path: dirPath, categories, totalFiles },
+        summary: `Project scan: ${totalFiles} files — ${nonEmpty.map(([c, f]) => `${f.length} ${c}`).join(', ')}`,
+    };
+});
+//# sourceMappingURL=filesystem-tools.js.map

package/dist/agents/filesystem-tools.js.map

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

package/dist/agents/guardrails.d.ts

@@ -0,0 +1,17 @@
+export interface GuardrailResult {
+    passed: boolean;
+    violations: GuardrailViolation[];
+}
+export interface GuardrailViolation {
+    parameter: string;
+    value: unknown;
+    rule: string;
+    severity: 'error' | 'warning';
+    correction: string;
+}
+export declare function validateToolArgs(toolName: string, args: Record<string, unknown>): GuardrailResult;
+/**
+ * Format violations as a string the agent can read and act on.
+ */
+export declare function formatViolations(result: GuardrailResult): string;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/agents/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/agents/guardrails.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AA0MD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAajG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAahE"}