@geotechcli/core 0.2.0

package/dist/agents/brain.d.ts

@@ -0,0 +1,39 @@
+import type { LLMConfig } from '../llm/types.js';
+import { type ToolResult } from './tools.js';
+import './filesystem-tools.js';
+import './bridge-tools.js';
+import './data-tools.js';
+export interface AgentStep {
+    type: 'thought' | 'tool_call' | 'tool_result' | 'answer' | 'error';
+    content: string;
+    toolName?: string;
+    toolArgs?: Record<string, unknown>;
+    toolResult?: ToolResult;
+    timestamp: number;
+}
+export interface AgentSession {
+    steps: AgentStep[];
+    context: Record<string, unknown>;
+    totalTokens: number;
+    totalLatencyMs: number;
+}
+export type AgentCallback = (step: AgentStep) => void;
+export declare function runAgent(userQuery: string, config: LLMConfig, onStep: AgentCallback, sessionContext?: Record<string, unknown>): Promise<AgentSession>;
+export declare class AgentConversation {
+    private context;
+    private history;
+    constructor(options?: {
+        context?: Record<string, unknown>;
+        history?: AgentSession[];
+    });
+    ask(query: string, config: LLMConfig, onStep: AgentCallback): Promise<AgentSession>;
+    hydrate(options: {
+        context?: Record<string, unknown>;
+        history?: AgentSession[];
+    }): void;
+    replaceContext(context: Record<string, unknown>): void;
+    getContext(): Record<string, unknown>;
+    getHistory(): AgentSession[];
+    clearContext(): void;
+}
+//# sourceMappingURL=brain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/agents/brain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAsB,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAK3D,OAAO,uBAAuB,CAAC;AAC/B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,iBAAiB,CAAC;AAMzB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AAiHtD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC,YAAY,CAAC,CAqOvB;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE;IAK/E,GAAG,CACP,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,CAAC;IAOxB,OAAO,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,GAAG,IAAI;IAKvF,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAItD,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIrC,UAAU,IAAI,YAAY,EAAE;IAI5B,YAAY,IAAI,IAAI;CAGrB"}

package/dist/agents/brain.js

