@trenchwork/erosolar 1.1.30 → 1.1.32

package/dist/capabilities/aflppCapability.js

@@ -0,0 +1,301 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { logDebug } from '../utils/debugLogger.js';
+import { runBinary, formatResult } from './_processRunner.js';
+import { getSharedArtifactStore } from '../core/artifactStore.js';
+const JOBS_ROOT = join(homedir(), '.erosolar', 'jobs', 'aflpp');
+function ensureJobsDir() {
+    if (!existsSync(JOBS_ROOT))
+        mkdirSync(JOBS_ROOT, { recursive: true });
+}
+function jobStatePath(jobId) {
+    return join(JOBS_ROOT, `${jobId}.json`);
+}
+function readJob(jobId) {
+    const p = jobStatePath(jobId);
+    if (!existsSync(p))
+        return null;
+    return JSON.parse(readFileSync(p, 'utf8'));
+}
+function writeJob(record) {
+    ensureJobsDir();
+    writeFileSync(jobStatePath(record.jobId), JSON.stringify(record, null, 2), 'utf8');
+}
+function isAlive(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function buildAflppTools() {
+    return [
+        {
+            name: 'afl_fuzz_start',
+            description: 'Start an AFL++ fuzz campaign as a detached background process. Returns a jobId. Poll via afl_fuzz_status, terminate via afl_fuzz_stop. Harness must be AFL-instrumented (afl-clang-fast / afl-cc).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    harness: { type: 'string', description: 'Path to AFL-instrumented binary' },
+                    inputDir: { type: 'string', description: 'Seed corpus directory (-i)' },
+                    outputDir: { type: 'string', description: 'Findings directory (-o)' },
+                    dictionary: { type: 'string', description: 'Optional dictionary path (-x)' },
+                    memoryLimitMB: { type: 'number', description: '-m memory limit MB (omit for none)' },
+                    extraArgs: { type: 'array', items: { type: 'string' }, description: 'Extra afl-fuzz args before --' },
+                    targetArgs: { type: 'array', items: { type: 'string' }, description: 'Args after -- passed to harness; use @@ for input file marker' },
+                },
+                required: ['harness', 'inputDir', 'outputDir'],
+            },
+            handler: async (args) => {
+                const harness = String(args.harness);
+                const inputDir = String(args.inputDir);
+                const outputDir = String(args.outputDir);
+                const argv = ['-i', inputDir, '-o', outputDir];
+                if (args.dictionary)
+                    argv.push('-x', String(args.dictionary));
+                if (typeof args.memoryLimitMB === 'number')
+                    argv.push('-m', String(Math.floor(args.memoryLimitMB)));
+                if (Array.isArray(args.extraArgs))
+                    argv.push(...args.extraArgs.map(String));
+                argv.push('--', harness);
+                if (Array.isArray(args.targetArgs))
+                    argv.push(...args.targetArgs.map(String));
+                ensureJobsDir();
+                if (!existsSync(outputDir))
+                    mkdirSync(outputDir, { recursive: true });
+                const child = spawn('afl-fuzz', argv, {
+                    detached: true,
+                    stdio: ['ignore', 'ignore', 'ignore'],
+                    env: {
+                        ...process.env,
+                        AFL_SKIP_CPUFREQ: '1',
+                        AFL_I_DONT_CARE_ABOUT_MISSING_CRASHES: '1',
+                    },
+                });
+                child.unref();
+                const jobId = `${Date.now()}_${child.pid ?? 'nopid'}`;
+                const record = {
+                    jobId,
+                    pid: child.pid ?? -1,
+                    harness,
+                    args: argv,
+                    inputDir,
+                    outputDir,
+                    startedAt: new Date().toISOString(),
+                };
+                writeJob(record);
+                return JSON.stringify({ jobId, pid: record.pid, outputDir, command: `afl-fuzz ${argv.join(' ')}` });
+            },
+        },
+        {
+            name: 'afl_fuzz_status',
+            description: 'Status and stats for a running AFL++ campaign by jobId.',
+            parameters: {
+                type: 'object',
+                properties: { jobId: { type: 'string' } },
+                required: ['jobId'],
+            },
+            handler: async (args) => {
+                const job = readJob(String(args.jobId));
+                if (!job)
+                    return JSON.stringify({ error: 'job not found', jobId: args.jobId });
+                const alive = isAlive(job.pid);
+                const statsFile = join(job.outputDir, 'default', 'fuzzer_stats');
+                const stats = {};
+                if (existsSync(statsFile)) {
+                    for (const line of readFileSync(statsFile, 'utf8').split('\n')) {
+                        const idx = line.indexOf(':');
+                        if (idx > 0)
+                            stats[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+                    }
+                }
+                const crashesDir = join(job.outputDir, 'default', 'crashes');
+                const crashFiles = existsSync(crashesDir)
+                    ? readdirSync(crashesDir).filter((f) => f !== 'README.txt')
+                    : [];
+                const store = getSharedArtifactStore();
+                const crashes = crashFiles.slice(0, 50).map((name) => {
+                    const path = join(crashesDir, name);
+                    try {
+                        const buf = readFileSync(path);
+                        const put = store.put(buf, {
+                            source: 'afl_crash',
+                            tags: [job.jobId, name],
+                            description: `afl crash ${name} from job ${job.jobId}`,
+                        });
+                        return { name, path, artifactId: put.id, size: put.size };
+                    }
+                    catch (e) {
+                        return { name, path, error: String(e) };
+                    }
+                });
+                return JSON.stringify({
+                    jobId: job.jobId,
+                    pid: job.pid,
+                    alive,
+                    startedAt: job.startedAt,
+                    stats,
+                    crashCount: crashFiles.length,
+                    crashes,
+                });
+            },
+        },
+        {
+            name: 'afl_fuzz_stop',
+            description: 'Terminate a running AFL++ campaign by jobId.',
+            parameters: {
+                type: 'object',
+                properties: { jobId: { type: 'string' } },
+                required: ['jobId'],
+            },
+            handler: async (args) => {
+                const job = readJob(String(args.jobId));
+                if (!job)
+                    return JSON.stringify({ error: 'job not found', jobId: args.jobId });
+                try {
+                    process.kill(job.pid, 'SIGTERM');
+                    await new Promise((r) => setTimeout(r, 1500));
+                    if (isAlive(job.pid))
+                        process.kill(job.pid, 'SIGKILL');
+                }
+                catch (e) {
+                    return JSON.stringify({ jobId: job.jobId, killed: false, error: String(e) });
+                }
+                return JSON.stringify({ jobId: job.jobId, killed: true });
+            },
+        },
+        {
+            name: 'afl_showmap',
+            description: 'Capture coverage trace for a single input under afl-showmap.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    harness: { type: 'string' },
+                    input: { type: 'string', description: 'Path to input file' },
+                    output: { type: 'string', description: 'Path to write trace map' },
+                    targetArgs: { type: 'array', items: { type: 'string' }, description: 'Args to harness; use @@ for input marker' },
+                },
+                required: ['harness', 'input', 'output'],
+            },
+            handler: async (args) => {
+                const targetArgs = args.targetArgs?.map(String) ?? [];
+                const argv = ['-o', String(args.output), '-i', String(args.input), '--', String(args.harness), ...targetArgs];
+                const result = await runBinary('afl-showmap', argv, { timeoutMs: 60_000 });
+                return formatResult('afl-showmap', argv, result);
+            },
+        },
+        {
+            name: 'afl_cmin',
+            description: 'Minimize a corpus to the smallest set with the same coverage (afl-cmin).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    harness: { type: 'string' },
+                    inputDir: { type: 'string' },
+                    outputDir: { type: 'string' },
+                    targetArgs: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['harness', 'inputDir', 'outputDir'],
+            },
+            handler: async (args) => {
+                const targetArgs = args.targetArgs?.map(String) ?? [];
+                const argv = ['-i', String(args.inputDir), '-o', String(args.outputDir), '--', String(args.harness), ...targetArgs];
+                const result = await runBinary('afl-cmin', argv, { timeoutMs: 30 * 60 * 1000 });
+                return formatResult('afl-cmin', argv, result);
+            },
+        },
+        {
+            name: 'afl_compile_harness',
+            description: 'Compile a fuzzing harness with AFL++ instrumentation (afl-clang-fast or afl-cc). Optionally persist the resulting binary to the artifact store. Use this to instrument a target before afl_fuzz_start.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    sources: { type: 'array', items: { type: 'string' }, description: 'Source files to compile' },
+                    output: { type: 'string', description: 'Output binary path' },
+                    compiler: { type: 'string', enum: ['afl-clang-fast', 'afl-cc', 'afl-clang-lto', 'afl-clang-fast++'], description: 'Default afl-clang-fast' },
+                    sanitizers: { type: 'array', items: { type: 'string' }, description: 'AFL_USE_* sanitizers (asan, ubsan, msan, cfisan, tsan, lsan)' },
+                    extraFlags: { type: 'array', items: { type: 'string' }, description: 'Extra compiler flags (e.g. -O2 -g -DPERSISTENT)' },
+                    libraries: { type: 'array', items: { type: 'string' }, description: 'Libraries to link (e.g. -lz, -lpcap)' },
+                    persistArtifact: { type: 'boolean', description: 'Register output binary in the artifact store' },
+                },
+                required: ['sources', 'output'],
+            },
+            handler: async (args) => {
+                const compiler = String(args.compiler ?? 'afl-clang-fast');
+                const sources = args.sources.map(String);
+                const argv = [];
+                if (Array.isArray(args.extraFlags))
+                    argv.push(...args.extraFlags.map(String));
+                argv.push(...sources);
+                if (Array.isArray(args.libraries))
+                    argv.push(...args.libraries.map(String));
+                argv.push('-o', String(args.output));
+                const env = {};
+                if (Array.isArray(args.sanitizers)) {
+                    for (const s of args.sanitizers) {
+                        env[`AFL_USE_${String(s).toUpperCase()}`] = '1';
+                    }
+                }
+                const result = await runBinary(compiler, argv, { timeoutMs: 10 * 60 * 1000, env });
+                let artifactInfo = {};
+                if (result.exitCode === 0 && args.persistArtifact && existsSync(String(args.output))) {
+                    try {
+                        const buf = readFileSync(String(args.output));
+                        const put = getSharedArtifactStore().put(buf, {
+                            source: 'afl_harness',
+                            tags: ['compiled', compiler],
+                            description: `AFL-instrumented harness ${String(args.output)}`,
+                        });
+                        artifactInfo = { artifactId: put.id, size: put.size };
+                    }
+                    catch (e) {
+                        artifactInfo = { artifactId: `error: ${String(e)}` };
+                    }
+                }
+                const formatted = formatResult(compiler, argv, result);
+                return artifactInfo.artifactId ? `${formatted}\n--- artifact ---\n${JSON.stringify(artifactInfo)}` : formatted;
+            },
+        },
+        {
+            name: 'afl_tmin',
+            description: 'Minimize a single input to the smallest one with the same coverage (afl-tmin).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    harness: { type: 'string' },
+                    input: { type: 'string' },
+                    output: { type: 'string' },
+                    targetArgs: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['harness', 'input', 'output'],
+            },
+            handler: async (args) => {
+                const targetArgs = args.targetArgs?.map(String) ?? [];
+                const argv = ['-i', String(args.input), '-o', String(args.output), '--', String(args.harness), ...targetArgs];
+                const result = await runBinary('afl-tmin', argv, { timeoutMs: 30 * 60 * 1000 });
+                return formatResult('afl-tmin', argv, result);
+            },
+        },
+    ];
+}
+export class AflppCapabilityModule {
+    id = 'capability.aflpp';
+    description = 'AFL++ fuzzer wrappers — afl_compile_harness, afl_fuzz_start (detached), afl_fuzz_status (auto-registers crash files in the artifact store), afl_fuzz_stop, afl_showmap, afl_cmin, afl_tmin. Long campaigns run as detached background processes addressed by jobId.';
+    async create(_context) {
+        void _context;
+        logDebug('[AFL++] Capability initialized');
+        const toolSuite = {
+            id: 'aflpp.tools',
+            description: 'AFL++ fuzzer wrappers',
+            tools: buildAflppTools(),
+        };
+        return { id: this.id, description: this.description, toolSuite };
+    }
+}
+//# sourceMappingURL=aflppCapability.js.map

