rea-agents 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -17
- package/bridge/android/ReaJadxBridge.java +14 -5
- package/bridge/ghidra/ReaGhidraBridge.java +173 -47
- package/bridge/hopper_bridge.py +310 -128
- package/bridge/mitmproxy/capture.py +0 -2
- package/bridge/native/rea_lldb_tracer.py +630 -94
- package/bridge/process/ProcessRunTokenReader.swift +39 -5
- package/bridge/pwntools/recorded_crash_impl.py +4 -0
- package/dist/android/JadxConfiguration.js +196 -33
- package/dist/android/JadxMcpTransport.js +4 -0
- package/dist/android/JadxProtocol.js +6 -0
- package/dist/android/JadxProvider.js +19 -2
- package/dist/android/JadxSession.js +23 -4
- package/dist/application/AnalysisContextQueries.js +8 -35
- package/dist/application/AnalysisDocument.js +32 -0
- package/dist/application/AppBundleExecutable.js +67 -21
- package/dist/application/CallPathTracing.js +19 -3
- package/dist/application/CapabilityInventory.js +6 -3
- package/dist/application/ClientConfigurationDocument.js +871 -6
- package/dist/application/ClientRegistrationIdentity.js +26 -5
- package/dist/application/ClientRegistrationStatus.js +29 -14
- package/dist/application/DirectAnalysis.js +27 -37
- package/dist/application/Doctor.js +4 -2
- package/dist/application/DoctorScope.js +25 -13
- package/dist/application/EnhancedLiteralTracing.js +22 -25
- package/dist/application/EnhancedTools.js +13 -11
- package/dist/application/EvidenceBundleFiles.js +23 -11
- package/dist/application/FunctionAnalysisEvidence.js +2 -3
- package/dist/application/InventoryProjectionEvidence.js +4 -3
- package/dist/application/InvestigationProviders.js +3 -2
- package/dist/application/JsonFiles.js +50 -28
- package/dist/application/ProcedureAddressResolution.js +11 -0
- package/dist/application/ReconstructionCoverageService.js +7 -4
- package/dist/application/ReconstructionObligationLedgerService.js +4 -3
- package/dist/application/Setup.js +13 -1
- package/dist/application/SetupClientConfiguration.js +10 -15
- package/dist/application/SetupHost.js +5 -2
- package/dist/application/SetupPlan.js +5 -3
- package/dist/application/SupportedClients.js +34 -1
- package/dist/application/Uninstall.js +4 -3
- package/dist/application/Update.js +18 -3
- package/dist/application/UpdateRuntime.js +46 -25
- package/dist/application/WebModuleTraceService.js +4 -2
- package/dist/application/WebNetworkCaptureService.js +4 -2
- package/dist/application/WebRuntimeService.js +5 -3
- package/dist/application/WebScriptExportService.js +2 -2
- package/dist/application/WebSourceLocationService.js +4 -2
- package/dist/application/WorkflowEvidence.js +82 -0
- package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
- package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
- package/dist/application/binary/AnalysisSnapshotCache.js +3 -6
- package/dist/application/binary/BinarySession.js +95 -68
- package/dist/application/binary/BinarySessionOpen.js +3 -3
- package/dist/application/binary/BinarySessionRecords.js +25 -3
- package/dist/application/binary/BinarySessionStatus.js +17 -1
- package/dist/application/binary/CompositeProvider.js +13 -0
- package/dist/application/binary/LazyAnalysisProvider.js +3 -0
- package/dist/application/binaryDiagnostics/BinaryLayoutService.js +4 -2
- package/dist/application/binaryDiagnostics/RecordedCrashService.js +4 -2
- package/dist/application/evm/EvmInterfaceService.js +4 -2
- package/dist/application/investigation/EvidenceLedger.js +21 -7
- package/dist/application/investigation/InvestigationRecords.js +8 -0
- package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
- package/dist/application/javascript/JavaScriptApplicationEvidence.js +24 -3
- package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
- package/dist/application/javascript/JavaScriptApplicationService.js +22 -15
- package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
- package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -4
- package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
- package/dist/application/javascript/JavaScriptArtifactPathResolution.js +6 -3
- package/dist/application/javascript/JavaScriptArtifactReconstruction.js +11 -3
- package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
- package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
- package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
- package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +63 -61
- package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +23 -1
- package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
- package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
- package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
- package/dist/application/managed/ManagedReconstructionService.js +4 -3
- package/dist/application/process/ProcessCli.js +14 -6
- package/dist/application/process/ProcessEvidence.js +4 -3
- package/dist/application/workflowInputError.js +18 -0
- package/dist/artifacts/ArtifactProvider.js +12 -2
- package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
- package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
- package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
- package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
- package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
- package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
- package/dist/artifacts/apple/MachoLoadCommandReader.js +92 -31
- package/dist/artifacts/apple/NibArchive.js +81 -14
- package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
- package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
- package/dist/artifacts/inventory/ArtifactGraphConstruction.js +13 -8
- package/dist/artifacts/inventory/scanCanonical.js +11 -14
- package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
- package/dist/browser/CdpCaptureCompleteness.js +2 -0
- package/dist/browser/CdpCaptureEventHandlers.js +76 -11
- package/dist/browser/CdpCaptureEventTypes.js +5 -1
- package/dist/browser/CdpCaptureEvents.js +25 -0
- package/dist/browser/CdpConnection.js +30 -11
- package/dist/browser/CdpOptionalCommand.js +2 -3
- package/dist/browser/CdpPageCapture.js +23 -1
- package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
- package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
- package/dist/browser/PlaywrightElectronActiveProvider.js +123 -124
- package/dist/browser/WebSourceMapFetcher.js +426 -72
- package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
- package/dist/browser/history/CaptureFailures.js +37 -1
- package/dist/browser/history/CaptureRelease.js +5 -0
- package/dist/browser/history/HarCaptureAdapter.js +3 -3
- package/dist/browser/history/HarJson.js +3 -2
- package/dist/browser/history/HistoricalCaptureDecoder.js +4 -2
- package/dist/cli/analysisSelector.js +23 -0
- package/dist/cli/applicationCommands.js +2 -3
- package/dist/cli/coreBinaryCommands.js +70 -12
- package/dist/cli/electronCommands.js +7 -6
- package/dist/cli/javascriptApplicationAnalysis.js +7 -3
- package/dist/cli/jsonOutput.js +4 -99
- package/dist/cli/nativeCallCommands.js +2 -3
- package/dist/cli/webRuntimeCommands.js +8 -8
- package/dist/cli.js +2 -1
- package/dist/cliCommandNames.js +0 -1
- package/dist/cliJsonInput.js +9 -4
- package/dist/config/environment.js +4 -0
- package/dist/config/ghidraStartupTimeout.js +17 -0
- package/dist/config/mcpResponseBudget.js +22 -0
- package/dist/config/parseConfig.js +2 -1
- package/dist/contracts/enhancedInputs.js +5 -3
- package/dist/contracts/enhancedToolContracts.js +3 -3
- package/dist/contracts/hopperMemoryContracts.js +2 -5
- package/dist/contracts/javascript/electronToolContracts.js +1 -1
- package/dist/contracts/managed/managedToolContracts.js +2 -4
- package/dist/contracts/native/nativeToolContracts.js +4 -2
- package/dist/contracts/officialToolContracts.js +14 -15
- package/dist/contracts/promptContracts.js +3 -3
- package/dist/contracts/sessionLifecycleInputs.js +3 -7
- package/dist/contracts/sessionStatusContract.js +2 -4
- package/dist/contracts/sessionToolContracts.js +4 -6
- package/dist/contracts/sessionToolSchemas.js +2 -5
- package/dist/contracts/toolContractExamples.js +0 -1
- package/dist/contracts/toolContractHelpers.js +4 -1
- package/dist/contracts/toolEffects.js +0 -1
- package/dist/contracts/toolOutputSchemaGroups.js +28 -27
- package/dist/contracts/toolOutputSchemaPrimitives.js +18 -0
- package/dist/contracts/toolSchemaMetadata.js +69 -10
- package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
- package/dist/domain/analysisErrorBase.js +8 -3
- package/dist/domain/analysisErrorCore.js +3 -1
- package/dist/domain/analysisErrorPresentation.js +72 -17
- package/dist/domain/analysisErrorProjection.js +106 -27
- package/dist/domain/android/androidAnalysis.js +2 -4
- package/dist/domain/android/androidApplication.js +17 -9
- package/dist/domain/apple/appleApplication.js +41 -14
- package/dist/domain/apple/dyldEnvironment.js +73 -0
- package/dist/domain/apple/dylibResolution.js +120 -9
- package/dist/domain/apple/dylibResolutionFindings.js +9 -7
- package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
- package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
- package/dist/domain/apple/keyedArchive.js +9 -1
- package/dist/domain/apple/machoContainer.js +54 -0
- package/dist/domain/apple/plistNumbers.js +76 -0
- package/dist/domain/artifactIdentity.js +29 -0
- package/dist/domain/artifactInventoryEvidence.js +19 -24
- package/dist/domain/bridgeCandidateProjection.js +71 -0
- package/dist/domain/browserCompleteness.js +1 -0
- package/dist/domain/browserObservationError.js +24 -5
- package/dist/domain/browserScenarioValues.js +2 -6
- package/dist/domain/bundleComparison.js +3 -2
- package/dist/domain/canonicalJsonDigestSteps.js +133 -0
- package/dist/domain/canonicalOrdering.js +9 -5
- package/dist/domain/changedBehavior.js +6 -6
- package/dist/domain/comparisonSourceEvidence.js +40 -0
- package/dist/domain/configurationErrors.js +1 -1
- package/dist/domain/evidence.js +64 -9
- package/dist/domain/evidenceBundle.js +42 -1
- package/dist/domain/evidenceErrors.js +12 -1
- package/dist/domain/explicitSensitiveFailure.js +17 -1
- package/dist/domain/firmware/firmwareAnalysis.js +6 -7
- package/dist/domain/hopperErrors.js +23 -2
- package/dist/domain/hopperValues.js +51 -8
- package/dist/domain/immutableJson.js +114 -0
- package/dist/domain/inputIssueProjection.js +3 -0
- package/dist/domain/javascript/electronActiveObservation.js +30 -4
- package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
- package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
- package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
- package/dist/domain/javascript/javascriptAstValues.js +20 -0
- package/dist/domain/javascript/javascriptRecovery.js +3 -8
- package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
- package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
- package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
- package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
- package/dist/domain/javascript/javascriptSemanticGraph.js +13 -0
- package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
- package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
- package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
- package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
- package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
- package/dist/domain/javascript/javascriptSourceParser.js +6 -2
- package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
- package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
- package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
- package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
- package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
- package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
- package/dist/domain/jsonSerialization.js +109 -0
- package/dist/domain/jsonValue.js +90 -6
- package/dist/domain/localPath.js +6 -0
- package/dist/domain/managed/managedApplicationGraph.js +10 -10
- package/dist/domain/managed/managedInspectionEvidence.js +16 -0
- package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
- package/dist/domain/managed/managedNativeVerification.js +3 -9
- package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
- package/dist/domain/native/nativeCallObservation.js +33 -11
- package/dist/domain/native/nativeCallPartialObservation.js +33 -0
- package/dist/domain/process/processCapture.js +8 -4
- package/dist/domain/process/processComparison.js +38 -4
- package/dist/domain/process/processScenario.js +11 -10
- package/dist/domain/propertyListKeys.js +1 -1
- package/dist/domain/propertyListXmlText.js +19 -0
- package/dist/domain/providerAdapterError.js +1 -1
- package/dist/domain/providerOperationHealth.js +54 -0
- package/dist/domain/reconstructionVerification.js +6 -43
- package/dist/domain/reconstructionVerificationSchemas.js +2 -2
- package/dist/domain/staticRuntimeCorrelation.js +6 -43
- package/dist/domain/webBundleAnalysis.js +20 -8
- package/dist/domain/webBundleAnalyzerInspection.js +13 -8
- package/dist/domain/webBundleAnalyzerResult.js +41 -2
- package/dist/domain/webRuntime.js +19 -5
- package/dist/domain/webSourceLocation.js +1 -0
- package/dist/firmware/FirmwareFiles.js +1 -1
- package/dist/generatedPackageMetadata.js +1 -1
- package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
- package/dist/ghidra/GhidraClient.js +47 -14
- package/dist/ghidra/GhidraDiagnostics.js +7 -7
- package/dist/ghidra/GhidraFunctionValues.js +10 -7
- package/dist/ghidra/GhidraInstallation.js +18 -21
- package/dist/ghidra/GhidraInventoryValues.js +14 -4
- package/dist/ghidra/GhidraJavaLaunch.js +62 -0
- package/dist/ghidra/GhidraLauncher.js +33 -16
- package/dist/ghidra/GhidraProviderCapabilities.js +14 -2
- package/dist/ghidra/GhidraProviderClient.js +23 -12
- package/dist/ghidra/GhidraSessionError.js +11 -7
- package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
- package/dist/ghidra/GhidraTransport.js +20 -0
- package/dist/hopper/BridgeLauncher.js +31 -11
- package/dist/hopper/HopperAnalysisProfile.js +62 -4
- package/dist/hopper/HopperCleanup.js +15 -3
- package/dist/hopper/HopperClient.js +222 -14
- package/dist/hopper/HopperFileOffset.js +237 -0
- package/dist/hopper/HopperMachOImage.js +196 -0
- package/dist/hopper/HopperOperationStage.js +6 -0
- package/dist/hopper/HopperProvider.js +63 -9
- package/dist/hopper/HopperProviderCapabilities.js +19 -1
- package/dist/hopper/HopperRegexSearch.js +137 -0
- package/dist/hopper/HopperRegexWorker.js +27 -0
- package/dist/hopper/HopperRequestQueue.js +68 -19
- package/dist/hopper/HopperTargetLease.js +3 -2
- package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
- package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
- package/dist/inspector/V8InspectorProvider.js +47 -11
- package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
- package/dist/javascript/sourceMaps/SourceMapCommand.js +16 -0
- package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
- package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
- package/dist/mcpDoctor.js +62 -2
- package/dist/native/AppleDispatchCoverage.js +47 -6
- package/dist/native/AppleDispatchDecodeFacts.js +6 -0
- package/dist/native/AppleDispatchMetadata.js +6 -3
- package/dist/native/AppleMachoFixups.js +48 -24
- package/dist/native/AppleMachoSelection.js +32 -16
- package/dist/native/AppleObjcCategories.js +6 -2
- package/dist/native/AppleObjcDispatchFacets.js +5 -2
- package/dist/native/AppleObjcProperties.js +2 -1
- package/dist/native/AppleSwiftDispatchFacets.js +27 -21
- package/dist/native/AppleSwiftVtables.js +21 -15
- package/dist/native/CommandRunner.js +81 -84
- package/dist/native/LldbCallTracer.js +365 -102
- package/dist/native/LldbRetainedObservations.js +178 -0
- package/dist/native/NativeCallObservation.js +62 -3
- package/dist/native/NativeMacOSProvider.js +98 -17
- package/dist/native/SignatureTargetBinding.js +155 -0
- package/dist/native/parsers/lipo.js +71 -1
- package/dist/native/pwndbg/PwndbgCoreContext.js +25 -5
- package/dist/native/pwntools/RecordedCrashStructureBindings.js +2 -0
- package/dist/process/DarwinProcessRunTokenReader.js +8 -9
- package/dist/process/ExecFileOutput.js +20 -0
- package/dist/process/OwnedCommand.js +7 -2
- package/dist/process/ProcessOwnership.js +203 -53
- package/dist/process/ProcessOwnershipObservation.js +49 -4
- package/dist/process/ProviderProcess.js +38 -7
- package/dist/process/capture/ProcessCaptureError.js +2 -2
- package/dist/process/capture/ProcessCaptureLifecycle.js +100 -34
- package/dist/server/EvidenceMcpServer.js +146 -0
- package/dist/server/createServer.js +15 -8
- package/dist/server/registerAndroidTools.js +2 -4
- package/dist/server/registerApplicationTools/helpers.js +2 -4
- package/dist/server/registerArtifactComparisonTool.js +11 -7
- package/dist/server/registerBinaryDiagnosticsTools.js +2 -4
- package/dist/server/registerBrowserScenarioTool.js +2 -4
- package/dist/server/registerBrowserTools.js +2 -4
- package/dist/server/registerBundleComparisonTool.js +2 -3
- package/dist/server/registerCloseLifecycleTool.js +8 -18
- package/dist/server/registerElectronTools.js +2 -4
- package/dist/server/registerEnhancedTools.js +18 -59
- package/dist/server/registerEvidenceTools.js +2 -4
- package/dist/server/registerEvmTools.js +2 -4
- package/dist/server/registerFirmwareTools.js +2 -4
- package/dist/server/registerFunctionComparisonTool.js +10 -6
- package/dist/server/registerInvestigationTools.js +7 -7
- package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
- package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
- package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
- package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
- package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
- package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
- package/dist/server/registerOfficialTools.js +2 -4
- package/dist/server/registerProcessComparisonTool.js +71 -45
- package/dist/server/registerRecordedCrashTools.js +2 -4
- package/dist/server/registerSessionRecordTools.js +5 -6
- package/dist/server/registerSessionStatusTool.js +17 -3
- package/dist/server/registerSessionTools.js +11 -3
- package/dist/server/registerWebModuleTool.js +2 -4
- package/dist/server/registerWebNetworkCaptureTool.js +2 -4
- package/dist/server/registerWebRuntimeTools.js +3 -7
- package/dist/server/registerWebScriptTool.js +2 -4
- package/dist/server/registerWebSourceLocationTool.js +2 -4
- package/dist/server/runDerivedOperation.js +15 -3
- package/dist/server/sessionAvailabilityPolicy.js +0 -1
- package/dist/server/toolRegistrationOptions.js +2 -2
- package/dist/server/toolResult.js +62 -10
- package/dist/server/toolResultEncoding.js +33 -0
- package/install.sh +1 -1
- package/native/windows/build/manifest.json +1 -1
- package/package.json +8 -3
- package/scripts/electron-active-hook-boundaries.cjs +18 -20
- package/scripts/electron-active-hook.cjs +241 -37
- package/skills/reverse-engineer-anything/SKILL.md +11 -3
- package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
- package/dist/ghidra/GhidraDefaults.js +0 -2
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { constants } from "node:fs";
|
|
3
|
+
import { lstat, mkdtemp, open, rm } from "node:fs/promises";
|
|
4
|
+
import { tmpdir } from "node:os";
|
|
5
|
+
import { basename, join } from "node:path";
|
|
6
|
+
import { AnalysisError } from "../domain/analysisErrorBase.js";
|
|
7
|
+
import { AnalysisAccessDeniedError, AnalysisArtifactChangedError, AnalysisCancelledError, AnalysisResourceConstraintError, } from "../domain/analysisErrorCore.js";
|
|
8
|
+
import { ProviderAdapterError } from "../domain/providerAdapterError.js";
|
|
9
|
+
import { err, ok } from "../domain/result.js";
|
|
10
|
+
import { NATIVE_MACOS_PROVIDER_IDENTITY } from "./NativeMacOSProviderMetadata.js";
|
|
11
|
+
const identity = (stat) => [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
|
|
12
|
+
const changedTarget = (target, reason) => err(new AnalysisArtifactChangedError("inspect_signature", target.path, reason));
|
|
13
|
+
const signatureReadFailure = (target, cause) => {
|
|
14
|
+
if (cause instanceof AnalysisError)
|
|
15
|
+
return cause;
|
|
16
|
+
const code = cause instanceof Error && "code" in cause ? cause.code : undefined;
|
|
17
|
+
if (code === "EACCES" || code === "EPERM")
|
|
18
|
+
return new AnalysisAccessDeniedError("inspect_signature", target.path, code, { cause });
|
|
19
|
+
if (code === "ENOENT" || code === "ENOTDIR" || code === "ELOOP")
|
|
20
|
+
return new AnalysisArtifactChangedError("inspect_signature", target.path, `Registered signature target is no longer readable (${code}): ${target.path}`, { cause });
|
|
21
|
+
return new ProviderAdapterError(NATIVE_MACOS_PROVIDER_IDENTITY.id, "inspect_signature", {
|
|
22
|
+
cause,
|
|
23
|
+
diagnostics: {
|
|
24
|
+
path: target.path,
|
|
25
|
+
phase: "target-version-binding",
|
|
26
|
+
system_code: typeof code === "string" ? code : null,
|
|
27
|
+
reason: cause instanceof Error ? cause.message : String(cause),
|
|
28
|
+
},
|
|
29
|
+
});
|
|
30
|
+
};
|
|
31
|
+
/** Inspect a digest-verified private copy, releasing it on every exit path. */
|
|
32
|
+
export const withSignatureTarget = async (target, inspect, signal) => {
|
|
33
|
+
let directory;
|
|
34
|
+
try {
|
|
35
|
+
signal?.throwIfAborted();
|
|
36
|
+
directory = await mkdtemp(join(tmpdir(), "rea-signature-"));
|
|
37
|
+
}
|
|
38
|
+
catch (cause) {
|
|
39
|
+
return err(signal?.aborted
|
|
40
|
+
? new AnalysisCancelledError("inspect_signature")
|
|
41
|
+
: snapshotFailure(target, "create", cause));
|
|
42
|
+
}
|
|
43
|
+
let result;
|
|
44
|
+
let cleanup;
|
|
45
|
+
try {
|
|
46
|
+
const binding = await bindSignatureTarget(target, join(directory, basename(target.path)), signal);
|
|
47
|
+
result = binding.ok ? await inspect(binding.value) : binding;
|
|
48
|
+
}
|
|
49
|
+
finally {
|
|
50
|
+
try {
|
|
51
|
+
await rm(directory, { recursive: true, force: true });
|
|
52
|
+
cleanup = ok(undefined);
|
|
53
|
+
}
|
|
54
|
+
catch (cause) {
|
|
55
|
+
cleanup = err(snapshotFailure(target, "cleanup", cause));
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
// Cleanup cannot replace the operation's original actionable failure.
|
|
59
|
+
return result.ok && !cleanup.ok ? cleanup : result;
|
|
60
|
+
};
|
|
61
|
+
const snapshotFailure = (target, phase, cause) => new ProviderAdapterError(NATIVE_MACOS_PROVIDER_IDENTITY.id, "inspect_signature", {
|
|
62
|
+
cause,
|
|
63
|
+
diagnostics: {
|
|
64
|
+
path: target.path,
|
|
65
|
+
phase: `signature-snapshot-${phase}`,
|
|
66
|
+
reason: cause instanceof Error ? cause.message : String(cause),
|
|
67
|
+
},
|
|
68
|
+
});
|
|
69
|
+
const snapshotIO = async (target, phase, operation) => {
|
|
70
|
+
try {
|
|
71
|
+
return await operation();
|
|
72
|
+
}
|
|
73
|
+
catch (cause) {
|
|
74
|
+
throw snapshotFailure(target, phase, cause);
|
|
75
|
+
}
|
|
76
|
+
};
|
|
77
|
+
const copySignatureBytes = async (target, source, snapshot, signal) => {
|
|
78
|
+
const size = Number(source.stat.size);
|
|
79
|
+
if (!Number.isSafeInteger(size))
|
|
80
|
+
throw new AnalysisResourceConstraintError("inspect_signature", "file-size", `Signature target size is not exactly representable: ${target.path}`, null);
|
|
81
|
+
const hash = createHash("sha256");
|
|
82
|
+
const chunk = Buffer.alloc(64 * 1024);
|
|
83
|
+
let position = 0;
|
|
84
|
+
while (position < size) {
|
|
85
|
+
signal?.throwIfAborted();
|
|
86
|
+
const { bytesRead } = await source.file.read(chunk, 0, Math.min(chunk.length, size - position), position);
|
|
87
|
+
signal?.throwIfAborted();
|
|
88
|
+
if (bytesRead === 0)
|
|
89
|
+
throw new AnalysisArtifactChangedError("inspect_signature", target.path, `Signature target was truncated while hashing: ${target.path}`);
|
|
90
|
+
const bytes = chunk.subarray(0, bytesRead);
|
|
91
|
+
hash.update(bytes);
|
|
92
|
+
// writeFile retries short writes; memory remains bounded to this chunk.
|
|
93
|
+
await snapshotIO(target, "write", () => snapshot.writeFile(bytes));
|
|
94
|
+
position += bytesRead;
|
|
95
|
+
}
|
|
96
|
+
return hash.digest("hex");
|
|
97
|
+
};
|
|
98
|
+
/** Hash and copy the same descriptor bytes, without reopening the mutable path. */
|
|
99
|
+
const bindSignatureTarget = async (target, snapshotPath, signal) => {
|
|
100
|
+
try {
|
|
101
|
+
signal?.throwIfAborted();
|
|
102
|
+
const before = await lstat(target.path, { bigint: true });
|
|
103
|
+
signal?.throwIfAborted();
|
|
104
|
+
if (!before.isFile() || before.isSymbolicLink())
|
|
105
|
+
return changedTarget(target, `Signature target is no longer a regular file: ${target.path}`);
|
|
106
|
+
const file = await open(target.path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
107
|
+
try {
|
|
108
|
+
const opened = await file.stat({ bigint: true });
|
|
109
|
+
signal?.throwIfAborted();
|
|
110
|
+
if (identity(opened) !== identity(before))
|
|
111
|
+
return changedTarget(target, `Signature target changed before open: ${target.path}`);
|
|
112
|
+
const snapshot = await snapshotIO(target, "create-file", () => open(snapshotPath, "wx", 0o600));
|
|
113
|
+
try {
|
|
114
|
+
const observed = await copySignatureBytes(target, { file, stat: opened }, snapshot, signal);
|
|
115
|
+
if (observed !== target.sha256)
|
|
116
|
+
return changedTarget(target, `Signature target digest changed: ${target.path}; expected ${target.sha256}, observed ${observed}`);
|
|
117
|
+
const after = await file.stat({ bigint: true });
|
|
118
|
+
const current = await lstat(target.path, { bigint: true });
|
|
119
|
+
signal?.throwIfAborted();
|
|
120
|
+
if (identity(after) !== identity(opened) ||
|
|
121
|
+
identity(current) !== identity(opened))
|
|
122
|
+
return changedTarget(target, `Signature target changed while establishing its version: ${target.path}`);
|
|
123
|
+
await snapshotIO(target, "seal", () => snapshot.chmod(0o400));
|
|
124
|
+
return ok({ identity: identity(opened), snapshotPath });
|
|
125
|
+
}
|
|
126
|
+
finally {
|
|
127
|
+
await snapshotIO(target, "close", () => snapshot.close());
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
finally {
|
|
131
|
+
await file.close();
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
catch (cause) {
|
|
135
|
+
return err(signal?.aborted
|
|
136
|
+
? new AnalysisCancelledError("inspect_signature")
|
|
137
|
+
: signatureReadFailure(target, cause));
|
|
138
|
+
}
|
|
139
|
+
};
|
|
140
|
+
/** Reject target drift across signature command captures. */
|
|
141
|
+
export const verifySignatureTarget = async (target, binding, signal) => {
|
|
142
|
+
try {
|
|
143
|
+
signal?.throwIfAborted();
|
|
144
|
+
const current = await lstat(target.path, { bigint: true });
|
|
145
|
+
signal?.throwIfAborted();
|
|
146
|
+
return current.isFile() && identity(current) === binding.identity
|
|
147
|
+
? ok(undefined)
|
|
148
|
+
: changedTarget(target, `Signature target changed during inspection: ${target.path}`);
|
|
149
|
+
}
|
|
150
|
+
catch (cause) {
|
|
151
|
+
return err(signal?.aborted
|
|
152
|
+
? new AnalysisCancelledError("inspect_signature")
|
|
153
|
+
: signatureReadFailure(target, cause));
|
|
154
|
+
}
|
|
155
|
+
};
|
|
@@ -3,6 +3,9 @@ const architectureSchema = z.object({
|
|
|
3
3
|
name: z.string().min(1),
|
|
4
4
|
cpu_type: z.string().nullable(),
|
|
5
5
|
cpu_subtype: z.string().nullable(),
|
|
6
|
+
cpu_type_code: z.number().int().nonnegative().nullable(),
|
|
7
|
+
cpu_subtype_code: z.number().int().nonnegative().nullable(),
|
|
8
|
+
capabilities: z.string().nullable(),
|
|
6
9
|
file_offset: z.number().int().min(0).nullable(),
|
|
7
10
|
size: z.number().int().min(0).nullable(),
|
|
8
11
|
alignment: z.number().int().min(0).nullable(),
|
|
@@ -18,6 +21,9 @@ export const parseLipoArchitectures = (output) => {
|
|
|
18
21
|
name: thinArchitecture,
|
|
19
22
|
cpu_type: null,
|
|
20
23
|
cpu_subtype: null,
|
|
24
|
+
cpu_type_code: null,
|
|
25
|
+
cpu_subtype_code: null,
|
|
26
|
+
capabilities: null,
|
|
21
27
|
file_offset: null,
|
|
22
28
|
size: null,
|
|
23
29
|
alignment: null,
|
|
@@ -36,6 +42,9 @@ export const parseLipoArchitectures = (output) => {
|
|
|
36
42
|
: name,
|
|
37
43
|
cpu_type: current.cputype ?? null,
|
|
38
44
|
cpu_subtype: current.cpusubtype ?? null,
|
|
45
|
+
cpu_type_code: cpuTypeCode(current.cputype),
|
|
46
|
+
cpu_subtype_code: cpuSubtypeCode(current.cpusubtype, current.capabilities),
|
|
47
|
+
capabilities: current.capabilities ?? null,
|
|
39
48
|
file_offset: integer(current.offset),
|
|
40
49
|
size: integer(current.size),
|
|
41
50
|
alignment: alignment(current.align),
|
|
@@ -54,7 +63,7 @@ export const parseLipoArchitectures = (output) => {
|
|
|
54
63
|
current = { architecture: line.slice("architecture ".length).trim() };
|
|
55
64
|
continue;
|
|
56
65
|
}
|
|
57
|
-
const match = /^(cputype|cpusubtype|offset|size|align)\s+(.+)$/u.exec(line);
|
|
66
|
+
const match = /^(cputype|cpusubtype|capabilities|offset|size|align)\s+(.+)$/u.exec(line);
|
|
58
67
|
if (match?.[1] !== undefined && match[2] !== undefined) {
|
|
59
68
|
current ??= {};
|
|
60
69
|
current[match[1]] = match[2].trim();
|
|
@@ -71,6 +80,67 @@ const integer = (value) => {
|
|
|
71
80
|
const parsed = Number.parseInt(value, 10);
|
|
72
81
|
return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : null;
|
|
73
82
|
};
|
|
83
|
+
const CPU_TYPES = {
|
|
84
|
+
CPU_TYPE_X86: 7,
|
|
85
|
+
CPU_TYPE_X86_64: 0x01000007,
|
|
86
|
+
CPU_TYPE_ARM: 12,
|
|
87
|
+
CPU_TYPE_ARM64: 0x0100000c,
|
|
88
|
+
CPU_TYPE_ARM64_32: 0x0200000c,
|
|
89
|
+
CPU_TYPE_POWERPC: 18,
|
|
90
|
+
CPU_TYPE_POWERPC64: 0x01000012,
|
|
91
|
+
};
|
|
92
|
+
const CPU_SUBTYPES = {
|
|
93
|
+
CPU_SUBTYPE_X86_ALL: 3,
|
|
94
|
+
CPU_SUBTYPE_X86_64_ALL: 3,
|
|
95
|
+
CPU_SUBTYPE_X86_64_H: 8,
|
|
96
|
+
CPU_SUBTYPE_ARM64_ALL: 0,
|
|
97
|
+
CPU_SUBTYPE_ARM64_V8: 1,
|
|
98
|
+
CPU_SUBTYPE_ARM64E: 2,
|
|
99
|
+
CPU_SUBTYPE_ARM64_32_ALL: 0,
|
|
100
|
+
CPU_SUBTYPE_ARM64_32_V8: 1,
|
|
101
|
+
CPU_SUBTYPE_ARM_V7: 9,
|
|
102
|
+
CPU_SUBTYPE_ARM_V7S: 11,
|
|
103
|
+
CPU_SUBTYPE_ARM_V7K: 12,
|
|
104
|
+
CPU_SUBTYPE_POWERPC_ALL: 0,
|
|
105
|
+
CPU_SUBTYPE_POWERPC_970: 100,
|
|
106
|
+
};
|
|
107
|
+
/** Normalize known lipo names while retaining the producer's original text. */
|
|
108
|
+
const cpuTypeCode = (value) => {
|
|
109
|
+
if (value === undefined)
|
|
110
|
+
return null;
|
|
111
|
+
const numeric = unsigned32(value);
|
|
112
|
+
return numeric ?? CPU_TYPES[value] ?? null;
|
|
113
|
+
};
|
|
114
|
+
/** Normalize the subtype and its separately printed ptrauth capability bits. */
|
|
115
|
+
const cpuSubtypeCode = (value, capabilities) => {
|
|
116
|
+
if (value === undefined)
|
|
117
|
+
return null;
|
|
118
|
+
const numeric = unsigned32(value);
|
|
119
|
+
if (numeric !== null)
|
|
120
|
+
return numeric;
|
|
121
|
+
const subtype = CPU_SUBTYPES[value];
|
|
122
|
+
if (subtype === undefined)
|
|
123
|
+
return null;
|
|
124
|
+
if (value !== "CPU_SUBTYPE_ARM64E")
|
|
125
|
+
return subtype;
|
|
126
|
+
const version = /PTR_AUTH_VERSION\s+USERSPACE\s+(\d+)/u.exec(capabilities ?? "")?.[1];
|
|
127
|
+
if (version === undefined)
|
|
128
|
+
return null;
|
|
129
|
+
const parsedVersion = Number(version);
|
|
130
|
+
if (!Number.isInteger(parsedVersion) ||
|
|
131
|
+
parsedVersion < 0 ||
|
|
132
|
+
parsedVersion > 15)
|
|
133
|
+
return null;
|
|
134
|
+
return (0x80000000 | (parsedVersion << 24) | subtype) >>> 0;
|
|
135
|
+
};
|
|
136
|
+
const unsigned32 = (value) => {
|
|
137
|
+
if (!/^(?:\d+|0x[\da-f]+)$/iu.test(value))
|
|
138
|
+
return null;
|
|
139
|
+
const parsed = Number(value);
|
|
140
|
+
return Number.isInteger(parsed) && parsed >= 0 && parsed <= 0xffffffff
|
|
141
|
+
? parsed >>> 0
|
|
142
|
+
: null;
|
|
143
|
+
};
|
|
74
144
|
const alignment = (value) => {
|
|
75
145
|
if (value === undefined)
|
|
76
146
|
return null;
|
|
@@ -28,7 +28,7 @@ const replySchema = z.discriminatedUnion("ok", [
|
|
|
28
28
|
}),
|
|
29
29
|
]);
|
|
30
30
|
/** Add mapping candidates from an owned core-only debugger, using the existing snapshot. */
|
|
31
|
-
export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, options, launcher, }) => {
|
|
31
|
+
export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, options, launcher, probePath, }) => {
|
|
32
32
|
const gdb = environment.REA_PWNDBG_GDB ?? "/usr/bin/gdb";
|
|
33
33
|
const entry = environment.REA_PWNDBG_GDBINIT ?? "";
|
|
34
34
|
const venv = environment.REA_PWNDBG_VENV_PATH ?? "";
|
|
@@ -37,23 +37,43 @@ export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, op
|
|
|
37
37
|
userMessage: message,
|
|
38
38
|
capturedOutput: diagnostics,
|
|
39
39
|
});
|
|
40
|
+
const checkCancelled = () => {
|
|
41
|
+
if (options?.signal?.aborted)
|
|
42
|
+
throw new AnalysisCancelledError(OPERATION, {
|
|
43
|
+
capturedOutput: diagnostics,
|
|
44
|
+
});
|
|
45
|
+
};
|
|
46
|
+
checkCancelled();
|
|
40
47
|
for (const [key, path, kind] of [
|
|
41
48
|
["REA_PWNDBG_GDB", gdb, "file"],
|
|
42
49
|
["REA_PWNDBG_GDBINIT", entry, "file"],
|
|
43
50
|
["REA_PWNDBG_VENV_PATH", venv, "directory"],
|
|
44
51
|
]) {
|
|
45
52
|
try {
|
|
53
|
+
checkCancelled();
|
|
46
54
|
if (!isAbsolute(path))
|
|
47
55
|
throw new Error("Expected an absolute caller-supplied path.");
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
56
|
+
const mode = key === "REA_PWNDBG_GDB" ? constants.X_OK : constants.R_OK;
|
|
57
|
+
if (probePath !== undefined) {
|
|
58
|
+
await probePath(path, kind, mode);
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
await access(path, mode);
|
|
62
|
+
checkCancelled();
|
|
63
|
+
const information = await stat(path);
|
|
64
|
+
checkCancelled();
|
|
65
|
+
if (kind === "file" ? !information.isFile() : !information.isDirectory())
|
|
66
|
+
throw new Error(`Expected a ${kind}.`);
|
|
67
|
+
}
|
|
68
|
+
checkCancelled();
|
|
52
69
|
}
|
|
53
70
|
catch (cause) {
|
|
71
|
+
if (options?.signal?.aborted)
|
|
72
|
+
checkCancelled();
|
|
54
73
|
throw unavailable(`${key} is unavailable at ${path}: ${cause instanceof Error ? cause.message : String(cause)}. Configure the requested core-only context, or omit include_debugger_context for basic recorded evidence.`, cause);
|
|
55
74
|
}
|
|
56
75
|
}
|
|
76
|
+
checkCancelled();
|
|
57
77
|
const stage = join(rootPath, "debugger");
|
|
58
78
|
await mkdir(stage, { mode: 0o700 });
|
|
59
79
|
const requestPath = join(stage, "request.json");
|
|
@@ -60,6 +60,8 @@ export function validateRecordedCrashStructure(report, snapshot, diagnostics) {
|
|
|
60
60
|
if (!header
|
|
61
61
|
.subarray(0, 6)
|
|
62
62
|
.equals(Buffer.from([0x7f, 0x45, 0x4c, 0x46, 2, 1])) ||
|
|
63
|
+
header[6] !== 1 ||
|
|
64
|
+
header.readUInt32LE(20) !== 1 ||
|
|
63
65
|
![0, 3].includes(header[7] ?? -1) ||
|
|
64
66
|
header[8] !== 0 ||
|
|
65
67
|
header.readUInt16LE(16) !== 4 ||
|
|
@@ -114,18 +114,15 @@ export const createDarwinProcessRunTokenReader = (options = {}) => {
|
|
|
114
114
|
if (signal.aborted || closed)
|
|
115
115
|
throw abortReason(signal);
|
|
116
116
|
const output = join(operationRoot, "reader");
|
|
117
|
+
const compilerEnvironment = { ...process.env };
|
|
118
|
+
// Use Swift's reusable default cache for REA's internal helper compilation.
|
|
119
|
+
delete compilerEnvironment.CLANG_MODULE_CACHE_PATH;
|
|
117
120
|
try {
|
|
118
|
-
await execFileOutput(options.xcrun ?? "/usr/bin/xcrun", [
|
|
119
|
-
"swiftc",
|
|
120
|
-
"-module-cache-path",
|
|
121
|
-
join(operationRoot, "modules"),
|
|
122
|
-
...sourceFiles,
|
|
123
|
-
"-o",
|
|
124
|
-
output,
|
|
125
|
-
], {
|
|
121
|
+
await execFileOutput(options.xcrun ?? "/usr/bin/xcrun", ["swiftc", ...sourceFiles, "-o", output], {
|
|
126
122
|
timeout: 60_000,
|
|
127
123
|
maxBuffer: 1024 * 1024,
|
|
128
124
|
signal,
|
|
125
|
+
env: compilerEnvironment,
|
|
129
126
|
});
|
|
130
127
|
}
|
|
131
128
|
catch (cause) {
|
|
@@ -134,7 +131,9 @@ export const createDarwinProcessRunTokenReader = (options = {}) => {
|
|
|
134
131
|
const code = cause instanceof Error && "code" in cause
|
|
135
132
|
? String(cause.code)
|
|
136
133
|
: "unknown";
|
|
137
|
-
throw new DarwinProcessOwnershipInspectionError(
|
|
134
|
+
throw new DarwinProcessOwnershipInspectionError(code === "ENOENT"
|
|
135
|
+
? `macOS process ownership inspection requires the Apple Swift compiler via xcrun (compiler result: ${code})`
|
|
136
|
+
: `macOS process ownership helper compilation failed via xcrun (compiler result: ${code}): ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
|
|
138
137
|
}
|
|
139
138
|
if (signal.aborted || closed)
|
|
140
139
|
throw abortReason(signal);
|
|
@@ -1,4 +1,24 @@
|
|
|
1
1
|
import { execFile, } from "node:child_process";
|
|
2
|
+
/** Read captured output metadata from a failed execFileOutput invocation. */
|
|
3
|
+
export const execFileOutputFailure = (cause) => {
|
|
4
|
+
if (!(cause instanceof Error))
|
|
5
|
+
return undefined;
|
|
6
|
+
const stdout = Reflect.get(cause, "stdout");
|
|
7
|
+
const stderr = Reflect.get(cause, "stderr");
|
|
8
|
+
const code = Reflect.get(cause, "code");
|
|
9
|
+
const signal = Reflect.get(cause, "signal");
|
|
10
|
+
const killed = Reflect.get(cause, "killed");
|
|
11
|
+
if (typeof stdout !== "string" || typeof stderr !== "string")
|
|
12
|
+
return undefined;
|
|
13
|
+
return {
|
|
14
|
+
stdout,
|
|
15
|
+
stderr,
|
|
16
|
+
code: typeof code === "string" || typeof code === "number" ? code : null,
|
|
17
|
+
signal: typeof signal === "string" ? signal : null,
|
|
18
|
+
killed: killed === true,
|
|
19
|
+
outputTruncated: code === "ERR_CHILD_PROCESS_STDIO_MAXBUFFER",
|
|
20
|
+
};
|
|
21
|
+
};
|
|
2
22
|
/** Run a shell-free command while capturing its complete UTF-8 output. */
|
|
3
23
|
export const execFileOutput = (command, arguments_, options = {}) => new Promise((resolve, reject) => {
|
|
4
24
|
execFile(command, [...arguments_], {
|
|
@@ -83,9 +83,14 @@ const collectOwnedCommand = async (spawn, limits, launcher, deadline, callerSign
|
|
|
83
83
|
: "Command deadline elapsed.", snapshot);
|
|
84
84
|
if (exceeded)
|
|
85
85
|
throw new OwnedCommandFailure("output-limit", "Command diagnostic output exceeded its complete-output budget.", snapshot);
|
|
86
|
+
const acceptedNonzeroExit = limits.acceptNonZeroExit === true &&
|
|
87
|
+
snapshot.exitCode !== null &&
|
|
88
|
+
snapshot.exitCode !== undefined &&
|
|
89
|
+
snapshot.exitCode !== 0 &&
|
|
90
|
+
snapshot.signal === null;
|
|
86
91
|
if (processFailure !== undefined ||
|
|
87
|
-
snapshot.exitCode !== 0 ||
|
|
88
|
-
|
|
92
|
+
((snapshot.exitCode !== 0 || snapshot.signal !== null) &&
|
|
93
|
+
!acceptedNonzeroExit))
|
|
89
94
|
throw new OwnedCommandFailure("process", processFailure ??
|
|
90
95
|
"Command failed; inspect its exit status and diagnostics.", snapshot);
|
|
91
96
|
}
|