@@ -0,0 +1,339 @@
+import { generateChat } from '../llm/router.js';
+import { toolRegistry } from './tools.js';
+import { validateToolArgs, formatViolations } from './guardrails.js';
+import { extractToolSafetyIssue, serializeContextForPrompt } from './safety.js';
+// Side-effect imports: these files register tools into the shared registry
+import './filesystem-tools.js';
+import './bridge-tools.js';
+import './data-tools.js';
+// ---------------------------------------------------------------------------
+// System prompt
+// ---------------------------------------------------------------------------
+function buildSystemPrompt() {
+    const toolDescriptions = toolRegistry.toToolDescriptions();
+    return `You are geotechCLI Agent, an expert geotechnical engineering AI that solves problems by EXECUTING real calculations, not just describing them.
+
+## YOUR TOOLS
+You have access to the following deterministic computation engines. These produce REAL engineering results with validated formulas:
+
+${toolDescriptions}
+
+## HOW TO USE TOOLS
+To call a tool, output EXACTLY this JSON block (no other text before or after it on that line):
+\`\`\`tool
+{"tool": "<tool_name>", "args": {<arguments as JSON>}}
+\`\`\`
+
+You will receive the tool's result immediately. Then you MUST reason about the result before deciding what to do next.
+
+## WORKFLOW (ReAct Pattern)
+For every request, follow this loop:
+
+1. THINK: Analyze what the user needs. What calculations are required? What data do you have? What assumptions are needed?
+2. ACT: Call the appropriate tool with the right parameters.
+3. OBSERVE: Read the tool's result carefully. Extract key values.
+4. REASON: Interpret the result in engineering context. Is the value acceptable? Does it trigger additional checks?
+5. REPEAT or ANSWER: If more calculations are needed, go back to step 2. Otherwise, provide your final answer.
+
+## RULES
+- ALWAYS use tools for calculations. Never invent numbers or estimate what a formula would produce.
+- If the user provides incomplete data, state your assumptions clearly before calling tools.
+- Chain multiple tools when engineering judgment requires it.
+- Reference actual standards: Terzaghi, Meyerhof, Bieniawski, Barton, Boulanger & Idriss, etc.
+- Report tool results with proper units and significant figures.
+- If a tool returns parseStatus/confidence metadata with canAutoProceed=false, treat it as blocked evidence. Do not continue downstream deterministic calculations from it until you retry, request better input, or explain the limitation.
+- When the analysis is complete, provide a clear engineering recommendation with supporting numbers.
+
+## FINAL ANSWER
+When you have completed all necessary calculations and reasoning, provide your final answer as clear prose. Do NOT output a tool call in your final answer. Include:
+- Summary of all calculations performed (with key numbers)
+- Engineering interpretation
+- Recommendations with supporting evidence
+- Any limitations or assumptions made`;
+}
+// ---------------------------------------------------------------------------
+// Context window management
+// ---------------------------------------------------------------------------
+const COMPRESS_THRESHOLD = 40_000;
+function totalChars(messages) {
+    return messages.reduce((sum, message) => sum + message.content.length, 0);
+}
+function compressMessages(messages) {
+    if (messages.length <= 4)
+        return messages;
+    const system = messages[0];
+    const userQuery = messages[1];
+    const keepLast = 4;
+    const tail = messages.slice(-keepLast);
+    const middle = messages.slice(2, -keepLast);
+    if (middle.length === 0)
+        return messages;
+    const summaryParts = [];
+    for (const message of middle) {
+        if (message.role === 'user' && message.content.startsWith('[Tool Result:')) {
+            const lines = message.content.split('\n');
+            const toolName = lines[0].replace('[Tool Result: ', '').replace(']', '');
+            const summaryLine = lines[1] ?? '';
+            summaryParts.push(`${toolName}: ${summaryLine}`);
+            continue;
+        }
+        if (message.role === 'user' && message.content.startsWith('[GUARDRAIL BLOCKED:')) {
+            summaryParts.push(message.content.split('\n')[0]);
+            continue;
+        }
+        if (message.role === 'user' && message.content.startsWith('[Tool Blocked:')) {
+            summaryParts.push(message.content.split('\n')[0]);
+        }
+    }
+    return [
+        system,
+        userQuery,
+        {
+            role: 'user',
+            content: `[Context summary - ${summaryParts.length} prior tool exchanges compressed]\n${summaryParts.join('\n')}\n\nContinue your analysis based on these results and the most recent exchange.`,
+        },
+        ...tail,
+    ];
+}
+// ---------------------------------------------------------------------------
+// Agent Brain
+// ---------------------------------------------------------------------------
+const MAX_ITERATIONS = 12;
+export async function runAgent(userQuery, config, onStep, sessionContext) {
+    const session = {
+        steps: [],
+        context: { ...(sessionContext ?? {}) },
+        totalTokens: 0,
+        totalLatencyMs: 0,
+    };
+    const messages = [
+        { role: 'system', content: buildSystemPrompt() },
+    ];
+    const serializedContext = serializeContextForPrompt(sessionContext);
+    const userContent = serializedContext
+        ? `[Prior session context]\n${serializedContext}\n\nCurrent request: ${userQuery}`
+        : userQuery;
+    messages.push({ role: 'user', content: userContent });
+    for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
+        if (totalChars(messages) > COMPRESS_THRESHOLD) {
+            const compressed = compressMessages(messages);
+            messages.length = 0;
+            messages.push(...compressed);
+        }
+        let response;
+        try {
+            response = await generateChat(messages, config, {
+                temperature: 0.2,
+                maxTokens: 2048,
+            });
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            const step = {
+                type: 'error',
+                content: `LLM error: ${errMsg}`,
+                timestamp: Date.now(),
+            };
+            session.steps.push(step);
+            onStep(step);
+            break;
+        }
+        session.totalTokens += response.usage.totalTokens;
+        session.totalLatencyMs += response.latencyMs;
+        const llmOutput = response.text;
+        messages.push({ role: 'assistant', content: llmOutput });
+        const toolCallMatch = llmOutput.match(/```tool\s*\n?([\s\S]*?)\n?```/);
+        if (!toolCallMatch) {
+            const answerStep = {
+                type: 'answer',
+                content: llmOutput,
+                timestamp: Date.now(),
+            };
+            session.steps.push(answerStep);
+            onStep(answerStep);
+            break;
+        }
+        const textBeforeTool = llmOutput.slice(0, toolCallMatch.index).trim();
+        if (textBeforeTool) {
+            const thoughtStep = {
+                type: 'thought',
+                content: textBeforeTool,
+                timestamp: Date.now(),
+            };
+            session.steps.push(thoughtStep);
+            onStep(thoughtStep);
+        }
+        let toolCall;
+        try {
+            toolCall = JSON.parse(toolCallMatch[1]);
+        }
+        catch {
+            const errStep = {
+                type: 'error',
+                content: 'Failed to parse tool call JSON. Retrying...',
+                timestamp: Date.now(),
+            };
+            session.steps.push(errStep);
+            onStep(errStep);
+            messages.push({
+                role: 'user',
+                content: 'Invalid tool call JSON. Output the tool call as valid JSON inside ```tool blocks.',
+            });
+            continue;
+        }
+        const callStep = {
+            type: 'tool_call',
+            content: `Calling ${toolCall.tool}`,
+            toolName: toolCall.tool,
+            toolArgs: toolCall.args,
+            timestamp: Date.now(),
+        };
+        session.steps.push(callStep);
+        onStep(callStep);
+        const guardrailCheck = validateToolArgs(toolCall.tool, toolCall.args);
+        if (!guardrailCheck.passed) {
+            const violationText = formatViolations(guardrailCheck);
+            const guardStep = {
+                type: 'error',
+                content: `Guardrail blocked ${toolCall.tool}: ${guardrailCheck.violations.filter((violation) => violation.severity === 'error').map((violation) => violation.rule).join('; ')}`,
+                toolName: toolCall.tool,
+                timestamp: Date.now(),
+            };
+            session.steps.push(guardStep);
+            onStep(guardStep);
+            messages.push({
+                role: 'user',
+                content: `[GUARDRAIL BLOCKED: ${toolCall.tool}]\n${violationText}\n\nYour tool call was BLOCKED because parameters violate physical or engineering constraints. Read the corrections above and call the tool again with fixed parameters.`,
+            });
+            continue;
+        }
+        if (guardrailCheck.violations.length > 0) {
+            const warnStep = {
+                type: 'thought',
+                content: `Guardrail warnings: ${guardrailCheck.violations.map((violation) => violation.rule).join('; ')}`,
+                timestamp: Date.now(),
+            };
+            session.steps.push(warnStep);
+            onStep(warnStep);
+        }
+        const result = await toolRegistry.execute(toolCall.tool, toolCall.args);
+        if (!result.success) {
+            const errorStep = {
+                type: 'error',
+                content: `Tool failed: ${result.error}`,
+                toolName: toolCall.tool,
+                toolResult: result,
+                timestamp: Date.now(),
+            };
+            session.steps.push(errorStep);
+            onStep(errorStep);
+            messages.push({
+                role: 'user',
+                content: `[Tool FAILED: ${toolCall.tool}]\nError: ${result.error}\n\nThe tool execution failed. Either:\n1. Fix the parameters and retry\n2. Try an alternative approach\n3. If unrecoverable, explain the limitation in your final answer`,
+            });
+            continue;
+        }
+        const resultStep = {
+            type: 'tool_result',
+            content: result.summary,
+            toolName: toolCall.tool,
+            toolResult: result,
+            timestamp: Date.now(),
+        };
+        session.steps.push(resultStep);
+        onStep(resultStep);
+        session.context[toolCall.tool] = result.data;
+        const safetyIssue = extractToolSafetyIssue(result.data);
+        if (safetyIssue) {
+            const blockedStep = {
+                type: 'error',
+                content: `${toolCall.tool} returned blocked output: ${safetyIssue.message}`,
+                toolName: toolCall.tool,
+                toolResult: result,
+                timestamp: Date.now(),
+            };
+            session.steps.push(blockedStep);
+            onStep(blockedStep);
+            messages.push({
+                role: 'user',
+                content: `[Tool Blocked: ${toolCall.tool}]\n${safetyIssue.message}\nWarnings: ${safetyIssue.warnings.join('; ') || 'None'}\n\nDo NOT continue downstream deterministic calculations from this output. Retry with better inputs, ask the user for clarification, or explain the limitation in your final answer.`,
+            });
+            continue;
+        }
+        const compactData = JSON.stringify(result.data);
+        const dataStr = compactData.length > 3000 ? `${compactData.slice(0, 3000)}...(truncated)` : compactData;
+        messages.push({
+            role: 'user',
+            content: `[Tool Result: ${toolCall.tool}]\n${result.summary}\nData: ${dataStr}\n\nAnalyze this result. Do you need more calculations, or can you provide the final answer?`,
+        });
+    }
+    if (session.steps.length > 0 && session.steps[session.steps.length - 1].type !== 'answer') {
+        messages.push({
+            role: 'user',
+            content: 'You have used all available iterations. Provide your final engineering answer now based on all tool results gathered so far. Do NOT call any more tools.',
+        });
+        try {
+            const finalResponse = await generateChat(messages, config, {
+                temperature: 0.2,
+                maxTokens: 3000,
+            });
+            session.totalTokens += finalResponse.usage.totalTokens;
+            session.totalLatencyMs += finalResponse.latencyMs;
+            const finalStep = {
+                type: 'answer',
+                content: finalResponse.text,
+                timestamp: Date.now(),
+            };
+            session.steps.push(finalStep);
+            onStep(finalStep);
+        }
+        catch {
+            const summaryStep = {
+                type: 'answer',
+                content: 'Agent reached maximum iterations. Results collected:\n' +
+                    session.steps
+                        .filter((step) => step.type === 'tool_result' && step.toolResult?.success)
+                        .map((step) => `- ${step.content}`)
+                        .join('\n'),
+                timestamp: Date.now(),
+            };
+            session.steps.push(summaryStep);
+            onStep(summaryStep);
+        }
+    }
+    return session;
+}
+// ---------------------------------------------------------------------------
+// Convenience: run with session memory
+// ---------------------------------------------------------------------------
+export class AgentConversation {
+    context = {};
+    history = [];
+    constructor(options) {
+        this.context = { ...(options?.context ?? {}) };
+        this.history = [...(options?.history ?? [])];
+    }
+    async ask(query, config, onStep) {
+        const session = await runAgent(query, config, onStep, this.context);
+        this.context = { ...this.context, ...session.context };
+        this.history.push(session);
+        return session;
+    }
+    hydrate(options) {
+        this.context = { ...(options.context ?? {}) };
+        this.history = [...(options.history ?? [])];
+    }
+    replaceContext(context) {
+        this.context = { ...context };
+    }
+    getContext() {
+        return { ...this.context };
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    clearContext() {
+        this.context = {};
+    }
+}
+//# sourceMappingURL=brain.js.map

package/dist/agents/brain.js.map

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

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

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

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

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

package/dist/agents/bridge-tools.js

@@ -0,0 +1,170 @@
+import { toolRegistry } from './tools.js';
+import { execSync } from 'node:child_process';
+import { validateShellCommand } from './sandbox.js';
+// ---------------------------------------------------------------------------
+// PLAXIS Remote Scripting API
+// ---------------------------------------------------------------------------
+async function plaxisRequest(endpoint, method, body, port = 10000) {
+    try {
+        const res = await fetch(`http://localhost:${port}${endpoint}`, {
+            method,
+            headers: body ? { 'Content-Type': 'application/json' } : undefined,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!res.ok)
+            return { ok: false, data: null, error: `PLAXIS returned ${res.status}` };
+        const data = await res.json().catch(() => res.text());
+        return { ok: true, data };
+    }
+    catch (err) {
+        return {
+            ok: false, data: null,
+            error: `Cannot reach PLAXIS at localhost:${port}. Ensure PLAXIS is running with Remote Scripting enabled.`,
+        };
+    }
+}
+toolRegistry.register({
+    name: 'plaxis_execute',
+    description: 'Send a Python command to a running PLAXIS 2D/3D instance via Remote Scripting API.',
+    parameters: {
+        type: 'object',
+        required: ['command'],
+        properties: {
+            command: { type: 'string', description: 'Python command for PLAXIS' },
+            port: { type: 'number', description: 'PLAXIS scripting server port', default: 10000 },
+        },
+    },
+}, async (args) => {
+    const command = String(args.command);
+    const port = args.port ?? 10000;
+    const dangerous = ['import os', 'import sys', 'subprocess', 'exec(', 'eval(', '__import__', 'shutil', 'rmtree', 'open(', 'write(', 'unlink'];
+    if (dangerous.some((d) => command.toLowerCase().includes(d))) {
+        return { success: false, data: null, summary: '', error: 'Command blocked: contains potentially dangerous operations.' };
+    }
+    const result = await plaxisRequest('/commands', 'POST', { commands: [command] }, port);
+    if (!result.ok)
+        return { success: false, data: null, summary: '', error: result.error ?? 'PLAXIS command failed' };
+    return {
+        success: true,
+        data: result.data,
+        summary: `PLAXIS executed: ${command.slice(0, 60)} → ${JSON.stringify(result.data).slice(0, 120)}`,
+    };
+});
+toolRegistry.register({
+    name: 'plaxis_get_results',
+    description: 'Extract calculation results from a PLAXIS model.',
+    parameters: {
+        type: 'object',
+        required: ['phase', 'resultType'],
+        properties: {
+            phase: { type: 'string', description: 'Phase name (e.g. "Phase_1")' },
+            resultType: { type: 'string', enum: ['displacement', 'stress', 'force', 'plastic_points', 'pore_pressure', 'factor_of_safety'] },
+            location: { type: 'string', description: 'Specific point or node' },
+            port: { type: 'number', default: 10000 },
+        },
+    },
+}, (args) => {
+    const phase = String(args.phase);
+    const resultType = String(args.resultType);
+    const resultCommands = {
+        displacement: `g_i.getresults(g_i.${phase}, g_i.ResultTypes.Soil.Utot, 'max')`,
+        stress: `g_i.getresults(g_i.${phase}, g_i.ResultTypes.Soil.SigmaXXeff, 'min')`,
+        force: `g_i.getresults(g_i.${phase}, g_i.ResultTypes.Plate.M2D, 'max')`,
+        plastic_points: `g_i.getresults(g_i.${phase}, g_i.ResultTypes.Soil.PlasticPointStatus, 'count')`,
+        pore_pressure: `g_i.getresults(g_i.${phase}, g_i.ResultTypes.Soil.PExcess, 'max')`,
+        factor_of_safety: `g_i.getresults(g_i.${phase}, g_i.ResultTypes.Soil.SumMsf, 'max')`,
+    };
+    const cmd = resultCommands[resultType];
+    if (!cmd)
+        return { success: false, data: null, summary: '', error: `Unknown result type: ${resultType}` };
+    return {
+        success: true,
+        data: { phase, resultType, command: cmd },
+        summary: `PLAXIS result query: ${resultType} from ${phase}`,
+    };
+});
+toolRegistry.register({
+    name: 'flac3d_execute',
+    description: 'Generate a FISH/command-line instruction for FLAC3D. Commands are generated for manual execution.',
+    parameters: {
+        type: 'object',
+        required: ['command'],
+        properties: {
+            command: { type: 'string', description: 'FLAC command or FISH code' },
+            port: { type: 'number', default: 5000 },
+        },
+    },
+}, (args) => {
+    const command = String(args.command);
+    return {
+        success: true,
+        data: { command, port: args.port ?? 5000 },
+        summary: `FLAC3D command queued: ${command.slice(0, 80)}`,
+    };
+});
+toolRegistry.register({
+    name: 'rocscience_execute',
+    description: 'Generate a Python command for Rocscience RS2/RS3/Slide scripting API.',
+    parameters: {
+        type: 'object',
+        required: ['command'],
+        properties: {
+            command: { type: 'string', description: 'Python command for Rocscience' },
+            software: { type: 'string', enum: ['rs2', 'rs3', 'slide', 'slide2'], default: 'rs2' },
+            port: { type: 'number', default: 8080 },
+        },
+    },
+}, (args) => {
+    const command = String(args.command);
+    return {
+        success: true,
+        data: { command, software: args.software ?? 'rs2', port: args.port ?? 8080 },
+        summary: `Rocscience ${args.software ?? 'RS2'} command queued: ${command.slice(0, 80)}`,
+    };
+});
+// ---------------------------------------------------------------------------
+// Shell command execution (sandboxed via sandbox.ts)
+// ---------------------------------------------------------------------------
+toolRegistry.register({
+    name: 'run_command',
+    description: 'Execute a safe, read-only shell command. Only allows: ls, cat, head, tail, wc, find, grep, file, stat, du, pwd, echo, python <script.py>. No pipes, redirects, or chaining.',
+    parameters: {
+        type: 'object',
+        required: ['command'],
+        properties: {
+            command: { type: 'string', description: 'Shell command to execute' },
+            cwd: { type: 'string', description: 'Working directory' },
+        },
+    },
+}, (args) => {
+    const command = String(args.command);
+    // SANDBOX: validate command through centralized sandbox
+    const check = validateShellCommand(command);
+    if (!check.safe) {
+        return { success: false, data: null, summary: '', error: check.error };
+    }
+    try {
+        const cwd = args.cwd ? String(args.cwd) : process.cwd();
+        const output = execSync(command, {
+            cwd,
+            timeout: 15_000,
+            maxBuffer: 1024 * 1024,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const lines = output.trim().split('\n');
+        const truncated = lines.length > 100;
+        const shown = truncated ? lines.slice(0, 100).join('\n') + '\n... (truncated)' : output.trim();
+        return {
+            success: true,
+            data: { command, cwd, output: shown, lines: lines.length },
+            summary: `Executed: ${command} → ${lines.length} lines output`,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message.split('\n')[0] : String(err);
+        return { success: false, data: null, summary: '', error: `Command failed: ${msg}` };
+    }
+});
+//# sourceMappingURL=bridge-tools.js.map

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

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

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

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

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

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