package/dist/capabilities/aflppCapability.js.map

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

package/dist/capabilities/baseCapability.d.ts

@@ -0,0 +1,72 @@
+/**
+ * BASE CAPABILITY MODULE - SHARED INFRASTRUCTURE FOR ALL CAPABILITIES
+ *
+ * Provides common utilities, patterns, and infrastructure for all capability modules
+ * to promote code reuse and maintain consistency across the codebase.
+ */
+import type { CapabilityContribution, CapabilityContext, CapabilityModule } from '../runtime/agentHost.js';
+import type { ToolSuite, ToolDefinition } from '../core/toolRuntime.js';
+export interface BaseCapabilityOptions {
+    /** Working directory for operations */
+    workingDir?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Enable evidence collection */
+    enableEvidence?: boolean;
+    /** Authorization level for operations */
+    authorization?: 'basic' | 'elevated' | 'military' | 'full';
+    /** Emergency override capability */
+    emergencyOverride?: boolean;
+}
+export interface OperationResult {
+    success: boolean;
+    timestamp: string;
+    operationId: string;
+    metadata: Record<string, any>;
+    evidence?: string[];
+    errors?: string[];
+}
+export interface EvidenceCollector {
+    collect(data: any, type: string): string;
+    save(fileName: string, content: any): string;
+    cleanup(olderThan?: number): void;
+}
+export interface SecurityContext {
+    hostname: string;
+    username: string;
+    platform: string;
+    architecture: string;
+    os: string;
+    userAgent?: string;
+}
+export declare class SharedUtilities {
+    static generateOperationId(prefix?: string): string;
+    static createEvidenceDir(baseDir: string, operationId: string): string;
+    static saveEvidence(evidenceDir: string, fileName: string, data: any): string;
+    static getSecurityContext(): SecurityContext;
+    static calculateChecksum(data: string | Buffer): string;
+    static validateAuthorization(current: string, required: string): boolean;
+    static createToolDefinition<T extends Record<string, unknown>>(name: string, description: string, parameters: any, handler: (args: T) => Promise<string> | string): ToolDefinition<T>;
+}
+export declare abstract class BaseCapabilityModule implements CapabilityModule {
+    abstract readonly id: string;
+    protected readonly options: BaseCapabilityOptions;
+    protected readonly utilities: SharedUtilities;
+    protected evidenceCollector: EvidenceCollector | null;
+    constructor(options?: BaseCapabilityOptions);
+    abstract create(context: CapabilityContext): Promise<CapabilityContribution>;
+    protected initializeEvidenceCollector(): void;
+    private cleanupOldFiles;
+    protected log(message: string, level?: 'debug' | 'info' | 'warn' | 'error'): void;
+    protected validateOperation(authorizationRequired?: string): boolean;
+    protected createOperationResult(success: boolean, operationId: string, metadata?: Record<string, any>, errors?: string[]): OperationResult;
+}
+export declare class ToolSuiteBuilder {
+    private tools;
+    private id;
+    private description;
+    constructor(id: string, description: string);
+    addTool<T extends Record<string, unknown>>(name: string, description: string, parameters: any, handler: (args: T) => Promise<string> | string): this;
+    build(): ToolSuite;
+}
+//# sourceMappingURL=baseCapability.d.ts.map

