@trenchwork/erosolar 1.1.30 → 1.1.32

package/dist/capabilities/gdbCapability.d.ts

@@ -0,0 +1,7 @@
+import type { CapabilityContext, CapabilityContribution, CapabilityModule } from '../runtime/agentHost.js';
+export declare class GdbCapabilityModule implements CapabilityModule {
+    readonly id = "capability.gdb";
+    readonly description = "GDB -batch wrappers for crash triage and binary inspection (gdb_run_with_input, gdb_inspect_at, gdb_disassemble). Pwndbg/GEF inherited from ~/.gdbinit if installed.";
+    create(_context: CapabilityContext): Promise<CapabilityContribution>;
+}
+//# sourceMappingURL=gdbCapability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gdbCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/gdbCapability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA2G3G,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,QAAQ,CAAC,EAAE,oBAAoB;IAC/B,QAAQ,CAAC,WAAW,0KAA0K;IAExL,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAU3E"}

package/dist/capabilities/gdbCapability.js

@@ -0,0 +1,125 @@
+import { logDebug } from '../utils/debugLogger.js';
+import { runBinary, formatResult } from './_processRunner.js';
+function buildGdbTools() {
+    return [
+        {
+            name: 'gdb_run_with_input',
+            description: 'Run a binary in gdb -batch with a crashing input, capture register state, full backtrace, disassembly around $pc, and process mappings. Pwndbg/GEF auto-loads if installed in ~/.gdbinit.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    binary: { type: 'string' },
+                    args: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Args passed to the binary; substitute @@ with inputFile if provided.',
+                    },
+                    inputFile: { type: 'string', description: 'Path to input file substituted for @@ in args' },
+                    stdinFromFile: { type: 'string', description: 'Path to file fed via stdin to the binary (uses gdb run < file)' },
+                    extraCommands: { type: 'array', items: { type: 'string' }, description: 'Extra gdb -ex commands appended after run' },
+                },
+                required: ['binary'],
+            },
+            handler: async (args) => {
+                const argv = ['-q', '-batch'];
+                const cmds = [];
+                const rawArgs = args.args?.map(String) ?? [];
+                const finalArgs = rawArgs.map((a) => (a === '@@' ? String(args.inputFile ?? '') : a));
+                if (args.stdinFromFile) {
+                    cmds.push(`set args ${finalArgs.join(' ')} < ${String(args.stdinFromFile)}`);
+                }
+                else if (finalArgs.length) {
+                    cmds.push(`set args ${finalArgs.join(' ')}`);
+                }
+                cmds.push('run');
+                cmds.push('echo \\n=== registers ===\\n');
+                cmds.push('info registers');
+                cmds.push('echo \\n=== backtrace ===\\n');
+                cmds.push('bt full');
+                cmds.push('echo \\n=== disasm @ $pc-32 ===\\n');
+                cmds.push('x/16i $pc-32');
+                cmds.push('echo \\n=== mappings ===\\n');
+                cmds.push('info proc mappings');
+                if (Array.isArray(args.extraCommands))
+                    cmds.push(...args.extraCommands.map(String));
+                cmds.push('quit');
+                for (const c of cmds)
+                    argv.push('-ex', c);
+                argv.push(String(args.binary));
+                const result = await runBinary('gdb', argv, { timeoutMs: 5 * 60 * 1000 });
+                return formatResult('gdb', argv, result);
+            },
+        },
+        {
+            name: 'gdb_inspect_at',
+            description: 'Run a binary in gdb -batch, break at an address or symbol, dump state.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    binary: { type: 'string' },
+                    breakAt: { type: 'string', description: 'Symbol name or 0x-address for break' },
+                    args: { type: 'array', items: { type: 'string' } },
+                    extraCommands: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['binary', 'breakAt'],
+            },
+            handler: async (args) => {
+                const argv = ['-q', '-batch'];
+                const cmds = [`break ${String(args.breakAt)}`];
+                const rawArgs = args.args?.map(String) ?? [];
+                if (rawArgs.length)
+                    cmds.push(`set args ${rawArgs.join(' ')}`);
+                cmds.push('run');
+                cmds.push('info registers');
+                cmds.push('bt');
+                cmds.push('x/8gx $sp');
+                if (Array.isArray(args.extraCommands))
+                    cmds.push(...args.extraCommands.map(String));
+                cmds.push('quit');
+                for (const c of cmds)
+                    argv.push('-ex', c);
+                argv.push(String(args.binary));
+                const result = await runBinary('gdb', argv, { timeoutMs: 3 * 60 * 1000 });
+                return formatResult('gdb', argv, result);
+            },
+        },
+        {
+            name: 'gdb_disassemble',
+            description: 'Disassemble a function or address range in a binary using gdb -batch.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    binary: { type: 'string' },
+                    target: { type: 'string', description: 'Symbol name or 0x-address' },
+                    range: { type: 'string', description: 'Optional 0x-end address for range (defaults to full function)' },
+                },
+                required: ['binary', 'target'],
+            },
+            handler: async (args) => {
+                const argv = ['-q', '-batch'];
+                const target = String(args.target);
+                const range = args.range ? `${target},${String(args.range)}` : target;
+                argv.push('-ex', `disassemble ${range}`);
+                argv.push('-ex', 'quit');
+                argv.push(String(args.binary));
+                const result = await runBinary('gdb', argv, { timeoutMs: 60 * 1000 });
+                return formatResult('gdb', argv, result);
+            },
+        },
+    ];
+}
+export class GdbCapabilityModule {
+    id = 'capability.gdb';
+    description = 'GDB -batch wrappers for crash triage and binary inspection (gdb_run_with_input, gdb_inspect_at, gdb_disassemble). Pwndbg/GEF inherited from ~/.gdbinit if installed.';
+    async create(_context) {
+        void _context;
+        logDebug('[GDB] Capability initialized');
+        const toolSuite = {
+            id: 'gdb.tools',
+            description: 'GDB -batch wrappers',
+            tools: buildGdbTools(),
+        };
+        return { id: this.id, description: this.description, toolSuite };
+    }
+}
+//# sourceMappingURL=gdbCapability.js.map