package/dist/capabilities/baseCapability.d.ts.map

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

package/dist/capabilities/baseCapability.js

@@ -0,0 +1,183 @@
+/**
+ * BASE CAPABILITY MODULE - SHARED INFRASTRUCTURE FOR ALL CAPABILITIES
+ *
+ * Provides common utilities, patterns, and infrastructure for all capability modules
+ * to promote code reuse and maintain consistency across the codebase.
+ */
+import crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// ============================================================================
+// SHARED UTILITIES
+// ============================================================================
+export class SharedUtilities {
+    static generateOperationId(prefix = 'op') {
+        const timestamp = Date.now();
+        const random = crypto.randomBytes(4).toString('hex');
+        return `${prefix}_${timestamp}_${random}`;
+    }
+    static createEvidenceDir(baseDir, operationId) {
+        const evidenceDir = path.join(baseDir, 'evidence', operationId);
+        if (!fs.existsSync(evidenceDir)) {
+            fs.mkdirSync(evidenceDir, { recursive: true });
+        }
+        return evidenceDir;
+    }
+    static saveEvidence(evidenceDir, fileName, data) {
+        const filePath = path.join(evidenceDir, fileName);
+        const content = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+        fs.writeFileSync(filePath, content, 'utf8');
+        return filePath;
+    }
+    static getSecurityContext() {
+        return {
+            hostname: os.hostname(),
+            username: os.userInfo().username,
+            platform: os.platform(),
+            architecture: os.arch(),
+            os: os.type(),
+            userAgent: process.env['USER_AGENT'] || 'AGI-Core/1.0'
+        };
+    }
+    static calculateChecksum(data) {
+        return crypto.createHash('sha256').update(data).digest('hex');
+    }
+    static validateAuthorization(current, required) {
+        const levels = ['basic', 'elevated', 'military', 'full'];
+        const currentIndex = levels.indexOf(current);
+        const requiredIndex = levels.indexOf(required);
+        return currentIndex >= requiredIndex;
+    }
+    static createToolDefinition(name, description, parameters, handler) {
+        return {
+            name,
+            description,
+            parameters,
+            handler
+        };
+    }
+}
+// ============================================================================
+// BASE CAPABILITY CLASS
+// ============================================================================
+export class BaseCapabilityModule {
+    options;
+    utilities;
+    evidenceCollector = null;
+    constructor(options = {}) {
+        this.options = {
+            workingDir: process.cwd(),
+            debug: false,
+            enableEvidence: true,
+            authorization: 'basic',
+            emergencyOverride: false,
+            ...options
+        };
+        this.utilities = SharedUtilities;
+    }
+    initializeEvidenceCollector() {
+        if (this.options.enableEvidence) {
+            this.evidenceCollector = {
+                collect: (data, type) => {
+                    const evidenceDir = SharedUtilities.createEvidenceDir(this.options.workingDir, SharedUtilities.generateOperationId());
+                    const fileName = `${type}_${Date.now()}.json`;
+                    return SharedUtilities.saveEvidence(evidenceDir, fileName, data);
+                },
+                save: (fileName, content) => {
+                    const evidenceDir = SharedUtilities.createEvidenceDir(this.options.workingDir, 'misc');
+                    return SharedUtilities.saveEvidence(evidenceDir, fileName, content);
+                },
+                cleanup: (olderThan) => {
+                    const evidenceDir = path.join(this.options.workingDir, 'evidence');
+                    if (fs.existsSync(evidenceDir)) {
+                        const cutoff = olderThan || (Date.now() - 7 * 24 * 60 * 60 * 1000); // Default: 7 days
+                        this.cleanupOldFiles(evidenceDir, cutoff);
+                    }
+                }
+            };
+        }
+    }
+    cleanupOldFiles(dir, cutoff) {
+        try {
+            const files = fs.readdirSync(dir);
+            for (const file of files) {
+                const filePath = path.join(dir, file);
+                const stat = fs.statSync(filePath);
+                if (stat.isDirectory()) {
+                    this.cleanupOldFiles(filePath, cutoff);
+                }
+                else if (stat.mtimeMs < cutoff) {
+                    fs.unlinkSync(filePath);
+                }
+            }
+        }
+        catch (error) {
+            // Silent fail for cleanup operations
+        }
+    }
+    log(message, level = 'info') {
+        if (this.options.debug || level !== 'debug') {
+            const timestamp = new Date().toISOString();
+            const prefix = `[${timestamp}] [${level.toUpperCase()}] [${this.id}]`;
+            console.log(`${prefix} ${message}`);
+        }
+    }
+    validateOperation(authorizationRequired = 'basic') {
+        if (this.options.emergencyOverride) {
+            return true;
+        }
+        const isValid = SharedUtilities.validateAuthorization(this.options.authorization, authorizationRequired);
+        if (!isValid) {
+            this.log(`Authorization required: ${authorizationRequired}, current: ${this.options.authorization}`, 'warn');
+        }
+        return isValid;
+    }
+    createOperationResult(success, operationId, metadata = {}, errors = []) {
+        const result = {
+            success,
+            timestamp: new Date().toISOString(),
+            operationId,
+            metadata: {
+                ...metadata,
+                securityContext: SharedUtilities.getSecurityContext(),
+                capabilityId: this.id
+            },
+            errors: errors.length > 0 ? errors : undefined
+        };
+        if (this.evidenceCollector && success) {
+            try {
+                const evidencePath = this.evidenceCollector.collect(result, 'operation_result');
+                result.evidence = [evidencePath];
+            }
+            catch (error) {
+                // Evidence collection is optional
+            }
+        }
+        return result;
+    }
+}
+// ============================================================================
+// TOOL SUITE BUILDER
+// ============================================================================
+export class ToolSuiteBuilder {
+    tools = [];
+    id;
+    description;
+    constructor(id, description) {
+        this.id = id;
+        this.description = description;
+    }
+    addTool(name, description, parameters, handler) {
+        this.tools.push(SharedUtilities.createToolDefinition(name, description, parameters, handler));
+        return this;
+    }
+    build() {
+        return {
+            id: this.id,
+            description: this.description,
+            tools: this.tools
+        };
+    }
+}
+//# sourceMappingURL=baseCapability.js.map

package/dist/capabilities/baseCapability.js.map

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

package/dist/capabilities/bashCapability.d.ts

@@ -0,0 +1,13 @@
+import type { CapabilityContribution, CapabilityContext, CapabilityModule } from '../runtime/agentHost.js';
+export interface BashCapabilityOptions {
+    workingDir?: string;
+    id?: string;
+    description?: string;
+}
+export declare class BashCapabilityModule implements CapabilityModule {
+    readonly id = "capability.bash";
+    private readonly options;
+    constructor(options?: BashCapabilityOptions);
+    create(context: CapabilityContext): Promise<CapabilityContribution>;
+}
+//# sourceMappingURL=bashCapability.d.ts.map

package/dist/capabilities/bashCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/bashCapability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3G,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,EAAE,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,OAAO,GAAE,qBAA0B;IAIzC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAe1E"}

package/dist/capabilities/bashCapability.js

@@ -0,0 +1,24 @@
+import { createBashTools } from '../tools/bashTools.js';
+export class BashCapabilityModule {
+    id = 'capability.bash';
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async create(context) {
+        const workingDir = this.options.workingDir ?? context.workingDir;
+        return {
+            id: this.options.id ?? 'bash.tools.shell',
+            description: this.options.description ?? 'Shell execution with stdout/stderr summaries for reproducibility.',
+            toolSuite: {
+                id: 'bash',
+                description: 'Shell access',
+                tools: createBashTools(workingDir),
+            },
+            metadata: {
+                workingDir,
+            },
+        };
+    }
+}
+//# sourceMappingURL=bashCapability.js.map

package/dist/capabilities/bashCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashCapability.js","sourceRoot":"","sources":["../../src/capabilities/bashCapability.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQxD,MAAM,OAAO,oBAAoB;IACtB,EAAE,GAAG,iBAAiB,CAAC;IACf,OAAO,CAAwB;IAEhD,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA0B;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;QACjE,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,kBAAkB;YACzC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,mEAAmE;YAC5G,SAAS,EAAE;gBACT,EAAE,EAAE,MAAM;gBACV,WAAW,EAAE,cAAc;gBAC3B,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC;aACnC;YACD,QAAQ,EAAE;gBACR,UAAU;aACX;SACF,CAAC;IACJ,CAAC;CACF"}