package/dist/capabilities/gdbCapability.js.map

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

package/dist/capabilities/ghidraHeadlessCapability.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Ghidra `analyzeHeadless` wrappers — direct binding to the
+ * support/analyzeHeadless driver Project Zero / NSA / Trail of Bits
+ * use at scale, no MCP bridge required. Each tool spawns
+ * analyzeHeadless with one of the embedded Jython post-scripts;
+ * scripts write JSON to a temp file the TS handler reads. Project
+ * databases live under ~/.erosolar/ghidra-projects/<project>/ so
+ * a follow-up tool call (decompile, xrefs, list-functions) reuses
+ * the analysis from the prior `ghidra_analyze` run.
+ *
+ * The post-script approach is preferred over running scripts via
+ * the Ghidra GUI / MCP bridge because:
+ *   - No process to keep alive; analyzeHeadless exits per call.
+ *   - Version-stable; the Jython script API is much more stable
+ *     than the MCP server's surface.
+ *   - First-class to Ghidra; this is the path the security
+ *     research community already uses.
+ */
+import type { CapabilityContext, CapabilityContribution, CapabilityModule } from '../runtime/agentHost.js';
+export declare class GhidraHeadlessCapabilityModule implements CapabilityModule {
+    readonly id = "capability.ghidraHeadless";
+    readonly description = "Ghidra analyzeHeadless wrappers \u2014 ghidra_analyze, ghidra_list_functions, ghidra_decompile, ghidra_xrefs, ghidra_fid_matches, ghidra_function_diff, ghidra_delete_project. Each tool spawns analyzeHeadless once with an embedded Jython post-script; project databases persist under ~/.erosolar/ghidra-projects/.";
+    create(_context: CapabilityContext): Promise<CapabilityContribution>;
+}
+//# sourceMappingURL=ghidraHeadlessCapability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ghidraHeadlessCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/ghidraHeadlessCapability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAqkBjC,qBAAa,8BAA+B,YAAW,gBAAgB;IACrE,QAAQ,CAAC,EAAE,+BAA+B;IAC1C,QAAQ,CAAC,WAAW,6TAAwT;IAEtU,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAU3E"}